Перейти к содержимому
14 дней бесплатно, без карты9 языков176 типов бизнеса · 50 приложений
RU· USD
Попробовать живое демоПопробовать бесплатно

Исходящие вебхуки: как это работает

Вебхук — это сообщение, которое система отправляет на указанный вами адрес в момент события: нового лида, отправки счёта, получения оплаты или оформления заказа. Внешняя система может реагировать сразу, а не опрашивать вас снова и снова.

Урок 3 из 9 · Как это работает

  • около 3 мин
  • System → Integrations → Integrations & API

Как это работает

  1. На странице «System → Integrations → Integrations & API» нажмите «Add endpoint» в панели «Webhook endpoints». Введите название и адрес, затем отметьте «All events» или выберите отдельные события из списка.

  2. После сохранения один раз показывается «Webhook signing secret». Скопируйте его в принимающую систему: с его помощью она проверяет, что сообщение действительно пришло с вашего сайта.

  3. Когда происходит событие, на которое оформлена подписка, система сразу отправляет данные на этот адрес. Получатель должен ответить об успехе в течение 10 секунд.

  4. Неудачная отправка повторяется через 1 минуту, 5 минут, 30 минут, 2 часа, 12 часов и 24 часа. После этого она помечается как неудачная.

  5. Конечную точку, которая не ответила 25 раз подряд, система отключает, а на панели управления появляется задача. Когда получатель снова заработает, нажмите «Enable» в её строке.

  6. Кнопка «Test» в строке или «Send test event» на странице конечной точки отправляет тестовое сообщение. На странице конечной точки также видны последние отправки, а кнопка «Rotate secret» заменяет секрет.

  7. «Delivery log» показывает каждую отправку со статусом, конечной точкой и событием, отправленным содержимым и полученным ответом. «Retry now» повторяет неудачную отправку. Записи хранятся 30 дней.

Где это найти

Настройки, которые на это влияют

Чек-лист

Прежде чем идти дальше, проверьте, что вы умеете:

  • Открыть 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» уже следующее сообщение подписывается новым секретом, поэтому обновите принимающую систему в тот же момент.
  • Повторы отправляет фоновый обработчик. Пока он остановлен, неудачные отправки не повторяются.