Telegram Bot

Для чего нужен раздел

Telegram-уведомления помогают администраторам, операторам и клиентам получать важные события: новые заявки, изменение статуса, проверки, ошибки, входы и служебные сообщения.

Когда использовать

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

Основные возможности

Возможность	Что означает простыми словами	Когда использовать
Список каналов	Каналы и чаты, куда отправляются уведомления	Когда нужно добавить или проверить получателя
Токен бота	Доступ Telegram-бота	При подключении бота
Привязка канала	Связь записи в админке с реальным чатом	Когда бот уже добавлен в чат
Диагностика канала	Проверка, видит ли бот чат	Когда уведомления не приходят
Статус канала	Включена ли отправка	Когда нужно временно остановить уведомления
Шаблоны уведомлений	Тексты Telegram-сообщений	Когда нужно изменить формулировку уведомления
Группы получателей	Администраторы, операторы, клиенты	Когда разные аудитории должны получать разные тексты

Поля и настройки

Поле / настройка	Что означает	Как правильно заполнять	Важно знать
Название	Имя канала в админке	Пишите понятное назначение	Например, "Операторы - новые заявки"
Токен доступа	Токен Telegram-бота	Заполняйте только в админке	Нельзя добавлять в документацию
ID канала	Числовой ID Telegram-чата	Получается через привязку или диагностику	Ошибка ID приведет к молчанию уведомлений
Имя канала	Человекочитаемое имя чата	Заполняется при привязке	Помогает проверить, что выбран правильный чат
Статус	Отправлять ли уведомления	Включайте после проверки	Выключенный канал не получает сообщения
Отправлять в бот	Тип получателя	Включайте по задаче	Зависит от логики проекта
Шаблон сообщения	Текст уведомления	Пишите коротко, без секретов	Можно использовать доступные переменные

Как настроить

1. Создайте Telegram-бота и добавьте его в нужный чат или канал.
2. В админке откройте Telegram-уведомления.
3. Создайте запись с понятным названием.
4. Вставьте токен в поле токена.
5. Сохраните запись.
6. Запустите диагностику канала.
7. Если админка нашла чат, привяжите его к записи.
8. Включите статус.
9. Проверьте тестовое событие или шаблон уведомления.

Типовые ошибки

Ошибка / ситуация	Причина	Что сделать
Уведомления не приходят	Бот не добавлен в чат или канал выключен	Добавить бота, включить статус и проверить диагностику
Неверный канал	Привязан другой ID чата	Повторить привязку
Ошибка Telegram 401	Неверный токен бота	Проверить токен в админке
Шаблон показывает пустые данные	Использована переменная, которой нет в событии	Проверить доступные переменные шаблона
Клиенты получают лишние сообщения	Неверно выбран шаблон или аудитория	Проверить группу получателей

Важные предупреждения

Не добавляйте токен бота, ID чата приватных каналов, реальные тексты с данными клиентов и приватные ссылки в документацию.

Перед массовым включением уведомлений проверьте, кто их получает: администратор, оператор или клиент.

Связанные разделы

Email-уведомления, Заявки, Верификация KYC, Логи, Настройки, Безопасность.