Integration with PBX features

Your Phone System offers a variety of features that are likely part of your daily routine, such as voicemail, call recording, do not disturb, call pickup, call parking, and more. These integrated features can be easily activated by dialing specific codes set up on your PBX through any connected SIP endpoint.

Ringotel provides seamless integration with some of the PBX features directly from the softphone user interface. It allows triggering certain features on the PBX system without remembering and manually dialing those feature codes. Instead, users can intuitively interact with the app’s interface on their mobile or desktop devices, while the Ringotel platform will dial a corresponding feature code on the background to keep the feature status in-sync with the PBX configuration.

Configuring the integration

Ringotel Shell admins can specify PBX feature codes in the connection’s Features settings.

Please check with your Phone System documentation for the feature codes configured in your system before the integration.

Currently, the following features are available for integration:

Voicemail
Do Not Disturb status
Call Parking
Call Forward
Call Waiting
Visual Paging

To enable PBX Features integration, check the Utilize PBX features options and provide feature codes for each feature you would like to enable.

Voicemail

The Voicemail feature integration works over standard SIP SUBSCRIBE/NOTIFY mechanism and allows users to:

Receive push notifications when new voicemail message is received on the extension.
Check voicemail with one tap/click by calling a Voicemail system number (shortcode) on the PBX.

The functionality does not support the delivery of voicemail audio messages. Instead, Ringotel will relay the Voice-Message header along with its value from the corresponding NOTIFY SIP message received from the PBX. For instance, Voice-Message: 2/0 (0/0). Additional text can be included before a message, such as: “You have a new voicemail: Voice-Message: 2/0 (0/0)“. If you wish to enable the delivery of audio messages to users, you can achieve this by utilizing our Messaging API.

Navigate to the Features settings and scroll down to the PBX Features section to configure integration with the voicemail feature.

In the Voicemail settings, Dial voicemail field, specify the feature code configured in your PBX system that is used to dial user's voicemail box. For example: *97.

Optionally, you can specify additional text in the New voicemail message field, that will be included in the notification, such as: “You have a new voicemail“.

If the BLF subscription code is different from the voicemail box number on the PBX, specify it in the BLF prefix field.

If permitted by the Ringotel administrators, users can manage the Voicemail feature in the Ringotel app under Settings → Call Settings. If you want to allow users to enable or disable this feature for their PBX extensions, specify the Activate/Deactivate VM feature code in the designated fields.

Some PBX systems are set up to send unsolicited NOTIFYs that include message-summary data. If you wish to block these notifications, you can do so by deselecting the Allow Unsolicited notifications option.

Once the integration settings are configured, click Save Changes. When done, users of this Connection should start receiving push notifications on new voicemail and will be able to check the new messaging with one tap/click from their mobile or desktop apps.

Do Not Disturb

Allows users to:

Toggle DND status on their extension

Navigate to the Features settings and scroll down to the PBX Features section to configure integration with the DND feature.

Then, in the Do not disturb settings, specify the Feature Codes used to activate and deactivate the user's DND status on their own extension.

Hit Save Changes afterward. When done, users of this Connection profile will be able to toggle DND status on their extension by changing the availability status on their mobile or desktop Ringotel apps.

Call Parking

Allows users to:

Park active calls
Retrieve parked calls
Receive notifications on parked call

To configure integration with the Call Parking feature, navigate to the Features tab, scroll down to the PBX Features section, and open the Call Park options.

Then, select one of the pre-configured presets if they match your PBX configuration of select Custom and provide feature codes configured in your system. Learn more → Visual Call Park

Hit Save Changes afterward. When done, users of this Connection profile will be able to use Call Parking integration from their mobile or desktop Ringotel app. Learn more → How to use a Call Park feature

Visual Paging

You can enable Visual Paging in the connections that are going to use the feature.

When activated, Ringotel will attempt to record paging messages and send them to users' softphone app as voice recordings.