К содержанию

Вебхуки: ответы в CRM и на ваш сервер

Каждый законченный ответ сразу уходит на ваш адрес, с повторами и журналом.

Вебхуки есть в тарифе «Корпоративный». Откройте опрос, «Параметры» → раздел «API» → карточка «Вебхуки» → «Настроить». На других тарифах страница покажет, что это даёт, и ссылку на тариф.

Как настроить

  1. Вставьте адрес (http или https), куда отправлять ответы: ваш сервер, CRM, Zapier, Make, n8n или Albato.
  2. Включите «Отправлять ответы» и сохраните.
  3. Нажмите «Проверить»: на адрес уйдёт тестовый запрос (событие ping), и страница покажет, что ответил сервер.

Секретный ключ создаётся сам. Им подписан каждый запрос (заголовок X-Simpoll-Signature, HMAC-SHA256), так ваш сервер проверит, что запрос пришёл от simpoll. Ключ можно сменить, тогда обновите его и у себя. Пример проверки подписи на Node.js и PHP есть на самой странице.

Что приходит

POST-запрос с JSON: название и адрес опроса, ответы на вопросы, имя и почта респондента, параметры ссылки (например, utm или id клиента), результат теста, а если человек пришёл по приглашению, данные приглашения. Отсеянные квотой ответы не отправляются.

Если сервер не ответил

Успешной считается отправка с кодом 2xx за 10 секунд. Иначе simpoll повторит её через минуту, 10 минут, час, 4 и 12 часов. Журнал показывает последние 20 отправок (время московское), неудачную можно повторить кнопкой. Адреса внутренней сети не принимаются, переадресации не выполняются.

Частые вопросы

Чем вебхуки отличаются от старого API?

Старый API есть на тарифах с API и передаёт ответы один раз в старом формате. Вебхуки отправляют JSON с подписью, повторяют неудачные отправки и ведут журнал.

Что будет, если тариф закончится?

Отправки остановятся: в журнале они будут отмечены как недоставленные из-за тарифа. После продления новые ответы снова пойдут.

Не нашли ответ?

Напишите нам, ответим и поможем разобраться.

Написать в поддержку