From VoIP.ms Wiki

Ringotel is a cloud-based softphone and unified communications platform designed to work with standard SIP-based VoIP systems. It provides features such as voice calling, messaging, presence, and video across desktop and mobile devices, while simplifying deployment and management for service providers and enterprises. Ringotel operates as a secure VoIP tunnel that routes SIP traffic between users and an existing PBX or VoIP system, reducing infrastructure complexity and improving reliability.

Ringotel supports centralized user provisioning and management through an admin portal or API, allowing automated onboarding, configuration, and device setup. It also offers integration options with CRM systems, messaging services, and business tools, and includes features such as push notifications, call recording, visual voicemail, BLF (busy lamp field), and rich messaging.

The platform is compatible with most standard SIP PBXs and telephony systems, enabling VoIP providers and organizations to extend their existing voice infrastructure to softphone users without deploying additional VPNs or session border controllers.

---

Contents 1 Pre-Requisites 2 VoIP.ms Sub-Account Specification 3 Create an Organization 4 Create a Connection 4.1 Connect to VoIP.ms (SIP Trunk Provider) 4.2 Connect to VoIP.ms (PBX) 5 4. Add Users 6 VoIP.ms SMS/MMS Integration with Ringotel 6.1 Overview 6.2 Prerequisites 6.3 Enable SMS Integration in Ringotel 6.4 Configure the DID Number in VoIP.ms 6.4.1 Enable SMS/MMS on the DID 6.5 Enable VoIP.ms API Access 6.6 Complete the Integration in Ringotel 6.7 Add SMS Numbers and Assign Users 6.8 Notes and Limitations

Pre-Requisites

Before configuring Ringotel Shell, ensure the following requirements are met:

• You must have a Ringotel account. After account creation, you will be redirected to the softphone provisioning portal.
• Prepare Organization details - Ringotel KB:
  • Organization Name
  • Domain (Ringotel subdomain)
  • Region closest to your users.
• Prepare connection details:
  • VoIP.ms — Create a Sub‑Account with User/Password authentication.

VoIP.ms Sub-Account Specification

---

---

Create an Organization

1. Go to Organizations in the Ringotel Shell portal.

2. Click Create Organization.

3. Fill required fields:

• Organization Name
• Domain (unique subdomain)
• Region (closest to user base)

4. (Optional) Configure onboarding language, tags, and additional settings.

5. Click Next to complete the organization setup.

Create a Connection

A Connection defines how Ringotel communicates with your PBX or SIP trunk provider.

Connect to VoIP.ms (SIP Trunk Provider)

1. Within the organization, click Create Connection.

2. Select Connect to a SIP Trunk Provider.

3. Enter the VoIP.ms details:

• POP server address
• Sub‑Account Username
• Sub‑Account Password
• Check Registration
• Use the same Sub‑Account username for: Number, Username, and Authname fields

4. Click Next to finish.

Connect to VoIP.ms (PBX)

1. Select Connect to a PBX server.

2. Complete the following field:

• Connection name: Define a connection name for your reference.
• Protocol: Select UDP or TCP. (To use SIP traffic encryption, select SIP-TLS)

*If you have selected SIP-TLS for SIP traffic encryption, you need to enable SIP traffic encryption on your Sub Account)

• Domain or IP address: indicate your preferred pop server.
• Country: Optional. ℹ️ To use this feature, your DID needs have "Dial Mode" set to "E164".

3 Click Advanced settings

• Audio codecs Check the following codecs G.711 Ulaw
• Miscellanous Display Name: Specify your Outbound CallerID Name
• Registration TTL: indicate 120 secondes

4. Save the connection.

---

4. Add Users

1. Navigate to Users inside your organization.

2. Click Add User.

3. Provide:

• Name
• Email (for onboarding instructions)
• Assigned Connection (if multiple connections are created)
• SIP credentials (auto-filled when PBX integration is active)

4. Save the user to automatically generate onboarding links.

---

VoIP.ms SMS/MMS Integration with Ringotel

This section describes how you can enable the SMS and MMS messaging for your DID numbers using Ringotel.

Once configured, SMS and MMS messages sent to your VoIP.ms DID can be sent and received directly from Ringotel applications.

Overview

VoIP.ms supports SMS and MMS on compatible DID numbers. By integrating VoIP.ms with Ringotel, you can:

• Send and receive SMS/MMS using VoIP.ms DID numbers
• Assign numbers to individual users or teams
• Manage conversations from desktop and mobile applications

Prerequisites

Before starting, ensure you have:

• An active VoIP.ms account
• One or more SMS-capable DID numbers
• An active Ringotel organization with Pro features enabled
• Administrator access to both VoIP.ms and Ringotel

Enable SMS Integration in Ringotel

1. Log in to the Ringotel Admin Portal
2. Open your organization
3. Navigate to Features
4. Enable SMS via Integrations
5. Save changes
6. Open the Integrations tab
7. Select VoIP.ms and click Set up Integration
8. Copy the Webhook URL (required for VoIP.ms configuration)

Configure the DID Number in VoIP.ms

Enable SMS/MMS on the DID

1. Log in to the VoIP.ms customer portal
2. Go to DID Numbers → Manage DID(s)
3. Select the DID number and click Edit
4. Under Message Service (SMS/MMS):
   1. Enable SMS/MMS
5. Enable SMS/MMS URL Callback
6. Paste the Ringotel Webhook URL and append the following parameters:

7. Save the DID settings

Enable VoIP.ms API Access

Ringotel communicates with VoIP.ms using the VoIP.ms API.

1. In the VoIP.ms portal, navigate to Main Menu → SOAP and REST/JSON API

2. Set an API Password

3. Enable the API if it is not already enabled

4. Under Enable IP Addresses, add the following Ringotel IP addresses:

5. Save the API settings

Complete the Integration in Ringotel

After setting up your API password and the IP addresses in your VoIP.ms portal, return to your Ringotel Admin portal to complete the connection.

1. 1. Your VoIP.ms login email
   2. Your VoIP.ms API password
2. Click Save & Continue

Add SMS Numbers and Assign Users

1. Add your VoIP.ms DID numbers with SMS enabled
2. Assign users who can send and receive messages
3. Enter phone numbers in national format (for example, 5033889028 for US/Canada)
4. Configure optional settings:
   1. Session stickiness (keeps conversations assigned to the same user)
   2. Number reformatting (prevents duplicate conversation threads)
   3. Sender name in messages
   4. Auto-replies and opt-out messages
5. Save the configuration

Users may need to log out and log back in to access SMS features.

Notes and Limitations