Вы можете подключить чат-бот напрямую к Telegram, без использования дополнительных чат-платформ.
Таким образом будет возможно запустить чат-бот в Telegram и избежать дополнительных затрат на интеграцию с другими платформами.
При подключении чат-бота в канал Telegram доступна следующая функциональность:
прием входящих текстовых сообщений и отправленных файлов – изображений и документов;
отправка исходящих текстовых сообщений в т.ч. – с поддержкой разметки markdown, изображений, документов и inline кнопок – реплик;
сохранение логов диалогов бота с пользователями в разделах Диалоги в Graph и Диалоги и Клиенты в Code, при этом все персональные данные в логах обезличены.
Обратите внимание:
Чат-бот подключается к Telegram напрямую, поэтому возможность подключения оператора и отправки ему данных в таком режиме будет недоступна. При попадании в блок Перевод на оператора и Отправить данные оператору будет выполнен переход Ошибка.
Чат-бот поддерживает только стандартные текстовые запросы и файлы от пользователя. Прочие события, например, реакции пользователя, голосования и т.д., приходящие в чат-бота будут игнорироваться.
Чат-бот, добавленный в групповые чаты, будет отвечать на запрос пользователю прямо в группе. При этом общая сессия сохраняется, например, если следующий пользователь напишет сообщение чат-боту, он продолжит уже начатый другим пользователем диалог.
Если в групповом чате добавлено несколько чат-ботов и обращение к чат-боту отправляется без уточнения имени, например, /привет, то это сообщение получит последний чат-бот, к которому обращались.
Для нескольких чат-ботов в одном чате рекомендуется делать прямое обращение к боту в чате в формате
/command@this_bot
.
Уникальные пользователи из канала Telegram учитываются в лимитах тарифа SaluteBot.
Регистрация чат-бота в Telegram
Перед подключением чат-бота в канал получите токен при регистрации в Telegram.
Для этого:
Откройте Telegram.
Перейдите в раздел поиска контактов.
Наберите в поисковой строке
botfather
. Это бот, который поможет быстро зарегистрировать нового бота в Telegram и получить необходимый для работы токен.Нажмите Старт для запуска бота.
Следуйте подсказкам бота для регистрации или редактирования вашего чат-бота.
Например, для создания чат-бота в Telegram боту botfather следует отправить команду /newbot
.
В результате botfather сообщит вам токен авторизации. Скопируйте его в буфер обмена.
Подключение чат-бота в Telegram
Для подключения проекта SaluteBot со сценарием на Graph или Code к Telegram:
Откройте проект SaluteBot.
Перейдите к разделу Чат-платформа для подключения интеграции.
Выберите интеграцию Telegram и нажмите Далее.
Укажите ранее полученный токен, который будет использоваться для авторизации вызовов.
Платформа проверит корректность токена, и в случае, если токен не пройдет валидацию, например, если он не существует в Telegram или уже используется в другом боте - вы получите сообщение об ошибке. Пожалуйста, проверьте корректность введенного токена и убедитесь, что он не используется в других проектах SaluteBot.
- Нажмите Добавить для добавления интеграции или Отмена для закрытия окна без сохранения.
После добавления интеграции не забудьте собрать ваш подключенный сценарий. Теперь ваш чат-бот будет работать в Telegram.
В результате в случае добавления корректного токена будет представлена ссылка и логин чат-бота в Telegram. При переходе по ссылке будет открыт диалог с вашим чат-ботом.
Особенности работы чат-ботов в групповых чатах
По умолчанию все боты, добавляемые в групповые чаты, имеют включенную опцию Privacy Mode
и видят только общие команды и команды, явно предназначенные для них.
Часто требуется создать телеграм-бота, работающего как персональный чат с ботом. При этом бот должен получить доступ ко всем сообщениям, отправленным в чат.
Для настройки корректной работы нескольких чат-ботов, подключенных в групповой чат, выполните одно из действий:
- выключите
Privacy Mode
или - предварительно добавьте чат-бот в администраторы группового чата или
- используйте опцию
force reply option for the bot's messages
.
Более подробную информацию об особенностях работы Telegram можно найти в документации к мессенджеру.