Разработка 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-боту: поиск контакта по номеру телефона, создание лида, запись активностей в таймлайн.
Сравнение провайдеров
| Провайдер | Настройка | Интеграция с Битрикс24 | Кастомная логика |
|---|---|---|---|
| Wazzup | Простая (через маркетплейс) | Нативная, готовая | Ограничена маршрутизацией |
| Green API | Средняя (REST API) | Через модуль или самописно | Полная свобода |
| Chat2Desk | Средняя (веб-интерфейс) | Через модуль | Ограничена настройками |
Green API проще в настройке для кастомного бота, чем Wazzup, примерно в два раза быстрее, если нужна нестандартная логика.
Ключевые отличия от Telegram
WhatsApp поддерживает ограниченный набор форматирования: курсив, жирный, зачёркнутый, моноширинный?
Никаких HTML-тегов, кнопок-Reply (только через официальный API Templates). В неофициальных API (Green API) кнопки недоступны — только текстовое меню: «Напишите 1 — статус заказа, 2 — связь с оператором». Через официальный API доступны Interactive Messages с кнопками, но только в рамках утверждённых шаблонов.
Медиа передаётся хорошо: изображения, документы, голосовые. Бот может принимать фото (например, для заявки на возврат) и сохранять на Диск Битрикс24 через disk.folder.uploadfile.
Интеграция через готовый модуль Wazzup
Если нет задачи реализовывать сложную логику бота — проще использовать Wazzup с готовой интеграцией:
- Регистрация в Wazzup, подключение номера WhatsApp.
- Установка приложения Wazzup из маркетплейса Битрикс24.
- Настройка маппинга: входящие сообщения WhatsApp → открытая линия → лид/сделка в CRM.
- Операторы отвечают из Битрикс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 месяца
Ориентировочные сроки и стоимость
| Компонент | Трудозатраты |
|---|---|
| Подключение провайдера (Green API / Wazzup) | 4–8 ч |
| Базовый бот (текстовые команды) | 16–24 ч |
| Интеграция с CRM Битрикс24 | 8–16 ч |
| Исходящие уведомления по событиям CRM | 8–16 ч |
| Приём медиа и загрузка на Диск | 4–8 ч |
| Деплой и мониторинг | 4–8 ч |
Средний бюджет таких проектов — от 150 000 до 300 000 рублей в зависимости от сложности. Стоимость рассчитывается индивидуально. Свяжитесь с нами для оценки вашего проекта.
Типичные ошибки при интеграции
- Использование неофициальных клиентов — приводит к блокировке номера.
- Неучтённые требования к шаблонам сообщений — первые исходящие отклоняются.
- Отсутствие fallback на оператора для нераспознанных команд — ухудшает пользовательский опыт.
Чек-лист перед стартом
- Верифицированный аккаунт Meta Business - Выбор BSP-провайдера - Утверждённые шаблоны для первого исходящего - API-ключи для Green API / Wazzup - Тестовый номер WhatsAppНаша команда имеет сертификаты Битрикс и опыт более 50 проектов по интеграции CRM с мессенджерами. Закажите разработку под ключ — мы гарантируем качественный результат и поддержку после запуска. Получите консультацию по вашему проекту. Свяжитесь с нами, чтобы обсудить ваш сценарий.







