Разработка WhatsApp-бота с интеграцией Битрикс24 под ключ

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

Интернет-магазин обрабатывает 300 заказов в день. Каждый второй клиент пишет в поддержку с запросом статуса заказа. Операторы перегружены, ответы задерживаются. Штатный WhatsApp не подходит — нужен автоматизированный бот, интегрированный с CRM. Без интеграции каждое входящее сообщение — ручной поиск заказа, переключение между окнами, потеря времени. Битрикс24 позволяет автоматически создавать лиды, сделки, активности из чата. Но чтобы это работало, нужно правильно подключить API, настроить вебхуки и обработать ограничения Meta. WhatsApp Business API — единственный легальный способ, и мы расскажем, как его подключить к Битрикс24. Разберём два основных подхода: через официального BSP-провайдера (Wazzup, 360dialog) и неофициальный Green API, а также покажем архитектуру бота на конкретном кейсе.

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

Meta не раздаёт доступ к WhatsApp Business API напрямую — работают через Business Solution Providers (BSP): 360dialog, Twilio, MessageBird, WABA.cloud. Провайдер регистрирует ваш номер в WhatsApp Business, выдаёт API-ключи. Официальный путь гарантирует стабильность, соответствие политике Meta и возможность использовать шаблоны сообщений. Без него номер блокируют после отправки нескольких десятков исходящих. Первое сообщение клиенту (не ответ на входящее) должно проходить через утверждённый шаблон — модерация занимает 24–72 часа. Произвольный текст разрешён только в ответ на входящее сообщение в течение 24 часов.

Что такое BSP-провайдер и зачем он нужен?

Популярные варианты для российского рынка:

• Green API — российский провайдер, быстрая регистрация, есть готовый модуль для Битрикс24. Технически использует веб-клиент WhatsApp, что неофициально, но для среднего бизнеса это рабочий вариант.
• Wazzup — нативная интеграция с Битрикс24, официальное приложение в маркетплейсе. Проще в настройке, но ограничивает кастомную логику.
• Chat2Desk — омниканальный сервис с поддержкой WhatsApp и Битрикс24.

Архитектура бота через Green API + Битрикс24

Клиент в WhatsApp
      ↓
Green API (webhook instanceId + apiTokenInstance)
      ↓
Сервер бота
      ↓ ↓
  Логика     Битрикс24 REST API
  бота       (crm.lead.add, crm.contact.list, etc.)

Получение входящих сообщений:

GET https://api.green-api.com/waInstance{instanceId}/receiveNotification/{apiTokenInstance}

Ответ в WhatsApp:

POST https://api.green-api.com/waInstance{instanceId}/sendMessage/{apiTokenInstance}
{
  "chatId": "[email protected]",
  "message": "Привет! Чем могу помочь?"
}

Интеграция с Битрикс24 аналогична Telegram-боту: поиск контакта по номеру телефона, создание лида, запись активностей в таймлайн.

Сравнение провайдеров

Green API проще в настройке для кастомного бота, чем Wazzup, примерно в два раза быстрее, если нужна нестандартная логика.

Ключевые отличия от Telegram

WhatsApp поддерживает ограниченный набор форматирования: курсив, жирный, зачёркнутый, моноширинный?

Никаких HTML-тегов, кнопок-Reply (только через официальный API Templates). В неофициальных API (Green API) кнопки недоступны — только текстовое меню: «Напишите 1 — статус заказа, 2 — связь с оператором». Через официальный API доступны Interactive Messages с кнопками, но только в рамках утверждённых шаблонов.

Медиа передаётся хорошо: изображения, документы, голосовые. Бот может принимать фото (например, для заявки на возврат) и сохранять на Диск Битрикс24 через disk.folder.uploadfile.

Интеграция через готовый модуль Wazzup

Если нет задачи реализовывать сложную логику бота — проще использовать Wazzup с готовой интеграцией:

1. Регистрация в Wazzup, подключение номера WhatsApp.
2. Установка приложения Wazzup из маркетплейса Битрикс24.
3. Настройка маппинга: входящие сообщения WhatsApp → открытая линия → лид/сделка в CRM.
4. Операторы отвечают из Битрикс24, клиент получает ответ в WhatsApp.

Ограничение: нет кастомной логики бота — только маршрутизация к операторам.

Кейс: бот для уведомлений о статусе доставки

Наш клиент — интернет-магазин электроники с 200–400 заказами в день. Клиенты заваливали поддержку вопросами «где мой заказ». Мы разработали автоматический бот на Green API.

Решение: при смене статуса заказа в CRM (стадия сделки) → вебхук → сервер бота → отправка уведомления в WhatsApp.

def on_deal_stage_change(deal_id, new_stage):
    deal = bitrix.get_deal(deal_id)
    phone = deal['CONTACT_PHONE']
    whatsapp_id = f"{phone.replace('+', '')}@c.us"

    messages = {
        'ACCEPTED': 'Заказ принят в обработку. Номер заказа: {order_num}',
        'SHIPPED': 'Заказ отправлен. Трек-номер: {track}',
        'DELIVERED': 'Заказ доставлен. Спасибо за покупку!'
    }

    if new_stage in messages:
        green_api.send_message(whatsapp_id, messages[new_stage].format(**deal))

Дополнительно: бот принимает входящий ответ «трек» → отвечает ссылкой на отслеживание; «оператор» → переводит в очередь поддержки.

Результат: обращения в поддержку по статусу доставки сократились на 60% за первые две недели. Клиент сэкономил до 150 000 рублей в месяц на зарплате операторов.

Что входит в разработку бота под ключ

• Анализ требований и выбор провайдера
• Проектирование архитектуры (сервер, API, события CRM)
• Реализация бота (обработка команд, интеграция с REST)
• Настройка бизнес-процессов (исходящие уведомления по статусам)
• Тестирование (юнит, интеграционное)
• Документация и обучение операторов
• Деплой на production и мониторинг
• Техническая поддержка в течение 1 месяца

Ориентировочные сроки и стоимость

Средний бюджет таких проектов — от 150 000 до 300 000 рублей в зависимости от сложности. Стоимость рассчитывается индивидуально. Свяжитесь с нами для оценки вашего проекта.

Типичные ошибки при интеграции

• Использование неофициальных клиентов — приводит к блокировке номера.
• Неучтённые требования к шаблонам сообщений — первые исходящие отклоняются.
• Отсутствие fallback на оператора для нераспознанных команд — ухудшает пользовательский опыт.

Наша команда имеет сертификаты Битрикс и опыт более 50 проектов по интеграции CRM с мессенджерами. Закажите разработку под ключ — мы гарантируем качественный результат и поддержку после запуска. Получите консультацию по вашему проекту. Свяжитесь с нами, чтобы обсудить ваш сценарий.

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

Модуль «Открытые линии» (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 недели.

Сроки

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