Set up Telnyx messaging

Use a Telnyx SMS number for text messages in your BYO PBX softphone account.

Prepare your Telnyx account

1. In the Telnyx portal, choose a number with SMS enabled.
2. Create or select a Messaging Profile and assign the number to it.
3. Have your API key and Messaging Profile ID ready.
4. Copy the account’s Public Key from Keys & Credentials > Public Key.

Telnyx documents number and profile setup  and where to find your public key . Complete any number activation or destination requirements shown in your Telnyx account before testing.

Connect Telnyx in SessionCloud

1. Open your BYO PBX project and go to Provisioning > Advanced > Messaging.
2. Enable SMS and save the project settings.
3. Choose Telnyx for the messaging provider.
4. Enter the API key, public key and messaging profile ID, then save the connection.
5. Copy the webhook URL shown for the connection.

Keep the API key in the portal’s provider settings. Users set up their softphone with the account provisioning you provide.

Set up incoming messages

Open the number’s messaging profile in Telnyx. Paste the URL from SessionCloud into its Webhook URL setting and save. Check that the number is assigned to this same profile. See Telnyx’s incoming-message setup .

The URL must come from the connection for this project. A URL belonging to another application will send incoming messages to that application instead.

Assign the number to a user

In the project’s messaging settings, add the Telnyx number and enter the user’s SIP username and SIP domain. Use the number in full international format, such as +447700900123, and save the assignment.

Provide updated provisioning for that account. If you use QR codes, create a new code after saving the number assignment and give it to the intended user.

Test the account

1. Open Messages in the provisioned softphone and send a short text to a test mobile number.
2. Reply from the mobile and check that it appears in the same conversation.
3. Background the softphone, lock the screen and send another reply.
4. Tap the notification and check that the conversation opens.

If a step fails, use Troubleshooting SMS.