Connect a provider

Before you can route TryVox numbers to your AI agents, connect the provider account that hosts them. You only do this once per account; the same connection serves every number you bind.

Steps

1. Go to AI Agents in the TryVox dashboard.
2. Click Connect provider.
3. Pick the provider — Vapi, ElevenLabs, or Retell.
4. Paste your API key from the provider's dashboard.
5. Click Connect.

We validate the key against the provider before saving. If the provider rejects it, you'll see an error here — no half-configured integrations get stored.

Where to find your API key

What we do with the key

• Stored encrypted at rest (AES-256-GCM).
• Used to: (a) list your agents when you bind a number; (b) re-validate when you click Test connection; (c) provision a SIP trunk + import the bound DID on your provider when you connect a number (this is what replaces the manual BYOC paste flow); (d) cascade-delete the same provider-side resources when you disconnect.
• We do not mutate your agent configuration (prompts, voices, tools) — only the phone-number / trunk / webhook resources we own end-to-end.

Rotating the key

You can rotate the API key at any time. The TryVox dashboard → integration detail → Rotate key button accepts the new key and re-validates before swapping. Existing bindings keep working — the SIP URI doesn't depend on the key.

Status meanings

Webhook URL (managed for you)

Each integration gets a unique webhook URL of the form:

https://api.tryvox.io/v1/ai/webhooks/{provider}/{integration_id}?s={secret}

You don't need to paste this anywhere. TryVox sets it on the provider's resource for you when you bind a number — Vapi as the per-phone-number serverUrl, Retell as the per-agent webhook_url. The per-integration secret in the URL is how we authenticate inbound events. If you suspect the URL has leaked, delete and re-create the integration to roll the secret.