ym88659208ym87991671
Подключаем чат-бот к Telegram | Документация для разработчиков

Подключаем чат-бот к Telegram

Обновлено 24 сентября 2024

Вы можете подключить чат-бот напрямую к Telegram, без использования дополнительных чат-платформ.

Таким образом будет возможно запустить чат-бот в Telegram и избежать дополнительных затрат на интеграцию с другими платформами.

При подключении чат-бота в канал Telegram доступна следующая функциональность:

  • прием входящих текстовых сообщений и отправленных файлов – изображений и документов;

  • отправка исходящих текстовых сообщений в т.ч. – с поддержкой разметки markdown, изображений, документов и inline кнопок – реплик;

  • сохранение логов диалогов бота с пользователями в разделах Диалоги в Graph и Диалоги и Клиенты в Code, при этом все персональные данные в логах обезличены.

Обратите внимание:

  1. Чат-бот подключается к Telegram напрямую, поэтому возможность подключения оператора и отправки ему данных в таком режиме будет недоступна. При попадании в блок Перевод на оператора и Отправить данные оператору будет выполнен переход Ошибка.

  2. Чат-бот поддерживает только стандартные текстовые запросы и файлы от пользователя. Прочие события, например, реакции пользователя, голосования и т.д., приходящие в чат-бота будут игнорироваться.

  3. Чат-бот, добавленный в групповые чаты, будет отвечать на запрос пользователю прямо в группе. При этом общая сессия сохраняется, например, если следующий пользователь напишет сообщение чат-боту, он продолжит уже начатый другим пользователем диалог.

  4. Если в групповом чате добавлено несколько чат-ботов и обращение к чат-боту отправляется без уточнения имени, например, /привет, то это сообщение получит последний чат-бот, к которому обращались.

  5. Для нескольких чат-ботов в одном чате рекомендуется делать прямое обращение к боту в чате в формате /command@this_bot.

Уникальные пользователи из канала Telegram учитываются в лимитах тарифа SaluteBot.

Регистрация чат-бота в Telegram

Перед подключением чат-бота в канал получите токен при регистрации в Telegram.

Для этого:

  1. Откройте Telegram.

  2. Перейдите в раздел поиска контактов.

  3. Наберите в поисковой строке botfather. Это бот, который поможет быстро зарегистрировать нового бота в Telegram и получить необходимый для работы токен.

  4. Нажмите Старт для запуска бота.

  5. Следуйте подсказкам бота для регистрации или редактирования вашего чат-бота.

Например, для создания чат-бота в Telegram боту botfather следует отправить команду /newbot.

В результате botfather сообщит вам токен авторизации. Скопируйте его в буфер обмена.

Подключение чат-бота в Telegram

Для подключения проекта SaluteBot со сценарием на Graph или Code к Telegram:

  1. Откройте проект SaluteBot.

  2. Перейдите к разделу Чат-платформа для подключения интеграции.

  3. Выберите интеграцию Telegram и нажмите Далее.

  4. Укажите ранее полученный токен, который будет использоваться для авторизации вызовов.

Платформа проверит корректность токена, и в случае, если токен не пройдет валидацию, например, если он не существует в Telegram или уже используется в другом боте - вы получите сообщение об ошибке. Пожалуйста, проверьте корректность введенного токена и убедитесь, что он не используется в других проектах SaluteBot.

  1. Нажмите Добавить для добавления интеграции или Отмена для закрытия окна без сохранения.

После добавления интеграции не забудьте собрать ваш подключенный сценарий. Теперь ваш чат-бот будет работать в Telegram.

В результате в случае добавления корректного токена будет представлена ссылка и логин чат-бота в Telegram. При переходе по ссылке будет открыт диалог с вашим чат-ботом.

Особенности работы чат-ботов в групповых чатах

По умолчанию все боты, добавляемые в групповые чаты, имеют включенную опцию Privacy Mode и видят только общие команды и команды, явно предназначенные для них.

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

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

  • выключите Privacy Mode или
  • предварительно добавьте чат-бот в администраторы группового чата или
  • используйте опцию force reply option for the bot's messages.

Более подробную информацию об особенностях работы Telegram можно найти в документации к мессенджеру.

ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.