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 Create an Organization 3 Create a Connection 3.1 Connect to VoIP.ms (SIP Trunk Provider) 3.2 Connect to PBX System 4 4. Add Users 5 VoIP.ms SMS/MMS Integration with Ringotel 5.1 Overview 5.2 Prerequisites 5.3 Enable SMS Integration in Ringotel 5.4 Configure the DID Number in VoIP.ms 5.4.1 Enable SMS/MMS on the DID 5.5 Enable VoIP.ms API Access 5.6 Complete the Integration in Ringotel 5.7 Add SMS Numbers and Assign Users 5.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.
  • PBX Systems — Ensure SIP/PBX credentials are available; if PBX is behind NAT, you may need to whitelist Ringotel server IP ranges.

---

---

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 PBX System

1. Select Connect to a PBX System.

2. In the connection settings, specify connection name, transport protocol, and a PBX server IP address or domain name.

3. Ringotel usually doesn’t require any changes to existing PBX configuration; additional settings are needed only if PBX is behind NAT.

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