Исходящие вебхуки: как это работает
Вебхук — это сообщение, которое система отправляет на указанный вами адрес в момент события: нового лида, отправки счёта, получения оплаты или оформления заказа. Внешняя система может реагировать сразу, а не опрашивать вас снова и снова.
Урок 3 из 9 · Как это работает
Как это работает
На странице «System → Integrations → Integrations & API» нажмите «Add endpoint» в панели «Webhook endpoints». Введите название и адрес, затем отметьте «All events» или выберите отдельные события из списка.
После сохранения один раз показывается «Webhook signing secret». Скопируйте его в принимающую систему: с его помощью она проверяет, что сообщение действительно пришло с вашего сайта.
Когда происходит событие, на которое оформлена подписка, система сразу отправляет данные на этот адрес. Получатель должен ответить об успехе в течение 10 секунд.
Неудачная отправка повторяется через 1 минуту, 5 минут, 30 минут, 2 часа, 12 часов и 24 часа. После этого она помечается как неудачная.
Конечную точку, которая не ответила 25 раз подряд, система отключает, а на панели управления появляется задача. Когда получатель снова заработает, нажмите «Enable» в её строке.
Кнопка «Test» в строке или «Send test event» на странице конечной точки отправляет тестовое сообщение. На странице конечной точки также видны последние отправки, а кнопка «Rotate secret» заменяет секрет.
«Delivery log» показывает каждую отправку со статусом, конечной точкой и событием, отправленным содержимым и полученным ответом. «Retry now» повторяет неудачную отправку. Записи хранятся 30 дней.
Где это найти
- System → Integrations → Integrations & API
/admin/integrations - Integrations & API → Delivery log
/admin/integrations/deliveries - System → Automations
/admin/automations
Настройки, которые на это влияют
- Apps & modules (Automation & integrations)
/admin/apps
Чек-лист
Прежде чем идти дальше, проверьте, что вы умеете:
- Открыть System → Integrations → Integrations & API
- На странице System → Integrations → Integrations & API нажмите Add endpoint в панели Webhook endpoints.
- После сохранения один раз показывается Webhook signing secret.
- Когда происходит событие, на которое оформлена подписка, система сразу отправляет данные на этот адрес.
- Неудачная отправка повторяется через 1 минуту, 5 минут, 30 минут, 2 часа, 12 часов и 24 часа.
Советы и частые ошибки
- Ничего не приходит? Откройте журнал доставки и прочитайте ответ в строке с ошибкой. Обычные причины — неверный адрес или получатель, который отвечает дольше 10 секунд.
- После повтора одно и то же сообщение может прийти несколько раз. Принимающая система должна по ID доставки отбрасывать повторы.
- После «Rotate secret» уже следующее сообщение подписывается новым секретом, поэтому обновите принимающую систему в тот же момент.
- Повторы отправляет фоновый обработчик. Пока он остановлен, неудачные отправки не повторяются.