Dubber Installation Guide

Introduction

Dubber on Wildix allows SMBs and businesses to capture, record, and analyze 100% of calls within the organization, allowing them to maintain high standards, boost sales effectiveness, and unlock other possibilities of voice data.

Find more info on this page: https://www.wildix.com/dubber/ 

Requirements

• WMS version:
• Minimum license: 
• Only Cloud PBX? 
• Windows ?  - can be installed on Windows and Linux only? (first step - WinSCP)  
• Dubber account

Installation 

Follow the below steps to configure Dubber integration: 

Step 1. Upload scripts

Download the following scripts and upload them to /home/admin/ directory using WinSCP or SCP:

• Script 1
• Script 2
  
  

Step 2. Create directory 

Go to console, login as super admin user and execute the following command:

bash /home/admin/dubber_deploy.sh

It creates /mnt/backups/dubber directory and populates it with scripts required for the configuration to function.

Step 3. Enter your Dubber account data

Input the following values (obtained in Dubber admin portal UI), into /mnt/backups/dubber/wildix_upload.php file:

• client_id
• client_secret 
• username 
• password 
• environment  

You can either use one of the text editors installed on the PBX (nano-tiny, vim), or edit the file before uploading it to the /home/admin/ directory (Step 1 of this guide). 

Example: 

$client_id = 't6zykpjghdyufngwiyu95pk9';                                                                                                                                                                                        
$client_secret = 'AkztHb6PTk';                                                                                                                                                                                                
$username = 'G-S3216574788';                                                                                                                                                                                                  
$password = 'zGfpYirpohmezRmeqKrjJ';                                                                                                                                                                                           
$environment = "uk1";

Step 4. Configure Dialplan

I. In the outbound / inbound Dialplan (depending on the users' needs), add the following Dialplan applications to populate the variables later used in the scripts:

1. Record call application. Recording must be started before other custom apps. Otherwise, some of the variables will be empty.
   
   Custom applications with the following values:
   
   

2. Set(__account=DubberAccountID)
   

   Note: DubberAccountID variable should be replaced with the customer’s Dubber account obtained on the Dubber website.

   
   

3. Set(__from=${CALLERID(num)})
4. Set(__to=${EXTEN})

5. Set(__dubpoint=DubPointID)

   Note: DubPointID variable should be replaced with the customer’s DubPoint IDs, obtained on Dubber website.

6. Set(__direction=outbound)
   

   Note: Direction value should be changed based on the setup, but ultimately it is just metadata for the visuals.

7. Set(__path=/mnt/backups/${CDR(userfield):2:${MATH(${LEN(${link2})}-10,i)}}0.mp3)
   

   Note: make sure that “Quality of calls recordings” is set to mp3 in Dialplan -> General settings, otherwise change “.mp3” to “.wav” in the 7th application.
   
   

   
   Then, you need to route the call: 
   

8. In the below example, Dial the trunk application is used.
   
   

II. Next, add a hangup Dialplan entry “h” and Custom application with the following value: 

• System(/mnt/backups/dubber/save_call.sh ${account} ${from} ${to} ${dubpoint} ${direction} ${path})

This executes the script after the end of the call.

Step 5. Process recording files and upload them to Dubber cloud

Add a cronjob to process recording files and upload them to Dubber cloud.

1. Execute the following command:
   

   crontab -e  

2. Add the following line in the file editor:
   

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

3. Save by pressing Ctrl+X.

Cronjob in the provided example is executed at the beginning of every minute, you can use crontab calculator to set it to a different value: https://crontab.guru/