Уведомления в Telegram
Оповещения в Telegram нужны для уведомления администраторов и пользователей об изменениях статусов заявок или других запросах без необходимости держать открытой страницу обменника.
Вы находитесь в инструкции для создания телеграм-бота для уведомлений клиентов по заявкам — если же вам нужна инструкция для создания бота для обмена, воспользуйтесь инструкцией для другого раздела.
Для корректной работы бота уведомлений требуется:
У пользователя должен быть добавлен юзернейм из Телеграм в ЛК в вашем обменнике
Пользователь должен активировать вашего бота для уведомлений командой
/startи получить от него ответ
Обратите внимание, что шаблоны для администраторов и пользователей в выпадающем списке являются отдельными сущностями и настраиваются независимо друг от друга (пункты в выпадающем списке)
Настройки
В Telegram отправьте пользователю @BotFather сообщение /newbot и следуйте инструкциям по созданию бота. После успешного создания бота, отобразится token - скопируйте его в буфер обмена. Другие настройки бота изменять не нужно.
В панели управления сайтом (раздел "Telegram" ➔ "Настройки") в поле "Token" укажите токен, который был получен во время создания бота.
Если раздел Telegram не отображается в боковой панели - включите модуль в разделе "Модули":
При необходимости логирования действий бота и последующего просмотра логов в разделе "Telegram" ➔ "Лог сообщений", активируйте следующие опции
В нижней части раздела "Telegram" -> "Настройки" перейдите по ссылке для регистрации вебхука.
При необходимости пропишите текст сообщений для пользователей бота.
В разделе "Пользователи" в профиле вашего пользователя укажите ваш Username из Telegram без @ (если Username отсутствует, то его необходимо задать в настройках Telegram)
Активируйте бота, отправив ему сообщение /start в Telegram.
В разделе "Сообщения" → "Тelegram шаблоны" настройте необходимые шаблоны для различных статусов заявок и других опций для отправления сообщений от имени бота администраторам и пользователям:
Еще раз обращаем ваше внимание, что шаблоны для администраторов и пользователей в выпадающем списке являются отдельными сущностями и настраиваются независимо друг от друга (пункты в выпадающем списке).
Начиная с версии 2.6 также можно отправлять сообщения только тем контактам, что указаны в настройках направления обмена, вкладка "Настройки уведомлений".
Добавлена возможность указать персональные e-mail/аккаунт в telegram/номер телефона для получения уведомления о заявке в этом направлении администратору/оператору (если одно или несколько полей для контактов заполнены, передача данных из шаблона выше будет осуществляться только на указанные контакты, игнорируя список администраторов в общем шаблоне для уведомлений).
Настройки шаблона:
Отправлять: "Да" — отправляем сообщения, "Нет" — не отправляем.
Telegram username администратора (без @) — username администратора, на который он будет получать уведомления. Через запятую можно указать несколько username, если у вас несколько администраторов.
Текст — текст отправляемого сообщения. Над полем для ввода текст, вы найдете панель с [шорткодами]. Используйте их в тексте письма и в заголовке письма, чтобы в отправляемых сообщениях отображались данные из заявок.
Для того чтобы использовать бота, необходимо добавить дополнительное поле "Телеграм" в каждое направление обмена, которое будет использовать бота.
Это необходимо для того, чтобы на странице обменника в направлениях обмена отображалось поле для ввода Username пользователем обменника
Для того, что использовать бота, пользователь обменника может указать свой Username в Telegram в настройках профиля (при этом он будет автоматически подставляться в поле "Телеграм", если оно будет присутствовать при создании заявки (набор полей определяется администратором для каждого направления индивидуально)) или при создании каждой заявки указывать Username вручную.
По умолчанию администраторам сообщения не отправляются, если администратор сам меняет статус заявки в админке (раздел "Заявки") - если вам необходимо, чтобы сообщения всегда отправлялись администратору, эту опцию необходимо активировать в разделе "Настройки обменника" -> "Основные настройки" -> "Другие настройки", пункт "Отправлять email админу, если админ сам меняет статус заявки".
Для того, чтобы получать уведомления в Telegram - каждому пользователя обязательно нужно "стартовать" бота на своём аккаунте
Диагностика неисправностей
Примечание для администраторов обменника: Чаще всего клиенты забывают запустить бота Telegram — из-за этого они не получают уведомления. Чтобы этого избежать, в шаблон Telegram-уведомления (например, “Новая заявка”) рекомендуется добавлять инструкцию: “Для получения уведомлений по заявке, пожалуйста, сначала перейдите в нашего Telegram-бота и нажмите \Start.”. Без активации бота с помощью этой кнопки Telegram не позволяет отправлять сообщения от имени бота клиенту.
Если пользователям или администраторам не приходят или перестали приходить сообщения от бота - загляните в раздел "Telegram" -> "Лог сообщений", где можно просмотреть все логи, относящиеся к работе бота. При необходимости вы можете воспользоваться фильтром, который показывает какие сообщения относятся к самому боту, а какие к пользователям бота.
При неполадках с отправкой сообщений с помощью бота, вы можете удалить и зарегистрировать заново вебхук (см. п. 4) - это может помочь восстановить работу бота.
Если вы используете Cloudflare или подобный сервис для своего сайта - добавьте IP-адреса Telegram в whitelist в вашем сервисе:
Альтернативный вариант: добавление пула IP-адресов по ASN (autonomous system number) — ASN Telegram и их добавление в whitelist в ЛК Cloudflare указаны в инструкции.
Последнее обновление