Результаты

Интеграции: Битрикс24 и вебхук

Как отправлять заявки из квиза в Битрикс24 или на свой вебхук

Обновлено 2026-09-03

Новые заявки можно сразу отправлять в CRM. Настройка одна на команду и работает для всех её квизов. Подключают владелец и администраторы: кабинет → Интеграции.

Заявка отправляется сразу после того, как посетитель нажал «Отправить». Если CRM не ответила, QuizAI повторит попытку ещё два раза. Заявка в любом случае остаётся в разделе «Лиды». Результат последней отправки виден на странице «Интеграции».

Битрикс24

Каждая заявка становится лидом в CRM.

В Битрикс24 откройте Приложения → Разработчикам → Другое → Входящий вебхук.
В правах доступа отметьте CRM и сохраните.
Скопируйте адрес вебхука вида https://ваш-портал.bitrix24.ru/rest/1/код/.
В QuizAI: Интеграции → Битрикс24, вставьте адрес и нажмите «Подключить».
Нажмите «Отправить тестовую заявку» и проверьте, что в CRM появился лид.

Что попадает в лид:

Поле Битрикс24	Что в нём
Название	«Заявка с квиза «название квиза»»
Имя, телефон, email	Контакты из формы
Комментарий	Вопросы и ответы, адрес страницы
Источник	«Веб-сайт», в описании — название квиза
UTM-метки	`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`, `utm_term`

Адрес вебхука работает как пароль к вашей CRM. QuizAI хранит его в зашифрованном виде и показывает только владельцу и администраторам.

Вебхук

Для своей CRM, Make, n8n или скрипта на сервере. На каждую заявку QuizAI отправляет POST с телом в JSON на ваш адрес. Адрес должен начинаться с https://.

{
  "event": "lead.created",
  "id": 123,
  "createdAt": "2026-10-21T12:00:00+03:00",
  "quiz": { "id": "01m1c7ycvgcxfxye93hqwbz5m4", "title": "Расчёт доставки" },
  "contact": { "name": "Иван", "phone": "+79001112233", "email": "ivan@example.com" },
  "answers": [
    { "question": "Что нужно привезти?", "answer": "Оборудование" }
  ],
  "source": {
    "pageUrl": "https://example.com/?utm_source=yandex",
    "referrer": "https://yandex.ru/",
    "utm": { "source": "yandex" }
  },
  "url": "https://quizai.pro/komanda/leads"
}

Заявка, отправленная кнопкой «Отправить тестовую заявку», приходит с полем "test": true.

Ответ с кодом 2xx считается успешным. На ошибки сервера (5xx) и недоступность QuizAI повторяет запрос ещё два раза. Перенаправления (3xx) не выполняются.

Проверка подписи

Чтобы убедиться, что запрос пришёл от QuizAI, проверьте заголовок X-QuizAI-Signature. В нём sha256= и HMAC-SHA256 тела запроса, где ключ — секрет со страницы «Интеграции».

$expected = 'sha256='.hash_hmac('sha256', file_get_contents('php://input'), $secret);

if (! hash_equals($expected, $_SERVER['HTTP_X_QUIZAI_SIGNATURE'] ?? '')) {
    http_response_code(401);
    exit;
}

Другие заголовки: X-QuizAI-Event: lead.created и X-QuizAI-Delivery — уникальный id попытки.

Персональные данные

В заявке есть персональные данные посетителя. Вы как оператор решаете, куда их передавать. Если CRM или сервер находятся за рубежом, это трансграничная передача: её нужно указать в вашей политике обработки персональных данных.