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 over a month ago

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?