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#

1. Create a Subaccount (recommended) and a Restricted API Key
2. Numbers can be purchased and managed in your Twilio account as usual
3. 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#

1. Generate an API Key from the Telnyx dashboard
2. Numbers can be purchased and managed in your Telnyx account as usual
3. When issuing a number from VoiceRun, we will use your Telnyx configuration