​
Рекомендации

Отвечайте быстро. Верните 200 OK в течение 10 секунд. Если обработка занимает больше — примите запрос, положите в очередь, обработайте асинхронно. Обрабатывайте повторы. Одно событие может прийти дважды. Сохраняйте id события и проверяйте дубликаты перед обработкой. Всегда проверяйте подпись. Особенно на продакшене — это защита от поддельных запросов. Подробнее — в разделе Безопасность и подпись. Логируйте всё входящее. Сохраняйте сырые запросы целиком — заголовки и тело. Это сильно упрощает отладку и аудит.

​
Распространённые ошибки

КодЧто значитЧто делать
400 Bad RequestНекорректные данныеПроверьте тело запроса и параметры
403 ForbiddenСервер недоступенПроверьте файрвол и настройки сервера
404 Not FoundURL не найденПроверьте правильность адреса
5xx Server ErrorОшибка на вашем сервереСмотрите логи своего сервера
TimeoutСервер не ответил за 10 секундВыносите обработку в фоновую очередь

​
Отладка

1

Тестовый запрос

Отправьте фиктивное событие через POST /api/call-lists/{callListId}/webhooks/test не дожидаясь реальных звонков
2

Локальная разработка

Используйте ngrok или localtunnel чтобы получить публичный URL для локального сервера
3

Логирование

Логируйте все входящие запросы включая заголовки и тело
4

Проверка подписи

Убедитесь что подпись корректно вычисляется вашим обработчиком

​
Если события пропадают

Проверьте статус вебхука в настройках колл-листа. Если активен, но события всё равно не приходят — напишите в поддержку.
  • Вебхук активен (статус active)
  • Ваш сервер работает и доступен извне
  • Выбран правильный тип события для вашего типа назначения
  • Для lead_only: звонки завершаются с подтвержденной договоренностью
  • Нет ошибок в логах вашего сервера