VoIP.ms

VoIP.ms is a Montreal-based Voice over IP (VoIP) company founded in 2007 who provides a vast range of standard telephony features as well as enhanced communication features to simplify both business and residential communications. With Ringotel and VoIP.ms integration, you can enable SMS and MMS messaging for softphone users in a few clicks.

How does it work

The VoIP.ms integration allows you to add your local DID numbers and assign one or multiple users who will be able to send/receive messages via these numbers.

Step 1. Enable SMS integration for a Ringotel organization.

In the organization where you want to enable the SMS integration, navigate to the connection’s Features settings and set Enable SMS via Integrations. Then, hit Save changes.

Open

Navigate back to the organization’s dashboard and switch to the Integrations tab. Click Set up Integration button on the VoIP.ms panel.

Open

Copy the provided Webhook URL, which we will need in the following steps.

Step 2. Setting up a VoIP.ms account.

Manage DID Numbers

First, you need to enable the SMS/MMS service for your VoIP.ms DID number(s) (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 field, check the box and enter the Webhook URL that previously copied from your Ringotel portal with the following string added to the end of the URL: ?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):

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, you should specify the API Password to be utilized for Ringotel integration. Afterward, click on Save API Password, followed by Enable/Disable API (if it hasn't been enabled yet). Within the Enable IP Addresses field, enter the designated Ringotel IPs that will send HTTP requests to the VoIP.ms API server:

Click Save IP Address to save changes.

Step 3. Configure Ringotel Integration.

Navigate back to your Ringotel admin portal and in the API login field enter your email used to login to VoIP.ms portal. In the API password field, enter the copied value of API Password created in the previous step. Then, click Save & Continue button.

Manage numbers

On the next step, add your VoIP.ms DID numbers for which you enabled SMS/MMS service in the previous steps, and assign users who we will be able to send/receive messages via these DID numbers. 

In the Country field, specify a country code for your DID numbers. In the Phone number field, specify your VoIP.ms phone number in the national format, for example, 5033889028.

Select Users who will send and receive SMS/MMS via this phone number. You can click Select all to select all users from this connection. 

In the Session stickiness field, specify a timeout during which the subscriber’s phone number will stick to a user who initiated a conversation by sending an outbound message.

Reformat outbound/inbound numbers options allows mitigating chats duplication when, for example, an incoming SMS is coming in one format (e.g., E.164), but users are sending outgoing SMS in another format (e.g., National). In addition, you can set a similar option for calls in the connection’s settings.

The Send user names in messages option includes user display names in outgoing messages, which will be visible to the customers.

Enable auto-replies allows for the automatic sending of messages and opt-out responses based on specific keywords.

Click Save.

You can add more phone numbers by clicking Add SMS number button.