Routing SIP Calls to Agents - Zero Runtime

You can route inbound or outbound SIP calls directly to an AI agent using Zero Runtime’s routing rules. This is useful for building automated voice assistants, IVRs, or connecting callers to intelligent agents for support, sales, or other workflows.

Example Request

curl -X POST 'https://api.videosdk.live/v2/sip/routing-rule' \
  -H 'Authorization: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Inbound support rule",
    "type": "inbound",
    "agentId": "Your Agent ID",
    "phoneNumbers": ["+14155551234"]
  }'

Example Response

{
  "id": "rr_abc123",
  "name": "Inbound support rule",
  "type": "inbound",
  "numbers": ["+14155551234"],
  "room": {
    "type": "dynamic",
    "prefix": "blank"
  },
  "agentId": "agent_xyz",
  "agentMetadata": {
    "team": "support"
  }
}

Deployment Notes for Agent Cloud

When using an Agent Cloud deployment, the agent must read the following environment variables to join the correct Zero Runtime room:

ZERORUNTIME_ROOM_ID: The room ID the agent should join for the call session.
ZERORUNTIME_AUTH_TOKEN: The authentication token for joining the room.

Your agent should read these environment variables at runtime to connect to the correct room and handle the SIP call.

You can configure agent routing rules via the Zero Runtime dashboard or using the API for automation and CI/CD workflows.

API Reference