Phones must be added to the Vicidial configuration in order for agents/users to be able to log into them. Before they are added in Vicidial they should be first configured in FreePBX. Freevoice Predictive Dialers come pre-configured with users and phones 100 through 150.

Adding/Changing Phones in Vicidial

Phones must be setup as extensions in FreePBX before they can be used in Vicidial. Make sure any phone you add in Vicidial is configured as a FreePBX extension, instructions on adding extensions in FreePBX can be found here.  Freevoice servers come default with phones 100 to 150 configured for SIP phones.

1.  Login to the Vicidial Administrator page.
2. Click the ADMIN link at the top right of the page.
3. This takes you to a listing of the phones in your Vicidial server. To modify an existing phone click the MODIFY link next to the phone. To add a new phone click the Add A New Phone link at the top of the page.
4. Fill in or edit the appropriate fields to configure the phone, use the list of opton descriptions below as a reference.
5. Click the Submit button to save the phone, if this is a new phone you will be taken you to the complete list of settings for the phone.

Deleting Phones In Vicidial 

Deleting phone in the Vicidial Admin will not remove the phone from the FreePBX configuration. This only prevents the phone from being used by a dialer agent. 

1. Login to the Vicidial Administrator page.
2. Click the ADMIN link at the top right of the page.
3. This takes you to a listing of the phones in your Vicidial server. Click the MODIFY link next to the phone to be deleted.
4. Scroll to the bottom of the page and click the DELETE THIS PHONE link. Then click the link near the top of the page that says "Click here to delete phone".

Complete list of Vicidial phone options 

Phone extension - This field is where you put the phones name as it appears to Asterisk not including the protocol or slash at the beginning. For Example: for the SIP phone SIP/test101 the Phone extension would be test101. Also, for IAX2 phones make sure you use the full phones name: IAX2/IAXphone1@IAXphone1 would be IAXphone1@IAXphone1. For Zap phones make sure you put the full channel: Zap/25-1 would be 25-1. Another note, make sure you set the Protocol below correctly for your type of phone.

Dial Plan Number - This field is for the number you dial to have the phone ring. This number is defined in the extensions.conf file of your Asterisk server

Voicemail Box - This field is for the voicemail box that the messages go to for the user of this phone. We use this to check for voicemail messages and for the user to be able to use the VOICEMAIL button on astGUIclient app.

Outbound CallerID - This field is where you would enter the callerID number that you would like to appear on outbound calls placed form the astguiclient web-client. This does not work on RBS, non-PRI, T1/E1s.

Phone IP address - This field is for the phone's IP address if it is a VOIP phone. This is an optional field

Computer IP address - This field is for the user's computer IP address. This is an optional field

Server IP - This menu is where you select which server the phone is active on.

Login - The login used for the phone user to login to the client applications.

Password - The password used for the phone user to login to the client applications.

Status - The status of the phone in the system, ACTIVE and ADMIN allow for GUI clients to work. ADMIN allows access to this administrative web site. All other statuses do not allow GUI or Admin web access.

Active Account - Whether the phone is active to put it in the list in the GUI client.

Phone Type - Purely for administrative notes.

Full Name - Used by the GUIclient in the list of active phones.

Company - Purely for administrative notes.

Picture - Not yet Implemented.

New Messages - Number of new voicemail messages for this phone on the Asterisk server.

Old Messages - Number of old voicemail messages for this phone on the Asterisk server.

Client Protocol - The protocol that the phone uses to connect to the Asterisk server: SIP, IAX2, Zap . Also, there is EXTERNAL for remote dial numbers or speed dial numbers that you want to list as phones.

Local GMT - The difference from Greenwich Mean time, or ZULU time where the phone is located. DO NOT ADJUST FOR DAYLIGHT SAVINGS TIME. This is used by the VICIDIAL campaign to accurately display the time and customer time.

Manager Login - This is the login that the GUI clients for this phone will use to access the Database where the server data resides.

Manager Secret - This is the password that the GUI clients for this phone will use to access the Database where the server data resides.

VICIDIAL Default User - This is to place a default value in the VICIDIAL user field whenever this phone user opens the astVICIDIAL client app. Leave blank for no user.

VICIDIAL Default Pass - This is to place a default value in the VICIDIAL password field whenever this phone user opens the astVICIDIAL client app. Leave blank for no pass.

VICIDIAL Default Campaign - This is to place a default value in the VICIDIAL campaign field whenever this phone user opens the astVICIDIAL client app. Leave blank for no campaign.

Park Exten - This is the default Parking extension for the client apps. Verify that a different one works before you change this.

Conf Exten - This is the default Conference park extension for the client apps. Verify that a different one works before you change this.

VICIDIAL Park Exten - This is the default Parking extension for VICIDIAL client app. Verify that a different one works before you change this.

VICIDIAL Park File - This is the default VICIDIAL park extension file name for the client apps. Verify that a different one works before you change this. limited to 10 characters.

Monitor Prefix - This is the dial plan prefix for monitoring of Zap channels automatically within the astGUIclient app. Only change according to the extensions.conf ZapBarge extensions records.

Recording Exten - This is the dial plan extension for the recording extension that is used to drop into meetme conferences to record them. It usually lasts upto one hour if not stopped. verify with extensions.conf file before changing.

VMAIL Main Exten - This is the dial plan extension going to check your voicemail. verify with extensions.conf file before changing.

