Vapi integration

Endpoint

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

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

• Required header: x-vapi-signature
• Dispatcher rejects unsigned requests.

Supported function names

• checkAvailability
• bookAppointment
• getServiceTypes
• transferToHuman

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

{
  "result": {
    "confirmed": true,
    "dispatchRequestId": "dsp_xyz789",
    "message": "Appointment booked for 2026-03-15 at 09:00."
  }
}

Testing

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