Вебхуки: ответы в CRM и на ваш сервер
Каждый законченный ответ сразу уходит на ваш адрес, с повторами и журналом.
Вебхуки есть в тарифе «Корпоративный». Откройте опрос, «Параметры» → раздел «API» → карточка «Вебхуки» → «Настроить». На других тарифах страница покажет, что это даёт, и ссылку на тариф.
Как настроить
- Вставьте адрес (http или https), куда отправлять ответы: ваш сервер, CRM, Zapier, Make, n8n или Albato.
- Включите «Отправлять ответы» и сохраните.
- Нажмите «Проверить»: на адрес уйдёт тестовый запрос (событие ping), и страница покажет, что ответил сервер.
Секретный ключ создаётся сам. Им подписан каждый запрос (заголовок X-Simpoll-Signature, HMAC-SHA256), так ваш сервер проверит, что запрос пришёл от simpoll. Ключ можно сменить, тогда обновите его и у себя. Пример проверки подписи на Node.js и PHP есть на самой странице.
Что приходит
POST-запрос с JSON: название и адрес опроса, ответы на вопросы, имя и почта респондента, параметры ссылки (например, utm или id клиента), результат теста, а если человек пришёл по приглашению, данные приглашения. Отсеянные квотой ответы не отправляются.
Битрикс24: ответы как лиды
Вместо своего сервера можно вставить адрес входящего вебхука Битрикс24. Тогда каждый законченный ответ создаёт в CRM лид: имя, почта, телефон (если в опросе есть вопрос про телефон), все ответы в комментарии, метки utm_* из ссылки в поля UTM, источник «Веб-сайт».
- В Битрикс24 откройте «Приложения» → «Разработчикам» → «Другое» → «Входящий вебхук».
- В настройке прав отметьте CRM (crm) и сохраните.
- Скопируйте адрес вебхука (вида https://ваш-портал.bitrix24.ru/rest/1/…/) в поле «Адрес» и сохраните.
- Нажмите «Проверить»: в CRM появится лид «Проверка связи с Simpoll», его можно удалить.
Если CRM портала работает в простом режиме (без лидов), Битрикс24 сам превращает лид в сделку: ответ появится в разделе «Сделки».
Адрес вебхука содержит ключ доступа к порталу: не публикуйте его. Повторы и журнал работают так же, как для обычного вебхука.
amoCRM: ответы как сделки
В поле «Адрес» можно вставить адрес аккаунта amoCRM (например, https://ваша-компания.amocrm.ru), а в поле «Долгосрочный токен amoCRM» токен интеграции. Тогда каждый законченный ответ создаёт сделку с тегом Simpoll и контактом (имя, почта, телефон, если в опросе есть вопрос про телефон), а все ответы, метки из ссылки и ссылка на ответ приходят примечанием к сделке.
- В amoCRM откройте «amoМаркет», нажмите «⋯» справа вверху и выберите «Создать интеграцию» → «Внешняя интеграция».
- Заполните короткую форму: название (например, Simpoll), доступ к данным аккаунта. Сохраните.
- В интеграции откройте вкладку с ключами, нажмите «Сгенерировать токен», выберите срок (до 5 лет) и сразу скопируйте токен: второй раз amoCRM его не покажет.
- В simpoll вставьте адрес аккаунта и токен и сохраните.
- Нажмите «Проверить»: в amoCRM появится сделка «Проверка связи с Simpoll», её можно удалить.
Токен даёт доступ к аккаунту amoCRM: не публикуйте его. Когда срок токена закончится, сгенерируйте новый и сохраните его на странице «Вебхуки».
Если сервер не ответил
Успешной считается отправка с кодом 2xx за 10 секунд. Иначе simpoll повторит её через минуту, 10 минут, час, 4 и 12 часов. Журнал показывает последние 20 отправок (время московское), неудачную можно повторить кнопкой. Адреса внутренней сети не принимаются, переадресации не выполняются.
Частые вопросы
Чем вебхуки отличаются от старого API?
Старый API есть на тарифах с API и передаёт ответы один раз в старом формате. Вебхуки отправляют JSON с подписью, повторяют неудачные отправки и ведут журнал.
Что будет, если тариф закончится?
Отправки остановятся: в журнале они будут отмечены как недоставленные из-за тарифа. После продления новые ответы снова пойдут.
Битрикс24 ответил 401, что делать?
У входящего вебхука нет прав CRM (crm) или его удалили. Откройте вебхук в Битрикс24, отметьте CRM и сохраните, затем снова нажмите «Проверить».
amoCRM не принимает токен, что делать?
Токен истёк, его отозвали или у интеграции нет доступа к данным аккаунта. Сгенерируйте новый долгосрочный токен в amoCRM, вставьте его на странице «Вебхуки», сохраните и нажмите «Проверить».