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», ответственный.
- Результат: обращение получает карточку по правилам портала, источник фиксируется для отчётов.
Событие CRM → уведомление в Telegram
Заголовок раздела «Событие CRM → уведомление в 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. Штатный
канал служит для переписки, а не для рассылок.
Что будет при отзыве токена? Канал перестанет принимать и отправлять сообщения до подключения бота с новым токеном.
Решения
Заголовок раздела «Решения»- Wazzup: Telegram и другие каналы в открытых линиях Битрикс24 — Сервис-коннектор, который подключает Telegram и другие мессенджеры к открытым линиям Битрикс24 и сохраняет переписку в карточке клиента.
- Albato: сценарии между Битрикс24 и Telegram — Конструктор интеграций, который связывает события Битрикс24 с сообщениями Telegram без кода: триггеры, действия и обмен данными по сценарию.