Проекты. Webhook при поступлении анкет
Webhook — механизм получения уведомлений при поступлении анкет.
Настроить Webhook можно при создании как классического проекта, так и с точками опроса на первом Шаге создания.
При настройке необходимо указать URL и параметры. Также можно настроить Лог на почту. Если указать e-mail каждый день будет приходить лог за прошедшие сутки.
Внести изменения в Webhook можно и в настройках проекта, когда проект уже отправлен в работу.
Общая схема
- При получении анкеты на сайт, происходит отправка GET запроса на заданный URL c указанными параметрами.
- Каждая отправка GET запроса на заданный URL записывается в лог, который хранится сутки и отправляется на заданный e-mail или удаляется.
Задание параметров URL
- в каждом запросе будут переданы следующие служебные параметры:
| Имя параметра | Значение |
|---|---|
| SF_Result | 0 - Завершающий в скрининге, 1 - Целевая анкета, 2 - Не подходит по квотам |
| SF_ID | GUID анкеты |
- так же, если в указанном URL есть какие-то параметры, то они ретраслируются дальше. (условно: www.ya.ru/?APIKEY="ABCDEFG" - так же передается дальше)
- дополнительно URL может быть дополнен параметрами, схема задания: ID вопроса через запятую, пробелы игнорируются, например: Q1, Q2, Q34
- если получен код вопроса, которого нет в анкете (или неподдерживаемый тип) - этот параметр игнорируется и не передается
- поддерживаемые типы вопросов:
| Тип вопроса | Возвращается | Комментарии |
|---|---|---|
| Текст | значение открытого вопроса | запрещеннные символы в ответе #, &, = |
| Диапазон | код ответа | |
| Число | значение | |
| Выбор вариантов, уточняющий | коды ответов через запятую без пробелов, значение "другое" - не передается, только коды | |
| Ранг | не передается | |
| Сетка | не передается | |
| Дата | дату | |
| Шкала | значение шкалы |
Пример:
где arg="Проект SimpleForms" - произвольные аргументы, которые будут переданы как есть
Q1,Q2,Q3 - коды вопросов, будут переданы их значения
user@example.com - почта, на которую будет отправлен Лог.
На почту будет отправлено сообщение с текстовым файлом (логом), в котором будет содержаться информация о выполнении Webhook.
Пример одной строки:
При обработке анкеты #24, идентификатор '439b8ed6-61fe-4cd4-871c-8g25dfd91cfe' произведена загрузка страницы 'https://example.com/exec?arg="Проект SimpleForms"&Q1=1&Q2=2&Q3=3&SF_ID=439b8ed6-61fe-4cd4-871c-8g25dfd91cfe&SF_Result=1'.