Вебхуки звонков: проблемы и решения

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

Шаги

1. 1

   Не приходит ни одно событие звонка

   Проверьте, что в вебхуке отмечены события раздела «Calls» («Edit»). Адрес должен быть HTTPS и открываться из интернета. Если Ваш сервер отвечает 4xx, повтора нет: посмотрите логи сервера. При 5xx или таймауте Clomni повторяет отправку, всего до 5 попыток.

2. 2

   Подпись не совпадает

   Считайте её от исходного тела запроса, не собирая JSON заново. Секретный ключ в окне редактирования вебхука, ключ другого вебхука не подойдёт. Подписывается строка <X-ChatX-Timestamp>.<тело>.

3. 3

   Одно и то же событие пришло дважды

   Это повторная отправка: в первый раз Ваш сервер не ответил вовремя. Не обрабатывайте один и тот же delivery_id дважды и отвечайте за 5 секунд.

4. 4

   call_ended пришёл, а call_answered нет

   На звонок не ответили, или call_answered ещё в пути. Порядок событий не гарантирован, упорядочивайте их по полям времени.

5. 5

   duration_seconds равно null

   На звонок не ответили. Или ответили на телефоне, а журнал звонков телефона не пришёл за 10 минут: тогда duration_known равно false. Журнал приходит только для номеров, подключённых по QR после 22 сентября 2026 года; помогает заново подключить старый номер по QR.

6. 6

   Не приходит call_recording_ready

   Запись есть только у звонков WhatsApp (QR) из панели и приложения и у звонков WhatsApp Business API, записанных в браузере. У звонка, на который ответили на телефоне, и у звонка Twilio записи нет.

7. 7

   summary равно null или пустой phone_number

   Краткое содержание готовится только для разговоров длиннее 10 секунд; если его не удалось сделать, оно null, а transcript всё равно приходит. Если contact.phone_number пустой, клиент скрывает номер в WhatsApp: узнавайте его по contact.id.