> 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/telegram-bots-and-destinations.md).

# Telegram-боты, группы и каналы

Один бот может технически работать в нескольких чатах, но для iEXExchanger безопаснее разделять назначения: обычные уведомления, Security-коды и продолжение обмена. Это упрощает права, отзыв токена и расследование доставки.

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

## Создание бота через BotFather

1. В Telegram откройте официальный аккаунт [@BotFather](https://t.me/BotFather).
2. Отправьте `/newbot`.
3. Укажите отображаемое имя.
4. Укажите уникальный username длиной от 5 до 32 символов из латинских букв, цифр и подчёркивания; обычный username заканчивается на `bot`.
5. Скопируйте выданный токен в защищённое хранилище.

Токен даёт полный контроль над ботом и должен храниться как пароль. Если он раскрыт, выпустите новый токен через BotFather, замените его в iEXExchanger, проверьте подключение и убедитесь, что прежнее значение больше не работает. Официальные команды и ограничения приведены в [справке Telegram BotFather](https://core.telegram.org/bots/features#botfather).

Через `/mybots` можно задать имя, описание, краткую информацию, изображение и список команд. Для клиентского бота заполните понятное описание назначения и не обещайте в нём действия, которых нет в текущем сценарии.

## Создание подключения

Откройте **«Настройки» — «Уведомления» — «Подключения»**, нажмите «Добавить» и выберите Telegram.

Выберите назначение:

* «Уведомления» — обычные клиентские и административные события;
* «Security-коды» — только защищённые коды и подтверждения;
* «Продолжение обмена» — личные диалоги клиентов по заявкам.

Для «Уведомлений» дополнительно выберите «В канал», «В группу» или «В бота». Назначение и место отправки после создания не меняются. После создания откройте подключение, внесите токен и оставьте его выключенным до привязки и проверки.

## Личный чат с ботом

Личный чат подходит для поддерживаемых клиентских или административных событий.

1. Откройте бота под аккаунтом получателя.
2. Нажмите Start или отправьте `/start`.
3. В iEXExchanger нажмите «Найти чат».
4. Выберите найденный чат и подтвердите подключение.
5. Выполните проверку и отправьте одно безопасное событие.

Бот не может первым начать личный диалог с пользователем. Каждый получатель должен сначала открыть его сам.

## Группа Telegram

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

Не отключайте режим приватности без необходимости. По умолчанию он ограничивает сообщения, которые бот получает в группе. Если для обнаружения пришлось изменить этот режим через BotFather, после привязки верните минимально необходимую настройку и повторите тест. [Telegram подробно объясняет режим приватности](https://core.telegram.org/bots/features#privacy-mode).

## Канал Telegram

1. Создайте канал или выберите существующий рабочий канал.
2. Добавьте бота администратором.
3. Разрешите ему публиковать сообщения; остальные административные возможности не выдавайте без необходимости.
4. Опубликуйте новое сообщение уже после добавления бота.
5. В iEXExchanger нажмите «Найти канал».
6. Выберите найденный канал и подтвердите подключение.
7. Отправьте тестовое административное уведомление.

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

## Если место отправки не находится

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

Если у токена уже включён webhook, поиск через получение последних обновлений может ничего не вернуть. Не отключайте действующий webhook рабочего бота вслепую: используйте отдельного бота нужного назначения либо согласованно смените способ получения сообщений.

## Итоговая проверка

1. Состояние подключения — «Стабильно».
2. Привязаны правильные название и ID чата.
3. Включены только нужные события и аудитория.
4. Тест приходит один раз и в нужное место.
5. Бот не имеет лишних прав в группе или канале.
6. Токен отсутствует в переписке, документах и снимках экрана.


---

# 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/telegram-bots-and-destinations.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.