Custom Twilio Integration
Connect Bland to your own Twilio account
Overview
Users can connect their own Twilio account to Bland. Easily bring over your existing phone numbers, integrations, and more.
Pre-requisites:
- Your own Twilio account
Step 1: Creating an Encrypted Key with your Twilio Credentials
- Go to your Twilio Console and get your Account SID and Auth Token.
- Create an
encrypted_key
by sending an API request to Bland.
This is the only time that your encrypted_key
will be returned to you. Make sure to store it securely, and new keys will need to be generated if lost.
Step 2: Using the Encrypted Key in Outbound Calls
Include encrypted_key
in the headers (in addition to the Authorization
header) of your API requests, and we’ll use that account’s credentials to make the call.
For example:
Note:
- You can set your
from
number in the API request - this will need to be a number owned by that Twilio account (and not one purchased through Bland). - By default, we’ll send calls from a randomly selected number in the specified Twilio account if a
from
is not specified.
Step 3: Importing Inbound numbers
- Your numbers imported from your Twilio account will appear on the Add-ons page under “BYOT” (Bring Your Own Twilio).
- From there, you can select specific numbers to import into your Bland account by sending an API request or selecting the specific numbers and importing them through the dashboard.
- Once imported, these numbers can be used for both inbound and outbound calls through Bland’s infrastructure.
Step 4: Configuring Inbound Numbers/Webhooks
Note: When updating inbound numbers, the headers need to include the encrypted_key
in addition to the Authorization
header. Doing so makes sure the updates are applied to the correct Twilio account.
Once you update an inbound number through the Dev Portal or API, that number will be automatically configured to run on Bland’s infrastructure. No additional steps are required!