Retell guide
Connect a Retell agent to a TryVox phone number.
Retell guide
End-to-end setup for Retell + TryVox numbers. Same shape as the Vapi guide.
Prerequisites
- TryVox account with at least one Active phone number.
- Retell account with at least one published agent.
- Retell API key (Dashboard → API Keys → secret key).
1. Connect Retell
- TryVox dashboard → AI Agents → Connect provider.
- Provider: Retell.
- Display name: any label.
- API key: paste your Retell secret key.
- Connect.
2. Bind a number for inbound + outbound
- Connect number → pick a TryVox number → pick the Retell agent → Connect.
When you bind, TryVox calls POST /import-phone-number on Retell with our termination URI + digest creds + your inbound_agent_id and outbound_agent_id. Inbound calls land at sip:<E.164>@5t4n6j0wnrl.sip.livekit.cloud; Retell maps E.164 → agent.
3. Outbound — 🚧 in progress
The same /import-phone-number call from step 2 registers our trunk for outbound on Retell's side, so the resource exists — but the egress path from your agent back through TryVox to the PSTN is being polished and is not GA in v1. Don't rely on agent-originated outbound for production yet; coordinate with support if you need it.
Per-agent webhooks are set programmatically via PATCH /update-agent if a webhook URL was configured on the integration — best-effort, won't fail the bind if it 403s.
You'll see the imported number under Phone Numbers in your Retell dashboard. Don't delete it manually — disconnect from TryVox and we'll clean up the Retell side.
Troubleshooting
| Symptom | Fix |
|---|---|
| Key invalid | Confirm the key is the secret (not a public/test key). |
| Call rings, no answer | Verify the agent is in Published state in Retell, and that inbound_agent_id is set (it is automatically when you bind through TryVox). |
| Connect fails: "retell: …import-phone-number returned 409" | The E.164 is already imported on Retell from an earlier setup. Delete the stale entry in Retell's dashboard, then retry. |