> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/ai-base/integracii-i-uvedomleniya/telegram-bot.md).

# 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, Логи, Настройки, Безопасность.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iexexchanger.com/help-center/ai-base/integracii-i-uvedomleniya/telegram-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.