docs.VoiceRun

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, Telnyx, and Infobip.

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
  • Infobip: Provide an API Key and, if your account uses a regional API host, a Base URL such as https://api.infobip.com

Tip: Use a Twilio Subaccount, Telnyx API Key, or Infobip 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

Infobip Configuration#

Infobip uses an API-driven call flow instead of returning TwiML/TeXML from the inbound webhook. When an inbound call arrives, VoiceRun accepts the call through the Infobip Calls API, starts a WebSocket media leg, and bridges that media stream to the selected agent release.

  1. Create an Infobip API Key with Calls API access.
  2. Add an Infobip telephony configuration in VoiceRun with:
    • apiKey — your Infobip API key
    • baseUrl — optional regional Infobip API base URL; defaults to https://api.infobip.com
  3. Configure the agent or phone entrypoint to use the Infobip telephony configuration.
  4. In Infobip, configure the number or calls configuration to send inbound call webhooks to:
https://api.voicerun.com/v1/agents/<AGENT_ID>/call?environment=<ENVIRONMENT_NAME>

Infobip phone number purchasing and webhook management are handled in the Infobip dashboard. VoiceRun can create, transfer, record, fetch, and hang up Infobip calls once the telephony configuration is connected.

telephonytwiliotelnyxinfobipbyot