Webhook-интеграция создает общий HTTPS-адрес назначения, который можно назначить нескольким агентам. Айва отправляет события по модели at-least-once, поэтому получатель должен уметь безопасно обрабатывать повторы.
POSTcall_event_id или Idempotency-KeyX-Aiva-Signature-256Integrations -> Вебхуки -> Добавить вебхук.Название.Webhook URL.Секрет подписи и сохраните его во внешней системе.Сменить секрет.Проверить интеграцию, чтобы отправить тестовую доставку.2xx, чтобы подтвердить доставку.Полезная нагрузка включает служебные поля и бизнес-данные разговора, в том числе:
event и versioncall_event_id, delivery_id, call_history_idoccurred_at, sent_at, attemptsummarycustomer_snapshotbusiness_payloadСреди заголовков особенно важны:
Idempotency-KeyX-Aiva-EventX-Aiva-Event-IdX-Aiva-Delivery-IdX-Aiva-TimestampX-Aiva-Signature-256Каждый агент использует один общий webhook из командного каталога.
Title: CRM intake webhook
Webhook URL: https://hooks.example.com/aiva/call-completed
call_event_id или Idempotency-Key для дедупликации<timestamp>.<raw_body> через общий секрет