Лид-формы ВКонтакте в Битрикс24 я подключаю по одной из трёх схем. Выбор зависит от числа полей в форме, от нужных UTM-меток и от того, кто разбирает обращения в CRM. Форма живёт в кабинете VK Рекламы: человек оставляет контакты, не выходя из ленты, а дальше заявку надо довезти до менеджера за минуты, пока он помнит про объявление. Ниже схемы, рабочий код передачи и места, где заявки на практике теряются чаще всего.
Как заявки из ВКонтакте попадают в Битрикс24: три схемы
VK хранит заявку у себя и отдаёт её наружу одним из способов: отправляет на ваш URL (вебхук), передаёт через готовое подключение к CRM или отдаёт по API, когда вы сами приходите за данными. Битрикс24 со своей стороны принимает лид через входящий вебхук с правом на CRM либо через то самое готовое подключение. Из этого складываются три схемы.
| Схема | Что нужно для запуска | Гибкость полей | Контроль дублей и потерь | Когда беру |
|---|---|---|---|---|
| Готовое подключение через CRM-форму Битрикс24 | Доступы к кабинету и порталу | Только те поля, которые предусмотрела интеграция | Полагаешься на правила CRM | Одна форма, простые вопросы, один ответственный |
| PHP-обработчик на хостинге | Хостинг с PHP и MySQL, входящий вебхук Битрикс24 | Любая: UTM, ответственный, разные воронки | Своя таблица с уникальным индексом и повторной отправкой | Несколько форм, нужны метки источника и проверки |
| Сценарий в n8n | Запущенный n8n и входящий вебхук Битрикс24 | Любая, собирается из узлов | Через узлы проверки и повтора | n8n уже есть, заявки идут ещё и в Telegram |
Хостинг под PHP-обработчик у вас уже есть вместе с сайтом, отдельный сервер не нужен. С n8n иначе: его надо где-то запускать, в облаке или на своём VPS. Свой сервер нужно настраивать, обновлять, продлевать на нём сертификат и оплачивать каждый месяц, на обычном хостинге сайта такое не заработает.
Забор заявок по API по расписанию я почти не использую. Заявка доезжает с задержкой до следующего запуска, а вебхук доставляет её сразу после отправки формы.
Готовое подключение лид-формы к Битрикс24: что проверить до запуска
Готовое подключение настраивается на стороне Битрикс24, а не в кабинете VK Рекламы: в CRM создаётся CRM-форма со сценарием «Лид-формы VK Реклама», и к ней привязывается лид-форма. По справке Битрикс24 это раздел CRM > Продажи > Каналы продаж > CRM-формы, для каждой лид-формы нужна отдельная CRM-форма. Есть ограничение: к Битрикс24 подключается только один кабинет VK Рекламы, и он должен принадлежать физическому лицу, кабинеты юридических лиц и рекламных агентств не поддерживаются. Если условия подходят, начинаю с этого варианта: для одной формы из имени и телефона его хватает. Названия разделов меняются, поэтому путь перед настройкой сверяйте со справкой.
Перед запуском проверяю четыре вещи:
- какие поля уходят в лид: имя, телефон, email, ответы на дополнительные вопросы;
- остаётся ли в лиде след источника: название формы, кампания, объявление, без него отчёт по рекламе в CRM получается пустым;
- что происходит при повторной заявке с того же телефона;
- кто становится ответственным за лид и приходит ли ему уведомление.
Тестовую заявку отправляю сам, с телефона, и открываю карточку лида в CRM. Смотрю, в каком виде записан номер, не превратились ли ответы на вопросы в кашу в комментарии и не потерялась ли форма-источник. Если хотя бы по одному пункту результат не устраивает, например заявки из разных форм должны уходить разным менеджерам, готового подключения мало и я перехожу на вебхук.
Бесплатный материал
🎁 Полезный скрипт в подарок
Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.
Без спама. Отписка в 1 клик.
Передача лидов из ВК в Битрикс24 через вебхук на PHP
Схема простая. VK отправляет заявку на адрес моего PHP-файла, файл проверяет секрет, сохраняет заявку в MySQL и отправляет её в Битрикс24 методом crm.lead.add. Всё это работает на обычном хостинге сайта.
В Битрикс24 создаю входящий вебхук с правом на CRM. Он выдаёт адрес вида https://ваш-портал.bitrix24.ru/rest/ID_пользователя/код/, к которому дописывается имя метода. Код в адресе работает как пароль, поэтому держу его в файле конфигурации вне публичной папки сайта и никогда не подставляю в JavaScript на странице.
Сначала таблица. Уникальный ключ по ID заявки VK защищает от повторной доставки, а сырое тело запроса хранится, чтобы недоставленную заявку можно было отправить позже.
CREATE TABLE vk_leads (
vk_lead_id VARCHAR(64) NOT NULL,
payload TEXT NOT NULL,
b24_lead_id INT UNSIGNED NULL,
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (vk_lead_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
Функция отправки в Битрикс24. Запрос идёт методом POST с JSON в теле, в ответ приходит ключ result с ID созданного лида.
<?php
const B24_URL = 'https://your-portal.bitrix24.ru/rest/1/xxxxxxxxxxxx/crm.lead.add.json';
function sendLeadToBitrix(array $lead): ?int
{
$fields = [
'TITLE' => 'Лид-форма ВК: ' . $lead['form_name'],
'NAME' => $lead['name'],
'PHONE' => [['VALUE' => $lead['phone'], 'VALUE_TYPE' => 'WORK']],
'SOURCE_ID' => 'ADVERTISING',
'ORIGINATOR_ID' => 'vk_leadform',
'ORIGIN_ID' => $lead['id'],
'UTM_SOURCE' => 'vk',
'UTM_CAMPAIGN' => $lead['campaign'],
'COMMENTS' => $lead['comments'],
];
if ($lead['email'] !== '') {
$fields['EMAIL'] = [['VALUE' => $lead['email'], 'VALUE_TYPE' => 'WORK']];
}
$body = json_encode(
['fields' => $fields, 'params' => ['REGISTER_SONET_EVENT' => 'Y']],
JSON_UNESCAPED_UNICODE
);
$ch = curl_init(B24_URL);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode((string) $response, true);
return $data['result'] ?? null;
}
Функция принимает уже разобранные поля. Как достать их из тела запроса VK, зависит от вашей формы и способа доставки, а точные названия ключей я по памяти не переписываю. Первым делом пишу сырое тело в лог, отправляю тестовую заявку и смотрю реальную структуру, и только после этого пишу разбор.
Дальше защита от дубля и сохранение результата:
$pdo = new PDO('mysql:host=localhost;dbname=leads;charset=utf8mb4', 'db_user', 'db_pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$raw = file_get_contents('php://input');
// здесь разбор $raw в массив $lead: id, form_name, name, phone, email, campaign, comments
try {
$pdo->prepare('INSERT INTO vk_leads (vk_lead_id, payload) VALUES (?, ?)')
->execute([$lead['id'], $raw]);
} catch (PDOException $e) {
if ($e->getCode() === '23000') { // повторная доставка той же заявки
echo 'ok';
exit;
}
throw $e;
}
$b24Id = sendLeadToBitrix($lead);
if ($b24Id) {
$pdo->prepare('UPDATE vk_leads SET b24_lead_id = ? WHERE vk_lead_id = ?')
->execute([$b24Id, $lead['id']]);
}
http_response_code(200);
echo 'ok';
Отвечаю быстро, кодом 200 и телом «ok»: так ждёт Callback API сообществ, для другого типа доставки требования к ответу сверяю с документацией VK. Заявки, у которых b24_lead_id остался пустым, добирает второй скрипт по cron хостинга раз в несколько минут. Обращения к REST Битрикс24 держу в пределах лимита: по документации для тарифов, кроме Энтерпрайз, это 2 запроса в секунду при пороге накопления 50. При превышении приходит статус 503 и код QUERY_LIMIT_EXCEEDED. Для потока лидов из рекламы запас большой, но при догрузке пачки из cron я ставлю паузу между вызовами.
Отдельная оговорка про сам портал. Если в нём отключены лиды (простой режим CRM, работа сразу со сделками), созданный лид сразу конвертируется в сделку, и через crm.lead.get его уже не получить. Режим портала проверяется методом crm.settings.mode.get. Сам crm.lead.add в документации помечен устаревшим: развитие метода остановлено, вместо него вендор советует crm.item.add, поэтому перед написанием кода я сверяю актуальный метод в справке Битрикс24.
Поля лид-формы ВК в CRM: что и куда раскладываю
Плохой маппинг портит больше, чем сбой доставки: лид пришёл, но менеджер не видит, откуда он, и не может отличить заявку из ВК от звонка. Раскладываю так.
| Что приходит из формы | Куда кладу в лид | Нюанс |
|---|---|---|
| Имя | NAME |
Если в форме одно поле «Имя и фамилия», кладу всё в NAME и разбирать на части не пытаюсь |
| Телефон | PHONE |
Массив объектов с VALUE и VALUE_TYPE, номер привожу к формату +7 |
EMAIL |
Тоже массив, пустое значение не отправляю | |
| Ответы на свои вопросы | COMMENTS или пользовательские поля UF_CRM_... |
Для фильтров и отчётов создаю поля заранее, разовые вопросы уходят в комментарий |
| Форма, кампания, объявление | TITLE, UTM_CAMPAIGN, UTM_CONTENT |
Работает, если эти данные есть в вашем варианте доставки, иначе сопоставляю по ID формы |
| ID заявки VK | ORIGIN_ID |
По нему потом находится лид и не создаётся дубль |
С телефонами у меня всегда одна и та же история: люди пишут «8 (900) 123-45-67», «+7 900 1234567» и просто цифры. Прогоняю номер через маленькую функцию, иначе поиск дублей в CRM работает хуже.
function normalizePhone(string $raw): string
{
$digits = preg_replace('/\D/', '', $raw);
if (strlen($digits) === 11 && $digits[0] === '8') {
$digits = '7' . substr($digits, 1);
}
return $digits === '' ? '' : '+' . $digits;
}
Источник у всех лидов из ВК одинаковый: SOURCE_ID со значением «Реклама» (ADVERTISING) и UTM_SOURCE равный vk. Так в фильтрах CRM и в отчётах видно, сколько заявок дала именно эта площадка.
Про персональные данные. Имена и телефоны остаются в Битрикс24 и в MySQL на российском хостинге. Промежуточные таблицы в Google Sheets или Airtable я для заявок не использую: персональные данные россиян по 152-ФЗ должны храниться на серверах в России. В самой лид-форме VK при этом должна быть ссылка на политику конфиденциальности.
Дубли и потерянные заявки в CRM: что проверяю после запуска
Дубли
Технический дубль возникает, когда одна и та же заявка приходит дважды, например после повторной доставки. Его отсекает уникальный ключ по ID заявки VK: вставка в таблицу падает, скрипт отвечает «ok» и ничего не создаёт. Совсем другое дело, когда человек оставил две разные заявки за день. Это вопрос правил отдела продаж: склеивать такие обращения встроенным поиском дублей CRM или вести отдельно. Обсуждаю это с продажниками один раз и фиксирую решение.
Потери
Заявки пропадают по трём причинам: Битрикс24 вернул ошибку (лимит, отозванный вебхук, не хватает прав), скрипт упал на разборе, недоступен хостинг. Против первых двух работает схема «сначала сохранить, потом отправить»: заявка лежит в таблице, а cron повторяет отправку. Про третью причину узнаю сам: если у записи b24_lead_id пуст дольше 15 минут, скрипт присылает мне сообщение в Telegram.
Проверка перед включением рекламы
- Отправляю тестовую заявку и сверяю карточку лида: поля, источник, ответственный.
- Отправляю ту же заявку повторно и убеждаюсь, что второго лида нет.
- Временно отзываю вебхук в Битрикс24 и отправляю заявку: она должна остаться в таблице и уйти после восстановления.
- Оставляю необязательные поля пустыми и смотрю, не падает ли разбор.
Если заявки нужно ещё и дублировать в Telegram, раскидывать по нескольким воронкам или отправлять в другие системы, ту же цепочку удобно собрать сценарием: узел вебхука, проверка дубля, HTTP-запрос к crm.lead.add. Это как раз случай, когда я беру автоматизацию в n8n, и такую связку делаю от 25 000 ₽. Для одной формы с одним менеджером отдельный сервер под n8n избыточен, там хватает PHP на хостинге сайта.
Что происходит с лидом после попадания в Битрикс24
Доставка это половина дела. Заявка из ленты остывает быстро: человек оставил контакты между делами и через сутки уже плохо помнит объявление. В Битрикс24 для этого есть роботы CRM: назначить ответственного, поставить задачу «перезвонить», отправить уведомление менеджеру. Я настраиваю их сразу вместе с интеграцией, иначе лид лежит в стадии «Новый» до тех пор, пока кто-нибудь случайно на него не наткнётся.
Отдельно смотрю, чтобы у ответственного был запасной вариант на случай отпуска или болезни, и заглядываю в отчёты по источнику через неделю после старта: если лидов из ВК в CRM заметно меньше, чем заявок в кабинете рекламы, ищу потери по схеме из предыдущего раздела.
Условия и возможности VK Рекламы и Битрикс24 меняются, поэтому перед запуском я уточняю их в документации самих сервисов.
Частые вопросы
Можно ли подключить лид-формы ВК к Битрикс24 без программиста?
Можно, через готовое подключение в CRM-формах Битрикс24, если рекламный кабинет VK принадлежит физическому лицу и вам хватает возможностей интеграции: одна форма, простые поля, один ответственный. Как только нужны разные воронки, метки источника или проверка дублей, приходится писать обработчик или собирать сценарий в n8n.
Что будет с заявкой, если Битрикс24 не ответил?
В моей схеме она уже сохранена в MySQL, и cron отправит её повторно. Как ведёт себя готовое подключение, зависит от его реализации, поэтому проверяйте тестом: отзовите доступ, отправьте заявку и посмотрите, дойдёт ли она после восстановления.
Куда складывать ответы на дополнительные вопросы формы?
Если по ним нужны фильтры и отчёты, создайте пользовательские поля лида заранее и передавайте ответы в них. Для разовых вопросов достаточно поля COMMENTS: менеджер увидит текст в карточке, но отфильтровать по нему будет трудно.
Как понять, что лид пришёл именно из ВКонтакте?
Передавайте SOURCE_ID со значением «Реклама», UTM_SOURCE со значением vk и собственный ORIGINATOR_ID. По ним лиды из ВК отделяются в фильтрах и отчётах CRM от звонков и заявок с сайта.