SIP / Phone Setup

Voice only. Inbound answering machine, bring your own trunk, or outbound dialing.

Capabilities: audio_inaudio_out (voice only, no text chat)

Early access

SIP is fully available in early access. In early access it's free and open — no plan restriction. For production voice, connect your own STT/TTS stack to the call's audio WebSocket (see the API reference). Hosted STT/TTS on SIP is beta-gated — contact [email protected] for supervised access.

Answering machine (inbound)

Get a routing number from Chamade. Configure call forwarding from your main number — when someone calls, your AI agent picks up.

Go to your Dashboard → scroll to the "AI Answering Machine" section
Click "Activate routing number" — a phone number is assigned from the pool
Configure call forwarding from your main phone number to the assigned Chamade number
Optionally enable "Auto-answer" so the agent picks up immediately without waiting for chamade_call_accept
Inbound call flow

Inbound calls appear with state "ringing". Your agent can answer with chamade_call_accept (MCP) or POST /api/call/{id}/accept (API). If auto-answer is enabled, calls go straight to "active". Unanswered calls time out after 60 seconds and become "missed".

Bring Your Own Trunk (BYOT)

Connect your own SIP trunk for full control over your phone numbers and provider.

Go to your Dashboard → scroll to the "SIP Trunk (BYOT)" section
Fill in your SIP trunk credentials: server host, port, username, password (realm and caller ID are optional)
Click "Connect"
Once connected, add your phone numbers (DIDs) in the "Inbound numbers" section below — enter the number in E.164 format (e.g. +33612345678)
Each DID has its own auto-answer toggle

Outbound SIP calls

With a BYOT trunk connected, your agent can make outbound phone calls by providing a SIP URI as the meeting URL:

MCP 
chamade_call_join(platform: "sip", meeting_url: "sip:[email protected]")
REST API 
curl -X POST https://chamade.io/api/call \
  -H "X-API-Key: chmd_..." \
  -H "Content-Type: application/json" \
  -d '{"platform": "sip", "meeting_url": "sip:[email protected]"}'

The SIP URI format is sip:+{number}@{your-trunk-host}. Chamade uses the trunk credentials you configured in the dashboard.