Розробка бота для Facebook Messenger з інтеграцією Бітрікс24

При запуску рекламної кампанії у Facebook ви отримуєте десятки заявок у Messenger, але менеджери витрачають час на ручну кваліфікацію та перенесення даних у CRM? Ми стикалися з цим не раз. Наше рішення — бот, який автоматично приймає повідомлення, ставить уточнюючі запитання за сценарієм, створює лід у Бітрікс24 і передає діалог оператору в потрібний момент. Інтеграція виконується під ключ: від налаштування Meta App до запуску в продакшен. Автоматизація першого дотику скорочує час реакції на 80% — це підтверджує Messenger Platform Documentation. Економія часу менеджерів — до 70%, а середня економія на обробці одного ліда скорочує витрати на рекламу до 30%.

Чому автоматизація Messenger важлива?

Клієнти очікують миттєвої відповіді. Бот обробляє ліди в 10 разів швидше ручного введення даних, при цьому виключає помилки людського фактора. Кожен лід одразу потрапляє в CRM з повною історією діалогу. Оператор бачить контекст і може підключитися в будь-який момент. Це підвищує конверсію в продаж на 25–40% за даними наших проєктів. При середньому рекламному бюджеті окупність інтеграції настає за 2–3 місяці.

Як працює інтеграція?

Клієнт пише на сторінку Facebook. Webhook Meta надсилає POST-запит на наш сервер. Сервер обробляє текст, визначає намір (intent) і відповідає через Messenger Send API. Паралельно через Bitrix24 REST API створюється лід і фіксується активність. Якщо клієнт запитує допомогу оператора, бот викликає Handoff Protocol — і діалог підхоплює менеджер прямо з картки CRM. Весь процес займає секунди.

Які технічні вимоги?

Meta надає Messenger Platform API для автоматизації. Для роботи потрібні: Facebook Developer App з продуктом Messenger, сторінка Facebook та PAGE_ACCESS_TOKEN. Верифікація webhook обов'язкова — GET-запит з hub.verify_token і hub.challenge. Сервер повертає challenge при збігу токена.

Вхідні повідомлення приходять як POST з JSON-тілом: {"entry":[{"messaging":[{"sender":{"id":"123"},"message":{"text":"приклад"}}]}]}. Meta чекає відповідь 200 OK протягом 5 секунд — важку обробку виносимо в чергу.

Відправка повідомлень зі швидкими відповідями:

function sendMessengerMessage(string $psid, string $text, array $quickReplies = []): void { $payload = [ 'recipient' => ['id' => $psid], 'message' => ['text' => $text], ]; if ($quickReplies) { $payload['message']['quick_replies'] = $quickReplies; } $ch = curl_init("https://graph.facebook.com/v18.0/me/messages?access_token=" . PAGE_ACCESS_TOKEN); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); curl_exec($ch); } $quickReplies = [ ['content_type' => 'text', 'title' => 'Так, цікавить', 'payload' => 'INTERESTED'], ['content_type' => 'text', 'title' => 'Просто дивлюсь', 'payload' => 'BROWSING'], ]; sendMessengerMessage($psid, 'Допомогти з вибором?', $quickReplies); 

Generic Template для карток товарів:

$template = [ 'recipient' => ['id' => $psid], 'message' => [ 'attachment' => [ 'type' => 'template', 'payload' => [ 'template_type' => 'generic', 'elements' => [[ 'title' => $productName, 'image_url' => $productImage, 'subtitle' => $productDescription, 'buttons' => [ ['type' => 'web_url', 'url' => $productUrl, 'title' => 'Детальніше'], ['type' => 'postback', 'title' => 'Замовити', 'payload' => "ORDER_{$productId}"], ], ]], ], ], ], ]; 

Створення лідів та активностей у Бітрікс24

$leadId = $b24->callMethod('crm.lead.add', [ 'fields' => [ 'TITLE' => "Messenger: {$firstName} {$lastName}", 'NAME' => $firstName, 'LAST_NAME' => $lastName, 'SOURCE_ID' => 'WEBFORM', 'SOURCE_DESCRIPTION' => 'Facebook Messenger', 'UF_CRM_FB_PSID' => $psid, 'COMMENTS' => "Facebook Profile ID: {$psid}", ], ])['result']; $b24->callMethod('crm.activity.add', [ 'fields' => [ 'OWNER_TYPE_ID' => 1, 'OWNER_ID' => $leadId, 'TYPE_ID' => 4, 'SUBJECT' => 'Повідомлення Facebook Messenger', 'DESCRIPTION' => "{$firstName}: {$messageText}", 'DEADLINE' => date('Y-m-d\TH:i:s'), ], ]); 

Що входить в роботу

Як налаштувати інтеграцію за 5 кроків?

1. Створіть Facebook Developer App і підключіть продукт Messenger.
2. Налаштуйте webhook на ваш сервер, вкажіть URL і verify token.
3. Розробіть сценарій діалогу: визначте стани, швидкі відповіді, падаючі повідомлення.
4. Реалізуйте інтеграцію з Бітрікс24 через REST API: створення ліда і логування активностей.
5. Протестуйте всі сценарії і пройдіть рев'ю додатку Meta.

Строки та бюджет

Разом: 2–3 тижні з урахуванням рев'ю Meta. Вартість розраховується індивідуально в залежності від складності сценарію та кількості інтеграцій. Окупність проєкту — в середньому 2–3 місяці за рахунок економії ресурсів. Отримайте оцінку вашого проєкту — зв'яжіться з нами для розрахунку.

Типові помилки та як їх уникнути

• Відсутність черги повідомлень. При високому навантаженні Meta повторює запити — без черги ви ризикуєте створити дублі лідів. Використовуємо черги (RabbitMQ або Redis).
• Неправильний Handoff. Без pass_thread_control діалог не передається оператору. Перевіряємо коректність виклику на етапі тестування.
• Пропуск рев'ю Meta. Додаток блокується без затвердження permissions. Готуємо політику конфіденційності і проходимо рев'ю заздалегідь.
• Ігнорування 24-годинного вікна. Після закінчення вікна можна надсилати тільки шаблони — налаштовуємо автоматичне надсилання схвалених Message Tags.

Наш досвід понад 10 інтеграцій Messenger + Бітрікс24 гарантує стабільну роботу під навантаженням. Сертифіковані спеціалісти Бітрікс24 забезпечують відповідність вимогам платформи. Замовте консультацію — ми покажемо, як бот може працювати на ваш бізнес. Гарантуємо прозорість процесу та підтримку після запуску.

Рев'ю додатку Meta: вимоги та ризики

Meta вимагає обов'язкового рев'ю перед публікацією. Ми готуємо всі документи: політику конфіденційності, іконки, опис. У процесі розробки уникаємо використання несхвалених шаблонів та спам-патернів. Після проходження рев'ю бот працює стабільно без ризику блокування.