Webhook-связка ломается не там, где код, а там, где не продумали сценарий

Webhook-связка ломается не там, где код, а там, где не продумали сценарий

Webhook — это не «передать данные», а цепочка с тремя точками отказа: отправитель, транспорт, обработчик. Если в одном месте нет контроля, связка начинает терять события, дублировать их или молча падать. Поэтому проверяйте не только URL, но и логику вокруг него.

Перед запуском проверьте базовый минимум:
— есть ли у payload уникальный id события;
— принимает ли обработчик повторный запрос без дублей;
— что происходит при таймауте, ошибке 4xx/5xx и пустом ответе;
— есть ли очередь или ретрай, если сервис временно недоступен.

Отдельная ошибка — слать в webhook «всё подряд». Лучше отправлять только нужные поля и сразу нормализовать структуру: даты, валюты, статусы, телефоны. Чем меньше преобразований после получения, тем меньше шанс сломать связку на ровном месте.

И еще один практический момент: всегда делайте тест на повторную отправку одного и того же события. Если система создает две сделки, две задачи или два платежа, значит, идемпотентность не настроена. Именно этот тест чаще всего экономит часы ручной чистки.

Если webhook нужен для бизнеса, относитесь к нему как к контракту: зафиксируйте формат, ошибки и поведение при повторе. Тогда связка будет жить долго и без сюрпризов.