Рассылки в Telegram

Регистрация бота

Для создания нового бота или редактирования существующих необходимо использовать бота - @BotFather (opens new window)

Для регистрации бота в меню выбираем пункт - Create a new bot. Указываем название бота и его имя. Название может быть любым, имя обязательно указывается латиницей, а также оно должно заканчиваться на _bot.

После успешной регистрации вы получите сообщение с информацией о вашем боте. Для дальнейшей работы потребуется токен. Для проверки токена вы можете воспользоваться этой ссылкой - https://api.telegram.org/bot{TOKEN}/getMe

Не забудьте заменить {TOKEN} на реальный токен.

Получение токена

Если бот у вас уже есть, достаточно обратиться к @BotFather (opens new window), выбрать пункт меню Edit your bots, выбрать бота и выбрать Api Token

Установка Webhook

Для того чтобы работать с данными, которые получает бот, в нашем случае это контакты клиента, необходимо установить webhook.

Webhook это URL адрес, на который будут уходить данные каждый раз, когда с ботом происходит взаимодействие, например подписка, сообщение или отправка команды.

Для установки нам необходимо перейти по ссылке https://api.telegram.org/bot{TOKEN}/setWebhook?url={https://site.ru}

{TOKEN} - API токен вашего бота
{https://site.ru} - ссылка на сайт, где будут обрабатываться запросы от бота

Передача данных в REES46

После того как установлен webhook и настроен обработчик запросов, можно передавать Telegram ID пользователя в REES46.

Документация по запросу доступная по ссылке - перейти в документацию (opens new window)

Пример запроса

https://api.rees46.ru/profile/set?shop_id={SHOP_ID}&shop_secret={SHOP_SECRET}&email={EMAIL}&phone={PHONE}&telegram_id={TELEGRAM_ID}

Поиск клиента в REES46

Для того чтобы Telegram ID был присвоен определенному клиенту, необходимо в запросе передать его телефон или E-mail. После этого, каждое событие на сайте или в приложении может запустить триггерную цепочку, которая отправит сообщение в телеграм.

Для массовых рассылок это не обязательно, достаточно передать только Telegram ID.