Уведомления в Telegram

Оповещения в Telegram нужны для уведомления администраторов и пользователей об изменениях статусов заявок или других запросах без необходимости держать открытой страницу обменника.

Настройки

  1. В Telegram отправьте пользователю @BotFather сообщение /newbot и следуйте инструкциям по созданию бота. После успешного создания бота, отобразится token - скопируйте его в буфер обмена. Другие настройки бота изменять не нужно.

  2. В панели управления сайтом (раздел "Telegram" -> "Настройки") в поле "Token" укажите токен, который был получен во время создания бота.

Раздел "Telegram" -> "Настройки"

Если раздел Telegram не отображается в боковой панели - включите модуль в разделе "Модули":

  1. При необходимости логирования действий бота и последующего просмотра логов в разделе "Telegram" -> "Лог сообщений", активируйте следующие опции

Раздел "Telegram" -> "Лог сообщений"
  1. В нижней части раздела "Telegram" -> "Настройки" перейдите по ссылке для регистрации вебхука.

Раздел "Telegram" -> "Настройки"
  1. При необходимости пропишите текст сообщений для пользователей бота.

Раздел "Telegram" -> "Настройки"
  1. В разделе "Пользователи" в профиле вашего пользователя укажите ваш Username из Telegram без @ (если Username отсутствует, то его необходимо задать в настройках Telegram)

Раздел "Настройки" в Telegram
Раздел "Пользователи" -> "Редактировать"
  1. Активируйте бота, отправив ему сообщение /start в Telegram.

  2. В разделе "Сообщения" → "Тelegram шаблоны" настройте необходимые шаблоны для различных статусов заявок и других опций для отправления сообщений от имени бота администраторам и пользователям:

Раздел "Сообщения" → "Тelegram шаблоны"

Настройки шаблона:

  • Отправлять: "Да" — отправляем сообщения, "Нет" — не отправляем.

  • Telegram username администратора (без @) — username администратора, на который он будет получать уведомления. Через запятую можно указать несколько username, если у вас несколько администраторов.

  • Текст — текст отправляемого сообщения. Над полем для ввода текст, вы найдете панель с [шорт-кодами]. Используйте их в тексте письма и в заголовке письма, чтобы в отправляемых сообщениях отображались данные из заявок.

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

Раздел "Направления обменов" -> "Доп. поля"

Это необходимо для того, чтобы на странице обменника в направлениях обмена отображалось поле для ввода Username пользователем обменника

Страница обмена
  1. Для того, что использовать бота, пользователь обменника может указать свой Username в Telegram в настройках профиля (при этом он будет автоматически подставляться в поле "Телеграм", если оно будет присутствовать при создании заявки (набор полей определяется администратором для каждого направления индивидуально)) или при создании каждой заявки указывать Username вручную.

Личный кабинет пользователя в обменнике

По умолчанию администраторам сообщения не отправляются, если администратор сам меняет статус заявки в админке (раздел "Заявки") - если вам необходимо, чтобы сообщения всегда отправлялись администратору, эту опцию необходимо активировать в разделе "Настройки обменника" -> "Основные настройки" -> "Другие настройки", пункт "Отправлять email админу, если админ сам меняет статус заявки".

Диагностика неисправностей

Если пользователям или администраторам не приходят или перестали приходить сообщения от бота - загляните в раздел "Telegram" -> "Лог сообщений", где можно просмотреть все логи, относящиеся к работе бота. При необходимости вы можете воспользоваться фильтром, который показывает какие сообщения относятся к самому боту, а какие к пользователям бота.

Раздел "Telegram" -> "Лог сообщений"

При неполадках с отправкой сообщений с помощью бота, вы можете удалить и зарегистрировать заново вебхук (см. п. 4) - это может помочь восстановить работу бота.

Если вы используете Cloudflare или подобный сервис для своего сайта - добавьте IP-адреса Telegram в whitelist в вашем сервисе:

91.108.56.0/22
91.108.4.0/22
91.108.8.0/22
91.108.16.0/22
91.108.12.0/22
149.154.160.0/20
91.105.192.0/23
91.108.20.0/22
185.76.151.0/24
2001:b28:f23d::/48
2001:b28:f23f::/48
2001:67c:4e8::/48
2001:b28:f23c::/48
2a0a:f280::/32

Альтернативный вариант: добавление пула IP-адресов по ASN (autonomous system number) — ASN Telegram и их добавление в whitelist в ЛК Cloudflare указаны в инструкции.

Last updated