Bring Your Own Telephony (BYOT)
Connect your own telephony provider to VoiceRun to make and receive calls using your existing numbers and carrier. We currently support Twilio and Telnyx.
Step-by-step#
1. Create a Telephony Configuration#
Go to your Organization → Configurations → Telephony and click Add Configuration.
Each provider has different requirements:
- Twilio: Provide Account SID, API Key SID, and API Key Secret
- Telnyx: Provide an API Key
Tip: Use a Twilio Subaccount or a Telnyx API Key with minimal required permissions.
2. Configure the Agent#
Select your agent from the Agents page. From the Details page, select the newly added Telephony Configuration from the dropdown.
3. Configure the Phone Number#
From your telephony provider's dashboard, purchase a phone number and configure it to send traffic to your agent. Configure incoming calls to make a POST request to:
https://api.voicerun.com/v1/agents/<AGENT_ID>/call?environment=<ENVIRONMENT_NAME>
- AGENT_ID: The ID of your agent (found in the URL of the Agent Details page)
- ENVIRONMENT_NAME: The name of your environment (all lowercase, no spaces)
4. Test Your Agent#
Call the issued number to start a conversation. View the session under the Sessions tab for the agent.
Twilio Configuration#
- Create a Subaccount (recommended) and a Restricted API Key
- Numbers can be purchased and managed in your Twilio account as usual
- When issuing a number from VoiceRun, we will use your Twilio configuration
Required Permissions#
For managing calls, your Restricted API Key needs:
- Voice → Calls → Create, Fetch, Update
- Voice → Recordings → Fetch, Read
For managing phone numbers:
- Phone Numbers → Incoming Phone Numbers → Create, Fetch, Update, Delete
- Phone Numbers → Available Phone Numbers → Read
Telnyx Configuration#
- Generate an API Key from the Telnyx dashboard
- Numbers can be purchased and managed in your Telnyx account as usual
- When issuing a number from VoiceRun, we will use your Telnyx configuration