Розробка 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 для реєстрації конектора. Інтеграція з 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 тижні.

Терміни

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