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

Telegram и Битрикс24: бот как канал обращений

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

  • Задача: принимать обращения из Telegram в CRM и отправлять клиентам и сотрудникам уведомления.
  • Что проверено: получение токена у @BotFather, подключение бота к открытой линии, ограничение «один бот — один портал», поведение в группах, лимит создания ботов, отключение канала.
  • Уровень: documented.
  • Что не проверено: состав полей карточки клиента и поведение конкретных роботов на вашем портале.

Интеграция нужна, когда клиенты переписываются с компанией в Telegram, а сделки и заявки ведутся в Битрикс24. Тогда переписка получает ответственного и историю, а уведомления о событиях CRM приходят в мессенджер.

Обратные случаи:

  • Клиенты пишут в MAX или ВКонтакте — используйте соответствующие каналы: Битрикс24 и MAX, Битрикс24 и ВКонтакте.
  • Нужен только внутренний чат сотрудников — это мессенджер Битрикс24, а не канал Telegram.
  • Нужны массовые рассылки по базе Telegram — это отдельный сценарий с правилами платформы и согласиями получателей, а не обработка входящих обращений.
  • Событие: клиент пишет в личный чат с Telegram-ботом.
  • Направление: Telegram → Битрикс24.
  • Сущности: сообщение, бот, диалог, открытая линия, оператор.
  • Результат: сообщение попадает в открытую линию, оператор отвечает из Битрикс24, история диалога сохраняется в CRM.
  • Событие: боту пишет пользователь, которого ещё нет в CRM.
  • Направление: Telegram → Битрикс24.
  • Сущности: контакт, лид или сделка, источник «Telegram», ответственный.
  • Результат: обращение получает карточку по правилам портала, источник фиксируется для отчётов.
  • Событие: новая сделка, оплата, просроченная задача или смена стадии.
  • Направление: Битрикс24 → Telegram.
  • Сущности: сообщение, chat_id, событие CRM, получатель.
  • Результат: сотрудник или клиент получает уведомление через sendMessage; это своя интеграция на Bot API, а не штатный канал.
  • Событие: оператор отправляет клиенту ссылку или QR-код на бота.
  • Направление: Битрикс24 → клиент.
  • Сущности: ссылка на бота, клиент, диалог.
  • Результат: клиент открывает чат и начинает диалог, после чего бот может отвечать ему без дополнительных приглашений.
Событие в Telegram Действие в Битрикс24 Примечание
Личное сообщение боту Диалог в открытой линии Бот работает только в личных чатах
Новый пользователь Создание контакта или заявки По правилам открытой линии и роботов
Сообщение в группе Ничего Сообщения групп в CRM не приходят
Отзыв токена Канал перестаёт работать Нужно подключить бота заново
Событие в Битрикс24 Действие в Telegram Примечание
Ответ оператора Сообщение клиенту через бота Штатный канал
Смена стадии или оплата Уведомление через свой бот Нужен chat_id получателя
Закрытие диалога Завершение переписки Клиент может написать снова
  • Штатный канал Telegram — бот создаётся в @BotFather, токен вставляется в настройках канала, бот привязывается к открытой линии. Кода нет, набор возможностей ограничен контакт-центром.
  • Приложение из Маркетплейса — добавляет сценарии и отчёты, но приносит вендора, подписку и его ограничения; проверяются права и совместимость.
  • iPaaS — связывает события Telegram и CRM без серверного кода; подходит для уведомлений, но логика остаётся вне репозитория.
  • Custom-интеграция на Bot API — свой сервис принимает webhook или getUpdates, ведёт журнал, вызывает методы Битрикс24 и наоборот. Даёт контроль над повторами и идемпотентностью.

Граница простая: переписка в CRM — штатный канал; собственные уведомления и сложные правила — Bot API.

Данные в Telegram Куда попадают в Битрикс24 Ключ соответствия Примечание
chat_id Диалог и получатель уведомлений Идентификатор чата Появляется после первого сообщения
Имя и username Контакт клиента Внешний идентификатор Могут быть скрыты настройками
Текст сообщения Сообщение диалога Время и автор Разметка и вложения — отдельно
Бот Канал обращения Токен Один бот — один портал
Ссылка на бота Источник обращения — Используется в приглашениях

Владелец данных: Telegram владеет профилем и доставкой сообщений; Битрикс24 — карточкой клиента, сделкой и историей работы. Бот не заменяет CRM-карточку и не хранит воронку.

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

Можно ли использовать один бот в двух Битрикс24? Технически подключить можно, но работать он будет только в последнем портале. Для второго портала нужен отдельный бот.

Попадут ли сообщения из групп? Нет, поэтому добавление бота в группы отключают — иначе сообщения теряются без следа в CRM.

Как отправить уведомление клиенту? Через собственный бот и sendMessage, если клиент уже начал диалог и известен его chat_id. Штатный канал служит для переписки, а не для рассылок.

Что будет при отзыве токена? Канал перестанет принимать и отправлять сообщения до подключения бота с новым токеном.