Webhooks Overview

Webhooks allow you to receive real-time notifications when events occur in Voxifi, enabling integration with your systems.

What Are Webhooks?

Webhooks are HTTP callbacks:

1. Event occurs in Voxifi (e.g., call ends)
2. Voxifi sends HTTP POST to your URL
3. Your server processes the event
4. Your system updates accordingly

Use Cases

Use Case	Events to Subscribe
CRM Updates	call.completed
Real-time Dashboards	call.started, call.ended
Call Analysis	call.completed (includes transcript and sentiment)
Error Monitoring	call.failed

How It Works

Voxifi ────► Your Webhook URL ────► Your System
         POST request with              Process and
         event payload                  take action

Quick Example

When a call completes, you might receive:

{
  "event_type": "call.completed",
  "event_id": "evt_abc123",
  "timestamp": "2024-01-15T10:35:00Z",
  "organization_id": "org_xyz",
  "data": {
    "call_id": "call_abc123",
    "duration_seconds": 125,
    "status": "completed",
    "cost": 0.45,
    "currency": "USD"
  }
}

Getting Started

1. Create Endpoint - Set up a URL that accepts POST requests
2. Configure Webhook - Go to Integrations > Webhooks in the console
3. Select Events - Choose which events to receive
4. Verify - Test with a sample event

Security

Webhooks include a signature for verification:

• HMAC-SHA256 signature in the X-Webhook-Signature header
• Verify to ensure requests are from Voxifi
• Reject unsigned or invalid requests

See Webhook Security for implementation.

Reliability

Voxifi ensures delivery:

• Automatic retries on failure with exponential backoff
• Dead letter queue for persistent failures
• Per-endpoint rate limiting (10 requests/minute by default)
• Delivery status tracking

Next Steps

• Creating Endpoints - Set up your first webhook
• Event Types - Available events