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

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

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

​
Отладка

1

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

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

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

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

Логирование

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

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

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

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

Проверьте статус вебхука в настройках колл-листа. Если активен, но события всё равно не приходят — напишите в поддержку. Проверьте по списку перед тем как писать в поддержку:
  • Вебхук активен (статус active)
  • Ваш сервер работает и доступен извне
  • Выбран правильный тип события: lead_only для Telegram/Email/MAX; call_session_result для CRM в визарде; call_result / lead_only для API
  • Для lead_only: звонки завершаются с подтвержденной договоренностью
  • Нет ошибок в логах вашего сервера
Если всё в порядке, но события всё равно не приходят — напишите в поддержку.