Менеджер отримує в CRM просто контакт, а відповіді квізу (бюджет, терміни, вподобання) залишаються в нечитабельному коментарі або взагалі не потрапляють до системи. В результаті кваліфікація ліда затягується на години, а рекламні канали — без атрибуції. Ми вирішуємо це завдання: налаштовуємо передачу кожної відповіді квізу в окреме користувацьке поле Бітрікс24, створюємо лід з UTM-мітками та автоматичним завданням-колбеком. Інтеграція виконується під ключ з гарантією 6 місяців і досвідом 10+ років на Бітрікс. Наша компанія на ринку CRM-рішень понад 5 років, реалізувала понад 80 успішних інтеграцій.
Чому квіз-форма ефективніша за звичайну?
Звичайна форма з трьох полів (ім'я, телефон, коментар) дає менеджеру мінімум інформації. Клієнт не завжди знає, що написати в коментарі, і часто залишає його порожнім. Квіз-форма структурує діалог: задає конкретні питання (бюджет, терміни, вподобання) та фіксує вибір із варіантів. В результаті в CRM потрапляють не просто контакт, а готова кваліфікація ліда. Це скорочує час обробки в 2–3 рази (тобто на 50-70% швидше) і підвищує конверсію в угоду на 30%.
Основні способи інтеграції: порівняння
Webhook vs CRM-форма vs кастомний квіз – кожен варіант має свої переваги. Webhook краще за рівнем кастомізації в 5 разів порівняно з CRM-формою. CRM-форма вбудовується за 1–2 години, але дає мінімум гнучкості. Кастомний квіз з REST API дозволяє повністю контролювати UX, але вимагає 1–2 тижнів розробки. Ми рекомендуємо перший варіант як оптимальний за співвідношенням ціна/якість.
| Підхід | Складність | Кастомізація | Час впровадження | Вимагає розробки |
|---|---|---|---|---|
| Webhook від квіз-сервісу -> посередник -> Бітрікс24 | Середня | Висока (свій мапінг) | 3–7 днів | Так (PHP-обробник) |
| Кастомний квіз на сайті -> REST API | Висока | Максимальна | 1–2 тижні | Так (фронт + бек) |
| CRM-форма Бітрікс24 (мультикрок) | Низька | Низька (дизайн) | 1–2 години | Ні |
Як інтеграція прискорює обробку лідів?
При ручній обробці менеджер (manager) витрачає час на передзвін і уточнення потреб. З інтеграцією всі відповіді вже є в картці ліда: бюджет, терміновість, тип приміщення — окремими полями. Менеджер одразу бачить, чи варто дзвонити терміново або надіслати комерційну пропозицію. Додатково ми створюємо завдання-активність (activity) «Зателефонувати через 2 години» — це автоматизує follow-up і знижує ризик втрати ліда на 80%.
Технічна реалізація: webhook Marquiz → Бітрікс24
Marquiz надсилає POST з JSON-пейлоадом при завершенні квізу:
Приклад пейлоаду Marquiz
{ "quiz_id": "abc123", "quiz_name": "Підбір вікон", "contact": { "name": "Іван", "phone": "+380991234567", "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]); Створення ліда через REST API
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; } } Налаштування користувацьких полів
Поля створюються через REST API або в інтерфейсі Бітрікс24 (CRM → Налаштування → Користувацькі поля). Документація Бітрікс24 REST API: https://dev.1c-bitrix.ru/rest_help/
// Создание пользовательского поля для лида через 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 | Тип |
|---|---|---|
| Бюджет | UF_BUDGET_RANGE | string |
| Тип приміщення | UF_ROOM_TYPE | string |
| Терміновість | UF_URGENCY | string |
| Кількість вікон | UF_WINDOWS_COUNT | integer |
Інтеграція через 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, }); } Що входить в інтеграцію
- Документація по API та мапінгу полів
- Доступи до webhook-обробника та FTP/хостингу
- Навчання менеджерів роботі з новими полями
- Тестування 3-х сценаріїв (квіз → лід → активність)
- Гарантійна підтримка 6 місяців
Процес та вартість
- Аналіз структури квізу та вимог до полів CRM.
- Створення користувацьких полів у Бітрікс24 (через REST або інтерфейс).
- Розробка webhook-обробника або REST-скрипта для прийому даних.
- Налаштування мапінгу питань → поля ліда.
- Створення автоматичного завдання-активності (дзвінок через 2 години).
- Тестування повного сценарію: заповнення квізу → поява ліда в CRM.
- Документація та передача доступів.
Базовий webhook (один квіз-сервіс, 3 поля відповіді, без UTM) — від 3 до 7 днів, вартість від 15 000 грн. Повне налаштування (кастомні поля, активність, UTM, кілька квізів) — 1–2 тижні, від 30 000 грн. Економія від автоматизації складає до 15 000 грн щомісяця за рахунок зниження витрат на ручну обробку. Надішліть запит на оцінку вашого проєкту — підготуємо комерційну пропозицію протягом дня.