> ## Documentation Index
> Fetch the complete documentation index at: https://api.zenedu.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Доставка и повторы

> Как Zenedu доставляет вебхуки, повторяет неудачные попытки и отключает неработающие адреса

## Успешная доставка

Доставка считается успешной, если ваш сервер ответил статусом `2xx` в течение 3 секунд.

Доставка считается неудачной, если:

| Ситуация | Что сделать |
| - | - |
| Ответ `4xx` или `5xx` | Проверьте логи обработчика. `404` и `405` обычно значат неверный путь или метод, `401`, `403` и `419` — авторизацию или CSRF-защиту |
| Нет ответа за 3 секунды | Отвечайте сразу, а событие обрабатывайте в фоновой очереди |
| Не удалось подключиться | Проверьте, что адрес доступен из интернета, а DNS и файрвол пропускают запросы |
| Ошибка TLS | Используйте действующий сертификат от доверенного центра сертификации. Самоподписанные сертификаты не принимаются |

## Повторные попытки

После неудачной доставки Zenedu повторяет её с увеличивающимися интервалами — от минуты до суток — в течение примерно двух суток. Каждая повторная попытка приходит с тем же телом, тем же `_id` и той же подписью.

Как только адрес ответит `2xx`, повторы этой доставки прекращаются. Другие события продолжают отправляться независимо от того, сколько попыток осталось у предыдущих.

## Автоматическое отключение

Если все повторные попытки не удались и за последние 96 часов на этот адрес не было ни одной успешной доставки, Zenedu отключает вебхук. В **Настройки → Проект → API и вебхуки** у такого вебхука появляется отметка о том, с какой даты он не отправляется. Если вебхук принадлежит автоматизации, она останавливается вместе с ним.

Пока вебхук отключён, события на него не отправляются и позже не досылаются. Когда адрес снова заработает:

1. Отправьте [тестовый вебхук](https://api.zenedu.io/ru/api-reference/webhooks/test.md) и убедитесь, что адрес отвечает `2xx`.
2. Включите вебхук в кабинете или через [Включить вебхук](https://api.zenedu.io/ru/api-reference/webhooks/activate.md). Вебхук автоматизации включается вместе с автоматизацией.
3. Восстановите пропущенные данные через API, например [список заказов](https://api.zenedu.io/ru/api-reference/orders/list.md) за период отключения.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.