Vicidial Integration

Vicidial is a dialer application built on top of Asterisk. NetBorder Call Analyzer is a Call Progress Analysis engine that ensures fast and accurate automated call classification, even when reaching wireless phones, or systems with Color Ringback Tone.

Software versions installed and tested:

• Vicidial Redux: ViciBox Redux.i686-0.1.7.iso

  • OpenSuSE v.11.1 32-Bit

  • Kernel 2.6.27.45 w/PAE

  • ViciDial 2.4-238 - BUILD: 100127-154

  • Asterisk v.1.4.28-vici

  • Dahdi v.2.2.0.2

  • Wanpipe v.3.5.9

  • Wanpipe-Voicetime v.1.0.9

• Netborder Call Analyzer version 1.0.9 DOWNLOAD

• Integration instructions available here. Additional precisions for some steps:

  • Step 1.13:

    • Opening ports UDP 10000 to 20000 on firewall. That's for Asterisk B2BUA, which is not necessary used. UDP Ports 9000 to 11000 must be opened for NCA.

  • Step 3.1:

    • For the release we installed and tested, the changes were already made into the file "/usr/src/asterisk-1.4.27.1-vici/channelschan_sip.c" to allow the NCA results in the SIP messages, so there was no need to apply the patch. Check this file and see if it has the NCA analysis functions(i.e. static int check_cpd_results(...)). If it's there you do NOT need to install the patch.

    • Latest patches for Asterisk HERE (netborder-cpd-*)

    •  

  • Step 4:

    • This version of Vicidial already comes with a paraxip carrier pre-setup. Just replace the "account entry" field with:

    [paraxip] disallow=all allow=ulaw type=peer host= (the ip address of your sip trunk) outboundproxy=(the ip address of the NCA) port=5060

    • In Asterisk 1.4, as the "port" parameter is used as the outbound proxy port if a proxy is defined, one has to use the same port for both for the outbound proxy and the request URL. Instructions in section 2.14 show how to change the NCA port from 5062 to 5060.

  •  Step 5:

    • In order to test it, you will need to do the following:

      • Create a campaign;

      • Create a List;

      • Load a lead associated with the list you created;

      • The lead is a text file containing the records as the one below(taken from the example in the Vicidial Manager Manual for testing purposes):

      • “100001|10001|107|1|7275551213 |MR|JOHN|Q|PUBLIC|249 MUNDON ROAD|MALDON|FL||||33709|USA|M|1970-01-01|7275551212 |test@test.com
        |nothing|COMMENTS|1|Southeast “

      • The 5th field is the telephone number to be dialed;

      • Create an user group;

      • Create an user(agent), member of the group you created;

      • Remove the dial prefix(9) from the campaign(detailed view) - Just replace it by 'X';

      • Update the carrier dialplan with the number you are using for tests;

      • Log in to your campaign with the agent credentials you created and and start dialing;

      • Check the Netborder Call Analyzer logs where you will confirm if the call is going through it and the results are being provided to Vicidial;

      • You can find the instructions for the above configuration on the Vicidial Manager Manual and Vicidial Agent Manual, which can be purchased and downloaded here. ->For the administration manual, the instructions can be found from the page 10.

      • If your first test works, you can now test it as a predictive dialer, where you are going to better see that the NCA is providing the results to the Vicidial and the latter is taking decisions based on those results(by not transfering the call to the agent);

      • In order to have Vicidial dial automatically, you have to change your Campaign settings to do so. Go into the campaign details settings and change the “Dial Method” to “ADAPT-TAPERED” and save it.

      • Logout and log back into your agent session and start the dialing process by hitting “RESUME”. The calls reaching answer machine, for example, won't be transferred to you. There are plenty of choices for these calls in Vicidial, like leaving a message for example. You can find the information on how to do it on the Manager Manual.

  •  Notes:

    • Changes are not applied immediately -> asterisk CLI (asterisk -r) will show when updates are activated. You can also check the conf files to see if the updates are there. Vicidial updated the *-vicidial.conf files (i.e. sip-vicidial.conf) and the original asterisk files include the *-vicidial.conf files.

    • "Carriers" in Vicidial are called "trunks" in FreePBX/trixbox and are Asterisk channels.