Разработка Telegram-бота с интеграцией Битрикс24

Когда клиент пишет в Telegram, а оператор занят — время ответа растёт

Расскажу на примере: клиент хочет узнать статус заказа, но оператор уже говорит с другим. Пока переключается, клиент ждёт минуты. А если это повторяется десятки раз в день — теряются и время, и нервы. Мы автоматизируем такие сценарии с помощью Telegram-бота, интегрированного с Битрикс24 через REST API. Бот обрабатывает типовые запросы за секунды: проверяет статус, записывает на услугу, отправляет уведомления. Оператор занимается только сложными вопросами.

Такой подход снижает нагрузку на колл-центр и ускоряет обслуживание без дополнительных сотрудников. Интеграция через REST API позволяет боту напрямую работать с CRM, задачами и календарём — без посредников.

Как Telegram-бот интегрируется с Битрикс24?

Есть два подхода. Первый — через открытые линии Битрикс24: бот подключается в разделе «Контакт-центр → Открытые линии → Подключить каналы → Telegram». Сообщения попадают в очередь операторов. Простая настройка, но бот — ретранслятор. Второй — самостоятельный бот на отдельном сервере: он получает сообщения через Telegram Bot API (webhook), сам обрабатывает сценарии и вызывает REST API Битрикс24. Полный контроль над логикой.

Почему самостоятельный бот надёжнее открытых линий?

Открытые линии не дают гибкости, когда нужна автоматизация (создание лидов, проверка статусов, запись на услуги). Самостоятельный бот открывает доступ к CRM, задачам и календарю через REST API. Мы используем Python + aiogram 3, Redis для состояний, PostgreSQL для логов. Вебхуки защищены секретным токеном.

Согласно документации Telegram Bot API, вебхуки — предпочтительный способ получения обновлений в реальном времени.

Архитектура самостоятельного бота

Клиент в Telegram
      ↓
Telegram Bot API (webhook)
      ↓
Сервер бота (Python aiogram / Node.js telegraf)
      ↓ ↓ ↓
  Логика    Битрикс24 REST API    Внешние сервисы
  бота      (crm.*, im.*, tasks.*)   (1С, склад, etc.)

Сервер получает update от Telegram, определяет intent пользователя (FSM или NLP), выполняет нужные действия в Битрикс24, возвращает ответ в Telegram.

Ключевые интеграционные точки с Битрикс24

Идентификация клиента

При первом обращении бот запрашивает телефон через KeyboardButton(request_contact=True). Полученный номер используется для поиска контакта в CRM: crm.contact.list с фильтром PHONE. Если найден — привязывает telegram_id к UF_CRM_TELEGRAM_ID. Если нет — создаёт новый контакт.

Создание лидов и сделок

Каждое новое обращение создаёт лид: crm.lead.add с SOURCE_ID = 'MESSENGER' и UTM_SOURCE = 'telegram'. Все сообщения пишутся в комментарий лида через crm.timeline.comment.add.

Статус заказа

Бот принимает номер заказа → делает запрос crm.deal.list по UF_ORDER_NUMBER → возвращает стадию и ожидаемую дату. Клиент получает ответ за 2-3 секунды без оператора.

Запись на услугу

Бот показывает доступные слоты из модуля Расписание Битрикс24 через calendar.accessibility.get → клиент выбирает время → создаётся встреча calendar.event.add с привязкой к контакту.

Передача сложных запросов оператору

Если бот не может обработать запрос, переводит на оператора. Правильная реализация:

1. Бот сохраняет историю диалога (последние N сообщений) в Redis.
2. Создаёт обращение в открытой линии через imopenlines.crm.chat.getLink или прямым созданием чата через im.chat.add.
3. Отправляет историю первым сообщением, чтобы оператор видел контекст.
4. Клиент продолжает переписку в Telegram, оператор отвечает из Битрикс24.

Кейс из практики: бот для сети автосервисов

Из нашей практики: сеть из 12 автосервисов, клиенты хотят записываться на ТО через Telegram, проверять готовность автомобиля, получать чек.

Сценарии бота:

• Запись на ТО → выбор точки (инлайн-кнопки) → выбор услуги → выбор даты/времени из расписания Битрикс24 → подтверждение → SMS-напоминание за день.
• Статус ремонта → ввод номера авто → запрос к crm.deal.list по UF_CAR_NUMBER → текущий этап из стадии сделки.
• Готов авто → автоматическое уведомление при смене стадии на «Готов к выдаче» (триггер через crm.deal.onUpdate → вебхук на сервер бота → bot.send_message).

