Уведомления в Telegram
Оповещения в Telegram нужны для уведомления администраторов и пользователей об изменениях статусов заявок или других запросах без необходимости держать открытой страницу обменника.
Вы находитесь в инструкции для создания телеграм-бота для уведомлений клиентов по заявкам — если же вам нужна инструкция для создания бота для обмена, воспользуйтесь инструкцией для другого раздела.
Для корректной работы бота уведомлений требуется:
У пользователя должен быть добавлен юзернейм из Телеграм в ЛК в вашем обменнике
Пользователь должен активировать вашего бота для уведомлений командой
/startи получить от него ответ
Настройки
В Telegram отправьте пользователю @BotFather сообщение /newbot и следуйте инструкциям по созданию бота. После успешного создания бота, отобразится token - скопируйте его в буфер обмена. Другие настройки бота изменять не нужно.
В панели управления сайтом (раздел "Telegram" -> "Настройки") в поле "Token" укажите токен, который был получен во время создания бота.
Если раздел Telegram не отображается в боковой панели - включите модуль в разделе "Модули":
При необходимости логирования действий бота и последующего просмотра логов в разделе "Telegram" -> "Лог сообщений", активируйте следующие опции
В нижней части раздела "Telegram" -> "Настройки" перейдите по ссылке для регистрации вебхука.
При необходимости пропишите текст сообщений для пользователей бота.
В разделе "Пользователи" в профиле вашего пользователя укажите ваш Username из Telegram без @ (если Username отсутствует, то его необходимо задать в настройках Telegram)
Активируйте бота, отправив ему сообщение /start в Telegram.
В разделе "Сообщения" → "Тelegram шаблоны" настройте необходимые шаблоны для различных статусов заявок и других опций для отправления сообщений от имени бота администраторам и пользователям:
Обратите внимание, что настройки для администраторов и пользователей в выпадающем списке являются отдельными сущностями и настраиваются независимо друг от друга
Настройки шаблона:
Отправлять: "Да" — отправляем сообщения, "Нет" — не отправляем.
Telegram username администратора (без @) — username администратора, на который он будет получать уведомления. Через запятую можно указать несколько username, если у вас несколько администраторов.
Текст — текст отправляемого сообщения. Над полем для ввода текст, вы найдете панель с [шорт-кодами]. Используйте их в тексте письма и в заголовке письма, чтобы в отправляемых сообщениях отображались данные из заявок.
Для того, чтобы использовать бота, необходимо добавить дополнительное поле в каждое направление обмена, которое будет использовать бота.
Это необходимо для того, чтобы на странице обменника в направлениях обмена отображалось поле для ввода Username пользователем обменника
Для того, что использовать бота, пользователь обменника может указать свой 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