Разработка 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. Свяжитесь с нами для обсуждения деталей. Закажите консультацию — оценим проект за один день. Получите консультацию и начните автоматизацию уже сегодня.