Skip to main content
All CollectionsHandy How To Guides
Wildix PBX and Voyc Integration
Wildix PBX and Voyc Integration
Anathi Booi avatar
Written by Anathi Booi
Updated today

This integration guide provides detailed step-by-step instructions for setting up the integration used for uploading call recordings from Wildix PBX to the Voyc platform. Following these instructions will ensure a successful and efficient setup.

Prerequisites

  • Go to the PBX’s terminal

📝Take Note: Pressing enter is a default for CLI

  • Log in as the super user using the Su command, then enter password Wildix when prompted.

To initiate the integration setup, please follow the steps outlined below:

Step 1: Upload the Archive

  1. First you have to download the archive from the provided link: voyc_upload

  2. Upload the archive to the /home/admin directory using admin credentials and either SCP or an FTP client like Filezilla/WinSCP (if it’s a cloud hosted PBX use port 2222; you may also need to enable SSH access in the Wildix portal first).

Step 2: Unzip the Archive

  1. Navigate to the directory where the archive is stored by running the following command:

    • cd /home/admin/

  2. Extract the contents of the archive to the desired location by executing the following command:

    • tar -xzvf voyc_upload.tar.gz -C /mnt/backups

Step 3: Create a Cron job

Edit the Crontab:

  1. In the CLI, execute:

    • crontab -e

  2. If it's your first time using crontab, you'll be prompted to select an editor. Choose Nano-tiny.

  3. Add the following line to schedule the processing and uploading scripts to run every minute:

    • * * * * * /mnt/backups/voyc_upload/process_files.sh > /dev/null 2>&1

  4. Save and exit the editor by pressing Ctrl + X, then confirm with Y, and hit Enter.

Step 4: Configure the Dialplan

In this step you have to configure the Dialplan, you can do this by:

  1. Importing the Dialplan configuration from this link: Dialplan configuration

  2. Forward calls directly from users or other outbound dialplan to Voyc using a jump to application.

  3. Fill out the mandatory channel_id, org_id and api_key variables (obtained in the Voyc admin portal) in the Voyc dialplan:

  4. TAGS & direction can be used to provide additional information about the call, feel free to change them according to your setup.

📝Take note: Don’t forget to fill out the dial the trunk application at the bottom of the Voyc dialplan:

Frequently Asked Questions

How do I upload the Voyc archive to the PBX?

Use SCP or an FTP client like Filezilla/WinSCP to upload the archive to the /home/admin directory. If it's a cloud-hosted PBX, use port 2222 and ensure SSH is enabled in the Wildix portal.

How do I unzip the Voyc archive?

Run the following commands:

cd /home/admin/

tar -xzvf voyc_upload.tar.gz -C /mnt/backups

This extracts the archive to the /mnt/backups directory.

Did this answer your question?