Inbound Calling Overview

Inbound Calling Overview

Inbound calling is the flow where a customer calls your phone number and SIPHON routes that call to your running agent worker.

The inbound flow

Inbound calling flow

  1. Run your agent worker (Agent(...).dev() / Agent(...).start()).
  2. Create an inbound dispatch rule (Dispatch(...).agent()) that links a trunk/number to your agent_name.
  3. When a call comes in, SIPHON forwards per-call configuration (LLM/STT/TTS + instructions) via metadata.

Learn the pieces

Provider-specific SIP examples (Twilio, Telnyx, Plivo, Wavix): Provider-specific quickstarts

Agent workers

Inbound calls target a worker by agent_name. Make sure your dispatch uses the same agent_name as your running worker.

See: Agents Overview