> 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/learn/7.-telegram/08-telegram-bot.md).

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

Создайте отдельных Telegram-ботов через BotFather и зарегистрируйте правильное назначение в iEXExchanger

## Что вы получите

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

## Почему лучше три бота

| Бот          | Назначение в iEXExchanger | Тип сообщений                                 |
| ------------ | ------------------------- | --------------------------------------------- |
| Уведления    | **«Уведомления»**         | Выбранные события заявок и сервиса            |
| Безопасность | **«Security-коды»**       | Одноразовые коды входа и подтверждения        |
| Заявки       | **«Продолжение обмена»**  | Реквизиты, статусы и двусторонний чат клиента |

Раздельные токены уменьшают последствия утечки и не создают конфликт между `getUpdates` и webhook. Один бот может технически выполнять ограниченный сценарий, но объединять назначения для рабочего сайта не рекомендуется.

{% hint style="warning" %}
Назначение Telegram-подключения, а для обычных уведомлений ещё и место доставки, выбираются при создании и затем не меняются. При ошибке создайте новое подключение.
{% endhint %}

## Создайте бота

{% stepper %}
{% step %}

### Найдите официальный BotFather

Откройте в Telegram аккаунт [@BotFather](https://t.me/BotFather) с подтверждённым именем пользователя. Не передавайте токен стороннему «помощнику».
{% endstep %}

{% step %}

### Запустите создание

Отправьте команду `/newbot`.
{% endstep %}

{% step %}

### Задайте публичное имя

Введите понятное имя, которое увидит пользователь: например, название сервиса и назначение.
{% endstep %}

{% step %}

### Задайте username

Выберите уникальное латинское имя, оканчивающееся на `bot`, без домена и пароля. Например, шаблон `yourservice_notify_bot`.
{% endstep %}

{% step %}

### Сохраните токен

BotFather выдаст токен доступа. Скопируйте его непосредственно в менеджер секретов. Не вставляйте значение в документацию, чат или снимок экрана.
{% endstep %}

{% step %}

### Оформите профиль

Через меню BotFather добавьте описание, краткий текст и логотип без обещаний, которых бот не выполняет. Пользователь должен отличать бота заявок от бота безопасности.
{% endstep %}
{% endstepper %}

Полная последовательность описана в [официальном руководстве Telegram](https://core.telegram.org/bots/tutorial).

## Настройте безопасность бота

* владельцем BotFather должен быть контролируемый аккаунт компании;
* включите двухэтапную защиту Telegram владельца;
* выдавайте доступ к токену только ответственным администраторам;
* не пересылайте токен самому боту или в группу;
* храните назначение, username, дату создания и ответственного без самого токена;
* при утечке отзовите токен через BotFather, сохраните новый в iEXExchanger и повторите проверки.

{% hint style="danger" %}
Токен даёт управление ботом. Считайте его паролем производственной интеграции.
{% endhint %}

## Поймите ограничения Telegram

{% tabs %}
{% tab title="Личный чат" %}
Бот не может первым начать разговор с произвольным пользователем. Пользователь должен открыть бота и нажать **Start** или отправить `/start`.
{% endtab %}

{% tab title="Группа" %}
Privacy Mode включён по умолчанию. Бот видит команды, ответы ему и служебные события, но не обязан получать каждое обычное сообщение.
{% endtab %}

{% tab title="Канал" %}
Для публикации бот добавляется администратором с минимальным правом отправлять сообщения.
{% endtab %}

{% tab title="Webhook" %}
Webhook и `getUpdates` взаимно исключаются. Бот продолжения обмена в production использует webhook, поэтому его не следует одновременно искать через polling обычного подключения.
{% endtab %}
{% endtabs %}

См. [возможности ботов](https://core.telegram.org/bots/features), [Bot API](https://core.telegram.org/bots/api) и [webhook-руководство](https://core.telegram.org/bots/webhooks).

{% hint style="info" %}
Не отключайте Privacy Mode без причины. Для обнаружения группы сначала отправьте команду боту, например `/start@username_бота`. Если режим всё же изменён в BotFather, Telegram может потребовать удалить и заново добавить бота в группу.
{% endhint %}

## Создайте запись в iEXExchanger

1. Откройте **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**.
2. Нажмите **«Добавить»**.
3. Выберите тип **Telegram**.
4. Укажите назначение: **«Уведомления»**, **«Security-коды»** или **«Продолжение обмена»**.
5. Для **«Уведомления»** выберите **«В канал»**, **«В группу»** или **«В бота»**.
6. Задайте уникальное внутреннее название и нажмите **«Создать»**.
7. Откройте созданную запись, вставьте токен и продолжите инструкцию выбранного назначения.

## Проверьте токен

Для обычного подключения действие **«Проверить»** обращается к Telegram, определяет бота и, если чат уже привязан, проверяет его тип. Для Security и продолжения обмена используются дополнительные защищённые проверки.

Успех `getMe` подтверждает токен, но не право публикации, привязку клиента, событие и доставку сообщения.

## Этап завершён, если

* [ ] бот создан через официальный BotFather;
* [ ] username уникален и заканчивается на `bot`;
* [ ] профиль ясно описывает назначение;
* [ ] токен хранится как секрет;
* [ ] для разных задач запланированы отдельные боты;
* [ ] назначение и место доставки выбраны без ошибки;
* [ ] понятны ограничения личного чата, группы и webhook;
* [ ] проверка подключения дополнена проверкой реального события.

Теперь подключите [канал, группу или личный чат](https://docs.iexexchanger.com/learn/7.-telegram/09-telegram-destinations.md).
