Уведомление в Telegram
Оповещение в Telegram о действиях клиентов
Важно после настройки Telegram
После добавления Telegram-бота, изменения токена доступа или подключения нового канала рекомендуется перезагрузить серверные процессы.
Это необходимо для корректной инициализации Telegram-интеграции и применения новых настроек.
Если после настройки уведомления не отправляются, канал не определяется автоматически или бот работает некорректно, сначала проверьте настройки, затем перезапустите сервер и повторите проверку подключения.
После перезагрузки рекомендуется нажать кнопку «Проверить» и убедиться, что бот успешно видит подключённый канал или чат.
Раздел «Telegram-уведомления» позволяет подключать Telegram-ботов и использовать их для отправки сообщений администраторам, операторам и клиентам.
Через этот раздел можно настроить рабочие уведомления о заявках, выплатах и действиях администраторов, личные сообщения клиентам и отдельного бота для кодов безопасности.
Система поддерживает несколько Telegram-подключений. Для каждого бота можно выбрать собственное назначение, получателей, события и шаблоны сообщений.
Где находится раздел
В панели управления откройте: «Настройки» — «Общие настройки»
Затем перейдите в раздел: «Уведомления» — «Telegram-уведомления»
Для открытия раздела группе пользователя должен быть предоставлен доступ к управлению Telegram-уведомлениями.
Если отображается сообщение «У вас нет доступа к разделу», проверьте группу администратора и выданные ей права.
Для чего нужен раздел
Через раздел можно:
подключать Telegram-ботов;
привязывать группы и каналы;
отправлять личные сообщения клиентам;
включать и отключать Telegram-доставку;
выбирать события для каждого подключения;
разделять уведомления между несколькими каналами;
настроить отдельного бота безопасности;
привязывать Telegram-аккаунты администраторов;
изменять шаблоны сообщений;
проверять доступ бота к группе или каналу;
диагностировать причины отсутствия сообщений.
Как работает система
Для успешной отправки обычного Telegram-уведомления должны одновременно выполняться следующие условия:
Включена общая отправка уведомлений.
Включена Telegram-доставка.
Нужный бот имеет статус «Включён».
Для бота выбран соответствующий тип события.
Бот имеет доступ к указанной группе или каналу.
Для личного сообщения Telegram клиента привязан к его аккаунту.
Очереди и фоновые процессы на сервере работают.
Если хотя бы одно условие не выполнено, сообщение не будет доставлено.
Виды Telegram-ботов
При создании подключения необходимо выбрать его назначение.
Доступны два варианта:
«Уведомления»
Рабочие сообщения администраторам, операторам и клиентам
«Коды и подтверждения безопасности»
Коды входа и подтверждение защищённых действий
Назначение выбирается при создании записи и впоследствии не изменяется.
Если назначение указано неправильно, создайте новое подключение с нужным типом.
Для обычных уведомлений и кодов безопасности рекомендуется использовать разных Telegram-ботов.
Создание Telegram-бота
Получите токен
После создания BotFather выдаст токен доступа.
Пример формата:
Скопируйте токен полностью, без пробелов и переносов строки.
Важно. Токен предоставляет доступ к управлению ботом. Не отправляйте его посторонним людям и не публикуйте в чатах, документах или репозиториях.
Если токен стал известен третьим лицам:
отзовите его через BotFather;
получите новый токен;
замените токен в iEXExchanger;
повторно проверьте привязку и отправку сообщений.
Добавление бота в iEXExchanger
В разделе «Telegram-уведомления» нажмите: «Добавить канал»
Заполните форму подключения.
Статус
Параметр определяет, может ли система использовать бота.
«Включён»
Бот участвует в отправке сообщений
«Выключен»
Настройки сохраняются, но сообщения не отправляются
Для первоначальной настройки рекомендуется:
создать запись выключенной;
выполнить привязку;
выбрать события;
проверить настройки;
включить бота.
Обычный бот уведомлений
Бот с назначением «Уведомления» используется для рабочих и клиентских сообщений.
Через него можно:
отправлять сообщения в группы и каналы;
уведомлять операторов о новых заявках;
отправлять финансовые уведомления;
сообщать о действиях администраторов;
отправлять клиентам личные сообщения;
использовать Telegram Mini App;
добавлять кнопку открытия заявки;
применять собственные шаблоны.
После создания откройте запись на редактирование.
Основные параметры
В редакторе обычного бота можно изменить:
название;
токен доступа;
статус;
режим личных сообщений;
список событий.
Назначение бота изменить нельзя.
После замены токена повторно проверьте доступ к привязанной группе или каналу.
Подключение группы
Если уведомления должны получать операторы или администраторы, можно использовать отдельную Telegram-группу.
Подготовка группы
Создайте группу или откройте существующую.
Добавьте в неё созданного бота.
Отправьте новое сообщение после добавления бота.
Вернитесь в панель управления.
Откройте нужную Telegram-запись.
Нажмите «Проверить».
Выберите найденную группу.
Нажмите «Привязать».
Боту должен быть разрешён доступ к сообщениям, необходимым для определения группы и отправки уведомлений.
Подключение канала
Для отправки уведомлений в Telegram-канал:
Откройте канал.
Добавьте бота в список администраторов.
Разрешите ему публикацию сообщений.
Опубликуйте новое сообщение после добавления бота.
Вернитесь в панель управления.
Нажмите «Проверить».
Выберите найденный канал.
Нажмите «Привязать».
Без права публикации бот не сможет отправлять сообщения в канал.
Проверка и привязка
Кнопка «Проверить» получает доступные Telegram-обновления и показывает найденные чаты, группы и каналы.
В окне диагностики могут отображаться:
текущая привязка;
ID чата;
название чата;
доступность чата для бота;
найденные варианты;
рекомендуемый вариант;
последние обновления;
наличие webhook;
подсказки по исправлению.
Проверка сама по себе не изменяет получателя. Для сохранения выбранного чата нажмите «Привязать».
После успешной привязки в записи появятся:
ID чата;
название;
состояние доступности или подтверждения.
Если группа или канал не найдены
Проверьте:
Бот добавлен в нужную группу или канал.
После добавления отправлено новое сообщение.
В канале бот назначен администратором.
Боту разрешена публикация.
В панели указан токен именно этого бота.
Сообщение отправлено после добавления бота.
Другой сервис не забирает обновления бота.
После проверки отправьте новое сообщение и снова нажмите «Проверить».
Webhook и получение обновлений
Telegram не позволяет одновременно полноценно получать обновления через webhook и стандартный запрос getUpdates.
Если диагностика сообщает о webhook:
проверьте, какой сервис его установил;
не отключайте webhook бота безопасности без необходимости;
для обычных уведомлений используйте отдельного бота;
удалите webhook только в том случае, если он больше нигде не используется;
после изменения отправьте новое сообщение и повторите проверку.
Для бота с назначением «Коды и подтверждения безопасности» привязка общей группы или канала не используется.
Отправлять только в бота
Параметр «Отправлять только в бота» назначает подключение основным ботом для личных сообщений клиентам.
Когда настройка включена:
сообщения отправляются в личные Telegram-чаты клиентов;
используется персональная Telegram-привязка клиента;
бот может применяться для Telegram Mini App;
общий канал или группа не используются как получатель клиентского сообщения.
Одновременно основным может быть только один обычный бот.
Если включить параметр у другого подключения, предыдущий бот перестанет использоваться как основной для личных сообщений.
Не включайте настройку у нескольких ботов в расчёте на одновременную клиентскую отправку.
Выбор уведомлений
В редакторе обычного бота находится блок: «Что отправлять в этот чат»
События разделены по аудиториям.
Для администраторов
В зависимости от версии системы и подключённых модулей могут быть доступны уведомления:
о создании заявки;
о новой заявке для администраторов;
о ежедневной статистике;
об ошибке автоматической выплаты;
о верификации карты;
о новой заявке на выплату бонусов;
о первом подтверждении блокчейн-транзакции;
о выполненной автоматической выплате;
о действии Google 2FA;
о входе в административную панель;
об изменении IP-адреса администратора;
о срабатывании страховки курса;
о новом сообщении клиента в чате заявки.
Административные уведомления обычно направляются в отдельную группу или канал операторов.
Для клиентов
Для клиентов могут быть доступны личные сообщения:
заявка создана;
заявка выполнена;
заявка отклонена;
заявка отложена;
заявка восстановлена;
клиент подтвердил оплату;
клиенту выданы реквизиты;
требуется верификация;
оператор ответил в чате заявки.
Для доставки клиентского сообщения необходимо:
включить «Отправлять только в бота»;
включить нужное событие;
оставить бота активным;
привязать Telegram клиента к его аккаунту.
Если Telegram клиента не привязан, система не сможет определить личный чат получателя.
После выбора событий нажмите «Сохранить».
Несколько Telegram-каналов
В системе можно создать несколько обычных Telegram-подключений.
Например:
Если одно событие включено у нескольких активных подключений, сообщение будет отправлено во все подходящие каналы.
Для личных клиентских сообщений одновременно используется только один активный бот с параметром «Отправлять только в бота».
Общие переключатели
В верхней части страницы находятся два основных переключателя.
Отправлять уведомления
Это главный переключатель всей системы уведомлений.
Если он выключен, прекращается отправка:
писем;
Telegram-сообщений;
уведомлений клиентам;
уведомлений администраторам.
Даже правильно настроенный Telegram-бот не будет отправлять сообщения, пока общий переключатель выключен.
Изменение применяется автоматически.
Уведомления Telegram
Переключатель управляет только Telegram-доставкой.
Если он выключен:
Telegram-боты сохраняются;
каналы остаются привязанными;
выбранные события не удаляются;
Telegram-сообщения временно не отправляются;
почтовые уведомления могут продолжать работать.
Изменение также применяется автоматически.
Шаблоны Telegram-уведомлений
Для редактирования сообщений нажмите: «Шаблоны»
Шаблоны разделены по аудиториям:
администраторы;
операторы;
клиенты.
Как изменить шаблон
Откройте «Шаблоны».
Выберите аудиторию.
Найдите нужное событие.
Измените текст сообщения.
Добавьте доступные переменные.
Включите пользовательский шаблон.
Нажмите «Предпросмотр».
Проверьте результат.
Нажмите «Сохранить шаблон».
Переменные в шаблонах
Переменные позволяют автоматически подставлять данные события:
номер заявки;
статус;
сумму;
валюту;
имя пользователя;
другие данные, доступные конкретному шаблону.
Точный список переменных отображается в редакторе выбранного события.
Используйте только доступные переменные. Если указать неподдерживаемое значение, система не сможет правильно подставить данные.
Стандартный и пользовательский текст
Если пользовательский шаблон выключен или не создан, система использует стандартный текст.
Кнопка «Вернуть стандартный текст» вставляет стандартный вариант в редактор. Изменение станет активным только после сохранения.
Предпросмотр
Предпросмотр подставляет тестовые значения и показывает приблизительный вид сообщения.
Перед сохранением проверьте:
структуру текста;
используемые переменные;
понятность сообщения;
отсутствие лишних технических данных;
корректность форматирования.
Форматирование
Telegram-шаблоны поддерживают разрешённое HTML-форматирование.
Если Telegram отклонит сообщение из-за ошибки в разметке, система может повторить отправку без HTML.
Несмотря на это, используйте предпросмотр и не добавляйте неподдерживаемые теги.
Бот безопасности
Бот с назначением «Коды и подтверждения безопасности» используется только для защищённых действий в административной панели.
Через него могут отправляться:
коды подтверждения;
подтверждения административного входа;
коды защищённых операций;
другие сообщения безопасности.
Такой бот не используется как общий канал заявок и не требует привязки группы или канала.
Ограничения бота безопасности
В системе может быть только один действующий бот безопасности.
Для его создания администратор должен:
иметь право управления Telegram-безопасностью;
иметь действующий E-mail;
указать правильный токен;
использовать токен отдельного Telegram-бота.
Не используйте одного бота одновременно для клиентских уведомлений и кодов безопасности.
Проверка токена
При создании система проверяет токен через Telegram.
Если Telegram не подтвердит его, бот безопасности не будет создан.
После успешной проверки в карточке отображаются:
имя бота;
ID бота;
владелец настройки;
дата последней проверки токена.
Токен бота безопасности хранится в защищённом виде и повторно в форме не показывается.
Изменение бота безопасности
Изменение названия, статуса или токена требует подтверждения шестизначным кодом, отправленным на E-mail владельца бота.
Откройте запись бота безопасности.
Измените нужные параметры.
Нажмите «Сохранить».
Получите код на E-mail владельца.
Введите шесть цифр.
Подтвердите изменение.
Если токен менять не нужно, оставьте поле нового токена пустым.
Отключение и отвязка
Бота безопасности нельзя удалить обычной кнопкой из списка.
Для отключения или отвязки требуется подтверждение по E-mail владельца.
Система может запретить отключение, если Telegram выбран администраторами как действующий способ получения кодов.
В этом случае:
переведите администраторов на Email или Google 2FA;
проверьте новый способ подтверждения;
повторите отключение бота безопасности.
Привязка Telegram администратора
Создания бота безопасности недостаточно. Каждый администратор, который будет получать коды в Telegram, должен отдельно привязать собственный аккаунт.
В панели управления откройте: «Пользователи» — «Список пользователей»
Выберите администратора и найдите блок: «Управление доступом»
Затем выполните следующие действия:
Нажмите «Создать ссылку Telegram».
Откройте полученную ссылку.
Запустите бота.
Подтвердите привязку.
Вернитесь в административную панель.
Нажмите «Проверить привязку».
Убедитесь, что отображается подключённый Telegram-аккаунт.
Выберите Telegram как способ подтверждения кодов безопасности.
Подтвердите изменение через текущий действующий способ.
Каждый администратор должен привязать собственный Telegram-аккаунт.
Управление подключениями
Удаление
Обычную Telegram-запись можно удалить из списка.
Перед удалением проверьте:
не является ли она основным клиентским ботом;
не используется ли токен в Telegram Mini App;
настроены ли важные события в другом канале;
существует ли резервный канал для администраторов.
Удаление записи из iEXExchanger:
не удаляет бота в BotFather;
не удаляет Telegram-канал;
не удаляет Telegram-группу.
Бот безопасности отключается или отвязывается через отдельную защищённую процедуру.
Как настроить уведомления администраторам
Создайте обычного бота через @BotFather.
Создайте Telegram-группу или канал.
Добавьте туда бота.
Для канала назначьте его администратором.
Разрешите публикацию сообщений.
Отправьте новое сообщение.
В iEXExchanger нажмите «Добавить канал».
Укажите название и токен.
Выберите назначение «Уведомления».
Создайте запись.
Нажмите «Проверить».
Выберите найденный чат.
Нажмите «Привязать».
Откройте редактор бота.
Включите нужные административные события.
Включите статус.
Сохраните настройки.
Создайте тестовое событие.
Как настроить личные уведомления клиентам
Создайте обычного Telegram-бота.
Добавьте его в iEXExchanger.
Выберите назначение «Уведомления».
Откройте запись на редактирование.
Включите «Отправлять только в бота».
Выберите события для клиентов.
Включите статус.
Сохраните настройки.
Убедитесь, что клиент может привязать Telegram.
Проверьте отправку на тестовой заявке.
Для теста используйте клиента с подтверждённой Telegram-привязкой.
Как настроить бота безопасности
Создайте отдельного Telegram-бота через @BotFather.
В iEXExchanger нажмите «Добавить канал».
Укажите название.
Вставьте токен.
Выберите назначение «Коды и подтверждения безопасности».
Создайте запись.
Проверьте данные бота.
Привяжите Telegram каждого администратора.
Выберите Telegram как способ подтверждения.
Выполните тестовое защищённое действие.
Для бота безопасности не требуется создавать группу или канал.
Проверка после настройки
После завершения настройки:
Включите «Отправлять уведомления».
Включите «Уведомления Telegram».
Включите нужного бота.
Проверьте привязку канала.
Включите подходящее событие.
Сохраните запись.
Создайте тестовую заявку или сообщение.
Проверьте доставку в Telegram.
Проверьте формат сообщения.
Проверьте журнал ошибок при отсутствии доставки.
Для клиентского теста используйте аккаунт с привязанным Telegram.
Для проверки бота безопасности запросите код через тестовое защищённое действие.
Частые ошибки
Бот удалён из группы или канала
Добавьте его повторно и предоставьте необходимые права.
Для канала обязательно разрешите публикацию сообщений.
Чат не найден
Возможные причины:
указан неправильный токен;
бот не добавлен в чат;
после добавления не отправлено новое сообщение;
бот не имеет необходимых прав;
другой сервис получает обновления этого бота;
для бота установлен webhook.
Проверьте диагностику, отправьте новое сообщение и повторите привязку.
Бот заблокирован пользователем
Для личных сообщений пользователь должен открыть бота и нажать Start.
Если пользователь заблокировал бота, личные сообщения не доставляются.
Указан неправильный токен
Сравните токен с данными BotFather.
При подозрении на утечку создайте новый токен и замените его в панели.
Telegram сообщает, что чат не найден
Обычно это означает, что:
указан неправильный ID;
бот удалён из группы;
бот удалён из канала;
бот не имеет доступа;
группа или канал были изменены.
Выполните повторную диагностику и привязку.
Клиентские сообщения не доставляются
Проверьте:
включена ли настройка «Отправлять только в бота»;
является ли этот бот активным;
включено ли нужное событие;
привязан ли Telegram клиента;
нажал ли клиент Start;
не заблокировал ли клиент бота.
Коды безопасности не приходят
Проверьте:
включён ли бот безопасности;
привязан ли Telegram администратора;
выбран ли Telegram как способ подтверждения;
включены ли общие переключатели;
не заблокировал ли администратор бота;
работают ли очереди.
Настройки верны, но сообщения задерживаются
Telegram-уведомления могут обрабатываться фоновыми задачами.
Техническому специалисту необходимо проверить:
очереди Laravel;
Laravel Horizon;
Redis;
фоновые процессы;
журнал ошибок;
доступ сервера к Telegram API.
После изменения токена или привязки может потребоваться перезапуск обработчиков очередей. Полная перезагрузка сервера обычно не нужна.
Раздел не отображается
Проверьте права группы пользователя.
В панели управления откройте: «Пользователи» — «Группы пользователей»
Выберите группу и предоставьте право управления Telegram-уведомлениями.
Рекомендации
Для надёжной работы Telegram-уведомлений:
используйте отдельного бота для кодов безопасности;
разделите операционные, финансовые и защитные уведомления;
не публикуйте токены;
не передавайте токены операторам;
предоставляйте доступ к настройкам только доверенным администраторам;
немедленно заменяйте токен при подозрении на утечку;
не отключайте бота безопасности, пока он используется администраторами;
защитите E-mail владельца бота двухфакторной авторизацией;
регулярно проверяйте права ботов в группах и каналах;
проверяйте работу очередей;
после важных изменений выполняйте тестовую отправку.
Контрольный список
Перед началом работы убедитесь:
Коротко
Telegram-уведомления позволяют отправлять сообщения администраторам, операторам и клиентам.
Обычный бот используется для заявок, выплат и личных клиентских сообщений. Отдельный бот безопасности применяется для кодов и подтверждения защищённых действий.
Для работы необходимо создать бота через @BotFather, добавить токен в iEXExchanger, выбрать назначение, привязать группу или канал, включить события и проверить доставку.
Для личных сообщений клиентам Telegram должен быть привязан к аккаунту пользователя. Для кодов безопасности каждый администратор отдельно подключает свой Telegram к боту безопасности.
Последнее обновление
Это было полезно?