Ringotel - VoIP.ms Wiki

Check out our YouTube channel to watch our simple tutorials that will help you set up most of our features.

Ringotel

From VoIP.ms Wiki

(Difference between revisions)
Jump to: navigation, search
[checked revision][checked revision]
(Created page with "300px '''Ringotel''' is a cloud-based softphone and unified communications platform designed to work with standard SIP-based VoIP systems...")
(→Connect to VoIP.ms (PBX))
 
(4 intermediate revisions not shown)
Line 13: Line 13:
* You must have a Ringotel account. After account creation, you will be redirected to the softphone provisioning portal.
* You must have a Ringotel account. After account creation, you will be redirected to the softphone provisioning portal.
-
* Prepare Organization details - [https://ringotel.atlassian.net/wiki/spaces/RSW/pages/2882043920/Get+started Get-Started Ringotel KB]:
+
* Prepare Organization details - [https://help.ringotel.com/en/articles/11187474-softphone-provisioning Ringotel KB]:
** Organization Name
** Organization Name
-
** Domain (Ringotel subdomain; cannot be changed later)
+
** Domain (Ringotel subdomain)
** Region closest to your users.
** Region closest to your users.
* Prepare connection details:
* Prepare connection details:
** '''VoIP.ms''' — Create a Sub‑Account with User/Password authentication.  
** '''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.  
+
 
 +
 
 +
== VoIP.ms Sub-Account Specification ==
 +
:: [[File:VoIP.ms_Ringotel_SubAccount-Creation.png|500px|none]]
----
----
Line 32: Line 35:
'''💬 Notes'''  
'''💬 Notes'''  
: 🧱 NAT / Firewall Notes
: 🧱 NAT / Firewall Notes
-
: If your PBX is behind a NAT firewall, you may need to allow incoming connections from Ringotel server IP addresses in your firewall or security appliance settings. See related firewall documentation for details. :contentReference[oaicite:2]{index=2}
+
: If your PBX is behind a NAT firewall, you may need to allow incoming connections from Ringotel server IP addresses in your firewall or security appliance settings. [https://help.ringotel.com/en/articles/11190222-configure-firewall-to-work-with-ringotel See related firewall documentation for details].
</div>
</div>
Line 42: Line 45:
: 3. Fill required fields:
: 3. Fill required fields:
::* Organization Name   
::* Organization Name   
-
::* Domain (unique subdomain; cannot be changed after creation)   
+
::* Domain (unique subdomain)   
::* Region (closest to user base)   
::* Region (closest to user base)   
: 4. (Optional) Configure onboarding language, tags, and additional settings.   
: 4. (Optional) Configure onboarding language, tags, and additional settings.   
: 5. Click '''Next''' to complete the organization setup.
: 5. Click '''Next''' to complete the organization setup.
-
:: [[File:VoIPms_Ringotel_CreateConnectionSIPTrunk.png|500px|none]]
 
== Create a Connection ==
== Create a Connection ==
Line 61: Line 63:
::* Use the same Sub‑Account username for: Number, Username, and Authname fields   
::* Use the same Sub‑Account username for: Number, Username, and Authname fields   
:4. Click '''Next''' to finish.
:4. Click '''Next''' to finish.
 +
:: [[File:VoIPms_Ringotel_CreateConnectionSIPTrunk.png|500px|none]]
-
:: [[File:VoIP.ms_Ringotel_SubAccount-Creation.png|500px|none]]
+
=== 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". ''
 +
:::[[File:VoIPms_Ringotel_CreateConnectionSIPPBX.png|550px]]
-
=== Connect to PBX System ===
+
:3 Click '''Advanced settings'''
-
:1. Select '''Connect to a PBX System'''.
+
::* '''Audio codecs''' Check the following codecs '''G.711 Ulaw'''
-
:2. Enter PBX extension credentials or integration parameters. 
+
::* '''Miscellanous''' '''Display Name''': Specify your Outbound CallerID Name
-
:3. Ringotel automatically uses existing PBX configuration; additional settings are needed only if PBX is behind NAT.  
+
::* '''Registration TTL''': indicate '''120''' secondes
 +
::: [[File:VoIPms_Ringotel_CreateConnectionSIPPBX_Advanced_AudioCodecs.png|350px]][[File:VoIPms_Ringotel_CreateConnectionSIPPBX_Advanced_Misc.png|350px]]
:4. Save the connection.
:4. Save the connection.
Line 80: Line 90:
::* Name   
::* Name   
::* Email (for onboarding instructions)   
::* Email (for onboarding instructions)   
-
::* Assigned Connection
+
::* Assigned Connection (if multiple connections are created)
::* SIP credentials (auto-filled when PBX integration is active)   
::* SIP credentials (auto-filled when PBX integration is active)   
:4. Save the user to automatically generate onboarding links.
:4. Save the user to automatically generate onboarding links.
Line 146: Line 156:
             width:58%;">
             width:58%;">
-
: <nowiki>https://shell.ringotel.co/services/Voipms/aXXXXXXXXXXXX?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}</nowiki>
+
: <nowiki>https://shell.ringotel.co/services/Voipms/aXXXXXXXXXXXXXXXXXXXX?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}</nowiki>
 +
 
 +
: The final URL should look similar to the following:
 +
: <nowiki>https://shell.ringotel.co/services/Voipms/a15945585810414401989?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}</nowiki>
</div>
</div>
 +
: 7. Save the DID settings
-
<pre>
 
-
?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}
 
-
</pre>
 
-
The final URL should look similar to the following:
 
-
 
-
 
-
# Save the DID settings
 
== Enable VoIP.ms API Access ==
== Enable VoIP.ms API Access ==
Ringotel communicates with VoIP.ms using the VoIP.ms API.
Ringotel communicates with VoIP.ms using the VoIP.ms API.
-
# In the VoIP.ms portal, navigate to '''Main Menu → SOAP and REST/JSON API'''
+
:1. In the VoIP.ms portal, navigate to '''Main Menu → SOAP and REST/JSON API'''
:: [[File:VOIPMS_Main_Menu_RestJsonAPI.png|500px|none]]
:: [[File:VOIPMS_Main_Menu_RestJsonAPI.png|500px|none]]
-
# Set an '''API Password'''
+
:2. Set an '''API Password'''
-
# Enable the API if it is not already enabled
+
:3. Enable the API if it is not already enabled
-
# Under '''Enable IP Addresses''', add the following Ringotel IP addresses:
+
:4. Under '''Enable IP Addresses''', add the following Ringotel IP addresses:
<div style="margin-left:50px;  
<div style="margin-left:50px;  
Line 180: Line 187:
</div>
</div>
 +
:5. Save the API settings
-
# Save the API settings
 
:: [[File:VOIPMS_API_Ringotel-IPs.png|500px|none]]
:: [[File:VOIPMS_API_Ringotel-IPs.png|500px|none]]

Latest revision as of 01:30, 14 May 2026

VoIP.ms Ringotel Logo.png

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

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

VoIP.ms Ringotel SubAccount-Creation.png

💬 Notes

🧱 NAT / Firewall Notes
If your PBX is behind a NAT firewall, you may need to allow incoming connections from Ringotel server IP addresses in your firewall or security appliance settings. See related firewall documentation for details.

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.
VoIPms Ringotel CreateConnectionSIPTrunk.png

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".
VoIPms Ringotel CreateConnectionSIPPBX.png
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
VoIPms Ringotel CreateConnectionSIPPBX Advanced AudioCodecs.pngVoIPms Ringotel CreateConnectionSIPPBX Advanced Misc.png
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

🔐 IMPORTANT ⚠️

 : Note: SMS via integrations requires the Ringotel Pro plan.

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:
https://shell.ringotel.co/services/Voipms/aXXXXXXXXXXXXXXXXXXXX?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}
The final URL should look similar to the following:
https://shell.ringotel.co/services/Voipms/a15945585810414401989?id={ID}&to={TO}&from={FROM}&message={MESSAGE}&files={MEDIA}
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
VOIPMS Main Menu RestJsonAPI.png
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:
54.145.196.146, 18.130.161.112, 3.0.222.77
5. Save the API settings
VOIPMS API Ringotel-IPs.png

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. Your VoIP.ms login email
    2. Your VoIP.ms API password
  2. Click Save & Continue
VoIPms Ringotel CreateConnectionSIPTrunk.png


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

⚠️ LIMITATIONS

➜ SMS and MMS availability depends on the DID type and country
➜ MMS support may vary by carrier
➜ Short codes and toll-free numbers may require additional configuration
Retrieved from "https://wiki.voip.ms/article/Ringotel"
Personal tools
Namespaces
Variants
Actions
VoIP.ms Wiki
Guides 🇨🇦
Guías 🇲🇽