В статье приведены возможности связи Integromat и Telegram, инструкция подключения и описание триггеров.


При помощи Integromat вы можете выполнять различные действия в своих группах и каналах, например:

  • Отправлять ответы из форм в группу;
  • Уведомлять весь состав администрации о новом пользователе, платеже, начатом диалоге, опубликованном посте и прочее;
  • Закреплять или откреплять какие-то сообщения в ресурсах;
  • Служебные операции в группе (назначение или снятие админских прав, удаление сообщения и так далее);
  • Отправлять любые сообщения (и медиа) в ресурсы;
  • и другие…



Способ выполнения


  1. Привязываем вебхук;
  2. Предварительный запуск;
  3. Получаем наши данные из формы (маленький круг - индикатор с цифрой 1);
  4. Добавляем в связку модуль Telegram Bot;
  5. Приглашаем нашего бота в группу/канал и выдаем права администратора (Внимание! Эта группа должна быть подтверждена в личном кабинете PuzzleBot, иначе бот самопроизвольно покинет её);
  6. Далее, в зависимости от задачи, применяем определенную функцию (см. Описание триггеров Telegram ниже); — (мы попробуем закрепить сообщение из нашей формы — Pin a Message);
  7. Для того, чтобы закрепить сообщение, нам нужно сначала получить это сообщение в пределах группы:
    В модуль Telegram Bot — Send a Text Message or a Reply переносим полученные данные (из п. 3)
    • Chat ID: адрес нашей группы (копируем и вставляем - @название_группы);
    • Text: сюда переносим функцию answer, т.е. то сообщение ИЗ формы, которое будем крепить в группе. Конечный вид - 1. forms [1]: answer (Если вы наведёте указателем мышки на эту форму, то сможете выбрать другой порядковый номер вашего ответа на форму);
    • Disable Notifications: включение или выключение оповещения для участников;
    • Disable Link Previews: включение или выключение превью вашей ссылки;
      Сохраняем - ОК
  8. Добавляем еще один модуль Telegram Bot — Pin a Message (которой будем уже крепить полученное сообщение):
    • Chat ID: переносим одноименную функцию из модульного окна;
    • Message ID: переносим одноименную функцию из модульного окна;
    • Disable Notifications: включение или выключение оповещения для участников;
      Сохраняем - ОК
  9. Готово.



Описание триггеров Telegram


Триггеры в Integromat — это некий модульный функционал, например: отправка сообщения или удаление этого сообщения.


Чтобы не повторяться, перечислим основные настройки:

  • Chat ID — id группы (вкладка Chat)
  • User ID — id подписчика (вкладка From)
  • Parse Mode — выбор синтаксиса: HTML или Markdown
  • Disable Notifications — включение или выключение оповещения для участников;
  • Disable Link Previews — включение или выключение превью вашей ссылки;
  • Text — текстовая графа, содержимое которой будет отправлено всем подписчикам (можно переносить ответы пользователей из форм ввода, добавлять математические формулы и переменные других модулей);
  • Message ID — id сообщения над которым вы хотите выполнить какую-то задачу (удалить, отредактировать, закрепить). Обычно, все модули, где есть данный пункт должны стоять следом после триггера Send a Text Message or a Reply. Иначе говоря, чтобы работать с сообщением, нужно знать с каким сообщением мы работаем (его id).


Действия с сообщениями:

  • Send a Text Message or a Reply — отправка сообщения или Ответ на сообщение.
  • Edit a Text Message — редактирование текстового сообщения.
  • Forward a Message пересылает сообщения любого рода (Данный триггер может использоваться для переадресации сообщений только внутри Телеграм). From Chat ID — введите уникальный идентификатор чата, на который было отправлено оригинальное сообщение (или имя адрес канала в формате @имя_канала).
  • Delete a Message — удаляет сообщение (сообщение можно удалить только в том случае, если оно было отправлено менее 48 часов назад).
  • Pin a Message — закрепить сообщение.
  • Unpin a Message — открепить сообщение.


Действия с медиа:

  • Send an Audio File — отправить аудиофайл.
  • Send a Document/Image — отправить документ/изображение.
  • Send an Album (Media Group) — отправить альбом (медиа-группа).
  • Send a Photo — отправить фото.
  • Send a Sticker — отправить стикер.
  • Send a Video — отправить видео.
  • Send a Video Note — отправить видео запись.
  • Send a Voice Message — отправить голосовое сообщение.
  • Send Media by URL or ID  — посылает файл по HTTP URL или по ID, существующему на серверах Telegram.
  • Download a File — скачать файл с сервера Telegram.


Действия с чатом:

  • List Updates
  • List Chats


Действия с подписчиками:

  • List Administrators in a Chat — кол-во админов в чате + их привилегии (Модуль лишь собирает результат. Чтобы отправить полученные данные в чат, нужно добавить ещё один модуль Send a Text Message or a Reply)
  • Get the Number of Members is a Chat — кол-во подписчиков в чате (Модуль лишь собирает результат. Чтобы отправить полученные данные в чат, нужно добавить ещё один модуль Send a Text Message or a Reply)
  • Kick a Chat Member — удалить подписчика из чата + ЧС
    • Until Date: занесение в черный список до определенной даты (формат 20.6.2016 17:26:44 GMT+03:00)
  • Restrict a Chat Member — назначить подписчика администратором
    • Until Date: выдача прав до определенной даты (формат 20.6.2016 17:26:44 GMT+03:00)
    • Set if the User Can Send Messages: можно ли админу отправлять сообщения
    • Can Send Media Messages: можно ли админу отправлять медиа
    • Can send Other Messages: можно ли админу отправлять иные сообщения (стикеры, игры, инлайн-команды сторонних сервисов)
    • Can Add Web Page Previews: можно ли админу включать превью для ссылок
  • Promote a Chat Member — выдать администратору привилегии
    • Change Info: можно ли админу редактировать заголовок чата, фотографию и другие настройки.
    • Create Channel Posts: создавать посты на канале [настройка для каналов]
    • Can Edit Messages: редактировать сообщения
    • Can Delete Messages: удалять сообщения
    • Can Invite Users: приглашать людей в чат
    • Can Restrict Members: выдавать админку
    • Can Pin Messages: закреплять/откреплять сообщения
    • Can Promote Members: выдавать привилегии подписчикам


Прочее:

  • Make an API Call