Передача данных из квиз-формы в CRM Битрикс24: webhook, REST

Менеджер получает в CRM просто контакт, а ответы квиза (бюджет, сроки, предпочтения) остаются в нечитаемом комментарии или вообще не попадают в систему. В результате квалификация лида затягивается на часы, а рекламные каналы — без атрибуции. Мы решаем эту задачу: настраиваем передачу каждого ответа квиза в отдельное пользовательское поле Битрикс24, создаём лид с UTM-метками и автоматической задачей-колбеком. Интеграция выполняется под ключ с гарантией 6 месяцев и опытом 10+ лет на Битрикс.

Почему стандартные формы заявок уступают квизам?

Обычная форма из трёх полей (имя, телефон, комментарий) даёт менеджеру минимум информации. Клиент не всегда знает, что написать в комментарии, и часто оставляет пустым. Квиз-форма структурирует диалог: задаёт конкретные вопросы (бюджет, сроки, предпочтения) и фиксирует выбор из вариантов. В результате в CRM попадают не просто контакт, а готовая квалификация лида. Это сокращает время обработки в 2–3 раза.

Три подхода к интеграции: сравнение

Мы рекомендуем первый вариант как оптимальный по соотношению цена/качество. Он подходит для большинства бизнесов, уже использующих готовые квиз-платформы.

Как интеграция квиз-формы с Битрикс24 ускоряет обработку лидов?

При ручной обработке менеджер тратит время на перезвон и уточнение потребностей. С интеграцией все ответы уже есть в карточке лида: бюджет, срочность, тип помещения — отдельными полями. Менеджер сразу видит, звонить ли срочно или отправить коммерческое предложение. Дополнительно мы создаём задачу-активность «Позвонить через 2 часа» — это автоматизирует follow-up и снижает риск потери лида.

Webhook-обработчик: Marquiz → Битрикс24

Marquiz отправляет POST с JSON-пейлоадом при завершении квиза:

{
  "quiz_id": "abc123",
  "quiz_name": "Подбор окон",
  "contact": {
    "name": "Иван",
    "phone": "+79161234567",
    "email": "[email protected]"
  },
  "answers": [
    {"question": "Тип помещения", "answer": "Квартира"},
    {"question": "Количество окон", "answer": "3"},
    {"question": "Срочность", "answer": "В течение месяца"},
    {"question": "Бюджет", "answer": "50 000 – 100 000 руб."}
  ],
  "result": "Стандартный пакет",
  "utm": {
    "utm_source": "yandex",
    "utm_campaign": "windows_brand"
  }
}

Обработчик на стороне вашего сервера (посредника между Marquiz и Битрикс24):

