> 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/knowledge-base/platezhi-uvedomleniya-i-integracii/notification-center/telegram.md).

# Telegram-подключения

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

Точка входа в панели: **«Настройки» — «Уведомления» — «Подключения»**. Для страницы требуется хотя бы одно из прав: «Настройки уведомлений», «Telegram-уведомления» или «Общие настройки». Для настройки бота Security-кодов дополнительно требуется право «Telegram-бот безопасности».

Права находятся по пути **«Пользователи» — «Список групп пользователей» — открыть группу**. Обычному сотруднику уведомлений выдавайте только минимальное право его обязанности.

## Создание бота

1. Создайте бота через официальный BotFather и получите токен. Полный порядок приведён в статье [«Telegram-боты, группы и каналы»](/knowledge-base/platezhi-uvedomleniya-i-integracii/notification-center/telegram/telegram-bots-and-destinations.md).
2. Откройте **«Настройки» — «Уведомления» — «Подключения»**.
3. Нажмите «Добавить» и выберите Telegram.
4. Выберите «Назначение».
5. Для обычных уведомлений выберите «Куда отправлять».
6. Задайте «Название» и нажмите «Создать».
7. Откройте подключение и заполните «Токен доступа Telegram-бота».

Токен после сохранения хранится в зашифрованном виде и полностью не отображается. «Параметр заполнен» и маскированная часть подтверждают наличие значения. Не используйте один токен в разных подключениях.

## Обычные уведомления

Назначение «Уведомления» поддерживает три места отправки:

* «В канал» — общие сообщения для сотрудников;
* «В группу» — сообщения рабочей группе сотрудников;
* «В бота» — личные сообщения клиентам и сотрудникам.

Для канала добавьте бота администратором и опубликуйте новое сообщение. Для группы добавьте бота и отправьте новое сообщение или команду самому боту. Для личного чата откройте бота и отправьте `/start`. Затем в настройке нажмите «Найти канал», «Найти группу» или «Найти чат», выберите найденное место и подтвердите подключение.

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

Если поиск не находит чат, повторите требуемое действие уже после добавления бота. Действующий webhook может мешать получению обновлений способом polling; не отключайте рабочий webhook без понимания назначения бота.

## Security-коды

Назначение «Security-коды» используется только для одноразовых кодов входа и подтверждения важных действий. После сохранения подтвердите владельца по предусмотренному процессу.

В карточке проверяйте имя бота, ID, владельца и время последней проверки токена. Изменение или отвязка защищаются шестизначным кодом, отправленным владельцу по E-mail. Такое подключение нельзя удалить обычным действием списка.

## Продолжение обмена

Назначение «Продолжение обмена» создаёт интерактивного личного бота. Клиент получает в нём платёжные реквизиты, а переписка синхронизируется с чатом заявки. Активным может быть только один такой бот.

Для рабочего сервера выберите «Защищённый webhook». Telegram должен обращаться к публичному HTTPS-адресу. Поле «Публичный URL webhook» можно оставить пустым для адреса сайта либо указать полный HTTPS-адрес, если используется отдельная точка входа.

«Локальное polling» предназначено для локальной проверки без публичного адреса. Оно требует постоянно работающего процесса, указанного самой формой, и не является обычным рабочим режимом сервера.

Кнопка продолжения обмена появляется у клиента только при одновременном выполнении условий:

* в настройке «Где продолжать обмен» выбран вариант «В мессенджерах»;
* чат заявок включён;
* текущий статус входит в список статусов, для которых показывается чат;
* подключение «Продолжение обмена» включено и успешно проверено;
* заявка не использует несовместимый сценарий оплаты.

Если бот недоступен или его проверка перестала быть успешной, система возвращает клиента к продолжению на сайте. Настройка режима описана в [«Настройках обмена»](/knowledge-base/nastroika-obmena-kursov-i-rezervov/calculator/order-settings.md), а работа переписки — в [«Центре чатов по заявкам»](/knowledge-base/zayavki-i-rabota-operatorov/order-chats.md).

## События и проверка

Для обычного подключения откройте действие «Уведомления», выберите события и приоритеты. Security-коды и продолжение обмена имеют собственный ограниченный сценарий и не получают произвольный набор обычных событий.

1. Нажмите «Проверить» и убедитесь, что состояние стало «Стабильно».
2. Для канала или группы вызовите безопасное административное событие.
3. Для личного бота проверьте `/start` и клиентское событие.
4. Для продолжения обмена создайте тестовую заявку и откройте Telegram с клиентского шага оплаты.
5. Ответьте из Telegram и убедитесь, что сообщение появилось в чате той же заявки.
6. Ответьте оператором и проверьте доставку клиенту без дубля.

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


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/knowledge-base/platezhi-uvedomleniya-i-integracii/notification-center/telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.