Перейти к содержимому

Telegram Bot API

Telegram Bot API в каталоге — интерфейс ботов: бот принимает сообщения клиента и отправляет ответы. Каналом для CRM он становится через открытую линию Битрикс24 или через вашу собственную интеграцию.

Бот отвечает за диалог в Telegram: клиент пишет в личный чат, бот передаёт сообщение в систему и возвращает ответ. CRM хранит клиента и историю; встроенный канал и собственный бот — разные способы этой связки.

Способ Что даёт Когда уместен Ограничения
Канал Telegram в контакт-центре Битрикс24 Личные сообщения боту попадают в открытую линию Основной сценарий переписки и заявок Бот работает только в личных чатах; нужен токен из BotFather
Bot API: sendMessage Программируемые уведомления из CRM и сервисов Оповещения о сделках, заказах, оплатах Нужен собственный бот и знание chat_id получателя
Bot API: webhook или getUpdates Получение новых сообщений на свой сервер Своя логика обработки Webhook требует HTTPS; long polling занимает соединение
Ссылка и QR на бота Быстрый вход клиента в диалог Поддержка и приглашение в чат Не заменяет оператора и обработку очереди

Bot API принимает HTTPS-запросы к api.telegram.org с токеном бота и возвращает JSON. Обновления приходят двумя способами: webhook (сервер Telegram вызывает ваш endpoint) или long polling через getUpdates; одновременно использовать оба для одного бота нельзя.

  • Один бот — один портал. Если один бот подключён к нескольким Битрикс24, он работает только в последнем подключённом.
  • Только личные чаты. Сообщения из групповых чатов в Битрикс24 не приходят; добавление бота в группы лучше сразу отключить в BotFather.
  • Лимит создания. Из одного аккаунта Telegram можно создать не более 20 ботов.
  • Токен. Токен выдаёт @BotFather; /revoke выпускает новый и отзывает старый, после чего прежние подключения перестают работать.
  • Формат и длина. У сообщений Telegram есть ограничение длины, а разметка задаётся отдельным параметром; длинные тексты делятся на части.
  • Инициатива. Бот может написать первым только тому, кто уже начал с ним диалог: идентификатор чата появляется после первого сообщения клиента.