Технический стек: Python + aiogram 3 + Redis (FSM) + PostgreSQL (логирование) + Bitrix24 REST.

Проблема: Telegram ограничивает частоту отправки — не более 30 сообщений в секунду в разные чаты. При массовой рассылке уведомлений нужна очередь с задержками. Решили через Redis-очередь с троттлингом.

Результат: Время записи клиента сократилось с 5 минут до 30 секунд, нагрузка на колл-центр снизилась на 70%. Экономия на операторах превышает значительную сумму в год для сети из 12 точек.

Что входит в работу

• Архитектура и проектирование сценариев (FSM, интеграционные точки).
• Разработка серверной части (Python/Node.js) с использованием Telegram Bot API и REST API Битрикс24.
• Настройка вебхуков, деплой (Docker, Nginx, SSL).
• Тестирование всех сценариев: идентификация, запись, статус, передача оператору.
• Мониторинг и логирование ошибок (Sentinel, Prometheus).
• Документация по эксплуатации и обучение команды.

Сроки ориентировочно

Опыт нашей команды подтверждается десятками успешных проектов. Мы гарантируем стабильную работу бота 24/7. Свяжитесь с нами для обсуждения деталей. Закажите консультацию — оценим проект за один день. Получите консультацию и начните автоматизацию уже сегодня.

Открытые линии: где всё начинается и ломается

Модуль «Открытые линии» (imopenlines) — штатный механизм Битрикс24 для омниканальных коммуникаций. Он связывает внешний канал с внутренним чатом через сущность Im\Model\ChatTable. Проблема в том, что из коробки настройки маршрутизации примитивные: «по очереди» или «всем сразу». Для реального отдела продаж с 15+ менеджерами, VIP-клиентами и SLA по времени ответа этого недостаточно. Мы дорабатываем маршрутизацию через обработчики событий OnImOpenLinesChatStart и REST API.

Менеджер переключается между пятью окнами, теряет сообщения, забывает ответить — клиент уходит к конкуренту, который ответил за 30 секунд. Настройка мессенджеров Битрикс24 собирает все каналы в один интерфейс, а CRM фиксирует каждое касание. Опыт показывает: после настройки среднее время первого ответа сокращается на 40% уже в первую неделю.

Как мы реализуем интеграцию мессенджеров

Подключаем Telegram, WhatsApp, Viber, VK, онлайн-чат, Email и другие каналы через штатные коннекторы или REST API. Каждый канал требует своей настройки, но результат единый — все сообщения попадают в открытые линии, а из них — в карточку клиента. Гарантируем, что ни одно обращение не потеряется: используем тегированное кэширование и агенты для проверки очередей.

Как подключить WhatsApp к Битрикс24?

WhatsApp — главный бизнес-канал. Интеграция через WhatsApp Business API с верифицированным аккаунтом. Настраиваем приём и отправку сообщений из интерфейса Б24 — они падают в открытую линию. Создаём HSM-шаблоны для инициации диалога (напоминание о брошенной корзине, статус заказа). Шаблоны проходят модерацию Meta — закладывайте 2-3 дня. Обеспечиваем передачу файлов, изображений, документов. Связываем переписку с контактом и сделкой через CRM_ENTITY_TYPE и CRM_ENTITY_ID.

Telegram: бесплатный канал с высоким охватом

Telegram Bot API бесплатный и хорошо документированный — приятная редкость среди мессенджеров. Интеграция в Битрикс24 выполняется через коннектор imopenlines. Настройка: подключаем бота к открытым линиям, настройка коннектора → Telegram. Приём сообщений, фото, видео, документов — всё маппится в чат Б24. Inline-кнопки и reply-клавиатуры для навигации. Webhook на https://yourdomain/rest/imconnector.register — регистрация коннектора. Интеграция с CRM: входящее сообщение создаёт лид через crm.lead.add или активность в сделке.

Telegram незаменим для:

• Поддержки через бота — типовые вопросы закрываются без оператора (до 70% обращений).
• Уведомлений: заказы, доставка, оплата — через Telegram Bot API sendMessage.
• Сбора лидов: бот задаёт квалифицирующие вопросы → создаёт лид.

