Консоль
Интеграции

Вебхук

Доставка событий звонков Айвы во внешние системы

Webhook-интеграция создает общий HTTPS-адрес назначения, который можно назначить нескольким агентам. Айва отправляет события по модели at-least-once, поэтому получатель должен уметь безопасно обрабатывать повторы.

Что понадобится

  • HTTPS endpoint, который принимает POST
  • логика дедупликации по call_event_id или Idempotency-Key
  • обработка HMAC-подписи из X-Aiva-Signature-256

Как добавить webhook

  1. Откройте Integrations -> Вебхуки -> Добавить вебхук.
  2. Заполните Название.
  3. Укажите Webhook URL.
  4. Сохраните запись.

Что сделать после сохранения

  • На странице интеграции скопируйте Секрет подписи и сохраните его во внешней системе.
  • При необходимости ротируйте секрет кнопкой Сменить секрет.
  • Используйте Проверить интеграцию, чтобы отправить тестовую доставку.
  • Возвращайте любой статус 2xx, чтобы подтвердить доставку.

Что отправляет Айва

Полезная нагрузка включает служебные поля и бизнес-данные разговора, в том числе:

  • event и version
  • call_event_id, delivery_id, call_history_id
  • occurred_at, sent_at, attempt
  • summary
  • customer_snapshot
  • business_payload

Среди заголовков особенно важны:

  • Idempotency-Key
  • X-Aiva-Event
  • X-Aiva-Event-Id
  • X-Aiva-Delivery-Id
  • X-Aiva-Timestamp
  • X-Aiva-Signature-256

Как назначить агенту

  1. Откройте агента.
  2. В секции интеграций выберите общий webhook из каталога команды.
  3. Сохраните агента.

Каждый агент использует один общий webhook из командного каталога.

Безопасный пример

Title: CRM intake webhook
Webhook URL: https://hooks.example.com/aiva/call-completed

Если обработчик получает повторы

  • это нормальное поведение модели at-least-once
  • используйте call_event_id или Idempotency-Key для дедупликации
  • проверяйте подпись на строке <timestamp>.<raw_body> через общий секрет