Разработка 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 — решение окупается за месяц за счёт автоматизации.