Telegram bot

Подключение:

Для того, чтобы настроить интеграцию Telegram бота и REES46, необходимо создать бота внутри мессенджера, или добавить токен текущего бота в систему.

Разберем создание бота:

Прежде всего, бот для Telegram — это по-прежнему приложение, запущенное на вашей стороне и осуществляющее запросы к  Telegram Bot API (opens new window). Причем API довольное простое — бот обращается на определенный URL с параметрами, а Telegram отвечает JSON объектом.

Прежде чем начинать разработку, бота необходимо зарегистрировать и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.

Пишем ему /start и получаем список всех его команд.

Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту. Единственное ограничение на имя — оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты. Токен, который выдаст бот — нам и нужен.

Добавляем только созданного бота, или ранее созданного, в систему:

Переходим к добавлению токена нашего бота в систему, для связки REES46 и telegram, для этого нужно в разделе настроек, выбрать «Настройки email/push» и в соответствующем разделе добавить токен бота (подробнее на скриншотах ниже)

Для того, чтобы мы могли отправлять рассылки в Телеграм от имени бота, нам необходим токен чат-бота (Настройки email/push - Настройки Telegram (Telegram token).

Когда пользователь зашел в чат-бот - ничего не происходит: как пришел, так и ушел. Но если пользователь пишет сообщение в бот или нажимает на кнопку (чаще всего предлагают нажать на кнопку /start) - тогда пользователь автоматически становится подписчиком бота и боту передается tg-id пользователя. Этот tg-id пользователя уже можно забирать и передавать к нам в систему – но в таком случае в нашей системе будет создан анонимный пользователь. Для того, чтобы не создавались анонимные пользователи и tg-id пользователей присваивались существующим профилям у нас в системе, необходимо дополнительно запрашивать email и/или телефон.

Чтобы получать информацию о пользователей необходимо обрабатывать обращения к боту. Для этого существует несколько методов, самое простое – webhook (opens new window).

В запросе содержится информация о пользователе и его обращении. Поэтому при клике на команду start мы можем как минимум получить ID клиента. Чтобы связать его с телефоном или email, его нужно запросить их. После того, как клиент передаст свой контакт нужно сохранить его к нам (opens new window).

Массовые и триггерные сообщения работают как обычно, более подробно ознакомиться с ними можно в соответствующих разделах.