Viber и VK: аудитория 35+ и соцсеть

Viber держит позиции в регионах. Подключаем бизнес-аккаунт через коннектор открытых линий. Используем Viber Business Messages — массовые рассылки с кнопками действий и rich-контентом. Приём и отправка из CRM работают сразу.

VK (ВКонтакте) — крупнейшая соцсеть в РФ. Интеграция через коннектор imopenlines сообщений сообщества. Обработка сообщений и комментариев из единого интерфейса. Автосоздание лида — обработчик OnImOpenLinesCrmCreate. Интеграция с VK Рекламой для трекинга источников через UTM. Бот для автоответов — VK Bot API + Callback API.

Почему важна правильная маршрутизация обращений?

Распределение обращений по операторам организовано через механизмы очередей. По умолчанию — «кто свободен». В реальности нужно сложнее:

• Определение ответственного по номеру или email из CRM — im.chat.get + поиск по crm.contact.list.
• Распределение по отделам на основе ключевых слов (NLP-классификатор или простой regex на первом сообщении).
• Приоритетная очередь для VIP — по сегменту в CRM.
• Эскалация при таймауте 5 минут — автопереключение на следующего.
• Переход на звонок прямо из чата — telephony.externalcall.register.

Используем кастомные обработчики событий OnImOpenLinesChatStart и REST API для реализации таких сценариев. Дополнительно подключаем Bizproc для сложных цепочек согласований и интеграцию с HL-блоками для хранения пользовательских параметров очередей. Результат: клиент не ждёт, оператор не перегружен.

Что входит в работу по интеграции мессенджеров

Чат-боты: сценарные и с NLP

Типы

Сценарные (rule-based): кнопочное меню, дерево решений. «Как оплатить» → «Где мой заказ» → «Часы работы». Передача на оператора при intent == 'unknown' → transfer_to_queue. Надёжно, предсказуемо, покрывает 60-70% типовых обращений.

С NLP: свободный текст на русском. Определение intent (купить, пожаловаться, узнать о доставке), извлечение сущностей (имя, дата, номер заказа). Контекстный диалог — помнит, о чём говорили. Реализуем на Rasa или Dialogflow, интеграция с Б24 через REST.

use Bitrix\Main\Loader;
use Bitrix\Imopenlines\Model\SessionTable;

Loader::includeModule('imopenlines');

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('imopenlines', 'OnImOpenLinesMessageReceive', function($event) {
    $message = $event->getParameter('message');
    $chatId = $event->getParameter('chatId');
    
    if (preg_match('/статус заказа (\d+)/i', $message, $matches)) {
        $orderId = $matches[1];
        // Получаем статус заказа через API
        $order = \Bitrix\Sale\Order::load($orderId);
        if ($order) {
            $status = $order->getField('STATUS_ID');
            \Bitrix\ImOpenLines\Chat::sendMessage($chatId, 'Ваш заказ №' . $orderId . ' в статусе: ' . $status);
        }
    }
});

Сценарии и реальный эффект

Сравнение: сценарный бот обрабатывает запросы в 5 раз быстрее оператора, а NLP-бот снижает fallback rate до 15% после обучения на реальных диалогах. Средняя экономия на зарплате операторов при внедрении чат-бота составляет значительную сумму — десятки тысяч рублей ежемесячно.

Процесс разработки

1. Анализ обращений — выгружаем историю из открытых линий, кластеризуем по темам. Определяем 80% типовых запросов.
2. Проектирование диалогов — карта на miro/figma. Каждая ветка заканчивается либо ответом, либо передачей оператору.
3. Разработка — логика, интеграция с CRM и внешними API. Для сценарных — конечный автомат на состояниях. Для NLP — pipeline: tokenizer → featurizer → classifier → response selector.
4. Обучение NLP — на реальных диалогах (не менее 500 примеров). Настройка threshold confidence.
5. Тестирование — прогон всех веток, edge cases (пустое сообщение, стикер, голосовое).
6. Оптимизация — мониторинг fallback rate, дообучение на новых диалогах каждые 2 недели.

Сроки

Результат — все обращения в едином окне, рутина автоматизирована, ни одно сообщение не теряется. Менеджеры продают, а не ищут нужный чат. Оцените, какие каналы нужны именно вам, — напишите, подберём под вашу нишу. Получите персональный расчёт срока и стоимости для вашего проекта.