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

Создание Telegram-бота и привязка личного чата, группы или канала

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

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

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

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

Токен даёт полный контроль над ботом и должен храниться как пароль. Если он раскрыт, выпустите новый токен через BotFather, замените его в iEXExchanger, проверьте подключение и убедитесь, что прежнее значение больше не работает. Официальные команды и ограничения приведены в справке Telegram BotFather.

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

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

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

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

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

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

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

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

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

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

Группа Telegram

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

Не отключайте режим приватности без необходимости. По умолчанию он ограничивает сообщения, которые бот получает в группе. Если для обнаружения пришлось изменить этот режим через BotFather, после привязки верните минимально необходимую настройку и повторите тест. Telegram подробно объясняет режим приватности.

Канал Telegram

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

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

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

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

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

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

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