Интеграция Webhooks

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

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

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

// если параметр "Тип WebHook" выбран POST multipart/form-data
// данные получаем так
$quizGoLead = json_decode($_REQUEST['quizgo_data']);

// если параметр "Тип WebHook" выбран POST JSON
// данные получаем так
$quizGoLead = json_decode(file_get_contents('php://input'));

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

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

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

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

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

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

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

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

// тест json
{
	"quiz": {
		// ид квиз-опроса в котором оставили заявку
		"id": 111,
		// название квиз-опроса в котором оставили заявку
		"name": "Заявка на пробный урок"
	},
	"project": {
		// ид проекта квиз-опроса в котором оставили заявку
		"id": 33,
		// название проекта квиз-опроса в котором оставили заявку
		"name": "QuizGo"
	},
	"company": {
		// ид компании квиз-опроса в котором оставили заявку
		"id": 16,
		// название компании квиз-опроса в котором оставили заявку
		"name": "QuizGO"
	},
	"lead": {
		// ид лида (зявки)
		"id": 1525890,
		// название лида формируется из названия квиза
		"title": "Заявка: Заявка на пробный урок",
		// дата создания
		"created_at": "2021-08-27T07:03:45.000000Z",
		"contact": {
			// имя лидя
			"name": "Юрий",
			// телефон лида
			"phone": "+7 (918) 971-40-96",
			// имейл лида
			"email": "dw@dwad.ru",
			// месенджер если выбрали
			"messenger": "Telegram",
			// контакт мессенджера
			"contact_messenger": "+7 (918) 971-40-96"
		},
		"utm": {
			// ютм метка utm_source
			"source": "",
			// ютм метка utm_medium
			"medium": "",
			// ютм метка utm_campaign
			"campaign": "",
			// ютм метка utm_content
			"content": "",
			// ютм метка utm_term
			"term": ""
		},
		// ответы на вопросы версии 1. Устарели. Но отправляются для старых интеграций.
		"answers": [
		// объект ответа
			{
			  // вопрос
			  "question": {
				// название вопроса
				"title": "Мне удобно заниматься в филиале",
				// тип вопроса
				"type": "radio"
			  },
			  // ответ
			  "answer": [
				{
				  // значение ответа
				  "title": "Митино"
				}
			  ]
			},
		]
  		// ответы на вопросы версии 2. Рекомендованы к использованию.
		"answers2": {
			"type": 2,
			// массив ответов на вопросы
			"value": [
				// объект ответа
				{
				// вопрос
				"question": {
				  // название вопроса
				  "title": "Мне удобно заниматься в филиале",
				  // тип вопроса
				  "type": "radio"
				},
				// ответы
				"answer": [
				  // ответ
				  "Митино"
				  ]
				}
			]
		},
		// роистат визит
		"roistat_visit": "376430",
		// ид сессии сервиса comagic
		"comagic_session_id": null,
		// Yandex Client ID
		"y_client_id": "16299773521055592381",
		// Google Client ID
		"g_client_id": "2038628577.1629910344",
		// Идентификатор клика в яндекс директ
		"yclid": null,
		// Идентификатор клика в google ads
		"gclid": null,
		// Идентификатор клика в фейсбуке
		"fbclid": null,
		// значение cookie _fbc из facebook pixel
		"fbc": null,
		// значение cookie _fbp из facebook pixel
		"fbp": "fb.1.1629477349720.1990085261",
		// значение дополнительных полей ***
		"custom_fields": Object
	}
}

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

Поделиться статьей: