Ringotel Integration for FusionPBX

Ringotel.mp4

Ringotel Install

Install Ringotel from the command line on your server

cd /var/www/fusionpbx/app
git clone https://github.com/fusionpbx/fusionpbx-app-ringotel.git ringotel
git config --global --add safe.directory /var/www/fusionpbx/app/ringotel
php /var/www/fusionpbx/core/upgrade/upgrade.php --permissions
php /var/www/fusionpbx/core/upgrade/upgrade.php

Customize the display name (Change <Your Display Name> and <your-folder-name>to what you want it to be):

sed -i "s/\$apps\[\$x\]\['name'\] = \"Ringotel\";/\$apps\[\$x\]\['name'\] = \"<Your Display Name>\";/" /var/www/fusionpbx/app/<your-folder-name>/app_config.php

Optional: Ringotel could be installed into a different directory such as rt.

git clone https://github.com/fusionpbx/fusionpbx-app-ringotel.git rt
git config --global --add safe.directory /var/www/fusionpbx/app/rt

The menu would need to edited to use the custom directory name.

Ringotel Website

• Menu -> Integrations -> API Settings
  • Webhook URL: your.domain.com/app/ringotel/webhook.php
• Create Key
• Save the key to use later

Your FusionPBX Server

• Default Settings
  • Category: ringotel
  • Subcategory: ringotel_token
  • Value: Save the API Key here

1. Ringotel Overview

The Ringotel Feature Side App integrates with FusionPBX to help administrators:

• Manage Extensions: Control FusionPBX extensions.

• Bind Extensions to Ringotel: Connect and synchronize extensions with Ringotel.

• Monitor Ringotel Status: View Ringotel status for extensions within FusionPBX.

• Bandwidth Integration: Integrate with Bandwidth with exist ringotel users.

• Call Parks: Enable and manage call parking functionality directly within the Ringotel environmen.

This streamlines user management for those using both FusionPBX and Ringotel.

In Integration tab, we currently have the Bandwidth integration feature. We may add more options later, or you can add new ones yourself.

Before accessing the Ringotel application page, update permissions and default settings in FusionPBX. This ensures proper user access and module functionality.

2. Ringotel Extensions List App

This feature adds a "Ringotel status of user" column to FusionPBX's extensions.php page.

To enable it, append the following line to your extension.php file (typically in app/extensions/):

    //include the ringotel extension list
    require_once dirname(__DIR__, 2)."/app/ringotel/ringotel_extension_list.php";

The new column will display statuses and user's information providing quick insight into each extension's Ringotel integration.

Example how to enable the "Ringotel Extensions List App":

ringotel_extension_list-2025-07-02_18.20.52.mp4