Интеграция с Telegram-ботом
Процесс отправки сообщения от имени Telegram-бота из Бипиума.
Last updated
Процесс отправки сообщения от имени Telegram-бота из Бипиума.
Last updated
Каталог для отправки сообщений в Telegram — способ отправки сформированных сообщений пользователям или в групповые чаты от имени Telegram-бота.
Отправка сообщения производится с использованием специального каталога «Уведомления», в записях которого фиксируются id пользователя / чата и текст сообщения. Текст сообщения может быть сформирован как обычный текст, так и в формате HTML-верстки с использованием дополнительных возможностей форматирования. Описание возможностей форматирования сообщения Telegram-бота можно найти в официальной документации к API Telegram. Каталог позволяет удобно отправлять сообщения путем создания новых записей и следить за историей всех отправленных сообщений из Бипиума.
При создании записи в каталоге «Уведомления» срабатывает сценарий по отправке сообщения по данным из полей созданной записи.
Для начала необходимо создать Telegram-бота, от лица которого пользователи будут получать сообщения. Процесс создания бота описан на официальной странице документации сервиса Telegram.
После успешного создания бота направляется сообщение, содержащее логин созданного бота и токен для доступа к его API.
Для того, чтобы бот мог отправлять сообщения, получателю сообщения необходимо на него подписаться. Если же предполагается, что бот будет отправлять сообщения в групповой чат, то необходимо добавить его в соответствующий чат.
Для того, чтобы отправить сообщение с помощью бота, мы должны указать чат айди пользователя, которому мы хотим отправить.
Пользователю необходимо запустить бота: https://t.me/getmyid_bot
После этого в ответ придет сообщение с нашим чат айди:
Если мы хотим отправлять сообщения от бота в групповой чат, нам также необходимо получить чат айди. Для этого мы добавляем бота https://t.me/getmyid_bot в групповой чат:
При добавлении бота, он автоматические отправит чат айди группы:
Обратите внимание, что чат айди группы начинается с дефиса.
Создайте каталог «Уведомления», данный каталог будет содержать информацию о всех осуществленных рассылках. Создание записи в каталоге инициирует отправку сообщения. Настройка полей представлена на скриншоте ниже, создавать поля необходимо в том же порядке:
Кому (Текст) Описание: В это поле передается id пользователя или чата.
Сообщение (Многострочный текст) Описание: Текст сообщения.
Создайте новую запись в системном каталоге «Сценарии». Заполните обязательные поля карточки произвольным образом и прикрепите в поле «Сценарий» следующий файл, нажав на кнопку «Загрузить…»:
Перейдите в системный в каталог «События» (обычно он находится в отделе Управление) и создайте новую запись. Заполните запись следующим образом:
В поле «Выполнить» в качестве сценария выберите созданный на предыдущем шаге сценарий.
Сценарий для отправки сообщения выглядит следующим образом:
В загруженном сценарии отредактируйте следующие компоненты, согласно комментариям внутри них:
Компонент «токен» В переменной «token» в качестве значения укажите токен вашего Telegram-бота в кавычках.
Создайте запись в каталоге «Уведомления». Заполните поля записи и нажмите кнопку «Сохранить». Пример заполнения представлен ниже:
После сохранения записи в каталоге сообщение будет отправлено указанному пользователю. Пример отправленного ботом сообщения представлен на скриншоте ниже:
