Вебхуки звонков: доставка, повторы и дубликаты

Обновлено: 9 октября 2026 · 4 мин чтения

Шаги

1. 1

   Как отвечать

   Отвечайте 2xx в течение 5 секунд. Долгую работу (запись в CRM, загрузку файла записи) делайте после ответа, в своей очереди.

2. 2

   Когда отправка повторяется

   Clomni отправляет запрос снова, когда:

   • к Вашему серверу нельзя подключиться;
   • ответа нет 5 секунд;
   • ответ 429 или 5xx.

   Всего 5 попыток, с паузами 30 секунд, 1, 2 и 4 минуты. Ответ 4xx (например 400, 401, 404) считается окончательным, повтора нет.

3. 3

   Как распознать дубликат

   При повторе delivery_id не меняется, в заголовке X-ChatX-Delivery то же значение. Запоминайте его: если тот же delivery_id пришёл снова, это дубликат, не обрабатывайте его. Пара id и event тоже уникальна для звонка и работает так же.

4. 4

   После 5 попыток

   Если все 5 попыток не удались, это событие теряется. Поэтому call_ended снова несёт все данные звонка: даже без call_started звонок можно полностью записать по call_ended. Храните звонок по id и обновляйте его при каждом событии.