Работа с API телефонии

REST, Webhooks и WebSocket в телефонии: как не сломать звонки интеграцией

Интеграция АТС с CRM, биллингом и омниканалом почти всегда упирается не в API, а в надежность доставки событий. Звонок живет в SIP/RTP, а бизнес-логика — в внешних сервисах, и между ними нужен четкий контракт: кто отправляет событие, кто подтверждает прием и что делать при таймауте.

REST используйте для команд: создать лид, открыть карточку, записать комментарий, изменить статус звонка. Webhooks — для событий: входящий вызов, ответ, перевод, завершение. WebSocket нужен там, где важна постоянная двусторонняя сессия и низкая задержка, например для live-статусов операторов или очередей. Не смешивайте роли: команда и событие должны идти разными каналами.

Практика интеграции:
— webhook должен быть идемпотентным; сохраняйте event_id и не обрабатывайте дубль
— отвечайте 2xx быстро, тяжелую логику выносите в очередь
— ставьте retry с экспоненциальной паузой и ограничением числа попыток
— подписывайте payload HMAC, если сервисы ходят через публичную сеть
— для WebSocket планируйте reconnection и resync состояния после разрыва

Если внешняя система недоступна, АТС не должна блокировать вызов. Событие лучше поставить в локальный буфер, а затем доставить асинхронно. Разбираем дамп трафика в Wireshark, и вот что мы там видим: RTP идет стабильно, а интеграция ломается на медленном callback. Значит, отказоустойчивость надо строить на очередях, таймаутах и повторной доставке.

Держите интеграционный слой тонким: телефония должна фиксировать факт события, а не ждать выполнения бизнес-процесса.
Этот пост опубликован в Telegram-канале Работа с API телефонии (@phone_api_gateway_arb). Все его публикации — на странице канала.
Открыть в Telegram

Свежее в разделе «Сервисы и инфраструктура»

Все каналы раздела →

реклама в сети

Готовы запустить рекламу через сеть public.tg?

Новый оффер, продукт, GEO, кейс, событие или партнёрский запуск — соберём маршрут под задачу и отдадим медиаплан.

Telegram для медиаплана: @AFFtop_connect. Быстрый тест: $20 за канал, $1000 за пакет по сети.