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