This VoIP.ms integration allows you to add your VoIP.ms SMS-enabled DID numbers and assign one or multiple users who will be able to send/receive messages via these numbers.
Note:
This integration is part of the Pro package. Upgrading an organisation to Pro pricing is required to enable this feature.
Step 1. Enable SMS integration for a Ringotel organisation.
In the Ringotel organisation where you want to enable the SMS integration, navigate to the connection’s Features settings and ensure that the Enable SMS option is set to via Integrations.
Navigate back to the organization’s dashboard and switch to the Integrations tab. Click Set up Integration button on the VoIP.ms panel.
Copy the provided Webhook URL, which we will need in the following steps.
Step 2. Setting up a VoIP.ms account.
Manage DID Numbers
Next, you need to enable the SMS/MMS service for your VoIP.ms DID number(s).
Note:
If you don't have DID numbers in your VoIP.ms account, you need to order them first.
Navigate to the VoIP.ms admin portal (https://voip.ms/signin) → DID Numbers → Manage DID(s), and click the “Edit” button for the number for which you want to enable SMS service.
On the Edit DID Settings page, scroll down to the Message Service (SMS/MMS) section and check Enable SMS/MMS box to enable the service for the DID number.
Then, in the SMS/MMS URL Callback (GET Request) field, check the box and specify the Webhook URL copied from your Ringotel admin portal in the previous step.
Important:
At the end of the URL, add the following string:
?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}As result, you should have the following URL structure (note that the number after /Voipms/a will be different in your case):
https://shell.ringotel.co/services/Voipms/a15945585810414401989?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}Click save button below to apply changes.
Configure API Settings
Next, navigate to Main Menu → SOAP and REST/JSON API to configure the API service.
In the API Configuration section, create the API Password that you will need to enter in the Ringotel integration settings in the next step. Then, click on Save API Password, followed by Enable/Disable API (if it hasn't been enabled yet).
In the Enable IP Addresses field, enter the following Ringotel IPs to allow HTTP requests to the VoIP.ms API server:
54.145.196.146, 18.130.161.112, 3.0.222.77
Click Save IP Address to save changes.
Note:
It may take some time for these changes to take effect in your VoIP.ms account.
Step 3. Configure Ringotel Integration.
Navigate back to your Ringotel admin portal and in the API login field enter your VoIP.ms portal login/email address. In the API password field, enter the copied value of API Password created in the previous step. Then, click Save & Continue button.
Step 4. Add your SMS number(s) to Ringotel.
Once the integration settings are successfully saved, click the Manage numbers button, add your SMS 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.
Tip:
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.
Step 5. Troubleshooting SMS Issues
If you are experiencing issues with SMS functionality, such as not being able to send or receive messages in the Ringotel app while using Voip.ms integration, follow the troubleshooting steps below to resolve them effectively.
Resolving Issues with Receiving SMS
To ensure that you can receive SMS messages in the Ringotel app using Voip.ms integration, follow these steps:
Verify Callback URL Configuration:
Go to the Voip.ms portal and navigate to DID Numbers → Manage DID(s), and click the “Edit” button for the number for which you want to enable SMS service.
Look for the section related to the SMS/MMS URL Callback.
Ensure that you have entered the correct Callback URL. The format should be as follows:
https://shell.ringotel.co/services/Voipms/a17487338851127872?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}Replace
a15945585810414401989with its respective value shown in your Ringotel admin portal.
Test the Callback URL:
After updating the Callback URL, test by sending a message to verify that the SMS functionality is working.
Troubleshooting Issues with Sending SMS
If you are unable to send SMS messages from the Ringotel app, follow these steps:
Check API Credentials:
Log into the Voip.ms portal.
Navigate to Main Menu → SOAP and REST/JSON API.
Verify that a secure API password has been created.
Ensure this password is correctly entered in the Ringotel integration settings.
Verify API Login Details:
Ensure that the API login field in the Ringotel integration contains your Voip.ms account login/email and not your Ringotel credentials.
Add Allowed IP Addresses:
In the "Enable IP Addresses" section, please ensure that the following IP addresses are specified:
54.145.196.146, 18.130.161.112, 3.0.222.77Separate multiple IPs with commas.
Test Sending an SMS:
After verifying these settings, attempt to send an SMS to check if the issue is resolved.
By carefully following the steps in this guide, you should be able to resolve most issues related to sending and receiving SMS in the Ringotel app when using Voip.ms integration. If problems persist, contact Ringotel support for further assistance.