Интеграция АТС с CRM, биллингом и омниканалом почти всегда упирается не в API, а в надежность доставки событий. Звонок живет в SIP/RTP, а бизнес-логика — в внешних сервисах, и между ними нужен четкий контракт: кто отправляет событие, кто подтверждает прием и что делать при таймауте.
REST используйте для команд: создать лид, открыть карточку, записать комментарий, изменить статус звонка. Webhooks — для событий: входящий вызов, ответ, перевод, завершение. WebSocket нужен там, где важна постоянная двусторонняя сессия и низкая задержка, например для live-статусов операторов или очередей. Не смешивайте роли: команда и событие должны идти разными каналами.
Практика интеграции:
— webhook должен быть идемпотентным; сохраняйте event_id и не обрабатывайте дубль
— отвечайте 2xx быстро, тяжелую логику выносите в очередь
— ставьте retry с экспоненциальной паузой и ограничением числа попыток
— подписывайте payload HMAC, если сервисы ходят через публичную сеть
— для WebSocket планируйте reconnection и resync состояния после разрыва
Если внешняя система недоступна, АТС не должна блокировать вызов. Событие лучше поставить в локальный буфер, а затем доставить асинхронно. Разбираем дамп трафика в Wireshark, и вот что мы там видим: RTP идет стабильно, а интеграция ломается на медленном callback. Значит, отказоустойчивость надо строить на очередях, таймаутах и повторной доставке.
Держите интеграционный слой тонким: телефония должна фиксировать факт события, а не ждать выполнения бизнес-процесса.
Работа с API телефонии
@phone_api_gateway_arb
REST, Webhooks и WebSocket в телефонии: как не сломать звонки интеграцией
Этот пост опубликован в Telegram-канале Работа с API телефонии (@phone_api_gateway_arb). Все его публикации — на странице канала.
Открыть в Telegram