Skip to main content

Webhooks

The AI Front Office sends webhook events for key activities. Use these to integrate with your CRM, notification system, or custom workflows.

Available Events​

call.received​

Fired when a new call comes in.

{
  "event": "call.received",
  "timestamp": "2026-03-15T14:30:00Z",
  "data": {
    "call_id": "call_abc123",
    "from": "+16015551234",
    "to": "+16016404037",
    "direction": "inbound",
    "status": "in_progress"
  }
}

call.completed​

Fired when a call ends.

{
  "event": "call.completed",
  "timestamp": "2026-03-15T14:35:00Z",
  "data": {
    "call_id": "call_abc123",
    "from": "+16015551234",
    "duration_seconds": 180,
    "recording_url": "https://...",
    "transcription": "Customer asked about...",
    "outcome": "appointment_booked"
  }
}

appointment.booked​

Fired when an appointment is scheduled during a call.

{
  "event": "appointment.booked",
  "timestamp": "2026-03-15T14:33:00Z",
  "data": {
    "appointment_id": "apt_xyz789",
    "customer_phone": "+16015551234",
    "service_type": "consultation",
    "scheduled_at": "2026-03-17T10:00:00Z",
    "duration_minutes": 30
  }
}

sms.received​

Fired when an inbound SMS is received.

{
  "event": "sms.received",
  "timestamp": "2026-03-15T15:00:00Z",
  "data": {
    "message_id": "msg_def456",
    "from": "+16015551234",
    "to": "+16016404037",
    "body": "Yes, I'd like to schedule for Tuesday"
  }
}

Configuration​

Webhook URLs are configured during onboarding. Contact support to add or modify webhook endpoints.

Security​

All webhook payloads are signed with a shared secret. Verify the X-Webhook-Signature header to ensure authenticity.

Retry Policy​

Failed deliveries are retried 3 times with exponential backoff (5s, 30s, 5min). After 3 failures, the event is logged but not retried.