Консоль
Integrations

Webhook

Deliver AIVA call events to external systems

Status: Available in the Integrations catalog.

The webhook integration creates a shared HTTPS destination that can be assigned to multiple agents. AIVA delivers events at-least-once, so the receiver must be able to handle duplicates safely.

What you need

  • an HTTPS endpoint that accepts POST
  • deduplication logic keyed by call_event_id or Idempotency-Key
  • HMAC validation for the X-Aiva-Signature-256 header

Add the webhook

  1. Open Integrations -> Webhooks -> Add webhook.
  2. Fill in Title.
  3. Set the Webhook URL.
  4. Save the record.

After saving

  • Copy the Signing secret on the detail page and store it in your receiver.
  • Rotate the secret whenever needed with Rotate secret.
  • Use Test integration to trigger a test delivery.
  • Return any 2xx status to acknowledge delivery.

What AIVA sends

The payload includes transport metadata and call business data, including:

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

Important headers include:

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

Assign it to an agent

  1. Open the agent.
  2. In its integrations section, choose the shared webhook from the team catalog.
  3. Save the agent.

Each agent uses one shared webhook from the team catalog.

Safe example

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

If your receiver gets duplicates

  • this is expected with at-least-once delivery
  • deduplicate with call_event_id or Idempotency-Key
  • verify the signature against the string <timestamp>.<raw_body> using the shared secret