Webhooks

Receive real-time notifications about events in your AI Workers account

Available Events

  • conversation.started - When a new conversation begins
  • conversation.ended - When a conversation ends
  • appointment.booked - When an appointment is scheduled
  • appointment.cancelled - When an appointment is cancelled
  • message.received - When a customer sends a message
  • call.completed - When a voice call ends

Webhook Payload

{
  "event": "appointment.booked",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "appointmentId": "uuid",
    "customerName": "John Doe",
    "scheduledAt": "2025-01-20T14:00:00Z",
    "service": "Consultation"
  }
}

Security

Webhook requests include a signature header that you can verify to ensure the request is from AI Workers. Always verify webhook signatures in production.