Twilio BYO Communication Integration Setup

Use this guide when your organization wants 1stLine by Burava to send calls and SMS through your own Twilio account.

Before you start

Prepare these values from your Twilio account:

• Account SID
• Auth Token
• From Number

The From Number must be an international phone number. Use the full country code, for example +18722723333.

The Twilio webhook URL for a 1stLine Communication Integration is:

https://1stline.burava.com/api/communication/webhooks/twilio/<integration_uid>

Replace <integration_uid> with the UID of the Twilio Communication Integration in 1stLine.

Caution

Provider verification and carrier registration can take time. Complete Twilio sender registration, A2P 10DLC review, toll-free verification, or local regulatory checks before you depend on the integration for production Escalation.

Caution

For US and Canada emergency calls, Twilio can charge a higher per-call fee when a 911 call is placed from a phone number without a registered emergency address. Twilio documents a $75 fee per 911 call in that case. Register an emergency address for numbers that may be used to call emergency services.

Steps

1. Find your Twilio credentials

Find your Account SID and Auth Token in Auth Tokens and How to Change Them. You will paste both values into 1stLine.

Keep the Auth Token private.

2. Buy an international phone number

Buy a Twilio phone number by following Phone Numbers.

Choose a number that supports the channels you need:

• Voice, if 1stLine will make calls.
• SMS, if 1stLine will send text messages.

Use the international form of the number as your 1stLine From Number, for example +1-872-272-3333.

3. Verify a non-Twilio caller ID if needed

If you need to place outbound calls from a non-Twilio phone number, verify it as a Verified caller ID on the Phone Numbers page.

Use a Twilio-owned number when you need Twilio to receive inbound calls or messages for that number.

4. Complete required messaging verification

Complete the carrier or country registration that applies to your sender:

• For US 10DLC SMS, complete Programmable Messaging and A2P 10DLC.
• For toll-free SMS, complete Toll-free verification.
• For other countries, review Twilio’s SMS Guidelines before sending production alerts.

5. Allow the countries you need for SMS

Open Twilio’s SMS Geo Permissions settings and allow every destination country that 1stLine needs to send SMS to. Twilio documents this in SMS Geo Permissions.

Keep countries you do not need disabled to reduce cost and fraud risk. If a Line Member has a phone number in a country that is not allowed, SMS to that number can fail.

6. Allow the countries you need for calls

Open Twilio’s Voice Geo Permissions settings and allow every destination country that 1stLine needs to call. Twilio documents this in Protect your account with Voice Dialing Geographic Permissions.

Twilio does not use the Telnyx-style Outbound Voice Profile in this 1stLine integration. For Twilio, the matching control is Voice Dialing Geo Permissions.

Keep countries you do not need disabled to reduce cost and toll fraud risk.

7. Understand the Twilio webhook URL

You do not need to set a separate Twilio Console webhook for the outbound call flow in this guide. When 1stLine creates a Twilio call, it sends Twilio the StatusCallback URL dynamically:

https://1stline.burava.com/api/communication/webhooks/twilio/<integration_uid>

1stLine uses the same URL for call status updates and phone keypad actions during the call.

Twilio does not provide a webhook public signing key for this 1stLine setup. Twilio signs webhook requests with the X-Twilio-Signature header and your Auth Token, described in Webhooks security.

8. Add the Communication Integration in 1stLine

1. Open Communication Integrations.
2. Click Add Integration.
3. Enter a clear Name.
4. Set Plugin ID to Twilio.
5. Fill in Account SID.
6. Fill in Auth Token.
7. Fill in From Number.
8. Click Save.

The integration UID is the final path value used in the webhook URL:

https://1stline.burava.com/api/communication/webhooks/twilio/<integration_uid>

If you do not see the UID in the UI, read the Communication Integrations API response for the integration. The response includes uid.

Note

1stLine encrypts the whole Communication Integration configuration and stores it securely. To view configured secret values through the API, call the Communication Integration details endpoint with decrypt=true, for example GET /api/communication/<integration_uid>?org_uid=<org_uid>&decrypt=true, using credentials that are allowed to read Communication Integrations.

After saving

Use the new integration in a Communication Rule:

1. Open Create Communication Rule.
2. Click Add Routine.
3. Choose the Twilio integration in Integration.
4. Choose Actions such as Send SMS or Make Call.
5. Save the routine and then save the rule.

Then attach that Communication Rule to a Line Member and send a real test alert.

Related pages

• Communication Integrations
• Communication Rules
• Guide: Verify a Phone Number
• Troubleshooting

Twilio is a third-party brand. Burava does not own, represent, or speak for it.