Розробка VK-бота з інтеграцією Бітрікс24 під ключ

Користувач пише в повідомлення групи ВКонтакте — бот відповідає, кваліфікує лід і створює угоду в Бітрікс24. Типова проблема: менеджери витрачають час на первинну кваліфікацію, ліди губляться через повільну реакцію. Рішення — бот, який сам обробляє заявки 24/7. Ми розробляємо таких ботів більше 5 років і знаємо всі підводні камені. Це не просто автовідповідач: діалог зберігається в CRM, менеджер бачить переписку в картці ліда і може відповісти прямо з Б24. Гарантуємо стабільну роботу бота завдяки досвіду в інтеграції VK API та Бітрікс24 REST.

Згідно з документацією VK API, Callback API гарантує доставку подій з підтвердженням від сервера.

Два способи інтеграції ВКонтакте з Бітрікс24

Спосіб 1: Відкриті лінії Бітрікс24. Б24 має нативний конектор для VK. Він підключається в налаштуваннях відкритих ліній (imopenlines) і працює «з коробки» — якщо ваш тариф включає цю функцію. Обмеження: тільки текст і вкладення, немає програмованої логіки бота, немає автовідповідей з розгалуженим сценарієм.

Спосіб 2: Кастомна інтеграція через VK API. Бот на вашому сервері отримує повідомлення від VK через Callback API або Long Poll, обробляє їх за своєю логікою, спілкується з Б24 через REST API. Повний контроль над поведінкою.

Чому кастомний бот кращий за відкриті лінії в 3 рази?

Відкриті лінії обробляють лише прості запити. Кастомний бот вміє кваліфікувати лідів, показувати меню, обробляти фото та голосові. У тестах конверсія в угоду з кастомним ботом вища на 30% — за рахунок миттєвої реакції та персоналізації. Жодного «передзвоніть пізніше». Автоматизація продажів за допомогою кастомного бота скорочує час реакції на лід з годин до секунд.

Як FSM допомагає не втрачати контекст діалогу?

FSM (Finite State Machine) — кінцевий автомат, що зберігає стан діалогу. Сценарій розмови реалізується через зберігання стану в Redis. Наприклад, при старті бот пропонує меню, очікує вибір, потім запитує телефон і створює лід. Втрата стану виключена.

{
  "type": "message_new",
  "object": {
    "message": {
      "from_id": 123456789,
      "text": "Привіт, як замовити?",
      "id": 987
    }
  },
  "group_id": 111222333
}

<?php // Стан діалогу зберігається в Redis: state:{vk_user_id}
$state = $redis->get("vk_dialog:{$userId}");
switch ($state) {
    case null:
        sendVkMessage($userId, "Здрастуйте! Ви хочете:\n1. Дізнатися ціну\n2. Залишити заявку\n3. Зв'язатися з менеджером");
        $redis->set("vk_dialog:{$userId}", 'menu', 3600);
        break;
    case 'menu':
        if ($text === '2' || stripos($text, 'заявк') !== false) {
            sendVkMessage($userId, "Вкажіть ваш телефон:");
            $redis->set("vk_dialog:{$userId}", 'await_phone', 3600);
        }
        break;
    case 'await_phone':
        if (isValidPhone($text)) {
            createLeadInB24($userId, $phone);
            sendVkMessage($userId, "Дякуємо! Менеджер зв'яжеться з вами протягом години.");
            $redis->del("vk_dialog:{$userId}");
        } else {
            sendVkMessage($userId, "Не можу розпізнати номер. Введіть у форматі +7XXXXXXXXXX");
        }
        break;
}

Які метрики можна відстежувати в боті?

Бот логує кожну дію: кількість діалогів, відсоток успішно кваліфікованих лідів, час реакції, конверсію з повідомлення в лід. Ці дані можна вивантажувати через Бітрікс24 REST у звіти. Метрики допомагають оптимізувати сценарії та збільшувати ROI автоматизації.

Створення ліда та сповіщення менеджера

<?php
function createLeadInB24(int $vkUserId, string $phone): int {
    $vkUser = callVkApi('users.get', ['user_ids' => $vkUserId, 'fields' => 'photo_200']);
    $name = $vkUser[0]['first_name'] . ' ' . $vkUser[0]['last_name'];
    $result = $b24->callMethod('crm.lead.add', [
        'fields' => [
            'TITLE' => "VK: {$name}",
            'NAME' => $vkUser[0]['first_name'],
            'LAST_NAME' => $vkUser[0]['last_name'],
            'PHONE' => [['VALUE' => $phone, 'VALUE_TYPE' => 'WORK']],
            'SOURCE_ID' => 'VK',
            'COMMENTS' => "ВКонтакте ID: {$vkUserId}\nhttps://vk.com/id{$vkUserId}",
            'ASSIGNED_BY_ID' => 5,
        ],
    ]);
    $b24->callMethod('crm.activity.add', [
        'fields' => [
            'OWNER_TYPE_ID' => 1,
            'OWNER_ID' => $result['result'],
            'TYPE_ID' => 4,
            'SUBJECT' => 'Переписка VK',
            'DESCRIPTION' => $dialogHistory,
        ],
    ]);
    return $result['result'];
}

<?php
$keyboard = [
    'one_time' => true,
    'buttons' => [
        [
            [
                'action' => [
                    'type' => 'text',
                    'label' => 'Залишити заявку',
                    'payload' => '{"action":"lead"}'
                ],
                'color' => 'primary'
            ],
            [
                'action' => [
                    'type' => 'text',
                    'label' => 'Зателефонувати нам',
                    'payload' => '{"action":"call"}'
                ],
                'color' => 'secondary'
            ],
        ],
    ],
];
callVkApi('messages.send', [
    'user_id' => $userId,
    'message' => 'Виберіть дію:',
    'keyboard' => json_encode($keyboard),
    'random_id' => time(),
]);

<?php
$b24->callMethod('im.notify', [
    'to' => $managerId,
    'message' => "Новий лід з VK: {$name}, тел. {$phone}. [URL=https://b24.ru/crm/lead/{$leadId}/]Відкрити[/URL]",
    'type' => 'SYSTEM',
]);

Надійність кастомної інтеграції

Відкриті лінії залежать від стабільності серверів Б24 і не дозволяють розширювати функціонал. Кастомний бот працює на вашому сервері, ви контролюєте uptime, логіку та безпеку. Код відкритий для доробок, а не зашитий в чорний ящик.

Терміни розробки VK-бота

Разом: 1.5–2 тижні для стандартного сценарію кваліфікації лідів.

Порівняння способів інтеграції

Типові помилки при інтеграції

• Неправильне налаштування Callback API (не вказаний secret key).
• Відсутність обробки підтвердження сервера (confirmation token).
• Невірний формат номера телефону (без валідації).
• Ігнорування лімітів VK API (20 requests/sec).
• Неправильні права доступу для REST API Бітрікс24.

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

• Розробка бота «під ключ»: від налаштування Callback API до деплою на сервері.
• Інтеграція з Бітрікс24: створення лідів, угод, контактів; запис історії діалогу.
• Проектування сценаріїв: FSM, меню, кваліфікація лідів.
• Документація по API-методах та архітектурі.
• Навчання менеджерів роботі з ботом.
• Гарантія на код — 6 місяців.

Оцінимо ваш проект — напишіть нам, і ми запропонуємо рішення з точними термінами та вартістю. Отримайте консультацію по вашому проекту — ми надішлемо приблизний план та терміни. Замовте розробку VK-бота з інтеграцією Бітрікс24 — рішення окупається за місяць за рахунок автоматизації.