// /local/api/quiz-webhook.php
require_once($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php');

header('Content-Type: application/json');

$payload = json_decode(file_get_contents('php://input'), true);

// Верификация по секретному токену в заголовке
$token  = $_SERVER['HTTP_X_QUIZ_TOKEN'] ?? '';
$secret = \Bitrix\Main\Config\Option::get('local.quiz', 'webhook_secret_marquiz');

if (!hash_equals($secret, $token)) {
    http_response_code(403);
    exit(json_encode(['error' => 'Unauthorized']));
}

$integrator = new \Local\Quiz\Bx24Integrator();
$result     = $integrator->createLeadFromQuiz($payload);

echo json_encode(['success' => true, 'lead_id' => $result]);

Создание лида в Битрикс24 через REST

namespace Local\Quiz;

use Local\Bx24\RestClient;

class Bx24Integrator
{
    private RestClient $bx24;

    public function __construct()
    {
        // Входящий вебхук Битрикс24 с правами crm.lead.add
        $webhookUrl = \Bitrix\Main\Config\Option::get('local.quiz', 'bx24_webhook_url');
        $this->bx24 = new RestClient($webhookUrl);
    }

    public function createLeadFromQuiz(array $data): int
    {
        $contact = $data['contact'] ?? [];
        $answers = $data['answers'] ?? [];

        // Формируем блок комментария с ответами квиза
        $comments = $this->buildQuizComment($data['quiz_name'] ?? '', $answers, $data['result'] ?? '');

        $leadFields = [
            'TITLE'          => ($data['quiz_name'] ?? 'Квиз') . ': ' . ($contact['phone'] ?? ''),
            'NAME'           => $contact['name'] ?? '',
            'PHONE'          => [['VALUE' => $contact['phone'] ?? '', 'VALUE_TYPE' => 'WORK']],
            'EMAIL'          => [['VALUE' => $contact['email'] ?? '', 'VALUE_TYPE' => 'WORK']],
            'SOURCE_ID'      => 'WEB',
            'STATUS_ID'      => 'NEW',
            'COMMENTS'       => $comments,
            'UF_QUIZ_ID'     => $data['quiz_id'] ?? '',
            'UF_QUIZ_RESULT' => $data['result'] ?? '',
            'UF_UTM_SOURCE'  => $data['utm']['utm_source'] ?? '',
            'UF_UTM_CAMPAIGN'=> $data['utm']['utm_campaign'] ?? '',
        ];

        // Добавляем отдельные поля под конкретные вопросы квиза
        $leadFields = $this->mapAnswersToFields($leadFields, $answers);

        $result = $this->bx24->call('crm.lead.add', ['fields' => $leadFields]);

        $leadId = (int)($result['result'] ?? 0);

        if ($leadId) {
            // Добавляем задачу менеджеру
            $this->bx24->call('crm.activity.add', [
                'fields' => [
                    'TYPE_ID'       => 2, // звонок
                    'SUBJECT'       => 'Позвонить по квизу: ' . ($contact['phone'] ?? ''),
                    'OWNER_TYPE_ID' => 1, // лид
                    'OWNER_ID'      => $leadId,
                    'DEADLINE'      => date('c', strtotime('+2 hours')),
                ],
            ]);
        }

        return $leadId;
    }

    private function buildQuizComment(string $quizName, array $answers, string $result): string
    {
        $lines = ["=== Квиз: {$quizName} ==="];

        foreach ($answers as $answer) {
            $lines[] = ($answer['question'] ?? '?') . ': ' . ($answer['answer'] ?? '—');
        }

        if ($result) {
            $lines[] = '';
            $lines[] = "Результат квиза: {$result}";
        }

        return implode("\n", $lines);
    }

    private function mapAnswersToFields(array $fields, array $answers): array
    {
        // Маппинг конкретных вопросов в пользовательские поля Битрикс24
        $mapping = [
            'Количество окон'    => 'UF_WINDOWS_COUNT',
            'Тип помещения'      => 'UF_ROOM_TYPE',
            'Бюджет'             => 'UF_BUDGET_RANGE',
            'Срочность'          => 'UF_URGENCY',
        ];

        foreach ($answers as $answer) {
            $question = $answer['question'] ?? '';
            $fieldCode = $mapping[$question] ?? null;

            if ($fieldCode) {
                $fields[$fieldCode] = $answer['answer'] ?? '';
            }
        }

        return $fields;
    }
}

Кастомные поля в Битрикс24 для квиза

Поля создаются через REST API или в интерфейсе Битрикс24 (CRM → Настройки → Пользовательские поля):

// Создание пользовательского поля для лида через REST
$this->bx24->call('crm.userfield.add', [
    'fields' => [
        'ENTITY_ID'   => 'CRM_LEAD',
        'FIELD_NAME'  => 'UF_QUIZ_RESULT',
        'USER_TYPE_ID'=> 'string',
        'XML_ID'      => 'QUIZ_RESULT',
        'EDIT_FORM_LABEL' => ['ru' => 'Результат квиза'],
        'LIST_COLUMN_LABEL' => ['ru' => 'Результат квиза'],
        'MANDATORY'   => 'N',
    ],
]);

Маппинг вопросов квиза в пользовательские поля

Интеграция через CRM-форму Битрикс24

Если квиз разрабатывается с нуля — альтернативный подход: CRM-форма Битрикс24 со скрытыми полями. Последний шаг квиза отправляет данные напрямую в форму через API:

// Финальный шаг квиза: отправляем данные в CRM-форму Битрикс24
async function submitQuizToBx24(answers, contact) {
    const formData = new FormData();

    // Поля CRM-формы
    formData.append('fields[NAME]', contact.name);
    formData.append('fields[PHONE][0][VALUE]', contact.phone);
    formData.append('fields[UF_QUIZ_RESULT]', getQuizResult(answers));
    formData.append('fields[COMMENTS]', formatAnswers(answers));

    // ID формы из настроек Битрикс24
    const formId = document.getElementById('quiz-container').dataset.bx24FormId;

    await fetch(`https://your-domain.bitrix24.ru/crm/webform/import/form/${formId}/`, {
        method: 'POST',
        body: formData,
    });
}

Этапы интеграции (пошагово)

1. Анализ структуры квиза и требований к полям CRM.
2. Создание пользовательских полей в Битрикс24 (через REST или интерфейс).
3. Разработка webhook-обработчика или REST-скрипта для приёма данных.
4. Настройка маппинга вопросов → поля лида.
5. Создание автоматической задачи-активности (звонок через 2 часа).
6. Тестирование полного сценария: заполнение квиза → появление лида в CRM.
7. Документация и передача доступов.

Почему важно передавать UTM-метки в сделку?

Без UTM-меток вы не узнаете, какой канал привёл целевого клиента. В интеграции мы передаём utm_source и utm_campaign в отдельные поля лида. Это позволяет строить отчёты по эффективности рекламных кампаний прямо в CRM, без дополнительных систем аналитики. Для менеджеров это помогает понимать контекст: например, лид с дешёвого баннера требует другого подхода, чем с дорогой контекстной рекламы.

Типичные ошибки при интеграции

• Отсутствие верификации webhook-запроса (секретный токен). Без неё любой может отправить фейковые лиды.
• Маппинг ответов только в комментарии. Ответы теряются в тексте, менеджеру сложно их анализировать.
• Игнорирование UTM-меток. Вы теряете атрибуцию трафика.
• Создание лида без автоматической задачи. Клиент может «зависнуть» в статусе NEW на дни.

Мы учитываем эти нюансы в каждом проекте. Наш опыт позволяет избежать типовых проблем и внедрить интеграцию с первого раза.

Сроки и стоимость

• Базовый webhook (один квиз-сервис, 3 поля ответа, без UTM) — от 3 до 7 дней.
• Полная настройка (кастомные поля, активность, UTM, несколько квизов) — 1–2 недели.

Стоимость рассчитывается индивидуально, зависит от количества квизов и сложности маппинга. Свяжитесь с нами для оценки вашего проекта — пришлём коммерческое предложение в течение дня. Закажите интеграцию и получите готовое решение с гарантией 6 месяцев.

Реальность внедрений CRM: 80% не приносят результата

Мы работаем с Битрикс24 больше 10 лет — за это время провели 500+ проектов. Каждый второй начинается с одинаковой проблемы: компания покупает CRM, настраивает «по учебнику», а через три месяца менеджеры заполняют два поля из двенадцати, сделки зависают на «Переговорах» месяцами, руководитель не может вытащить аналитику. Корень не в плохом софте — корень в подходе. CRM настраивают без аудита реальных процессов, без учёта возражений персонала и без пошагового плана автоматизации. В этой статье — пошаговая инструкция, как мы этого избегаем.

Все специалисты сертифицированы 1С-Битрикс, методология отработана на сотнях кейсов. 1С-Битрикс — платформа, которая в связке с Битрикс24 даёт реальную сквозную аналитику, если настроена правильно.

Почему сотрудники саботируют CRM?

Менеджеры привыкли к Excel и блокнотам — CRM воспринимают как тотальный контроль. Наше решение: вовлекаем ключевых сотрудников на этапе проектирования, показываем личную выгоду — автоматические напоминания, готовые шаблоны КП, меньше рутины. Обучаем на реальных сценариях, а не абстрактных примерах. Сопротивление падает в 4 раза быстрее, чем при «приказном» внедрении.

Как избежать неполного ввода данных?

Обязательные поля заполняют, остальное игнорируют — знакомая картина? Решаем трехуровнево:

• Настраиваем обязательные поля по стадиям воронки (на каждом этапе — только актуальные данные).
• Внедряем автозаполнение из UTM-меток, парсинг email, данные из открытых баз.
• Убираем избыточные поля — меньше полей, выше качество.

По данным нашей практики, оптимизация полей снижает количество пропусков на 70% уже в первый месяц.

Кривые воронки: как спроектировать правильно?

Слишком много стадий, нет критериев перехода, дублирующие этапы — типичные ошибки. Мы проектируем воронку по факту: как продажи устроены на самом деле, а не как написано в учебниках. Используем данные из CRM за первые 2 недели аудита, чтобы выявить реальные этапы и точки потерь. Это позволяет сократить цикл сделки на 25–40%.

Автоматизация: что делать сразу?

Настраиваем роботов и бизнес-процессы с первого дня — чтобы команда сразу почувствовала разницу. Например, распределение лидов, отправка писем после смены статуса сделки, создание задач на смежников. Компании, внедрившие автоматизацию на старте, достигают плановых показателей на 3 месяца быстрее.

Какие возможности Битрикс24 ускоряют продажи?

• Обращения из всех каналов (телефон, почта, мессенджеры, формы) фиксируются автоматически.
• Лиды создаются и распределяются без ручного вмешательства.
• Визуальный канбан с кастомными стадиями — перетащил карточку на следующий этап, автоматически ушло письмо, создалась задача.
• Омниканальность: единое окно для телефонии, email, WhatsApp, Telegram, Viber, VK, Instagram, онлайн-чата.
• Роботы и бизнес-процессы: рассылки, генерация документов, напоминания, эскалации — без кода.
• Аналитика: воронка, конверсии, источники лидов, нагрузка менеджеров, среднее время обработки.

Что даёт интеграция сайта на 1С-Битрикс с CRM Битрикс24?

Синергия двух продуктов даёт измеримые результаты, и мы реализуем её через прямой обмен данными. Формы сайта передают лиды в CRM мгновенно с полной UTM-разметкой — вы видите, откуда пришёл клиент. Онлайн-чат связывается через открытые линии: посетитель пишет на сайте, менеджер отвечает из CRM. Заказы в магазине на базе инфоблоков v2.0 превращаются в сделки с полной историей покупок, что позволяет предлагать допродажи. Коллтрекинг с подменой номеров привязывает звонки к рекламным каналам. Мы используем CommerceML для обмена данными с 1С УТ/ЕРП: номенклатура, остатки, цены — синхронизируются через агенты без ручного вмешательства. Сквозная аналитика собирает расходы на рекламу, визиты, заявки, продажи в одном отчёте — ROI каждого канала. Для нестандартной логики применяем REST API и HL-блоки, чтобы хранить произвольные данные (например, историю взаимодействий с техподдержкой). В одном из проектов мы настроили такую связку для сети розничных магазинов: интеграция касс 1С с CRM дала автоматическое создание контактов при покупке по карте лояльности, а CRM-маркетинг через Битрикс24 увеличил повторные покупки на 18% за полгода.

Как мы настраиваем CRM: процесс

1. Аудит. Разбираемся, как продажи работают сейчас. Где теряются лиды? Какие каналы приносят клиентов? Формируем рекомендации до начала технического внедрения.
2. Проектирование. Множественные воронки для разных направлений, кастомные поля, обязательные этапы и условия перехода. Структура отражает реальный процесс.
3. Интеграции. Связываем с сайтом, телефонией, почтой, мессенджерами, Яндекс.Директ, Google Ads, 1С.
4. Кастомные модули. Когда стандартного не хватает — приложения для Битрикс24: специфические отчёты, нестандартная бизнес-логика, интеграции с отраслевыми системами.
5. Миграция. Переносим базы из amoCRM, Мегаплан, Salesforce, HubSpot, Excel. Связи, история коммуникаций, вложения — всё на месте.
6. Обучение. Тренинги под вашу конфигурацию, видеоинструкции, документация.

Что входит в работу?

Облачная или коробочная: что выбрать?

Сравнение: облачная версия обходится в 2–3 раза дешевле коробочной на старте, но для B2B-компаний с большими объёмами данных коробка окупается за 1,5–2 года за счёт отсутствия абонплаты за каждого пользователя.

Метрики, которые мы отслеживаем для вашего бизнеса

• Конверсия по этапам воронки. Если 80% теряются на этапе КП — проблема в ценообразовании, а не в менеджерах. Норма: 5–15% для B2B, 1–5% для B2C с высоким чеком.
• Время обработки лида. Ответ за 5 минут повышает конверсию в 10 раз по сравнению с ответом через полчаса. Настраиваем алерты — если менеджер не ответил за 15 минут, лид переходит к другому.
• LTV. CRM сегментирует клиентов по lifetime value — менеджеры фокусируются на самых ценных.
• Средний цикл сделки. Если растёт — что-то сломалось. Причины отказов — золотая жила для корректировки продукта и скриптов.

Наши кейсы

Производственная компания (B2B). Завод с оборотом 200 млн в год. Заявки терялись в почте, руководитель узнавал о крупных сделках постфактум. Мы настроили автоматическую фиксацию обращений, воронку «квалификация → расчёт → КП → согласование → договор → оплата», и роботов, которые формируют КП по шаблону. Конверсия выросла на 23%, время обработки заявки упало с 4 часов до 20 минут. Экономия фонда оплаты труда менеджеров — более 100 000 рублей в месяц за счёт сокращения рутины.

IT-сервисная компания. Три воронки: новые клиенты, допродажи, тендеры. Автогенерация договоров и счетов, интеграция с Jira — после подписания задачи автоматически падают в отдел разработки. Руководство получило взвешенный прогноз выручки с точностью 90%. Проект окупился за 4 месяца.

Сроки и стоимость внедрения

Стоимость рассчитывается индивидуально под ваш объём задач. После внедрения — техподдержка с SLA (реакция от 1 часа), регулярный аудит использования и развитие функционала.

Готовы обсудить вашу ситуацию? Свяжитесь с нами — проведём бесплатный аудит текущей CRM за 2 дня и предложим архитектуру внедрения с гарантией результата. Закажите консультацию — покажем на цифрах, сколько вы сэкономите с правильной настройкой.