Telnyx provides developers access to real-time voice and SMS capabilities via communication API.
How does it work
The Telnyx SMS/MMS integration allows you to add your Telnyx phone numbers and assign multiple users who will be able to send/receive messages via these numbers.
SMS/MMS integration is part of the Pro package. Upgrading an organization to Pro pricing is required to enable this feature.
Step 1. Enable SMS integration for a Ringotel organization.
Navigate to the connection features settings where the users for which you would like to enable integration are created. Then, set Enable SMS via Integrations and hit Save changes.
Then, navigate to your organization → Integrations tab. Click Enable Integration button on the Telnyx panel.
Then, copy Webhook URL provided.
Step 2. Set up your Telnyx account.
Navigate to your Telnyx admin portal (http://portal.telnyx.com ) → Real-Time Communications → Messaging → Programmable Messaging and click Add new profile to create a new Messaging Profile. Follow the setup steps to create a new messaging profile.
In the Inbox settings, enter the Webhook URL that you copied earlier from the Ringotel portal in the Webhook URL field.
In the Senders settings assign your Telnyx numbers to the new Messaging Profile. Complete other steps to create a profile.
Next, once the new messaging profile is created, navigate to Account Settings → API keys.
Click Create API Key to generate a new key.
Step 3. Complete the Ringotel integration.
Switch to the Ringotel admin portal and enter the copied API Key into the Telnyx integration settings.
Click Save changes.
Manage numbers
Once the integration settings are successfully saved, click the Manage numbers button, add your Telnyx phone numbers, and assign users who will be able to send/receive SMS/MMS via these phone numbers.
Country
Specify the country code for your SMS phone number.
Phone number
In the Phone number field, enter your SMS phone number.
Display Name
You can set a name for this phone number that will appear in the title of the group chat dialog box.
Session stickiness
For shared numbers, this options allows users to initiate private chats with customers. For example, if you create a shared number and set the “Session stickiness” to 1 day, this will allow users to initiate private chats with customers. And if the customer responds within that window, it will remain a private chat between the user who initiated the conversation and the customer. However, if the customer responds outside of the session stickiness window, that particular private chat will automatically turn into a group chat where all other users assigned to the SMS number will be able to continue the conversation and view the chat history.
Users
Select users who will send and receive SMS/MMS through this phone number. Create shared numbers with group chat behaviour by assigning multiple users to one SMS number. Click "Select All" to select all users from this connection.
Select user names in messages
With this option, customers will see user display names in messages sent by those users.
Auto-replies
Auto-replies can be used in a variety of cases, such as 10DLC opt-out compliance, text-based IVRs with keyword-based autoresponders, and automatic greetings when a new dialog is created. Enter * (asterisk) as a keyword to configure an automatic welcome message when a new dialog is created.
Reformat outbound/inbound numbers
Reformat outbound/inbound numbers rules allow to transform numbers before they are received in the application or on the carrier’s side. By default, they are set to recommended values.
Click Save to create or update an SMS number.
Note:
You can add more phone numbers by clicking Add SMS number button.
Important:
After setting up an integration, users who you assigned to the phone numbers will need to re-login from their Ringotel app.