How to set up the Predictive Dialer

How to set up the Predictive Dialer

This document provides a step-by-step guide for configuring and integrating the Predictive Dialer application with the PBX system.

Created: October 2025

Permalink: https://wildix.atlassian.net/wiki/x/AYBMYQ

Introduction

The Predictive Dialer is a tool that automatically generates outgoing calls based on the number of available call agents plus an additional number of spare calls. This feature increases call center efficiency by pre-dialing customers in advance. Once a call is answered, the customer hears a message informing them that their call will be forwarded to an agent. While waiting, they hear either hold music or a ringback tone.

Setup Instructions

Follow the steps below to set up the Predictive Dialer:

  1. Git clone git@git.wildix.com: Web/wtapi.git

  2. Switch to testing branch

  3. Run the following command from project folder locally

node serve
  1. The node command will start a local server and display a link, that can be opened in a browser (usually http://localhost:9876/demo/)

  2. Go to WMS → PBX → Integrations → Applications → OAuth 2.0 and click Add:

Predicitve-dialer-add.png
  1. Add a new application with any application name and Redirect URL from localhost demo page (usually http://localhost:9876/demo/oauth2redirect.html)

new application.png
  1. Copy Application ID. It can be shared with the customer so they can log in to the WebAPI demo interface (https://webapi.wildix.com/v2/)

application-id.png
  1. Copy /demo/predictiveDialer/demo_data folder from the project to /var/www/public/ folder on the PBX

  2. Add a Call Group on PBX with any users

  3. Go to localhost demo page (see step 4), enter PBX host and Application ID (see step 7), click the Connect button:

pbx-host-id-app.png
  1. Login as user and grant access to the application

  2. Go to More → Predictive Dialer

more-predicitive-dialer.png
  1. Click the Settings button

  2. Enter the Call group id (call group from step 9), Uri numbers (uri to getContacts.php, see step 8), fill in the rest of the fields and click Save:

settings.png

You should see data from getContacts.php and Operators from Call Group displayed on page accordingly:

outgoing-call-operators.png