SIP / Phone Setup

Voice only. Bring your own SIP trunk — Chamade does not provide phone numbers.

Capabilities: audio_inaudio_out (voice only, no text chat)

Early access

SIP is fully available in early access — free and open, no plan restriction. For voice, either connect your own STT/TTS stack to the call's audio WebSocket (BYO audio, see the API reference) or let Chamade run the speech layer on its side using your own provider API key — BYOK via dashboard → Voice providers, free on Chamade's side. See Voice providers.

How it works

Chamade keeps a SIP REGISTER session open with your provider using the credentials you enter in the dashboard. Inbound calls routed to one of your registered DIDs hit Chamade, which forwards a call_invite event to your agent. Outbound calls reuse the same trunk credentials per-call.

Connect your trunk

Go to Dashboard → SIP / Phone → Connect SIP trunk.

Fill in server host, port (default 5060), username, password, and realm. Realm is required by most commercial providers (for OVH: sip-domain.io) — REGISTER will fail with 404 if your provider expects one. Caller ID is optional and only used on outbound.

Click "Connect". Chamade starts the REGISTER loop immediately.

Add your DIDs

Required for inbound

Each phone number that should reach your agent must be added as a DID. Calls to numbers not listed are rejected. Adding a DID also registers it with the SIP bridge for routing.

Once the trunk is connected, find the Phone numbers (DIDs) block on the same card.

Enter the number in E.164 format (e.g. +33612345678), optionally a label, click Add.

Toggle auto-answer per DID: on = calls go straight to active. Off = your agent receives a call_invite event with state ringing and must call chamade_call_accept within 60s (otherwise the call is marked missed).

Outbound SIP calls

With a 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.

File attachments

Not supported

SIP is an audio-only protocol — there is no file channel. To share a file during a phone conversation, send it through one of Chamade’s text-capable platforms (Discord, Telegram, WhatsApp, Slack, NC Talk) in parallel with the call.