Webhooks

Orbitali sends webhook events to an agent's Server URL while a call is active.

Events

Event	When it is sent
assistant-request	Before the call starts when an agent uses a dynamic prompt
tool-call	When the model requests one of the agent's tools

Assistant request

Use assistant-request to build the prompt and greeting from your own data.

{
  "type": "assistant-request",
  "call": {
    "id": "call_123",
    "from": "+15551234567",
    "to": "+15557654321"
  },
  "agent": {
    "id": "agent_123",
    "name": "Receptionist"
  }
}

Return the resolved prompt and optional greeting.

{
  "prompt": "You are the receptionist for Acme Clinic. Help callers book appointments.",
  "greeting": "Thanks for calling Acme Clinic. How can I help?"
}

Tool call

Use tool-call to execute a model-requested action.

{
  "type": "tool-call",
  "call": {
    "id": "call_123"
  },
  "tool": {
    "name": "check_availability",
    "arguments": {
      "date": "2026-05-14",
      "time": "15:00"
    }
  }
}

Return a JSON object the model can use.

{
  "available": true,
  "slots": ["15:00", "15:30"]
}

Operational expectations

• Serve the endpoint over HTTPS.
• Keep responses fast; callers are waiting in realtime.
• Return structured JSON for success and errors.
• Avoid exposing secrets in tool responses because the model may speak relevant details back to the caller.