Интеграция Webhooks

Как работает WebHook?

QuizGO отправляет POST запрос на указанный вами url в настройках. Данные отправляются в виде JSON строки, они доступны в $_REQUEST['quizgo_data'] или $_POST['quizgo_data']

Ниже представлен PHP код, показывающий как можно получить информацию на вашей стороне:

<?php

$quizGoLead = json_decode($_REQUEST['quizgo_data']);

echo 'ИД квиза с которого пришел лид: ' . $quizGoLead->quiz->id . "\n";
echo 'Название квиза с которого пришел лид: ' . $quizGoLead->quiz->name . "\n";

// получим контакты лида

echo 'Имя: ' . $quizGoLead->lead->contact->name. "\n";
echo 'Телефон: ' . $quizGoLead->lead->contact->phone . "\n";
echo 'Имейл: ' . $quizGoLead->lead->contact->email . "\n";

// получим первый вопрос и ответ на него

echo 'Первый вопрос: ' . $quizGoLead->lead->answers[0]->question->title. "\n";
echo 'Ответ на первый вопрос: ' . $quizGoLead->lead->answers[0]->answer[0]->title . "\n";

// получим все вопросы и ответы квиза

foreach ($quizGoLead->lead->answers as $answ) {
    echo 'Вопрос: ' . $answ->question->title. "\n";
    foreach ($answ->answer as $a) {
        echo 'Ответ на вопрос: ' . $a->title . "\n";
    }
}

 
Ниже показан подробный JSON, который QuizGO отправляет через WebHook:

{
  "quiz": {
    // ид квиза с которого пришел лид
    "id": 116, 
    // название квиза с корого пришел лид
    "name": "Опрос для клиентов QuziGO"
  },
  "project": {
    // ид проекта с которого пришел лид
    "id": 33,
    // название проекта с которого пришел лид
    "name": "QuizGo"
  },
  "company": {
    // ид компании с которой пришел лид
    "id": 16,
    // название компании с которой пришел лид
    "name": "QuizGO"
  },
  "lead": {
    // ид лида
    "id": 2178,
    // заголовок лида
    "title": "Заявка: Опрос для клиентов QuziGO",
    // дата создания лида
    "created_at": "2019-08-31T15:20:55.000000Z",
    "contact": {
      // имя контакта
      "name": "Иван Иванов",
      // телефон 
      "phone": "+7 (999) 111-22-33",
      // имейл
      "email": "example@mail.ru"
    },
    // UTM метки
    "utm": {
      "source": "yandex",
      "medium": "cpc",
      "campaign": "cid|43305199|context",
      "content": "gid|3821312231|aid|7505688924|16794641360_",
      "term": "test quizgo"
    },
    // ответы на вопросы в виде массива
    "answers": [
      {
        "question": {
          // название вопроса
          "title": "Как вы работаете?",
          // тип вопроса
          "type": "radio"
        },
        // ответы на вопрос, в виде массива, 
        // так как ответов может быть несколько
        "answer": [
          {
            // значение ответа
            "title": "Веб-студия"
          }
        ]
      },
      // пример вопроса, где может быть несоклько ответов
      {
        "question": {
          "title": "Тестовый вопрос типа карточка с картинкой (множественный выбор)",
          "type": "cards_checkbox"
        },
        "answer": [
          {
            "title": "1 - Вариант ответа 1"
          },
          {
            "title": "2 - Вариант ответа 2"
          },
          {
            "title": "3 - Вариант ответа 3"
          }
        ]
      },
    ]
  }
}

Если у вас есть предложения по улучшению функционала, пишите нам в чат поддержки. Вместе мы сделаем лучший конструктор квиз-опросов.