VMAIL Dump Exten - This is the dial plan prefix used to send calls directly to a user's voicemail from a live call in the astGUIclient app. verify with extensions.conf file before changing.

Exten Context - This is the dial plan context that this phone primarily uses. It is assumed that all numbers dialed by the client apps are using this context so it is a good idea to make sure this is the most wide context possible. verify with extensions.conf file before changing.

DTMF send Channel - This is the channel string used to send DTMF sounds into meetme conferences from the client apps. Verify the exten and context with the extensions.conf file.

Outbound Call Group - This is the channel group that outbound calls from this phone are placed out of. There are a couple routines in the client apps that use this. For Zap channels you want to use something like Zap/g2 , for IAX2 trunks you would want to use the full IAX prefix like IAX2/VICItest1: This e-mail address is being protected from spambots. You need JavaScript enabled to view it :4569. Verify the trunks with the extensions.conf file, it is usually what you have defined as the TRUNK global variable at the top of the file.

Browser Location - This is applicable to only UNIX/LINUX clients, the absolute path to Mozilla or Firefox browser on the machine. verify this by launching it manually.

Install Directory - This is the place where the astGUIclient and astVICIDIAL scripts are located on your machine. For Win32 it should be something like C:\AST_VICI and for UNIX it should be something like /usr/local/perl_TK. verify this manually.

CallerID URL - This is the web address of the page used to do custom callerID lookups. default testing address is: http://astguiclient.sf.net/test_callerid_output.php

VICIDIAL Default URL - This is the web address of the page used to do custom VICIDIAL Web Form queries. default testing address is: http://astguiclient.sf.net/test_VICIDIAL_output.php

Call Logging - This is set to true if the call_log.agi file is in place in the extensions.conf file for all outbound and hang up 'h' extensions to log all calls. This should always be 1 because it is manditory for many astGUIclient and VICIDIAL features to work properly.

User Switching - Set to true to allow user to switch to another user account. NOTE: If user switches they can initiate recording on the new user's phone conversation

Conferencing - Set to true to allow user to start conference calls with upto six external lines.

Admin Hang Up - Set to true to allow user to be able to hang up any line at will through astGUIclient. Good idea only to enable this for Admin users.

Admin Hijack - Set to true to allow user to be able to grab and redirect to their extension any line at will through astGUIclient. Good idea only to enable this for Admin users. But is very useful for Managers.

Admin Monitor - Set to true to allow user to be able to grab and redirect to their extension any line at will through astGUIclient. Good idea only to enable this for Admin users. But is very useful for Managers and as a training tool.

Call Park - Set to true to allow user to be able to park calls on astGUIclient hold to be picked up by any other astGUIclient user on the system. Calls stay on hold for upto a half hour then hang up. Usually enabled for all.

Updater Check - Set to true to display a popup warning that the updater time has not changed in 20 seconds. Useful for Admin users.

AF Logging - Set to true to log many actions of astGUIclient usage to a text file on the user's computer.

Queue Enabled - Set to true to have client apps use the Asterisk Central Queue system. Required for VICIDIAL and recommended for all users.

CallerID Popup - Set to true to allow for numbers defined in the extensions.conf file to send CallerID popup screens to astGUIclient users.

VMail Button - Set to true to display the VOICEMAIL button and the messages count display on astGUIclient.

Fast Refresh - Set to true to enable a new rate of refresh of call information for the astGUIclient. Default disabled rate is 1000 ms ,1 second. Can increase system load if you lower this number.

Fast Refresh Rate - in milliseconds. Only used if Fast Refresh is enabled. Default disabled rate is 1000 ms ,1 second. Can increase system load if you lower this number.

Persistant MySQL - If enabled the astGUIclient connection will remain connected instead of connecting every second. Useful if you have a fast refresh rate set. It will increase the number of connections on your MySQL machine.

Auto Dial Next Number - If enabled the VICIDIAL client will dial the next number on the list automatically upon disposition of a call unless they selected to "Stop Dialing" on the disposition screen.

Stop Rec after each call - If enabled the VICIDIAL client will stop whatever recording is going on after each call has been dispositioned. Useful if you are doing a lot of recording or you are using a web form to trigger recording.

Enable SIPSAK Messages - If enabled the server will send messages to the SIP phone to display on the phone LCD display when logged into VICIDIAL. Feature only works with SIP phones and requires sipsak application to be installed on the web server. Default is 0.

DBX Server - The MySQL database server that this user should be connecting to.

DBX Database - The MySQL database that this user should be connecting to. Default is asterisk.

DBX User - The MySQL user login that this user should be using when connecting. Default is cron.

DBX Pass - The MySQL user password that this user should be using when connecting. Default is 1234.

DBX Port - The MySQL TCP port that this user should be using when connecting. Default is 3306.

DBY Server - The MySQL database server that this user should be connecting to. Secondary server, not used currently.

DBY Database - The MySQL database that this user should be connecting to. Default is asterisk. Secondary server, not used currently.

DBY User - The MySQL user login that this user should be using when connecting. Default is cron. Secondary server, not used currently.

DBY Pass - The MySQL user password that this user should be using when connecting. Default is 1234. Secondary server, not used currently.

DBY Port - The MySQL TCP port that this user should be using when connecting. Default is 3306. Secondary server, not used currently.

Taken from the Vicidial Admin Help page.