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

Разработка бота для 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 требует обязательного ревью перед публикацией. Мы готовим все документы: политику конфиденциальности, иконки, описание. В процессе разработки избегаем использования неодобренных шаблонов и спам-паттернов. После прохождения ревью бот работает стабильно без риска блокировки.