Telnyx BYO Communication Integration Setup

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

Before you start

Prepare these values from your Telnyx account:

• API Key
• From Number
• Connection ID
• Messaging Profile ID
• Webhook Signing Public Key
• 1stLine webhook URL

The From Number must be an international phone number. In 1stLine, enter it in dashed international format, for example +1-872-272-3333.

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

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

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

Caution

Telnyx account level changes and carrier registration can take time. Confirm your Telnyx account level and capabilities, then complete any required 10DLC registration, toll-free verification, or local regulatory checks before you depend on the integration for production Escalation.

Steps

1. Create or find your Telnyx API key

Create or find your API Key in Create and Manage API Keys. You will paste this value into 1stLine.

2. Buy an international phone number

Buy a phone number by following Fundamentals - Searching + Ordering 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. In 1stLine, format it with dashes, for example +1-872-272-3333.

3. Confirm account level and required messaging registration

Check Telnyx Account Levels and Capabilities and confirm your account has the capabilities required for the phone number, messaging, and voice features you plan to use.

Then complete the carrier or country registration that applies to your sender:

• For US long code SMS, complete 10DLC registration.
• For toll-free SMS, complete Toll-Free Verification.
• For other countries, check the local Telnyx number and messaging requirements before sending production alerts.

4. Create the Telnyx Communication Integration in 1stLine

Create the integration before you finish the Telnyx portal setup, because the Telnyx webhook URL includes the 1stLine integration UID.

1. Open Communication Integrations.
2. Click Add Integration.
3. Enter a clear Name.
4. Set Plugin ID to Telnyx.
5. Fill in API Key.
6. Fill in From Number.
7. Fill in Connection ID if you already created the Voice API Application. If not, return and edit the integration after Step 6.
8. Fill in Messaging Profile ID if you already created the Messaging Profile. If not, return and edit the integration after Step 5.
9. Fill in Webhook Signing Public Key.
10. Click Save.

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

https://1stline.burava.com/api/communication/webhooks/telnyx/<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.

5. Create a Messaging Profile

Create a Messaging Profile in Messaging Profiles Overview.

Set the Messaging Profile webhook URL to:

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

Use the same URL for the failover webhook if Telnyx requires one for your setup.

Then assign your phone number to that profile with Phone Number Messaging Configuration. Copy the Messaging Profile ID and save it in the 1stLine integration.

6. Create a Voice API Application

Create a Voice API Application by following Getting Started with Telnyx Voice API.

Set the Voice API Application webhook URL to:

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

Copy the Application ID from the Voice API Application details page. Telnyx uses this value as the connection_id; in 1stLine, paste it into Connection ID.

7. Create or update an Outbound Voice Profile

Create an Outbound Voice Profile for outbound calls. Telnyx documents Outbound Voice Profiles in Create an outbound voice profile.

In the Outbound Voice Profile:

• Add the Voice API Application or connection that your 1stLine number uses.
• Allow every destination country that 1stLine needs to call.
• Keep countries you do not need disabled to reduce cost and fraud risk.

Telnyx uses allowed destinations on the Outbound Voice Profile to decide where outbound calls can go. If a Line Member has a phone number in a country that is not allowed, calls to that number can fail.

8. Copy the webhook signing public key

Copy the Public Key from the Telnyx Mission Control Portal. Telnyx documents it in Receiving Webhooks under webhook signature verification.

In 1stLine, paste this value into Webhook Signing Public Key.

9. Confirm the Communication Integration in 1stLine

1. Open Communication Integrations.
2. Edit the Telnyx integration.
3. Confirm API Key, From Number, Connection ID, Messaging Profile ID, and Webhook Signing Public Key are filled.
4. Click Save.

1stLine also sends this same webhook URL to Telnyx dynamically when it creates outbound SMS and call requests.

After saving

Use the new integration in a Communication Rule:

1. Open Create Communication Rule.
2. Click Add Routine.
3. Choose the Telnyx 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

---

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