Skip to content
Dispatcher Docs

Vapi integration

Endpoint

Section titled “Endpoint”

POST https://app.hiredispatcher.com/api/webhooks/vapi

Setup Steps

Section titled “Setup Steps”
  1. In Vapi, open your assistant.
  2. Add Server URL tools/functions.
  3. Point tool calls to Dispatcher endpoint.
  4. Ensure assistantId is present in call.metadata.
  5. Enable webhook signing and send x-vapi-signature.

Authentication

Section titled “Authentication”
  • Required header: x-vapi-signature
  • Dispatcher rejects unsigned requests.

Supported Function Names

Section titled “Supported Function Names”
  • checkAvailability
  • bookAppointment
  • getServiceTypes
  • transferToHuman

Example Request

Section titled “Example Request”
{
  "message": {
    "type": "function-call",
    "functionCall": {
      "name": "bookAppointment",
      "parameters": {
        "date": "2026-03-15",
        "time": "09:00",
        "serviceType": "HVAC Repair",
        "customerName": "John Smith",
        "customerPhone": "+15551234567",
        "urgency": "routine"
      }
    },
    "call": {
      "id": "call_abc123",
      "metadata": { "assistantId": "asst_456" }
    }
  }
}

Example Response

Section titled “Example Response”
{
  "result": {
    "confirmed": true,
    "dispatchRequestId": "dsp_xyz789",
    "message": "Appointment booked for 2026-03-15 at 09:00."
  }
}

Testing

Section titled “Testing”

Run a live test call in Vapi and verify tool-call responses are returned synchronously.