Академический Документы
Профессиональный Документы
Культура Документы
September 2008
New Media Software Ltd PO Box 299 Eastleigh Hampshire SO50 7WR Telephone 0845 612 4000 www.nms-adaptive.com
Page 1 of 176
September 2008
Contents
1 CHANGE HISTORY..............................................................................9 2 INTRODUCTION................................................................................10 3 INSTALLING ADAPTIVE SERVER.........................................................11 3.1 PREREQUISITES...................................................................................................11 Licence and serial number............................................................................11 Server PC.......................................................................................................11 Network connections.....................................................................................11 Telephone system [Adaptive CTI and diallers]...............................................11 Email servers (SMTP and POP3) and email accounts [Adaptive Desktop SMS and Adaptive Messaging]...............................................................................11 3.2 HOW TO INSTALL THE SERVER SOFTWARE......................................................................12 Serial number................................................................................................12 Executables folder.........................................................................................12 Data folder....................................................................................................12 Call Recorder Folder......................................................................................13 When the set-up program has finished..........................................................13 3.3 HOW TO UPGRADE YOUR LICENCE...............................................................................13 3.4 HOW TO UPGRADE YOUR SERVER SOFTWARE...................................................................13 3.5 HOW TO ACTIVATE YOUR ADAPTIVE SOFTWARE................................................................13 3.6 HOW TO INSTALL THE CALL RECORDER SOFTWARE..........................................................15 3.6.1 Software installation..............................................................................15 3.6.2 Hardware installation............................................................................15 3.6.3 Sharing the Call Recorder Folder...........................................................16 3.7 RUNNING THE SERVER SOFTWARE FOR THE FIRST TIME........................................................16 3.8 WHAT TO DO NEXT..............................................................................................16 4 THE ADAPTIVE MANAGEMENT CONSOLE............................................17 4.1 INSTALLING THE ADAPTIVE MANAGEMENT CONSOLE.........................................................17 Executables folder.........................................................................................17 Data folder....................................................................................................17 When the set-up program has finished..........................................................17 4.2 LOGGING INTO THE ADAPTIVE MANAGEMENT CONSOLE.....................................................17 4.3 TOOLBAR..........................................................................................................17 4.4 CONFIGURATION.................................................................................................18 4.4.1 Configuring users and teams.................................................................18 4.4.2 Configuring Message Rules....................................................................26 4.4.3 Configuring Dialling Campaigns.............................................................31 4.4.4 Configuring Macros and screen-pops.....................................................43 4.4.5 Configuring the Queues Server..............................................................49 4.4.6 What is the Adaptive CTI Gateway?.......................................................53 4.4.7 Configuring the Adaptive CTI Gateway..................................................53 4.4.8 Configuring the Adaptive Messaging Processor Service........................68 4.4.9 Configuring the Adaptive Web Gateway................................................77 4.4.10 Running the Adaptive Message Database Administrator.....................78 4.4.11 Configuring the SQL Exporting Service................................................80 4.5 SERVER ACTIVITY................................................................................................82 4.5.1 Data Controller.....................................................................................82 4.5.2 Message Processor................................................................................83 4.5.3 Telephone Events..................................................................................83 4.5.4 Web Gateway........................................................................................84 4.5.5 Call Recorder Archive............................................................................84
Page 2 of 176
September 2008
4.6 REAL-TIME REPORTS..............................................................................................85 Real-time users status report........................................................................85 Real-time queues report................................................................................85 Real-time server report.................................................................................85 4.7 HISTORICAL REPORTS.............................................................................................86 Historical Multi User Summary report............................................................86 Historical Single User Summary report..........................................................86 Historical Single User Detail report................................................................86 Historical queues throughput report..............................................................87 Historical server reports................................................................................87 Predictive Dialler...........................................................................................87 Call Recordings..............................................................................................88 4.8 CAMPAIGN REPORTS..............................................................................................89 4.8.1 Single Campaign Report........................................................................89 4.8.2 Call Duration By User............................................................................91 4.8.3 Call Duration by Result..........................................................................91 4.8.4 Multi Campaign Report..........................................................................92 4.8.5 Historical Extension Reports..................................................................92 5 THE ADAPTIVE SERVICES..................................................................93 5.1 STARTING THE ADAPTIVE SERVICES............................................................................93 5.2 IF ANY SERVICE FAILS TO START.................................................................................93 5.3 STOPPING AND RESTARTING THE ADAPTIVE SERVICES.........................................................93 6 THE ADAPTIVE DESKTOP..................................................................94 6.1 PREREQUISITES...................................................................................................94 6.2 INSTALLING THE ADAPTIVE DESKTOP...........................................................................94 Executables folder.........................................................................................94 Data folder....................................................................................................94 When the set-up program has finished..........................................................94 7 USING THE ADAPTIVE DESKTOP........................................................95 7.1 QUICK REFERENCE: THE ADAPTIVE DESKTOP AT A GLANCE...................................................95 7.2 WHY ARE SOME OF MY BUTTONS GREYED OUT?...............................................................96 7.3 LOGGING IN.......................................................................................................96 Automatic login options.................................................................................97 7.4 SETTING YOUR TELEPHONE EXTENSION..........................................................................97 7.5 AVAILABLE / UNAVAILABLE.......................................................................................97 7.6 GET NEXT MESSAGE..............................................................................................97 Setting your preferred queue........................................................................97 7.7 CREATING AND SENDING NEW OUTBOUND EMAIL...............................................................98 7.7.1 Send, bulk send and schedule...............................................................98 7.7.2 Grab + Email.........................................................................................98 7.7.3 Signatures.............................................................................................98 7.8 CREATING AND SENDING NEW OUTBOUND SMS..............................................................98 7.8.1 Grab + SMS...........................................................................................98 7.9 ON-SCREEN TELEPHONE CALL CONTROL USING THE ADAPTIVE DESKTOP....................................99 Transferring a call.........................................................................................99 The Telephone Number combo..................................................................99 7.10 GRAB + DIAL.................................................................................................99 Configuring Grab + Dial................................................................................99 7.11 BUSY LAMP FIELD...........................................................................................100 Selecting which users and extensions to monitor........................................100 Icons view, Report view...............................................................................100 Double-clicking a monitored user or extension............................................101 7.12 CALL LISTS...................................................................................................101 Inbound calls...............................................................................................101 Outbound calls............................................................................................101 Missed calls.................................................................................................102
Page 3 of 176
September 2008
Personal contacts list...................................................................................102 Company contacts list.................................................................................102 7.13 SEE WHO IS CALLING.........................................................................................102 How does the Adaptive Desktop decide which entry to show?....................103 7.14 CALL-BACKS..................................................................................................103 Scheduling a personal call-back...............................................................103 7.15 MESSAGE DATABASE BROWSER............................................................................103 Simple and advanced searches...................................................................104 Viewing messages.......................................................................................104 7.16 ADAPTIVE DESKTOP VIEW MENU DISPLAY OPTIONS.....................................................104 7.17 THE CAMPAIGN CALL DIALOG...............................................................................104 8 THE COMPANY CONTACTS LIST.......................................................108 8.1 FILE NAME AND LOCATION.....................................................................................108 8.2 FILE FORMAT....................................................................................................108 An example company contacts l file............................................................108 Telephone number formats and the see who is calling feature................109 Commas within field data............................................................................109 Custom fields; screen-popping using account numbers instead of CLI........109 8.3 CREATING THE COMPANY CONTACTS LIST FILE................................................................109 How often can the file be updated?.............................................................110 How big can the company contacts list be?.................................................110 9 THE ADAPTIVE PROGRESSIVE DIALLER............................................111 9.1 HOW DOES PROGRESSIVE DIALLING WORK?..................................................................111 9.2 HOW TO USE THE ADAPTIVE PROGRESSIVE DIALLER........................................................111 9.3 PREPARING THE ADAPTIVE PROGRESSIVE DIALLER FOR FIRST USE.........................................112 Install and configure the software correctly................................................112 Make sure the appropriate blending options are set on the Adaptive CTI Gateway.......................................................................................................112 Using Do Not Disturb during progressive dialling........................................112 Creating more queues to hold campaign calls.............................................113 9.4 MAKING THE CALLS IN THE CAMPAIGN........................................................................113 9.4.1 The five stages of a campaign call at the Adaptive Desktop...............113 9.5 RUNNING MULTIPLE CAMPAIGNS SIMULTANEOUSLY............................................................115 9.5.1 Assigning more than one campaign to one user..................................115 9.6 VIEWING CAMPAIGN RESULTS.................................................................................115 9.7 STOPPING A CAMPAIGN EARLY................................................................................115 10 THE ADAPTIVE PREDICTIVE DIALLER..............................................116 10.1 WHY NOT JUST USE A PROGRESSIVE DIALLER?.............................................................116 10.2 HOW DOES PREDICTIVE DIALLING WORK?...................................................................116 10.3 PREREQUISITES...............................................................................................116 Dedicated extensions..................................................................................116 10.4 INSTALLING THE ADAPTIVE PREDICTIVE DIALLER..........................................................117 10.5 CREATING A PREDICTIVE DIALLER CAMPAIGN................................................................117 Abandoned predictive dialler calls...............................................................117 10.6 THE ADAPTIVE PREDICTIVE DIALLER MODULE.............................................................119 Configuring the Adaptive Predictive Dialler.................................................119 Telling the Adaptive Predictive Dialler to start dialling................................121 Telling the Adaptive Predictive Dialler to stop dialling.................................121 10.7 PREDICTIVE DIALLER CAMPAIGN CALLS AT THE ADAPTIVE DESKTOP......................................121 Configure your users handsets to auto-answer inbound calls.....................121 The Adaptive Desktop campaign call dialog for predictive dialler calls.......122 10.8 VIEWING CAMPAIGN RESULTS................................................................................122 10.9 STOPPING A PREDICTIVE DIALLER CAMPAIGN EARLY........................................................122 11 PROGRESSIVE AND PREDICTIVE DIALLER CAMPAIGN CALL SCRIPTS.123 11.1 CREATING TEMPLATE
CALL SCRIPT
(HTML)
FILES.....................................................123
Page 4 of 176
September 2008
What content should I put into my template HTML files?.............................123 What are the URLs for call control?.............................................................124 Can I use pictures, frames, style sheets, etc.?.............................................124 How can I get actual call data displayed in my scripts?...............................124 11.2 USE THE ADAPTIVE CAMPAIGN EDITORS SHOW THE SCRIPT VIEWER OPTION.......................125 11.3 IMPORT OR CREATE THE REQUIRED CUSTOM FIELDS FOR YOUR CAMPAIGN CALL DATA...................126 11.4 HOW THE ADAPTIVE DESKTOP DISPLAYS CALL SCRIPTS...................................................126 11.5 PASSING DATA FROM THE SCRIPT VIEWER INTO THE CAMPAIGN RESULTS.................................126 12 ADAPTIVE MESSAGING (ADAPTIVE DESKTOP SMS, ADAPTIVE WEB ASSIST AND THE ADAPTIVE CONTACT CENTRE)...................................128 13 USING THE ADAPTIVE DESKTOP TO PROCESS INBOUND MESSAGES.129 13.1 THE ADAPTIVE MESSAGE PAIR VIEWER....................................................................129 Message viewer macros and the Block Insert Text macro function.............130 Find related messages................................................................................130 13.2 ABANDONING AND NFA-ING INBOUND MESSAGES........................................................130 14 THE MESSAGE DATABASE.............................................................132 14.1 SUMMARY FILES AND CATALOGUING THE DATABASE........................................................132 14.2 CONFIGURING THE MESSAGE DATABASE ADMINISTRATOR...............................................132 15 ADAPTIVE WEB ASSIST.................................................................133 15.1 WEB CALL-BACKS............................................................................................133 15.2 WEB CHAT....................................................................................................133 15.3 PREREQUISITES...............................................................................................133 Can the Adaptive server software and the web server run on the same server PC?...............................................................................................................134 Which web server software can I use?.........................................................134 Network connections...................................................................................134 15.4 INSTALLING ADAPTIVE WEB ASSIST........................................................................134 15.4.1 Install the Adaptive server software on the Adaptive server PC........134 15.4.2 Install the Adaptive Desktop software on each client PC...................135 15.4.3 Install the Adaptive Web Assist files on the web server.....................135 Create a folder on your web server for the Adaptive software to use..........135 Register the Web Assist COM object on your web server............................136 Set up your global.asa file...........................................................................136 15.5 TRYING OUT WEB ASSIST...................................................................................136 15.6 CUSTOMISING ADAPTIVE WEB ASSIST.....................................................................137 Server settings and the global.asa file........................................................137 Style sheets.................................................................................................138 16 ADAPTIVE DATA CONTROLLER SERVICE.........................................139 16.1 STARTING AND STOPPING THE ADAPTIVE DATA CONTROLLER...........................................139 16.2 DATABASE ACCESS..........................................................................................139 17 TROUBLESHOOTING.....................................................................140 17.1 CONTACTING THE NEW MEDIA SOFTWARE SUPPORT TEAM...............................................140 17.2 WHERE DO I FIND MY SITE CODE, SERIAL NUMBER AND OTHER LICENCE INFORMATION?...............140 17.3 PERMISSIONS FOR THE AM DATA FOLDER.................................................................141 17.4 INSTALLATION PROBLEMS.....................................................................................141 17.4.1 The server software set-up program reported an error.....................141 17.4.2 The server set-up program didnt accept the serial number..............141 17.4.3 The Adaptive programs folder on the server PC doesnt appear to include all the modules your licence allows..................................................142 17.4.4 The client software set-up program reported an error.......................142 17.5 PROBLEMS RUNNING THE SERVER SOFTWARE...............................................................143 17.5.1 The Adaptive Queues Server service [all products]...........................143 17.5.2 The Adaptive CTI Gateway [Adaptive CTI and diallers]......................143
Page 5 of 176
September 2008
17.6 PROBLEMS LOGGING INTO THE ADAPTIVE DESKTOP.......................................................144 17.6.1 Are you using the local copy of the Adaptive Desktop?.....................144 17.6.2 Adaptive Desktop error messages when trying to log in...................144 17.6.3 It takes a very long time to log into the Adaptive Desktop................148 17.6.4 After logging into the Adaptive Desktop, the Telephone number combo is greyed out.....................................................................................148 17.6.5 After entering a telephone number and striking Enter, nothing happens .....................................................................................................................149 17.6.6 Troubleshooting the company contacts list.......................................150 17.6.7 The Adaptive Desktop isnt retrieving campaign calls or messages. .151 17.7 PROBLEMS WITH THE ADAPTIVE PROGRESSIVE DIALLER..................................................151 17.7.1 The Campaign Editor says it has assigned the campaign to the queue, but the users arent getting them................................................................152 17.7.2 Campaign calls are in the queue, but Adaptive Desktop users arent being presented with them..........................................................................152 17.7.3 Campaign calls are in the queue, but Adaptive Desktop users arent being presented with them..........................................................................152 17.7.4 Data controller - assigned campaigns are not placing calls in the queue .....................................................................................................................153 17.7.5 Data Controller Database errors are occurring...............................153 17.7.6 Data Controller Unknown errors are occurring................................153 18 BACKING UP AND RESTORING ADAPTIVE DATA..............................154 18.1 WHERE IS ADAPTIVE DATA STORED?.......................................................................154 18.2 BACKING UP DATA FROM YOUR ADAPTIVE SYSTEM.........................................................154 What should I back up?...............................................................................154 Shut down all Adaptive software before taking a backup............................154 18.3 RESTORING ADAPTIVE DATA.................................................................................155 18.4 MOVING YOUR ADAPTIVE SERVER SOFTWARE FROM ONE SERVER PC TO ANOTHER.....................155 WARNING....................................................................................................155 Moving your licence.....................................................................................155 How to do the move....................................................................................155 Advice on moving Adaptive server software................................................157 Dont! As you can see from this section, moving an entire Adaptive server installation is a lengthy and complicated process. There is considerable scope for error. It is quite possible that you will break your currently working software and it may take a great deal of time and effort before you fix all the faults that the move introduces...................................................................157 If you must move servers, ask your installation engineer to perform the move for you..........................................................................................................157 If you aren't under pressure, the procedure will be straightforward. If you ARE under pressure, particularly time pressure, it will be complicated........157 Allow yourself enough time to do each check in turn. Do not skip any of the checks described in this section...................................................................157 Check the permissions on the new AM Data folder and then check them again............................................................................................................157 19 BACKING UP ADAPTIVE CALL RECORDER CALLS.............................158 19.1 CREATING A NEW ARCHIVE..................................................................................158 19.1.1 Printing the Archive List.....................................................................159 20 TELEPHONE CONNECTIONS GUIDE.................................................160 INTRODUCTION................................................................................160 20.1 TERMINOLOGY USED IN THIS DOCUMENT....................................................................160 ISDN............................................................................................................160 Trunk...........................................................................................................160 TAPI.............................................................................................................160 TSP (sometimes called TAPI driver)..........................................................160
Page 6 of 176
September 2008
CLI (Caller Line Identification)......................................................................160 20.2 SUMMARY OF SUPPORTED TELEPHONE SYSTEMS............................................................161 20.3 WHICH ADAPTIVE PRODUCTS WORK ON WHICH TELEPHONE SYSTEMS?..................................163 20.4 AASTRA ASCOTEL INTELLIGATE..............................................................................164 20.4.1 Licensing requirements.....................................................................164 20.4.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................164 20.4.3 Extension numbering requirements...................................................164 20.4.4 Obtaining the TSP..............................................................................164 20.4.5 Installing the TSP...............................................................................164 20.4.6 Configuring the Adaptive CTI Gateway..............................................164 20.5 ALCATEL OMNIPCX OFFICE................................................................................166 20.5.1 Licensing requirements.....................................................................166 20.5.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................166 20.5.3 Obtaining the TSP..............................................................................166 20.5.4 Installing the TSP...............................................................................166 20.5.5 Configuring the Adaptive CTI Gateway..............................................167 20.6 AVAYA IP OFFICE............................................................................................168 20.6.1 Licensing requirements.....................................................................168 20.6.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................168 20.6.3 Obtaining the TSP..............................................................................168 20.6.4 Installing the TSP...............................................................................168 20.6.5 If your IP Office denies CTI access.....................................................168 20.6.6 Configuring the Adaptive CTI Gateway..............................................168 20.7 INTER-TEL AXXESS AND CS 5000.......................................................................169 20.7.1 Licensing requirements.....................................................................169 20.7.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................169 20.7.3 Configuring the Adaptive CTI Gateway..............................................169 20.8 LG LDK/IPLDK...........................................................................................170 20.8.1 Licensing requirements.....................................................................170 20.8.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................170 20.8.3 Obtaining the TSP..............................................................................170 20.8.4 Installing the TSP...............................................................................170 20.8.5 Configuring the Adaptive CTI Gateway..............................................171 20.9 MITEL 3300 ICP..........................................................................................171 20.9.1 Licensing requirements.....................................................................171 20.9.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................171 20.9.3 Software drivers obtaining and installing........................................171 20.9.4 Configuring the Adaptive CTI Gateway..............................................171 20.10 PANASONIC KX-TD.......................................................................................172 20.10.1 Licensing requirements..................................................................172 20.10.2 Installing the TSP.............................................................................172 20.10.3 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................172 20.10.4 Obtaining the TSP............................................................................172 20.10.5 Installing the TSP.............................................................................172 20.10.6 Configuring the Adaptive CTI Gateway............................................172 20.11 PANASONIC KX-TDA.....................................................................................173 20.11.1 Licensing requirements..................................................................173 20.11.2 Physical connection from the telephone system to the Adaptive server PC......................................................................................................173 20.11.3 USB................................................................................................173 20.11.4 CTI Link LAN card..........................................................................173 20.11.5 Obtaining the TSP............................................................................173
Page 7 of 176
September 2008
20.11.6 Installing the TSP...........................................................................173 20.11.7 If you are using a direct USB connection.......................................173 20.11.8 If you are using a CTI Link LAN card...............................................174 20.11.9 Configuring the Adaptive CTI Gateway...........................................174 20.12 SAMSUNG OFFICESERV AND 7200.....................................................................175 20.12.1 Licensing requirements..................................................................175 20.12.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................175 12.12.3 Obtaining the TSP............................................................................175 12.12.4 Installing the TSP.............................................................................175 12.12.5 Configuring the Adaptive CTI Gateway.........................................175 12.12.6 Configure the Samsung telephone system to use block dialling......175 20.13 SIEMENS HIPATH..........................................................................................176 20.13.1 Licensing requirements..................................................................176 20.13.2 Physical connection from the telephone system to the Adaptive server PC.................................................................................................................176 20.13.3 Obtaining the TSP...........................................................................176 20.13.4 Installing the TSP............................................................................176 20.13.5 Configuring the Adaptive CTI Gateway...........................................176 21.
Page 8 of 176
September 2008
1 Change History
Date 15/01/200 7 15/01/200 7 15/01/100 7 11/07/200 8 Section 1 Change History 8.7.3 Signatures 5.3 Configuring Users and Teams All Description This new section has been added to record changes in this document and make it easier to see whats new. A user-specific signature is now added to the outgoing email if configured. A screen shot of the add user screen has been added along with a description of how to configure signatures. Initial rewrite for Version 9 Release
Page 9 of 176
September 2008
2 Introduction
Welcome to the Adaptive software suite! This guide will help you to install, configure and use your Adaptive software. It covers all the Adaptive products, including: - Adaptive Management Console - Adaptive CTI Basic and Professional - Adaptive Desktop SMS - Adaptive Progressive Dialler - Adaptive Predictive Dialler - Adaptive Messaging - Adaptive Web Assist - Adaptive Contact Centre For more information on Adaptive software and how it can benefit your business, visit our website at www.nms-adaptive.com.
Page 10 of 176
September 2008
Server PC
To install the Adaptive Server software, you will need a PC running one of the following Microsoft operating systems: - Windows 2000 Server (service pack 4 or higher) - Windows XP Professional (maximum of 10 users) - Windows Server 2003 The server PC must have at least one Concurrent Access Licence (CAL) per user. For more information on minimum server PC specifications, visit the website.
Network connections
The server PC and all client PCs must be on the same LAN. Client PCs will need TCP/IP access to ports 54321 and 55443 on the server PC. These ports are configurable but 2 ports are required for use, 1 by the Adaptive CTI Gateway, and 1 by the Adaptive Queues Server. The server PC and all client PCs must have full file access rights to the AM Data folder on the server PC, used by the Adaptive server software to store settings and messages.
Adaptive Messaging sends and receives email using the industry-standard SMTP and POP3 protocols. Your network, your email server and your Adaptive Server PC must be configured to allow an application on the server PC to send email to the email server using SMTP and to receive it from the email server using POP3. Microsoft Outlook and Microsoft Exchange Adaptive Messaging is compatible with Microsoft Exchange. However, you must configure and start the Internet Mail Service, also known as the SMTP Service, on your Exchange Server. You cannot rely on the transport mechanism used between Microsoft Outlook and Microsoft Exchange. Microsoft Outlook is nearly always configured to use its own, proprietary, mail transfer protocols with Microsoft Exchange Server: it does not use SMTP and POP3.
Email servers (SMTP and POP3) and email accounts [Adaptive Desktop SMS and Adaptive Messaging]
Page 11 of 176
September 2008
If your email server is Microsoft Exchange, do the following simple test before you install and configure your Adaptive Server software. On the computer you will use as the Adaptive Server, use a standard email client (i.e. NOT Microsoft Outlook, although Outlook Express is acceptable, as is Pegasus, Eudora, pine, elm, etc.) to send email to and receive email from an EXTERNAL email account (e.g. a Hotmail account, or a Yahoo! account) using SMTP and POP3. If you can send email to and receive email from an external account using a standard client, then the Adaptive Message Processor will also be able to send and receive email. If you cannot send and receive email on the server PC using a standard client, nor will Adaptive Messaging. Common causes of difficulty sending and receiving email using SMTP and POP3 on Exchange Server include: - Failure to configure or start the Internet Mail (SMTP) Service. - Incorrect configuration of SMTP forwarding on Exchange Server. - A firewall blocking onward SMTP connections. Note that Adaptive Messaging itself is a standard email client, but because of its many configuration options, you may find it easier to test your SMTP/POP3 connections using a simpler client. Microsoft Outlook Express is freely available and is suitable for this task. Other standard email clients include Pegasus Mail and the command-line clients pine and elm.
Serial number
If you are installing the Adaptive server software for the first time, you will be asked to enter your serial number. Adaptive software licence serial numbers are actually long strings of upper-case letters. Your dealer or distributor will supply the serial number for your Adaptive software licence. Copy your serial number onto the Windows clipboard and then paste it into the Serial number box. If you have entered the number correctly, the Next button will be enabled.
Executables folder
This is where the Adaptive program files will be stored on the server PC. You can choose any local drive and folder on the PC.
The Adaptive software will store user settings, messages, contacts lists and many other shared items of information in this folder and its sub-folders. Choose a location carefully. Make sure you allow enough disk space (see the website for guidelines) and that you can grant all client PCs full file access rights to the folder and all its sub-folders. If your licence includes messages components such as email and SMS, the AM Data folder will contain your Message Database. Make sure the location you choose is reliable, large enough, has fast enough access and can safely be shared to grant full access rights to client PCs.
Data folder
Page 12 of 176
September 2008
You should also bear in mind that you might want to include the AM Data folder and all its sub-folders in your scheduled backup.
Page 13 of 176
September 2008
From the Windows Start | Programs > Adaptive menu, run Adaptive Management Console At the Activation Required dialog, enter the activation code into the Activation code edit box and then click the Enter activation code button.
How do I know when my Adaptive software needs activating? You will need to activate your Adaptive software whenever you install or upgrade your Adaptive server software. After installing or upgrading, you can use the software for a few days before activating it, but make sure you activate the software before this grace period expires. If your Adaptive server software needs activating, then it will display the Activation Required dialog whenever you start the Adaptive Server Launch application or the Adaptive CTI Gateway. You can also display the Activation Required dialog by clicking the Activate now button on the Current Licence Information dialog. Note: if the Activate now button is not displayed, then you do not need to activate your Adaptive software.
Page 14 of 176
September 2008
3.6.1
Software installation
Run the call recorder installer, AdaptiveCallRecorderSetup905.exe, as downloaded from the website. If the installation is an upgrade install, your previous settings will be loaded by the installer. Click Next for all configuration options. If youre performing a new install, you will need to configure the following options: 1. Executables directory: Defaults to C:\Program Files\Adaptive. This is where Adaptive will install its Call Recorder software. 2. Call Recorder Folder: This is the folder where the call recorder will save recorded calls and configuration details. This folder should be shared, with full file permissions granted for all users who will be using the Adaptive Management Console. You should have already created and shared this folder when installing the main Adaptive Server. 3. Call Recorder server name: This locates the SQL database where recorded call records will be stored. It should be of the form ServerName\InstanceName, where ServerName is the name of the computer you are installing the call recorder too, and InstanceName should be AMCR. As an example, if your call recorder computer were called Tech1, this value should be Tech1\AMCR. After these options have been configured, the Adaptive installer will begin copying files to your computer. During this process, the Adaptive installer will being installing Microsoft SQL Server 2005, to store recorded call records. If you already have Microsoft SQL Server installed, the installer will just create a new server instance called AMCR. Once this is done, the Adaptive Installer will exit. Navigate to your Call Recorder folder (as configured above), enter the Bin directory and double click on Install_HyperEngine.bat. This will install the Optilogix call recording service. Then, double click on Start_HyperEngine.bat to start the service for the first time.
3.6.2
Hardware installation
Insert the call recorder into a completely free USB 2 hub and power up the device. If you have any other USB device plugged in, you may experience hardware difficulties as the Call Recorder uses a large percentage of the USB bus bandwidth. Windows will detect the new hardware and will ask you to install the drivers for it. Follow the wizard and when asked whether Windows should connect to Windows Update, select No, not this time and click next. At the next window, select Install from list or specific location and click next. At the next window, tick Include this location in the search, and then click Browse. Navigate to your Call Recorder folder, open the Bin folder, then the USB folder. (by default C:\AM CR Data\Bin\USB). Click OK, then next in the Found New Hardware window.
Page 15 of 176
September 2008
Windows will now load the driver from that location. Then connect the cables to your telephone switch. When you install the driver, the LEDs on the Optilogix hardware should blink. Shortly afterwards, both LEDs should light up and stay on. If you have connected the recorder to your telephone switch, one light should begin slowly flashing. You may need to restart the HyperService service if the LEDs do not light up.
3.6.3
Page 16 of 176
September 2008
Executables folder
This is where the Adaptive program files will be stored on the client PC. You can choose any local drive and folder on the client PC.
Data folder
Enter the mapped network drive letter, followed by a colon and a backslash. For example, if you mapped the drive letter M to the network path \\<servername>\\AM Data then you should enter M:\ as the data folder path.
4.3 Toolbar
From the toolbar of the Management Console you will be able to do the following Login / Logout by clicking on this button Run the Campaign Editor Run the Macro Editor Run the Message Database Administrator Print the selected report
Page 17 of 176
September 2008
Get information about the Adaptive Management Console Get help for the Adaptive Management Console
4.4 Configuration
Select the Configuration Editor menu command to configure Users, Teams, Queues and User Statuses from any machine that has the Adaptive Management Console installed on it. See section 4.4.7 for more details on configuring these options for CTI use and section 4.4.8 for messaging options.
The Name and Password fields specify the details the user will use to log into the Adaptive Desktop. The Display name field specifies the name that will appear on that users Adaptive Desktop display and on all users Busy Lamp Field display if they monitor this user.
Page 18 of 176
September 2008
You may assign a user to a team by selecting the team from the Team dropdown list. If you have not created any teams, the list will be entry. Users do not have to belong to a team and you may leave the selected team set to <none> if you wish. The user can be assigned a default extension from this page. This will be utilised in conjunction with the CTI Gateway setting to use the default telephone extension numbers for users. The user can set the default language that they use for spell checking emails and SMS messages. By default this is set to English(UK) Custom (email) address Use these settings to allow the user to reply to emails using an email address specific to them. Custom (email) signature for this user (if required): Type in a specific signature to be added to any new email messages that this user creates. This signature will not be used when the user is presented with an incoming and outgoing email pair; in this case the signature should be generated using the Adaptive Rules Engine. This signature will be able to use HTML formatting to improve the look of your custom signatures. Agent Queues Configuration If your licence enables call-backs or campaign calls, the Add User and Edit User dialogs will display a Queues tab.
You can assign two types of queue to each user: Retrieval queues are the ones users can access to process call-backs and campaign calls. Forwarding queues allow users to assign call-backs for other users. Agent Macros Configuration
Page 19 of 176
September 2008
If your licence supports both call-backs and custom macros, the Add User and Edit User dialogs will also display a Macros tab.
This allows you to assign macros to buttons that will appear on the call-back message viewer, when a call-back is presented to this user. Agent Permissions Configuration The Permissions tab allows configuration of the module permissions that the agent will have access to (see next page for an image) Any area on this tab that is not checked will mean that the agent cannot use that module until the configuration is revised.
Page 20 of 176
September 2008
Agent Email Permissions Configuration The Email Permissions tab is used to configure the email permissions that will be allowed by the associated user
Page 21 of 176
September 2008
4.4.1.2 The Teams page The Teams page shows a list of all configured teams. Click the Add button to display the Add Team dialog. Team Name and Macros Configuration If your licence allows you to add macros to the Adaptive Desktop toolbar or the Macros menu on the Adaptive Desktop, then you can add standard or custom macros to the toolbar or menu by clicking the button immediately above the corresponding list.
Page 22 of 176
September 2008
Team Queues Configuration For each team, retrieval and forwarding queues are configurable, in the same way that they are configured for an agent. You can assign two types of queue to each team: Retrieval queues are the ones teams can access to process call-backs and campaign calls. Forwarding queues allow teams to assign call-backs for other teams.
Team Message Viewer Macros If your licence supports both call-backs and custom macros, the Add Team and Edit Team dialogs will also display a Message Viewer Macros tab (see image on the next page). This allows you to assign macros to buttons that will appear on the call-back message viewer, when a call-back is presented to this user. Note that buttons you assign here will appear on a second row in the message viewer toolbar, in addition to the row containing any buttons assigned to the user (see the previous section).
Page 23 of 176
September 2008
Team Screen-Pops If your licence enables screen-pops, the Add Team and Edit Team dialogs will show a Screen-Pops tab (see Image on the next page). See the dedicated Screen-Pops section of this guide for more information.
Page 24 of 176
September 2008
Team SMS Modems If your licence enables SMS Modems or SMS to email Gateways, the Add Team and Edit Team dialogs will show a Team SMS Modems tab (see Image on the next page). On this page you can configure your team to use either a configured GSM modem, or a configured email-to-SMS gateway. See Section for configuration details.
Page 25 of 176
September 2008
Page 26 of 176
September 2008
If each of two different rules creates a reply to an inbound message, both replies are valid and will be sent. One rule cannot both send an auto-reply and put a message into a queue for a user to handle. To achieve this, you should use two different rules. To apply rule changes, you must stop and restart the Message Processor. (You do not need to stop the Queues Server.)
4.4.2.2 How to create a rule to auto-reply to every inbound email Create a new rule Click the button above the list of rules, to create a new rule. Enter a descriptive name for the rule, such as Auto-respond to all inbound emails. Create an action to write the reply Click the button above the list of actions, to create a new action. Give the action a meaningful name, such as Unconditionally send auto-reply. Click the button above the list of write items, to create a new write item:
Select the Text radio button and click Next. On the second page of the wizard, enter the text of your auto-reply and click Next:
Page 27 of 176
September 2008
On the third page of the wizard, choose end of body and click Finish:
Page 28 of 176
September 2008
Back in the Action Editor dialog, click the Change button (at the bottom of the dialog) and at the Output Options dialog, check the Include the inbound message check box and select the send the outbound message radio button:
Click OK to close the Output Options dialog, OK to close the Action Editor and OK again to close the Rule Manager and save your new rule. Remember to stop and restart the Message Processor to apply your new rule. 4.4.2.3 How to create a rule to put sales inquiries into the Sales queue Make sure you have a Sales queue If you do not already have a queue called Sales, use the Configuration Editor Queues page to create one. Remember to log out all users and stop and restart the Queues Server service, to apply your change. Create a new rule Click the button above the list of rules, to create a new rule. Enter a descriptive name for the rule, such as Put sales emails into the sales queue. Create a search to find out if the email was to sales Click the button above the list of searches, to create a new search. Select text search type. In the Text Search Editor, enter a meaningful name for the search, such as Was the email sent to sales? Click the button above the list of search criteria. In the Edit Text Search Criterion dialog, in the Look for this text box, enter sales@. From the Where to look in the message drop list, select To address. In the Type of match section at the bottom of the dialog, from the Use this precision drop list, select exact.
Page 29 of 176
September 2008
Click the OK button to close the dialog. Click the OK button at the Text Search Editor dialog. Create an action to put the message in the Sales queue Click the button above the list of actions, to create a new action. Give the action a meaningful name, such as Put sales messages into sales queue. In the Action Editor dialog, click the button above the list of required searches. The Was the email sent to sales? search name will appear automatically in the list. Go straight to the Change button and in the Output Options dialog, select place the draft reply in this queue. From the drop list, choose the Sales queue.
Click OK to close the Action Editor and OK again to close the Rule Manager and save your new rule. Remember to stop and restart the Message Processor to apply your new rule.
Page 30 of 176
September 2008
4.4.2.4 What the two example rules will do When the Message Processor downloads an email sent to any of the addresses you configure on the Email Server Pairs page of the Configuration Editor, it will automatically create and send a reply. In addition, if the email was sent to sales@ (assuming you have configured such an address as one of your email server pairs), then the inbound message and a blank template reply will be put into the Sales queue, ready for a user to retrieve and process using the Adaptive Desktop. Inbound messages to sales@ will receive an auto-reply and will be put into the Sales queue. All other inbound messages will receive an auto-reply but will not be put into a queue. In an operational environment, you would in practice either limit the auto-reply to sales messages, or create another rule to put non-sales emails into another queue.
Note that the Campaign Editor is just that: an editor. The campaigns you create in the editor are just files: lists of names and numbers, together with associated settings. A campaign only goes live when you assign it to a queue. You can load and save files as often as you like using the Campaign Editor and you will not affect any active campaigns until you use the Assign campaign command. Campaign name Users see the campaign name when the Adaptive Desktop displays the campaign call dialog. Managers see it when they use the Adaptive Management Console to view the results of the campaign. Always try to enter a meaningful name,
Page 31 of 176
September 2008
because both users and managers will be using that name later. (Note that the display name of the campaign need not be the same as its file name.) Adding calls manually You can use the Add Call dialog to add a call manually to your campaign. Click the button above the Calls to make list to display the Add Call dialog. In the dialog, enter the telephone number and the contact name. (There are no custom fields in a new campaign.) Then click OK to close the dialog. The new call is added to the list of calls in the campaign. Note that you can move calls up or down the list by selecting them and using the up and down arrow buttons. Similarly, you can also manually edit or delete a campaign call. Importing lists of calls To import a list of calls, use the Campaign | Import From File menu command. Use the standard Windows File Open dialog to select a text file. The file format should be plain text (ASCII), with one entry per line, each field being separated by commas. The Adaptive Campaign Editor treats the first line of the file as a list of field names and each subsequent line as a campaign call, consisting of the telephone number, the name, and then any custom fields. The simplest example of a suitable file is as follows: Telephone Number,Contact Name 08456124000,New Media Software 02380698176,Fred Bloggs Importing calls with custom fields A slightly more complicated example would be: Telephone Number,Contact Name,Account Code 08456124000,New Media Software,DC44581 02380698176,Fred Bloggs,AN88475 The first line may contain the field names. The first two field names should always be Telephone Number and Contact Name. You can include up to ninety-nine (99) custom fields after the Telephone Number and Contact Name. If you use custom fields, make sure each entry has the same number of fields, otherwise your users may find it confusing (and any custom campaign screenpops may not work as expected). Once you have selected your import file, and this is the first time you have imported data into this campaign, a dialog box will be displayed as shown below:
Page 32 of 176
September 2008
Use the First row contains column headers to specify whether your import file contains headers or not. If your file does not contain headers then un-tick this option and default field names will be created for you. You can now specify the type of each field in your import data. If you wish to use multi-number dialling in your campaign then simply double-click on each of the fields that contain the telephone numbers to call. You will see that each time you double-click the field type will toggle between Standard and Telephone Number. You will notice that you cannot change the type of the first two fields in the list as these are fixed fields that are required by the Adaptive software. Any fields marked as Telephone Numbers will be subjected to a validation routine during the import process to make sure that the field contains valid telephone numbers. Once you have completed your field definitions click the OK button to run the import. Clicking the Cancel button at any time will close the dialog box without importing any data. Importing more calls into an existing list of calls If you use the Import function for a campaign that already has one or more calls, then the newly imported calls will have the same number of custom fields as the existing calls. If each entry in the newly imported file has fewer fields, then the later custom fields for each added call will be empty: if each entry has more fields, then later fields will be discarded. If the subsequent files you import have field names in the first row then make sure you find and delete this row in your campaign data list.
Page 33 of 176
September 2008
4.4.3.1 Campaign settings In the Adaptive Campaign Editor, use the Campaign | Settings menu command to launch the Campaign settings dialog. The Wrap-up and Retries page
Call preparation time is how long the Adaptive Desktop will display the campaign call dialog to the user before starting to dial the call. This can be useful for giving the user time to find the right script, or customer record. If you check the unlimited box, then the Adaptive Desktop will present the campaign call dialog to the user, but will not dial it until the user clicks the Dial button on that dialog. Post-call wrap-up time is how long after the call has ended (by either the user or the customer hanging up their telephone) the Adaptive Desktop will wait before returning to an available state and starting to blend the next piece of work for the user. During wrap-up, the Adaptive Desktop marks the user as unavailable and sets the telephone extension to Do Not Disturb (if so configured). Engaged and unanswered retry counts tell the Adaptive Desktop how many times to redial calls that were engaged or unanswered. A call counts as unanswered if it rings for more than the time specified in the edit box, where ring time is measured from the time the Adaptive Desktop issues the Dial command to the telephone system.
Page 34 of 176
September 2008
This page determines how the call is presented to users at the Adaptive Desktop. The default behaviour is to Show the standard campaign call dialog. When the Adaptive Desktop retrieves the call, it will show the user the pop-up dialog box described in section 7.16, displaying basic call information such as the contact name and allowing the user to select a result code for the call, or reschedule the call, etc. Show the script viewer will present an HTML-based call script to the user at the Adaptive Desktop. The script can allow the user to control the call, including selecting the result code for the call or rescheduling it, in a similar way to the standard campaign call dialog, but via any standard HTML command. See section 11 for more information.
Page 35 of 176
September 2008
Use this page to set up a list of result codes (also known as outcome codes). While the user is on a campaign call, the Adaptive Desktop shows these codes in a drop list in the campaign call dialog. The user can choose one of the codes in the list at any time during the call, including during wrap-up time (if any). When the call ends and the dialog closes, the result code selected by the user is logged as the outcome of the call. When the Adaptive Management Console generates a results report for the campaign, it will show the result of each call using two columns, one being the numerical value of the code and the other being the name given to that code. When you add a result code to the list in the Result codes page of the Campaign Editor, you can specify both the name and the numerical value of the code, so that you can coordinate result codes with your normal database reports, if required. The order of result codes in the list prescribes the order in which they will appear in the Result code drop list presented to the user, in the Adaptive Desktop campaign call dialog. On the Result codes page of the editor, you can change the order of result codes using the up and down arrow buttons. Result code actions When creating a result code you can also specify what action the Adaptive Desktop should take. The following actions are available: Contact Completed, this is the default action and completes the campaign call putting the user into wrap if required. Dial the next number, this hangs up the current dialled call and tries to dial another number for the contact if one is specified. Dial the next number and never retry this number, this hangs up the current dialled call and tries to dial another number for the contact if one is
Page 36 of 176
September 2008
specified. It also marks the current dialled number as unusable in the campaign so that it is not redialled again if this call is placed back into the queue. The Rescheduling page
Default reschedule time determines the time users will see at the desktop when they use the Reschedule button to reschedule a campaign call. For example, if you set this default to one hour, then if a user clicks the Reschedule button at 10.43, the Reschedule Campaign Call dialog will show 11.43 as the initial time. The user can of course change this time as appropriate. This campaign setting can be useful for reducing the amount of time selection users have to do when rescheduling calls. Maximum reschedule time restricts how far ahead users can reschedule calls. For example, it is seldom useful to reschedule a call for over a year from now! If the user reschedules a campaign call for more than the maximum reschedule time you configure in the campaign settings, that time will automatically be reduced to the configured maximum. Allow users to reserved rescheduled calls for themselves means that if a user reschedules a campaign call using the button on the campaign call dialog, the Reschedule dialog will give the user a check box to make sure that when the rescheduled call is due, it will be presented only to that user. If the box is left unchecked, or if you configure your campaign settings not to allow users to reserve rescheduled calls for themselves, then when a rescheduled campaign call is due, it will be presented to the next user who can retrieve calls from that campaign, regardless of which user rescheduled it.
Page 37 of 176
September 2008
As discussed in an earlier section, when you import calls into a campaign, you may choose to import custom fields for each call, in addition to the standard Telephone Number and Contact Name fields. The first line of the imported file can be used to specify the names of the custom fields. You can add, edit or remove custom fields using the Fields page. To add a custom field click the add button and enter the name and type of field in the boxes displayed as shown below.
The type of field tells the Adaptive software how to interpret the field when the campaign call is presented for dialling. Any field with the type Telephone Number will be used by the Adaptive Desktop or Predictive dialler as a valid telephone number to dial. This allows campaign call records to contain multiple telephone numbers for a single contact. For example home, mobile and work numbers. When the campaign call is presented the Adaptive software will dial each number in turn (in the order they are found in the custom fields) until it gets a successful connection. Once a campaign call is Result coded then, depending on the Result code selected by the User, the next number may be dialled whilst keeping the same campaign call available on the Adaptive Desktop. For example the user may successfully connect to an answer machine at the contacts home and code the call as such, then continue to call the contacts mobile number.
Page 38 of 176
September 2008
To edit a custom field highlight the required field and then click the button. To delete a custom field highlight the required field and then click the X button. You can change the order of your custom fields by highlighting a field and then use the up and down buttons. You cannot edit or change the first two fields, Telephone Number and Contact Name, as these are required fields for the Adaptive software and as such are fixed. Remember that what you are changing is the number and name of the fields, not the values of those fields for any particular campaign call. You can change the values of custom fields for a specific call in the main campaign editor window, by selecting the call in the list and clicking the button to bring up the Edit Call dialog. The Select Queue Page
To eliminate mistakes and speed up the assigning process when putting call data into queues you can pre-select a queue on this page. Selecting a queue here does not assign any calls to it. When you select Assign campaign from the menu this queue will be automatically selected on the Assign dialog screen. Leaving this selection blank will also default the Assign queue dialog selection to blank.
Page 39 of 176
September 2008
You can assign macros to run at the following points during a campaign call: - When the campaign call is presented to the user (i.e. when the Adaptive Desktop shows the campaign call dialog). - When the call starts ringing. - When the call is answered. - When wrap-up begins after the customer or the user hangs up. - When the call is rescheduled. - When the campaign call dialog closes. These campaign-specific screen-pops are independent of any normal screen-pops configured for all outbound calls made by users in a team. This is useful if, for example, a user participates in outbound dialling campaigns but also makes noncampaign calls. In this case, if you were to assign a generic outbound telephone call screen-pop, then the screen-pop would be activated for every outbound call, not just for campaign calls. If you do assign both campaign-specific screen-pops and generic outbound call screen-pops, then at the appropriate event, all your screen-pops will fire. Campaign-specific screen-pops do not replace generic screen-pops. Creating campaign-specific screen-pop macros using the Adaptive Macro Editor When you insert a message field into a custom macro, using the Select Message Field dialog in the Adaptive Macro Editor, the bottom two types of field you can select are Campaign call field and Campaign call custom field number. The Campaign call field value for a call allows you to specify that the macro should type the telephone number, contact name or result code. If you use result code, then the macro will type the numerical value of the result code currently selected by the user. If the user has not selected a result from the drop list in the campaign call dialog, then the macro will type 0 (zero).
Page 40 of 176
September 2008
If you select Campaign call custom field number and enter the number of the custom field you wish to use in the edit box, then when the macro runs, it will type the value of the specified custom field for the current campaign call. For example: suppose you write a custom macro to type the value of Campaign call custom field number 1 into Notepad, and you assign this macro to the campaign screen-pop event Campaign call presented. When the user is presented with the campaign call dialog for the following call: 08456124000,Phill McGowan,DC44581 Notepad will appear and DC44581 will be typed into it. The Campaign Data Page The tab for this page is only visible if the Adaptive Data Controller service is running on the same machine as the Campaign Editor. This is due to the fact that Data Controller sessions must be created on the same server to guarantee that the database connections are setup correctly. If you cannot see the Campaign Data tab make sure that the service is running then close and re-open the settings page. Note: Before setting up Campaign Data please create any custom fields required as these will be required to match to the database fields. The Campaign Data page is shown below:
To use the Data Controller for a campaign you must first tick the Configure data controller box. Database options
Page 41 of 176
September 2008
First you will need to setup a connection to your database to do this click the Connection button. The process of setting up a connection is described in section 4.2. Once you have a database connection you then need to specify how to retrieve your data from the database. The use of the Wizard and Advanced options for doing this are also covered in section 4.2. Important note: All data fields that are matched with custom fields must be returned from the database as text fields only. Data Controller does not support the conversion of other field types. Results options When the Data controller imports your campaign you have the option of storing your campaign results in a single file or in multiple files. Select One file or One file per schedule option as required. Selecting the One file option will create a single result file not matter how many times this campaign is imported on a scheduled basis by the Data Controller. This file will appear in the Management Console reports dated as of the first day that the schedule ran. Selecting Once file per schedule will create a new result file for each import that the Data Controller makes for this campaign. Each result file will be dated as per the time that the Data Controller executed that particular import. Purge options Each time the Data Controller runs the campaign you can choose to remove some or all of the existing calls from the queue before importing new data. Depending on the options selected, using the tick boxes, you can remove any combination of undialled, engaged, unanswered or rescheduled calls. Additionally you can choose whether the purge relates to the entire queue or just to calls that belong to this campaign. This allows any other calls in the queue to be preserved if required. Schedule options To schedule the campaign data to run with the Data Controller first select which days of the week it will run by ticking the appropriate boxes. You then have the option of running the import once a day by selecting the Once at button and specifying a time with the drop-down boxes. Alternatively you can schedule the import to run continuously within a period of time each day. To do this select the First run at button and select the time at which the import will start running followed by the time that the import will stop running. You can then choose to import data every so many minutes by ticking the Every box and entering a value in minutes. You can also choose to import data when the number of calls reaches a particular threshold level. Tick the If undialled campaign calls fall to box and enter the required value in the box. These methods can be used either separately or in combination when scheduling an import. 4.4.3.2 Assigning the campaign to a queue Save the file first! Always save a campaign to a file before assigning it. Use the File | Save As menu command. Note that saving a campaign to a file does not activate it. The campaign file can be saved to any directory, but it is recommended that you keep your campaign files in the Campaigns sub-folder of the AM Data folder. Typically, the path will be: C:\AM Data\Campaigns
Page 42 of 176
September 2008
If you have created a Data Controller campaign the you will be forced to save the campaign before you assign it. Assign the campaign Use the Campaign | Assign Campaign menu command, or click the toolbar button, to display the Assign Campaign To Queue dialog. Select a queue from the drop list and then click the OK button. Make sure that all your campaign settings are correct before you assign a queue. Once you have assigned campaign calls to a queue, you cannot change the settings. If you have imported calls directly into the campaign then as soon as you assign the campaign to a queue, the calls are placed in that queue and users can start to retrieve them. However if you have created a Data Controller campaign then the campaign is simply registered with the Data Controller Service and the calls will be placed into the queue based on the schedule you have specified. To monitor the Data Controller use the Adaptive Management Console, see section 13.4 for more details.
Page 43 of 176
September 2008
Edit a team (or add a new team) and on the Name and Macros tab, click the new button above the Buttons on the toolbar list. - Select a macro file (using a standard File Open dialog). - Click OK to close the dialog, then OK on the Edit Team dialog. - Make sure a user is assigned to the team you have just edited. - Go to an Adaptive Desktop, log out any current user, then log in as a user who is a member of the team to which you have assigned the screen-pop. You should notice that the macro you assigned to the team now appears as a button on the macros toolbar. Make a telephone call to the users extension and click the button to check that the screen-pop works. You can also assign a manual screen-pop to the Macros menu in the Adaptive Desktop, instead of the macros toolbar. To do this, in the sequence described above, simply click the button for the Macro menu commands list instead of the Buttons on the toolbar list. 4.4.4.4 Automatic versus manual screen-pops An automatic screen-pop will always happen whenever the event occurs. If you assign Screen-pop MS Outlook to inbound telephone call ringing, then every inbound call will switch the focus to Microsoft Outlook and attempt to find a matching record. This is suitable for a user who always answers inbound telephone calls from customers and needs to know as soon as possible the details for the caller. However, it may be less suitable for a user who receives many intercom calls, or who might need to speak to the caller first before deciding which database to use. You can use manual screen-pops at any time during a call, by clicking the button. You can even use manual screen-pops when there is no telephone call active at your extension, although of course there will be no CLI. You can assign as many macros as you wish to the toolbar and the Macros menu on the Adaptive Desktop. In this way, you could for instance have two or three different screen-pops available to the same user for different types of call.
Page 44 of 176
September 2008
4.4.4.5 Custom macros the Adaptive Macro Editor With Adaptive CTI Professional, the Adaptive Macro Editor allows you to create your own macros. This editor can be run from the Adaptive Management Console Toolbar, or from the Configuration Menu of the Adaptive Management Console.
Remember that an Adaptive Macro is really just a series of keystrokes. To see this, type abc into the body of the macro (the large edit box labelled Macro in the editor). To test your macro, you can now click the Run toolbar button to run it in the Macro Editor. You will notice that when the macro runs, it types what was in the body of the macro. The text now reads abcabc because the macro typed the letters abc into the current window. From this, you can see that one simple but useful type of macro is one that types standard words or phrases for you. Such macros can save users time and effort, as well as helping them to avoid mistakes. The Adaptive Macro Editor also allows you to embed simple commands into your macros. You can use these to: - Type any keystroke (not just qwerty characters) - Type the current value of a variable, e.g. the current callers CLI, instead of just fixed characters. This is the foundation of telephone screen-pop macros. - Switch the focus to another Windows application. This allows a macro that was run from the Adaptive Desktop to type fixed characters or even variables into the Find box of a database application. Creating an example custom screen-pop
Page 45 of 176
September 2008
The following will create a macro that will run a new instance of Notepad and type the telephone number of the current call into it. This example will show you the basics of creating custom screen-pop macros and assigning them to users. Run the Adaptive Macro Editor and create a new macro. In the Display name box, type Show number in Notepad. Use the Insert | Function | Run Program menu command or the toolbar button, to display the Insert Run program macro command dialog:
Type Notepad.exe and click OK. You will see that this has appeared in the body of the macro: run(Notepad.exe) Now use the Insert | Message Field menu command the Select Message Field dialog: toolbar button, to display
Select Telephone Number in the Pre-defined field combo, then click OK. You will see that the body of the macro is now: run(Notepad.exe)field(Telephone Number) Now save the macro, using File | Save As in the usual way. Call the file name ShowNumberInNotepad.amm so that later on it will be easy to remember what the macro does.
Page 46 of 176
September 2008
IMPORTANT NOTE: make sure you save the macro file in the Macros sub-folder of the AM Data folder. By default, the Save As dialog should start in that directory, but on some versions of Windows, you may find that it starts in My documents instead. Screen-pop macros must be stored in <AM Data directory>\macros. Testing the macro in the Macro Editor To test the macro, use the Run | Run menu command or click the Run toolbar button . A new copy of Notepad will run and the number 0123456789 will be typed into it by the macro. (If this doesnt happen, go back to the start of this section and make sure that you followed all the steps correctly.) Testing the macro in the Adaptive Desktop Now follow the same steps described above for assigning a standard screen-pop to the inbound telephone call ringing event for a team, but instead, assign your new, custom macro. Log into an Adaptive Desktop as a user in that team and make a telephone call to that extension. You should see a new copy of Notepad appear and your CLI appear in it. 4.4.4.6 Can I screen-pop my application? Can you set the Windows focus to your application window? Can you make the application do what you want using only the keyboard, not the mouse? If the answer to both the above questions is yes, then you can screen-pop your application. Designing a custom screen-pop Remember that a screen-pop is just a way of automating some or all of a normal business process. A screen-pop macro does exactly what a user does manually: it just does it faster, more easily and without mistakes. To design a screen-pop, you simply need to replicate what the user does manually, but using keystrokes and macro commands. All applications are different, but when you consider carefully what your really want to happen when a screen-pop event happens, the sequence of events is nearly always this: - The telephone rings or is answered. - The user notes the CLI or caller name, as displayed by the telephone handset. - The user switches focus to the application. - The user opens the applications Find or Search dialog. - The user types in the CLI or caller name, then clicks OK, Find now or Search now. - The application displays the callers details. To design a screen-pop macro to replicate this sequence, all you need to do is substitute the appropriate keystrokes and macro commands for the existing, manual, user actions. For example: suppose Widgets Ltd uses Brand X Database to hold customer records. At present, when Sally in sales answers the telephone to a customer, she goes to Brand X Database on her PC, uses the Find menu command to bring up the Find Customer Record dialog, carefully copies the CLI from her telephone handset into the Telephone number edit box and then strikes Enter. To create a screen-pop macro to automate this, go to Sallys PC and put a small cardboard box over the mouse, so that you cant use it. (!) Now use the
Page 47 of 176
September 2008
keyboard to switch to Brand X Database and bring up the Find dialog. This will probably involve typing Alt+F, or Alt+T followed by i, or Alt+S; the exact keystroke will vary from one application to another. Write down which key or keys you needed. At the Find dialog, use the keyboard to move the caret edit box cursor to the Telephone number edit box. There may be an accelerator for this, such as Alt+P or Alt+T; or there may not, in which case you can always strike the Tab key a set number of times until the focus is in the Telephone number field. If you have to use a number of tabs, make sure you count them carefully and that its always the same number of tabs from opening the Find dialog. Again, write down which key or keys you needed. Type in a telephone number and then strike Enter. (If that doesnt initiate the search, you may need to work out a key combination to make the search start, such as using the Tab key one or more times to put the focus on the Search now button and then strike Enter or Space.) Finally, you may or may not need to strike the Esc key to clear the Find dialog. Now go to the Adaptive Macro Editor and create a new macro. The first thing to do is to insert a command telling the macro to switch the Windows focus to the Brand X Database window. Do this by using the Insert | Function | Set Focus menu command or the toolbar button, then in the Set focus dialog, enter the caption of the Brand X Database window, or a unique part of the caption. (For instance, if you look at a new copy of Notepad, youll notice that it says Untitled Notepad. The word Notepad always appears in its caption, even when you use Notepad to edit an existing file.) Now enter your keystrokes into the body of the macro. Be careful to enter exactly the same sequence as you wrote down. If necessary, use the Insert | Special Key menu command or the toolbar button to allow you to enter special key combinations (such as Alt+F) into the macro. Save your macro with a suitable file name. If you have a copy of Brand X Database running on the computer, try running the macro from within the Adaptive Macro Editor and see if it works. If not, you will have to assign the macro to a button or a screen-pop event and then log into Adaptive Desktop on a computer that does have a copy of Brand X Database.
Page 48 of 176
September 2008
Page 49 of 176
September 2008
Click the Add button to add a new queue. Make sure the name you enter is not the same as any of your existing queues. If you check the Allow manual message selection by permissioned users box, then users who can retrieve messages from this queue can choose the order in which they retrieve messages. If the box is not checked, users will always retrieve the oldest message in the queue. The Service level settings you enter for a queue will tell the real-time queues report when to show a red bar for messages in the queue, instead of the normal green bar. Purging queues If you need to remove all the calls or messages from a queue, you can select the queue and click the Purge button. If the Queues Server is running, the Purge button will remove all campaign calls. If it is not running, the button will remove all calls and all messages. When clicking the Purge button you will be presented with the following screen:
Page 50 of 176
September 2008
Click the box next to type of calls in the queue that you wish to purge. Click the OK button to the purge the selected calls from the queue. You will be presented with a count box telling you how many calls of each type have been removed. Clicking the Cancel button will close the Purge queue screen and the queue will not be affected. You will notice that the All Messages box is greyed out. To remove all the messages from a queue you must first stop the Adaptive Queues Server. You must make sure all users have logged out before you stop the service. Once you have stopped the service you will find when you reselect the purge option that the All Messages box is now available. 4.4.5.2 Configuring User Statuses
The User Statuses page shows the list of Unavailable statuses that users can use when they use the Unavailable command on the Adaptive Desktop. If your licence enables the Adaptive Management Console, then the historical single user
Page 51 of 176
September 2008
report will show a breakdown of the time the user spent unavailable, based on which of these statuses the user chose. 4.4.5.3 Configuring the Queues Server
You will usually not have to change these settings from their default values, unless your network is configured to restrict certain IP connections or ports. Multiple Editors Only one user at a time may edit the configuration details. If the system detects that more than one user is editing the configuration then a warning message will be displayed to the current user. The editing lock can be overwritten but this may mean that edits made by the other user will be lost.
Page 52 of 176
September 2008
All licences support Client Server Comms, Do Not Disturb and Banned Numbers. Some licences (e.g. Adaptive CTI Basic) may not support all of the other pages.
Page 53 of 176
September 2008
4.4.7.1 Configuring the Client Server Comms See the image in section 4.4.7 Communication with Adaptive Desktop The top half of this page shows the settings that Adaptive Desktop clients will use to communicate with the Adaptive CTI Gateway. You will usually not have to change these settings from their default values, unless your network is configured to restrict certain IP connections or ports. Use default telephone extension numbers for users If this option is checked, then the number that has been configured for an agent (see section 4.4.1.1) as their default extension will used at the time of Login to the Adaptive Desktop. Communication with the telephone system The bottom half of the page lets you specify the telephone system to which the Adaptive CTI Gateway will connect. Use the drop list to select the type of telephone system, then click the Settings button to configure the settings for your particular telephone system. Supported telephone systems and their settings Inter-Tel Axxess You need to enter the IP address and port number for your Axxess. (The port number usually defaults to 4000 for direct telephone system connections and 4001 for CT Gateway connections.) If you are using the Inter-Tel CT Gateway: enter the Applications IP address and port number. If you do not have the Inter-Tel CT Gateway and you are using an Axxess v8 or above: enter the IP address and port number of your Axxess. If you have a pre-v8 Axxess and you are using the Inter-Tel Switch Transceiver but NOT the Inter-Tel CT Gateway: enter the IP address and port number of the Switch Transceiver. Mitel 3300 ICP There are no settings for the Mitel telephone system. All you need to do is install and configure the MiTAI run-time library on the server PC. TAPI 3rd Party The exact settings you require will depend on which type of telephone system you have. In general, you should use one of the Preset buttons to configure the settings automatically to match your telephone system. Click the button appropriate to your telephone system and all the settings will be set appropriately.
Page 54 of 176
September 2008
The most typical use of the Dialling Properties dialog is to tell the Adaptive CTI Gateway to dial 9 for an outside line. To do this: - Check the box marked Identify a dialled number as external. - Select the before dialling, always prefix with these digits radio button. - Enter 9 in the edit box. The Settings dialog Line Device Identification
Page 55 of 176
September 2008
The Line Device Identification tab of the TAPI Settings dialog is required to be configured for any TAPI compliant phone system that the Adaptive Software has been integrated with. You would use this page to configure any prefixes or suffixes required for extensions on phone systems. The Settings dialog DND Settings
The DND settings tab is used for setting and detecting DND for different phone systems.
Page 56 of 176
September 2008
The Trace Information (diagnostics) tab is used to configure additional trace information that will be displayed the CTI Gateway event viewer.
Page 57 of 176
September 2008
The See who is calling feature of Adaptive CTI relies on the CLI (Caller Line Identity) number for a call. Telephone systems can be configured to pass the CLI in various ways. For instance, suppose a customer with a home telephone number 02380 612404 calls your company. The following actual examples show how different telephone systems would pass the CLI for the call to the Adaptive CTI Gateway: 02380612404 2380612404 902380612404 92380612404 442380612404 Comparing telephone numbers with contacts list entries To avoid having multiple entries in your Contacts List for each contact just to cope with all the different possible ways in which the telephone system might pass the CLI, you can use the Compare only the rightmost digits in numbers setting. Check the box and enter the number of digits to compare, in the edit box. The default value, 8, is recommended. Contacts list display If you check the Show the company contacts list on the desktop box, then the Adaptive Desktop will show all the entries in your company Contacts List to users, as an extra tab on the Call Lists section of their Busy Lamp Field dialog. Your users can use this list as a company directory, or company-wide speed dial list. N.B. if your Contacts List is large (e.g. over a thousand entries), the size of the list displayed on the Company Contacts List tab for users may be too large to be usable.
Page 58 of 176
September 2008
If you check the Refresh contacts list every box and then select a refresh time in the drop down box then the list of contacts displayed on the Adaptive Desktop will be updated periodically based on the time selected. Contacts list import The settings in this box allow the contacts list to be imported from any ODBC compliant database. The Current connection box specifies the name of the data source that the contact list is currently imported from, if any. To select or create a database for importing contacts click the Connection button and you will be presented with the following screen.
If the data source you require is in the list then select it and click OK, alternatively you may click the New button to create a new data source. Follow the instructions given by the wizard to create a new data source and when complete select it and click OK. You will then be returned to the settings screen. You can now choose how to collect your contact data from the database. You can either click the Wizard button which allows you to select the data using point and click options. Or you can click the Advanced button which allows you to directly write a database query.
Page 59 of 176
September 2008
If you opt to use the Wizard then you will be presented with the following screen.
The Tables drop-down box contains a list of database tables found when connecting to your data source. Select the table you require that contains your contact details. Once you have selected a table the Database fields available will automatically fill with a list of fields found in the table you have selected. These fields will be displayed in alphabetical order. To the right of the Database field name list you will see a pre-populated box titled Match an Adaptive field to a database field. This list contains the first seven (7) fixed fields for the contact list required by Adaptive along with a further ninety nine (99) custom fields. You simply need to match the database fields in the Database field name fields to the Match an Adaptive field to a database field fields. To do this highlight a field in the Database field name list by clicking on it. Then highlight the field you wish to match in the Match an Adaptive field to a database field list then click the > button. You will see the name of the database field appear next to the Adaptive field in the Match an Adaptive field to a database field list. If you wish to match more that one database field to an Adaptive field, for example if your database fields separate out contact name into Title / First Name / Last Name, then simply hold down the Ctrl key on your keyboard whilst selecting each field. You will notice that each field remains selected in the list as you scroll up and down. Releasing the Ctrl key and clicking anywhere in the list will cancel a multiple selection. When you match multiple fields to an Adaptive field by clicking the > button you will notice that the following characters are added + +. This is to ensure that there is a space between the fields when displayed. If you wish to change a field match simply reselect fields from each list and click the > button and the match will change.
Page 60 of 176
September 2008
If you wish to remove a match then highlight the required Adaptive field and click the < button. You will see that the matching Database field name is blanked out. Criteria Once you have matched all your fields you may want to limit the contacts returned by the database. To do this you can use the Criteria options. Using the Table drop-down box select the table that you want to base your criteria on. This will then automatically populate the Field drop-down box. Using the Field drop-down box select the field in the table that you want to base your criteria on. Using the Operator box select how the criteria will be match, the options available are: equals greater than greater than or equals is like less than less than or equals not equal Most of these options are obvious however the is like needs a short explanation. Use the is like option when you want to return contact data based on a partial match. For instance address is like Southampton. This would return any records where the address field contained the word Southampton in it regardless of the rest of the contents of that field. e.g. Two such fields may contain A Company, 1 A Street, Northampton Another Company, 1 Another Street, Southampton Only the record containing the second address field would be returned. All the other operators work on an exact match, for instance: Type_of_contact is equal to external Enter the data that you wish to match into the Value drop-down box. For instance in the above case you would enter external. Once you have setup your criteria in the drop-down boxes remember to click the Add button to add it to the Criteria list below, if you do not do this then the criteria will be ignored and will be lost when you close the settings window. To remove a criteria from the list, highlight it by clicking on it and then click the Del button. When you have completed the Wizard click the OK button to return to the Settings screen. Clicking Cancel at anytime will ignore any changes you have made and return you to the Settings screen.
Page 61 of 176
September 2008
If you opt to use the Advanced button you are presented with the following screen:
Here you can type in your own custom database commands for retrieving contact records. As the button suggests this is an advanced option and should only be used by trained database engineers. When you have completed your database commands click OK to store them and you will be returned to the Settings screen. Clicking Cancel at anytime will ignore any changes you have made and return you to the Settings screen. Once you have created your database connection and specified how to collect the contact records you can then setup a schedule for repeating the process on a periodic basis. To choose the days of the week on which you wish the contacts import to run simply tick or un-tick the boxes next to the name of the day you required. If you only wish the contacts import to run once a day then click the Run daily at radio button. Then select the time you wish the import to run at by choosing the hour and minute from the corresponding drop-down boxes. If you wish the contacts list import to run more than once a day then click the Start at radio button. You will notice that the Run daily drop-down boxes are greyed out and the Start at, End at and Every boxes become available. Select the time that you want the import to start using the drop-down boxes and then select the time you want the import to stop using the End at drop-down boxes. This ensures that the contacts import will only run within the selected period. Use the Every drop-down box to specify the frequency that the contacts import should run. The minimum is 5 minutes and the maximum is 55 minutes. Once you have setup your schedule click the OK or Apply buttons to save it. Please note that the contacts import will only work when the Data Controller service is running. This service is document elsewhere in this manual.
Page 62 of 176
September 2008
This page allows you to specify whether or not the telephone handset associated with an Adaptive Desktop will set Do Not Disturb when the user uses the Unavailable option on the Adaptive Desktop. You can also specify whether or not to set Do Not Disturb on the telephone handset when the user is processing a message (e.g. scheduled call-back, email, SMS or web chat). (Note that some telephone systems do not support a custom DND message index or text. The custom index and text will be ignored for those telephone system s.)
Page 63 of 176
September 2008
The Adaptive software suite allows you to blend telephone and messaging work, for users. At the Adaptive Desktop, this is achieved by automatically retrieving the next message for a user after that user has not been using the telephone for more than a certain period of time. (Telephone work is given priority, because an inbound telephone call typically needs an immediate response, whereas a message can usually wait until the user has finished his current telephone call.) To enable blending, check the Automatically retrieve another message box and enter a time (in seconds) in the edit box. What does the blending time mean? If blending is enabled and a user has met all of the following criteria for more than the minimum blending time in seconds: - Logged into an Adaptive Desktop that is associated with a telephone extension. - User is available on the Adaptive Desktop. - Telephone extension is idle (on hook and not ringing, talking or on hold). - User is not processing a message (call-back, email, SMS or web chat). then the Adaptive Desktop will automatically check in each of the users configured retrieval queues to find the next message for the user. If it finds such a message, it will automatically present it to the user. Blending is required for progressive and predictive dialling. When a user finishes a campaign call, the next progressive dialler call will be automatically presented to that user after the minimum blending time. Set DND ON while checking for messages If you check this box, then every time an Adaptive Desktop blends, and every time the user manually clicks uses the Get message command on the Adaptive Desktop, that users telephone extension will have Do Not Disturb set. If there is no message waiting for that user, the DND will be cleared on that extension. N.B.
Page 64 of 176
September 2008
This can add significantly to the loading on your telephone system; in general, you should not use this option. 4.4.7.5 Configuring the Banned Numbers tab
The multi-line edit box allows you to enter telephone numbers that cannot be dialled by users of the Adaptive Desktop. If a user tells the Adaptive Desktop to dial a number in this list, either by typing it in and clicking the Dial button, or by using Grab + Dial, or even if the number appears in a Progressive Dialler campaign, then the Adaptive Desktop will tell the user that the number is on the banned numbers list and cannot be dialled. The Banned Numbers page displays a list of telephone numbers that cannot be dialled by users of the Adaptive Desktop. If a user tells the Adaptive Desktop to dial a number in this list, either by typing it in and clicking the Dial button, or by using Grab + Dial, or even if the number appears in a Progressive Dialler campaign, then the Adaptive Desktop will tell the user that the number is on the banned numbers list and cannot be dialled. The user can add numbers to the list by entering it into the control at the bottom of the page (seen below to the left of the Add Number button). Using the Delete Selected and Delete All buttons users can delete either a selection of numbers, or all numbers from the list. This is only to be used with extreme caution the numbers entered in this are there as numbers not be called! Use the Import button to import your TelePreference list from a text file. The text file should have one telephone number per line. The Export button allows the user to export the list of numbers to a Telephone Preference list.
Page 65 of 176
September 2008
On this page, you can specify users and extension that cannot be monitored by the Busy Lamp Field on any users Adaptive Desktop. To restrict monitoring of a user by name, simply check the box next to that users name. To restrict monitoring of an extension number, simply type that extension number into the edit box. To restrict multiple extensions, enter each number in the edit box, one per line.
Page 66 of 176
September 2008
This tab is used by the CTI Gateway to determine which extensions the Gateway is to set up monitors for. These extensions could be the extensions of agents, but more normally these extensions will be used to monitor extensions that are not being used by Adaptive Users
Page 67 of 176
September 2008
Page 68 of 176
September 2008
The Message Processor downloads all inbound email from all the configured POP3 accounts on the server pairs page. Inbound messages can then be queued for users or NFA-ed by the Message Processor. However, if you only accept messages below a certain size, or you know that all messages from a particular domain or sub-domain are unwanted, then it is much more efficient for the Message Processor not even to download those messages. You can use filters to do this. To block messages over a certain size, check the Dont download messages larger than check box and enter the maximum message size in kilobytes into the edit box. To block all messages from a certain domain, click the Add button and in the Add Address dialog, type in the domain. The Message Processor will block any email whose domain contains any of the addresses you enter in the filters page. For example, if you enter the following filters: yahoo.co.uk .uk.info then email from the following addresses would be blocked: dave.smith@yahoo.co.uk e.patterson@somewhere.uk.info but email from the following would be downloaded: f.smith@yahoo.com r.jones@somewhere.info b.Cartwright@somewhereelse.co.uk
Page 69 of 176
September 2008
Clearly, you need to be cautious about entering an address filter such as .com or .co.uk, since that may block most or even all of your inbound email. You can also specify outbound filters, to prevent your users from sending email to unsuitable accounts or containing unsuitable words or phrases. Again, the address filter uses partial matching, just like the inbound address filter. If the Message Processor blocks an outbound message because of its addressee or content, then it places the message in the Undeliverable queue, for attention by an appropriate user.
Page 70 of 176
September 2008
Direct Sending of SMS Messages via SMS Modems Adaptive supports up to eight (8) SMS Modems that can be directly connected to the Adaptive Message Processor. Each modem can be configured using the SMS Modems tab as shown below. For each modem you simply need to select the COM Port it is on, give it a friendly name that will be used throughout the Adaptive software, enter its own phone number and then tick where it is to be used to send and receive SMS messages. Once configured the SMS modems can be used in conjunction with the rules in the Adaptive Message Processor to send and receive SMS messages. Additionally teams can be assigned to use one or more of the SMS modems for their messaging requirements. SMS modems can be used along side the SMS to Email Gateway as required. Use the Message Processor Connections tab to specify how often the SMS modems are polled to send and received SMS messages. The default installation value is set at 15 seconds.
Page 71 of 176
September 2008
This page shows the default From and From Address for outbound emails sent by the Adaptive Message Processor or by users of the Adaptive Outbound Email Viewer. The information on this page is the same as you entered in the Configuration Wizard when you ran the Adaptive Server Launch program for the first time (as discussed in section Error: Reference source not found). The Reply to and Reply to addr fields allow you to set the default values that your customers email clients will use when they click the Reply button in response to an email sent through Adaptive Messaging. Note that any of the addresses on this page can be overridden by users Custom (email) address information (see the Users page, above) or by actions in message processing rules.
Page 72 of 176
September 2008
SMS Email Gateway Using Adaptive Desktop SMS Email Gateway, there are two principal ways of sending SMS messages to mobile phones. The first is to use a web-based SMS gateway service, supplied by a service provider. The second is to use the Adaptive Active SMS Gateway server software and one or more GSM modems with SIM chips (see section 4.4.8.4). Web-based SMS gateway services These services convert emails to SMS messages. You purchase SMS message credits in advance from the service provider. The service provider specifies the format in which you should send emails and the address to which you should send them. On receipt of correctly formatted emails, the gateway converts the message to an SMS and sends it to the destination mobile. Typically, web-based SMS gateway services require one of two types of formatting. The rules for each are given below. Type 1: - Put the message text in the email body. - Put the destination mobile number in the email subject line. - Send the email to a fixed address. Example email:
Page 73 of 176
September 2008
To: outboundsms@myprovider.co.uk Subject: 07887164243 Body: hLO Mr Smith, ths ws snt wth Adaptive Desktop SMS! Type 2: - Put the message text in the email subject line. - Send the email to <destination mobile number>@<providers domain> Example email: To: 07887164243@myprovider.co.uk Subject: hLO Mr Smith, ths ws snt wth Adaptive Desktop SMS! The settings on the SMS (outbound) page of the Configuration Editor make it easy to configure the Adaptive Message Processor to convert SMS messages into correctly formatted emails. Adaptive Active SMS Gateway Server software and GSM modem Another way to send outbound SMS messages, and also to receive inbound SMS messages, is to use the Adaptive Active SMS Gateway Server software in conjunction with a GSM modem (the Active SMS Gateway software supports up to eight GSM modems, for large-scale SMS centres). When an inbound SMS arrives at the GSM modem, the Adaptive Active SMS Gateway Server software converts it into an email and uploads it to an account on your email server. The Adaptive Message Processor can then download the email in the normal way, queue it and present it to a user. To send an outbound SMS, the Adaptive Message Processor formats the email using the same rules as for a type 1 web-based SMS gateway (see above) and sends the email to an account on your local email server. The Adaptive Active SMS Gateway Server software downloads the email from your local email server, converts it into an SMS and sends it using its GSM modem.
Page 74 of 176
September 2008
This page shows a list of the configured pairs of inbound (POP3) and outbound (SMTP) email servers. The Adaptive Message Processor can retrieve email from multiple accounts. Use the Add, Edit and Remove buttons to reorganise the email pairs. Note that there must always be at least one configured email server pair, so the Remove button is greyed out if there is only one pair. The Add Server Pair / Edit Server Pair dialog requires the same standard POP3 and SMTP account information as any other standard email client. In addition, you can specify a limit to the number of messages downloaded at once, to prevent your Message Processor from being overloaded if it connects to a very heavily used email account. Note that any change to email server pairs will only be applied when you stop and restart the Message Processor.
Page 75 of 176
September 2008
Use this page to specify how frequently the Message Processor should check for new inbound messages and upload outbound messages. Some email servers, especially across satellite broadband or midband connections, may not be able to handle client POP3 connections more frequent than about once every ten minutes. However, an email server with high-speed, reliable connections can probably cope with connections as frequent as every one or two minutes.
Page 76 of 176
September 2008
In the Directory on web server machine edit box, type in the full path to the AMASPTemp folder on your web server PC, using the drive letter you mapped from the Adaptive server PC to that folder on the web server PC. In the illustration above, the M: drive on the Adaptive server PC maps to that folder on the web server PC. Select the queues to use for web call-back requests and web chats. In the illustration, the Sales queue has been selected. You can use the Default queue if you wish. (Remember that users retrieve web call-backs and chats (just as they retrieve emails, progressive dialler campaign calls, etc.) based on their retrieval queues. See section 4.4.1 for more information.) Click the Apply button and then go to the URLs tab:
Page 77 of 176
September 2008
The illustration above shows the default settings for URLs. In general, the only change you should need to make is to replace webserver in the first part of each URL with the name of your own web server. For instance, if the URL of your website was this: http://mysite.com/ and you had placed the WebAssist folder immediately under your main website folder, then you would typically use settings such as these: http://mysite.com/WebAssist/Adviser/AdviserTalkContainer.asp http://mysite.com/WebAssist/Adviser/AdviserTalkSession.asp etc. If you have created a new website containing only Adaptive Web Assist, you will probably need to change the settings to URLs such as these: http://WebAssist/Adviser/AdviserTalkContainer.asp etc. When you have made the changes you require, click OK button to close the Configuration Settings dialog. You will see the following dialog:
Stop and restart the Adaptive Web Gateway service. To see the Web Gateway activity see section 4.5.4
Page 78 of 176
September 2008
may need to synchronise the summary files for your Message Database, so that user searches return all the expected results. The Message Database Administrator will not run unless the Queues Server service has stopped. This means that you must log out all users and then stop the service, before running the Message Database Administrator tool. To run it, go to the server PC and use Adaptive Management Console | Config | System | Message Database Administrator.
The Message Database Administrator shows a list of current archives (if any). The main functions of the Message Database Administrator are cataloguing the live database and creating and maintaining archives. 4.4.10.1 Catalogue the live database
To re-catalogue the live Message Database, click the Catalogue Live Database toolbar button or use the File | Catalogue Live Database menu command. The Catalogue Live Database message box will appear, warning you that cataloguing the live database may take some time. Depending on your server PC speed and your data storage speed (hard disk throughput), cataloguing a Message Database of about 10,000 messages might take up to three minutes, and a Message Database of a million messages might take over five hours. If you choose to click OK at the Catalogue Live Database message box, a progress dialog will appear for each phase of the cataloguing process. There are four main phases: - Delete old summary files. - Catalogue inbound messages. - Catalogue outbound messages. - Write new summary files. When the entire process has finished, the Catalogue completed message box will appear. 4.4.10.2 Archives An archive is a discrete collection of all messages between given start and end dates. Creating archives is the only way to delete messages from the main Message Database. Click the Create New Archive toolbar button or use the File | Create New Archive menu command to display the Create New Archive dialog.
Page 79 of 176
September 2008
Enter a name for the archive: this name will appear in the drop list shown to users in the Match criteria section of the Message Database Browser. Use the drop calendars to select start and end dates for the archive and then click OK. The Message Database Administrator will go through the message database checking for messages that lie between the selected start and end dates. When it has finished, it will display a confirmation dialog will appear, showing the new archives display name, the start and end dates and the number of messages that will be removed from the main database and placed in the archive.
Click OK to create the archive. A progress dialog will appear while the messages are moved to the new archive and then catalogued in the new archive. When the process has finished, you will see two confirmation message boxes, Archive catalogue completed and Archive created successfully. You can re-catalogue an existing archive by highlighting it in the list and clicking the Catalogue Archive toolbar button or using the File | Catalogue Archive menu command. Except in the event of serious network failure or physical data loss (e.g. partial hard drive failure), you should never need to do this, since archives are not written to by any of the live software. To delete an archive, highlight it in the list and click the Delete Archive or the File | Delete Archive menu command. Deleting an archive will permanently delete all the messages in it. button
Page 80 of 176
September 2008
If the SQLite Database option is checked then the export will be in SQLite format, otherwise the exports will be in a standard format manageable by either MySQL or MSSQL. To configure the Connection Settings see section 16.2. The Schedule options when configured will instruct the SQL Exporting Service to run at the configured times.
Page 81 of 176
September 2008
The Current campaigns list shows details of any campaigns currently registered with the Data Controller. To see the Campaign history simply click on any campaign in the list and the history will be shown in the list below. To start or stop a campaign highlight it in the Current campaigns list and then click the appropriate button. You can also start or stop all campaigns using the Start All and Stop All buttons respectively. To delete a campaign first it must be stopped. The select the campaign and click the Delete button. The Contact List detail is populated with the details of the default Company Contacts List (see section 8). Use the Close button to close this screen and return to the Management Console.
Page 82 of 176
September 2008
This dialog details the status of messages, both SMS and email, and the connection status to either configured SMS modems and email server pair accounts.
This dialog details all the CTI Gateway activity and events. Any configured diagnostics from the CTI Gateway Configuration Settings (see section 4.4.7.1) are also included within this dialog. Additionally, the status of connected agents is displayed in the lower part of the dialog.
Page 83 of 176
September 2008
This indicates that the Adaptive Web Gateway is running correctly and is monitoring visitor requests for web call-backs and chats. The time display should update approximately every four seconds. If you do NOT see this page, go to Management Console | Config | Server | Web Gateway Service and make sure you have correctly entered all the required settings.
Page 84 of 176
September 2008
Page 85 of 176
September 2008
handled. This report is only available if your licence includes a message module such as SMS or email.
This report allows you to the activity of a user over a selected time period. Select this report from the Historical | Users > Single User Detail menu option. You will be presented with the standard report wizard screen. First enter an optional name for the report and select whether you want the time period to be printed on the report. Then, using the date and time boxes, select the period within which you want to report on a users activity. Select the Users tab to pick a user from the list to report on. The OK button will only become available once you have selected a valid date and time period and you have selected a user from the users tab.
Page 86 of 176
September 2008
Once the report has run each report line has the following fields: Field Name Start Date/Time End Date/Time Record Type Action Direction Number From To Subject Detail Company Contact Description The start and time of this action The end and time of this action The type of data this record shows, this can be one of Email, Telephone Call, SMS, LOGIN, LOGOUT, Callback. These are specific to the record type and describe the action that occurred, for example, incoming/outgoing call, message sent, Login, Logout etc. The direction of the action incoming or outgoing. The telephone number called or received. Email from addresses. Email to addresses. Email/SMS subject Destination of message / SMS or Campaign details. Name of company - Where a telephone number matches the company contacts list the name of the company and contact are displayed in these fields. Name of contact - Where a telephone number matches the company contacts list the name of the company and contact are displayed in these fields.
Call Recording If you have the Adaptive Call Recorder installed then double-clicking on any telephone related user entry will perform a search on the Call Recorder database and return any calls related to that entry. See the section on the Call Recorder report for more information.
Use the Historical|Predictive Dialler menu command to display a report of the daily activity of the Predictive Dialler. The report shows the statistics collected by the Predictive Dialler on any one day.
Predictive Dialler
Page 87 of 176
September 2008
If you have the Adaptive Call Recorder system installed this report shows all the incoming and outgoing calls captured by the Adaptive Call Recorder. Select Historical | Call Recordings to access the report wizard. Optionally enter your report title and select whether you want to show the report period on the report. Then select the period for the report using the date/time selection boxes. Click the User tab to access the selection criteria for the report, you can skip this tab if you simply want to show all calls by clicking OK. The User tab gives you access to the following criteria selections. Criteria Search for call recordings Description Use the radio buttons to define how the other criteria are used in the report. Selecting ALL ensures that ALL criteria are met before a call recording is returned. Selecting ANY allows ONE OR MORE of the criteria to be matched before returning a call recording. Use the tick boxes to choose the direction of the calls you are interested in. Additionally if you tick the Calls of duration at least box you can also type in a MINIMUM duration of a call. Type in any CLI, DDI, or Called Numbers that you wish to look for in your search. You can enter partial digits if required to search for groups of calls. For instance you may want to look for calls to a specific STD. Be careful when selecting the exact match boxes as this means that you have to identify all the digits in a number. This may include any service numbers such as 141 etc. If you use the company contacts system in the Adaptive software then you can search for a contact using these fields. The fields allow you to enter a partial match for a contact name or company name, and in addition you can also optional search and additional two fields of the standard 7 contact fields. For instance you can search on email address.
Call Recordings
Call information
Telephone numbers
Contacts
Once you have selected your criteria click OK to run the report. The following columns are displayed for a call recording. Column Name Start Date/Time End Date/Time Duration DDI CLI Called Number Direction Company Contact Description The start date and time of the call The end date and time of the call The length of the call in seconds The DDI number of the call if any (depends on direction) The CLI number of the call if any (depends on direction) The Number called if any (depends on direction) The direction of the call, incoming or outgoing If you use the Adaptive Contact database then the name of the company if a match is found If you use the Adaptive Contact database then the name of the contact if a match is found
Page 88 of 176
September 2008
Double-clicking on a call recording will play that call from the database. You can have up to four players running at the same time. If you have more than four players running then you will be asked to close a player before the next one will play. Additionally you may find that after double-clicking on a call recording that it is archived. If this is the case you will be presented with a screen asking you to enter media where the archive can be found. The screen will tell you the Label of the media that the call was archived onto. The system knows the name of the file it is looking for and when you browse to the correct directory on the archive media the OK button will become available. Clicking OK will restore the archived recording and play the file. Call recordings can also be played by selecting a telephone entry for any single user detailed report, or by selecting a telephone entry in a single campaign report. Archiving call recordings Call recordings can be archived directly from the Management Console. It is recommended that this only be managed from the call recording machine. To archive from the Management Console, choose Controllers -> CRArchive. A list is presented allowing Archive here a dialog is presented to allow the selection of calls to be archived, the target path, volume name and how to handle the archive volume, e.g. append to an existing archive, and finally whether back up is required. Archive History a dialog is presented that details a full archiving history. Schedule Archive a dialog is presented to allow the user to schedule a time and date for archiving to occur. Restore a dialog is presented allowing the selection of any archives to be restored. Burn Disk -> CD or DVD allows the user to burn an archived item to either CD or DVD.
Page 89 of 176
September 2008
Number the telephone number for the call. Name the name of the contact, i.e. the person being called. Engaged how many times the call was retried because it was engaged. Unanswered how many times the call was retried because it was unanswered. Rescheduled the number of times the call was rescheduled by a user. Result the name of the final result code. Code the numerical value of the final result code. User the display name of the user who made the call. Prep time the call preparation time, in seconds. Ring time the time in seconds between the Adaptive Desktop (or the Adaptive Predictive Dialler, for predictive campaigns) dialling the call and the call recipient answering it. Talk time the time in seconds between the call recipient answering the call and the call being hung up, either by the recipient or by the user. Wrap-up time the time in seconds the user spent in wrap-up after the call was hung up. Rescheduled time if the call was rescheduled by a user, the reschedule time, i.e. the time the user chose to make the call again. Reserved for if the call was rescheduled and reserved for the user, the display name of the user for whom the rescheduled call was reserved. Custom fields if any custom field values were assigned to the call, they are shown in the report. This allows post-campaign cross-referencing with account numbers, for instance.
Note that the Engaged and Unanswered fields can be non-zero and yet the final result may not be Engaged or Unanswered. For instance, if the campaign settings stipulate that engaged calls should be retried twice and unanswered calls four times, then it is quite possible that the final call result shows an Engaged count of 1, an Unanswered count of 3 and a Result of Appointment booked (for instance). The Result and Code fields reflect the final outcome of the call. The values shown will depend on how the call finished. The following table summarises the possible recorded call outcomes: Action User selects a result code from the list in the campaign call dialog User did not select a result code, although call terminated normally (i.e. recipient or user hung up the telephone) User clicked the Terminate button on the campaign call dialog User rescheduled the call Engaged (more than the number of retries specified in the campaign settings) Unanswered (more than the number of retries specified in the campaign settings) Telephone error while dialling (e.g. unobtainable number, or handset could not be taken off hook, or telephone system returned an error) Result <selected by the user> Uncoded Code <selected by the user> 0
-1 -7 -4 -5 -6
Page 90 of 176
September 2008
Rescheduled calls have a result of rescheduled in the campaign results log. The historical report will show the reschedule time chosen by the user and whether or not the user reserved the call. The rescheduled call will be presented at the due time and a new result will be logged for the outcome of the rescheduled call. Note that this means that it is quite possible for a single original campaign call to yield more than one result entry in the final historical campaign report.
Page 91 of 176
September 2008
This report displays the same results as the Single Campaign report however these results are be accumulated over multiple campaigns. Use the Historical | Campaigns | Multi Campaign Report menu command to display the Multi Campaign Report wizard. To configure the report follow the same steps as for the Call Duration By User report for selecting Time period, campaigns and Users. You then need to select which call result codes you also want to report on. Select these in the normal way using the Ctrl and Shift keys as necessary. Once you have selected all the required criteria the OK button will be enabled and you can run the report. Users Select any users who you wish to include in the report. Again as with the Campaigns screen use the Ctrl and Shift keys for multiple selections. Exporting campaign results You can export the results of a dialler campaign to a comma-separated variable (CSV) file, for use in other applications such as Microsoft Excel. To do this, open the report and then use the File | Export Data menu command.
Page 92 of 176
September 2008
Page 93 of 176
September 2008
6.1 Prerequisites
Client PCs must be running one of the following Microsoft operating systems: Windows 2000 (service pack 4 or higher) Windows XP Home or Professional Windows Server 2003
Executables folder
This is where the Adaptive program files will be stored on the client PC. You can choose any local drive and folder on the client PC.
Enter the mapped network drive letter, followed by a colon and a backslash. For example, if you mapped the drive letter M to the network path \\<servername>\\c$\\AM Data then you should enter M:\ as the data folder path.
Data folder
Once installation is complete, the set-up program will close. You will notice a new folder in your Windows Start | Programs folder, called Adaptive.
Page 94 of 176
September 2008
The caption shows the user name and the current preferred queue, or <automatic> if no preferred queue has been selected. During a telephone call, the caption will change to show the call status (e.g. ringing, talking, etc.) and also who is calling, if the telephone number matches an entry in the users personal contacts list or the company contacts list. The menus allow access to all Adaptive Desktop user functions, if you prefer these to toolbar buttons. The Macros menu, if configured for this users team, allows menu access to custom macros. The standard toolbar buttons are as follows: Log In/Out click to log in, or to log out if you are already logged in. Available/Unavailable click to select an unavailable status, or to return to available. Get Next Message New Email Grab + Email (highlight an email address in another application, then click this) New SMS Grab + SMS (highlight a mobile phone number in another application, then click this) Answer (when an inbound call rings at your telephone extension) Hang Up Hold/Retrieve Transfer The Telephone number combo shows the number of the current call, either the CLI (Caller Line Identity) for an inbound call or the number dialled for an outbound call. Dial Grab + Dial (highlight a telephone number in another application, then click this) Busy Lamp Field / Call Lists (toggle the Busy Lamp Field / Call Lists dialog) New Call-Back List Call-Backs (show all existing call-backs in this users retrieval queues) Message Database Browser
Page 95 of 176
September 2008
The desktop macros toolbar, if configured, shows macros assigned to this users team. Click a macro button to run that macro. The status bar shows the total number of messages and calls waiting for this user in all the users retrieval queues, plus a cycling display showing the number of messages and calls in each queue.
7.3 Logging in
Run the Adaptive Desktop using Start | Programs > Adaptive > Adaptive Desktop. Use the door login button or the File | Log In/Out menu command to log in as a user. The login dialog will appear:
Enter your user name and password. The Module Permissions are a reflection of the configuration of the user configured in the Adaptive Management Console (see Section 4.4.1.1).
Page 96 of 176
September 2008
Page 97 of 176
September 2008
7.7.3 Signatures
If the logged in users settings defines a signature then this is automatically added to the bottom of the email body when a new email is created.
Go to another Windows application, highlight a mobile phone number, then go to the Adaptive Desktop and click the Grab + SMS button . The Adaptive Outbound SMS Viewer will appear with the selected mobile number automatically entered into the To field.
Page 98 of 176
September 2008
button to put the other person on hold, or retrieve the call if you have already put it on hold. If you are not on an inbound call, you can make a new outbound telephone call. Enter the number into the Telephone Number combo and click the Dial button .
Transferring a call
While you are talking on a telephone call, or when the call is on hold, you can click the Transfer button to transfer the call to another extension. At the Transfer Call dialog, enter the extension number to which you wish to transfer the call. Select the Transfer option for a normal, supervised transfer, or the One-step transfer option to send the call immediately to the target extension without first initiating a consultation call. (Note that this option is not supported on all telephone systems.) Click the Begin transfer button when you are ready to transfer the call. For a normal, supervised transfer, the Complete transfer button will only become available when the consultation call to the target extension has been answered.
The default behaviour of the Grab + Dial feature in the Adaptive Desktop will successfully dial a number highlighted in over 90% of Microsoft Windows applications. For those applications that do not work with the standard behaviour, you can reconfigure the way the Grab + Dial feature works. Use the File | Configure Grab + Dial menu command to display the Configure Grab + Dial Behaviour dialog. The top option is the default: it tells the Adaptive Desktop to treat the Grab + Dial command as an instruction to task-switch between applications using the standard Windows keyboard accelerators, copy the current selection in the other application to the clipboard and then dial the contents of the clipboard. Other options include simply dialling whatever is already on the clipboard, using DDE or running an Adaptive Macro (which in turn will allow you to type any keystrokes, run any application or perform any sequence of commands you provide in another program).
Page 99 of 176
September 2008
The screen-shot above shows a typical Busy Lamp Field and Call Lists dialog display. The upper half of the dialog, the Busy Lamp Field, shows the telephone status of selected users and extensions. The example screen-shot is in icons mode. The statuses shown are as follows: - Extensions 1000, 1001 and 1006 are not on a call. - Extension 1005 has a call on hold. - Extension 1010 is talking. - Extension 1011 is ringing. - User Neil is logged into Adaptive Desktop and is associated with extension 1000 (which is currently not on a call). - User Phill McGowan is not logged into Adaptive Desktop, so his icon is greyed out. - User Eric may not be monitored by other users. The Adaptive CTI Gateway includes a settings page allowing you to restrict monitoring of selected users and extensions. Extension 1012 has also been restricted in this way.
Use the View: drop list to change between Icons view and Report view. In Icons view, you see a graphical representation of your monitored users and extensions. If the icon shows that a call is active, you can see more information about that call
September 2008
by hovering over it until the tool-tip appears (provided your Busy Lamp Field window is the active window). Report view shows more information on the status of each monitored user and extension. You can change the sort order of users and extensions by clicking on the column headers. (Note that this is a snapshot sort, based on the call status at the time you click the header. The relative positions of users and extensions will not change dynamically, so you will not have to try to follow their positions while they flicker up and down the list.)
Inbound calls
If your extension rings while you are logged into the Adaptive Desktop and you answer the call, then the call will be added to your list of inbound calls. The entry will show the time and date of the call and the number (if the CLI is available). If the CLI matches an entry in your personal contacts list or the company contacts list, then the company name and contact name will be added in the Details column for the entry. You can double-click an entry to dial the number. You can sort the calls in your list by clicking the column headers. You can also right-click on an entry to dial the number, remove the entry from your list, or add a corresponding entry to your personal contacts list. If you already have 100 calls in your inbound calls list and you answer another inbound call, then the oldest call will automatically be removed and the new call will be added.
If you dial an outbound call and that call is answered, while you are logged into the Adaptive Desktop, then the call will be added to your list of outbound calls. The entry will show the time and date of the call and the number you dialled. If the number matches an entry in your personal contacts list or the company contacts list, then the company name and contact name will be added in the Details column for the entry. You can double-click an entry to redial the number. You can sort the calls in your list by clicking the column headers. You can also right-click on an entry to dial the number, remove the entry from your list, or add a corresponding entry to your personal contacts list. If you already have 100 calls in your outbound calls list and you make another call that is answered, then the oldest call will automatically be removed and the new call will be added.
Outbound calls
September 2008
If your extension rings while you are logged into the Adaptive Desktop and you do not answer the call, then the call will be added to your list of missed calls. The entry will show the time and date of the call and the number (if the CLI is available). If the CLI matches an entry in your personal contacts list or the company contacts list, then the company name and contact name will be added in the Details column for the entry. You can double-click an entry to return a missed call. If your return call is answered, then the entry in your missed calls list will show [returned] before the number. You can sort the calls in your list by clicking the column headers. You can also right-click on an entry to dial the number, remove the entry from your list, or add a corresponding entry to your personal contacts list. If you already have 100 calls in your missed calls list and you miss another call, then the oldest call will automatically be removed and the new call will be added.
Missed calls
September 2008
If there is no CLI available for the call (e.g. the caller withheld their number, or it was an international call, or your telephone system or ISDN connection does not support CLI), the Adaptive Desktop will not show any see who is calling information. For an outbound call, of course, the number will always be available. Provided the CLI is available, the Adaptive Desktop checks every entry in your personal contacts list in sequence, trying to match the CLI to the company number, DDI, mobile or fax number for that entry. If the CLI matches any of those numbers, the Adaptive Desktop displays the details for that entry. If the Adaptive Desktop cannot match the CLI to any entry in your personal contacts list, then it tries to match the number to an entry in your company contacts list. If it finds a match there, it displays the details for that entry. Note that if a call comes in and you have a matching entry in your personal contacts list AND a matching entry in your company contacts list, then the Adaptive Desktop will use the personal contacts list entry as its preferred matching entry. In other words, the personal contacts list trumps the company contacts list.
7.14 Call-backs
To schedule a call-back, click the New Call-Back toolbar button to display the Adaptive Call-Back Viewer. This is the Adaptive Desktops integrated call-back client, which allows you to schedule a call-back for yourself or others. Type in a telephone number and a contact name, select a time and date, choose a queue from the drop-down and click the Schedule button on the toolbar or use the File | Schedule menu command. You can also optionally enter an alternative number and any notes that should accompany the call. If the blending option is enabled in the Adaptive CTI Gateway, then when the call-back is due, it will be automatically presented to the next available user who can retrieve messages from the queue in which the call-back was placed. You can also use the List Call-Backs toolbar button to display a list of all the call-backs currently scheduled in your retrieval queues. The same call-back dialog appears when the call-back is presented. You can click the Dial button to make the call. You can close the call-back using the Complete or No Further Action buttons, or you can reschedule the call-back by again selecting a time, date and queue and then clicking the Schedule button.
September 2008
toolbar button . Most of the integrated message viewers accessed from the Adaptive Desktop also include a toolbar button allowing you to get to the Message Database Browser. Some also include a Find Related Messages button, which automatically pre-selects search criteria in the Message Database Browser to locate messages related to the current message.
Viewing messages
To view a message, simply double-click the entry in the results list. An appropriate viewer dialog will appear, showing the details of the message and also the message journal, which shows the history of the message in the Adaptive system. To print a message, go to the viewer dialogs system menu and choose Print or type Ctrl+P while viewing the message.
September 2008
The dialog shows the call status and the campaign name in its caption. In the example, the call has been answered and the user has been talking for eighteen seconds. The campaign to which this call belongs is called May sales drive. Contact name shows the name associated with the number that was dialled for this call. The list of number, name pairs is configured for the campaign using the Adaptive Campaign Editor. The Result code drop list allows you to select a result code (or outcome) for this call. The result code you select is logged for this call when the dialog closes. You can select a different code at any time while the campaign call dialog is displayed, even if the telephone call itself has ended (e.g. if the customer hangs up and you go into post-call wrap-up). The Account number field shown above is actually a custom field. The campaign has been configured with a single custom field for each call, in this case labelled Account number. The value of the custom field for this call is AC88475; clearly, this is the account number for this contact. The Dial now button is greyed out in the example above. If a campaign specifies that there is call preparation time before a campaign call is dialled, then the dialog will be shown before the call is actually made on the telephone. You can cut short the preparation time and dial at once by clicking the Dial now button. The Reschedule button allows you to pick a time and date to redial this campaign call:
September 2008
The campaign may have been configured to allow you to reserve a rescheduled call specifically for yourself, in which case the Reserve this call for me check box is available. If you check it, then when the call is due, the Adaptive Desktop will present the call to you (provided you are logged in at the time). If you leave the box unchecked, or if it is greyed out, then when the call is due, it will be presented to the next available user who can retrieve calls from this campaign. The Terminate button immediately hangs up the call, closes the campaign call dialog and logs the result code for the call as Terminated. You would typically use this button to end a call if the telephone system had difficulty during dialling, or if the call was unobtainable but the telephone system did not report it as such (e.g. if you hear the characteristic da-daa-daaa sound of an unobtainable number, from your headset). The Adaptive Desktop does not go into wrap-up if the user clicks the Terminate button. If you choose a Result code before you click the Terminate button then the call is coded with that selected result, otherwise the call is coded with Terminated. Any call that is terminated regardless of its Result code is removed from the queue and will not be redialled. The Terminate button is greyed out once the call is connected. The final button has three actions, depending on the progress of the campaign call: During call preparation, dialling and ringing, the Abandon button will close the dialog and put the call back into the queue. You can use the Abandon button if you retrieved a campaign call by mistake, or if you decide before the customer answers the call that you do not want to make another campaign call. While talking to the customer, the End call button will hang up the call. If the campaign was configured with post-call wrap-up time, then the dialog will remain open, the Adaptive Desktop will go unavailable and your telephone extension will be set to Do Not Disturb (if so configured). During wrap-up, the End wrap button immediately ends the wrap-up time for the call. When the wrap-up period expires, or when you click the End wrap button during wrap-up, the campaign call dialog will close, the result code you selected (if any) will be logged for the call and the Adaptive Desktop will return to available. If you check the Make this my last call for now box, then when the campaign call dialog closes, the Adaptive Desktop will stay unavailable in a status of wrap-up and your telephone handset will remain in Do Not Disturb (if so configured). Multi-number Dialling When calling on some campaigns the data maybe setup such that a campaign contact has more than one telephone number. For instance, Home / Mobile / Work. If this is the case then the campaign call dialog will remain open on the same contact as it tries each of these numbers in turn. The multi-number dialling affects the way that the Terminate button works whilst a call is being made. If the Terminate button is pressed then the current dialled number is terminated however if there is another number to try then this is then dialled. The message Trying another number will be seen at the top of the Campaign Call Dialog before the next number is then dialled. If you have set call preparation time then this will be entered first before the next number is called.
September 2008
The Abandon buttons continues to work in the same way the only change to this is that when the call comes back from the queue it starts dialling with the number that was abandoned. For instance if the mobile number was being dialled and Abandon was clicked then the call will start dialling using the Mobile number when the it is next presented.
September 2008
The following example contents of a company contacts list includes various examples of differently formatted entries, all of which are valid:
New Media Software,08456124000,Phill McGowan,08456124000,07787177263,08456124001,,pmcgowan@newmediaserver.com New Media Software,0845 612 4000,Neil Kersley,08456124002,,08456124001,nkersley@newmediaserver.com Inter-Tel,01162903000 "ISV Group",,"Laurie Dobson",(0)1882-371 623,,,ldobson@isvgroup.com ,02380712487,Southampton Tec,,,,,AC0918827
September 2008
September 2008
editor, such as Windows Notepad, to create the file manually. Simply type in the entries using the formatting rules given above.
September 2008
September 2008
If required, create one or more queues to hold campaign calls and configure users to retrieve from those queues.
When you have done the above, for each campaign, you need to do the following: - Use the Adaptive Campaign Editor to prepare the campaign. - Assign the campaign to a queue.
Make sure the appropriate blending options are set on the Adaptive CTI Gateway
As described in section 4.4.7, in the Adaptive CTI Gateway, use the File | Settings menu command and go to the Blending page. Check the box and enter an appropriate time, as shown below:
September 2008
If the Set DND while user is unavailable box is NOT checked: - The Adaptive Desktop will not set or clear DND on users extensions during progressive dialling work.
September 2008
Dial now button, the Adaptive Desktop will dial the call on the users telephone handset. During call preparation, the user can click the Terminate button. This will close the campaign call dialog and the campaign call will not be put back into the queue. The call will have a result of Terminated logged in the campaign report. 9.4.1.2 Stage two: dialling After the Adaptive Desktop has told the telephone to dial the campaign call, but before the telephone system has received a ringing tone from the trunk, the campaign call dialog is in Dialling mode. This is generally a very short stage, but if it takes a significant amount of time for the telephone call to start ringing for instance, if the telephone system has a slow Least Cost Routing algorithm then the dialog will show the user what is happening. If dialling takes more than sixty seconds without a response from the telephone system, then the call will be abandoned, i.e. put back into the queue for the next available user to try again. During dialling, the user can click the Terminate button. This will tell the telephone system to stop dialling (if possible); on the Adaptive Desktop, it will close the campaign call dialog and the campaign call will not be put back into the queue. The call will have a result of Terminated logged in the campaign report. 9.4.1.3 Stage three: ringing When the telephone system tells the Adaptive Desktop that the call has started ringing on the trunk, the campaign call dialog on the Adaptive Desktop will display Ringing. This stage lasts until the customer answers the call and the talking stage begins, or the call has been ringing for more than the configured unanswered ring time for the campaign, or the user clicks the Terminate button. During ringing, the user can click the Terminate button. This will tell the telephone system to hang up the call; on the Adaptive Desktop, it will close the campaign call dialog and the campaign call will not be put back into the queue. The call will have a result of Terminated logged in the campaign report. 9.4.1.4 Stage four: talking When the recipient answers the telephone, the campaign call dialog goes into Talking status. This lasts for as long as the call is connected. During this time, the user can select a result code, use the Reschedule feature, or use the End call button to hang up the call and go into wrap-up. 9.4.1.5 Stage five: wrap-up After the call ends (because either the customer hangs up, the user hangs up, or the user clicks the End call button), the campaign call dialog goes into Wrapup mode, for the duration specified in the campaign settings. During wrap-up, the user can (re)select a result code, reschedule the call, or click the End wrap button to close the campaign call dialog immediately. When is a call removed from the queue? A campaign call goes back into the queue if: - The user clicks Abandon. - It was engaged and the campaign settings specified a retry count for engaged calls. - It was unanswered, i.e. the campaign settings specified a ring time and a retry count for unanswered calls and the call was ringing for more than the specified time. - The user rescheduled it. A campaign call is removed from the queue if: - The call was answered. If the user does not select a result code for a call, it is recorded as uncoded. - The user clicked the Terminate button.
September 2008
The call was unobtainable, i.e. if the telephone number was invalid (e.g. 00000 or 01234567) or the telephone system experienced an unrecoverable error when it was told to dial the call. The call will have a result code of Failed to connect in the campaign results.
9.4.1.6 How a user can take a break from campaign calls At the Adaptive Desktop, if you are currently on a campaign call, simply use the Make this my last call for now check box on the campaign call dialog. If you are not on a call, use the Available / Unavailable command (a.k.a. the coffee cup toolbar button) to go unavailable. You will not be presented with another campaign call while you are using the telephone for other call activity, e.g. receiving an inbound call, or making an outbound call. Finally, of course, you could always log out of the Adaptive Desktop!
Any user can make calls from more than one campaign. If you follow the advice above and keep different campaigns in different queues, you can simply add extra queues to that users list of retrieval queues. You can even reorder the list of retrieval queues for a user, to determine which queue (and hence which campaigns) gets priority in that users work.
September 2008
10.3 Prerequisites
The Adaptive Predictive Dialler requires the Adaptive Progressive Dialler. The dialler module itself must be installed on a dedicated computer (not the server PC), which must be running one of the following Microsoft operating systems: - Windows 2000 (service pack 4 or higher) - Windows XP Home or Professional - Windows Server 2003
The Adaptive Predictive Dialler uses telephone extensions to make calls to customers. It must have its own, dedicated, digital extensions to do this. You must not share extensions between the dialler and ordinary telephone users (including Adaptive Desktop users). Each extension must be able to go off hook, initiate a call, transfer that call using one-step or blind transfer and go on hook again. Analogue extensions are typically unsuitable for the predictive dialler.
Dedicated extensions
September 2008
September 2008
Abandoned unanswered calls are placed back into the predictive dialler using the settings specified in the Predictive Dialler tab on the Campaign Editor settings screen as seen below. Abandoned answered (or abandoned connected, or dead air calls) Suppose the campaign settings tell the predictive dialler to dial four calls for each free user and one user is free. The dialler will dial four calls. Suppose two customers answer at the same time. The dialler can only transfer one of these connected calls to the user; the other call is still connected, but there is now no free user who can deal with that call. Two customers answering simultaneously is a relatively rare event. A more common reason for abandoned answered calls is if the dialler is in predictive rather than overdialling mode. Suppose the campaign settings tell the predictive dialler to dial four calls for each free user, predicting that a call takes 30 seconds. One user is participating in the campaign and has been talking for 30 seconds. The dialler dials four calls. Suppose a customer answers, but the user has not actually finished talking on the previous call. The dialler will be forced to drop the connected call because there is no free user to deal with it (even though the prediction was that the user would be free by that time). Abandoned answered calls are placed back into the predictive dialler using the settings specified in the Predictive Dialler tab on the Campaign Editor settings screen as seen below.
September 2008
Rescheduled Calls When rescheduling calls in a predictive campaign you can specify whether these are rescheduled as progressive calls or are placed back into the predictive dialler. It is recommended that if the calls are rescheduled as progressive that a dedicated user is placed on the queue to handle only those progressive calls. If the calls are presented to a user who is also handling predictive calls this may result in increased levels of answer abandoned calls. If you choose to reschedule calls back into the predictive dialler the Allow users to reserve rescheduled calls for themselves option on the Adaptive Campaign Manager Rescheduling tab will have no effect and this option will not be available at the Adaptive Desktop.
The main display is split into four panes, with a resizable splitter bar between them. The top left pane shows participating users and their status. The top right pane shows the diallers dedicated extensions and their status. The bottom left pane shows the diallers retrieval queues and how many campaign calls are in each queue. The bottom right pane shows real-time statistics for the dialler.
September 2008
transfer connected calls and then click OK. You can multiply select users from the list. Use the Settings | Extensions menu command or the Assign Extensions toolbar button to open the Assign Extensions dialog. Click the button to open the Enter Extension Numbers dialog: type in the numbers of the extension that are dedicated to the use of the dialler and then click OK. Use the delete, up and down buttons to change the extensions assigned to the dialler. Extensions higher up the list will be used first, whenever the dialler has to make new calls. N.B. you must assign digital extensions to the dialler. Analogue extensions cannot be taken off hook and put back on hook automatically, so they are not suitable for the dialler module. Use the Settings | Queues menu command or the Assign Queues toolbar button to open the Assign Queues dialog. Click the button; in the Select Retrieval Queues dialog, highlight the queues from which the dialler should retrieve predictive campaign calls and then click OK. You can multiply select queues from the list. If you assign more than one queue to the dialler, then the dialler will retrieve calls from the queues in the order shown. You can use the up and down buttons to reorder the queues. Assign the same retrieval queues to participating users You must ensure that at least one participating user (and preferably all of them) can retrieve campaign calls from the same queues as the dialler can, i.e. you must include those queue in the users configured retrieval queues. Although users do not dial predictive dialler campaign calls directly, they must be able to make abandoned calls that the dialler reschedules as progressive. Setting Preferences The preferences screen allows you to specify the following options:
The Answered Abandoned Threshold, the predictive dialler uses this percentage to control how many calls per user it makes. As the answer abandoned calls near the percentage the dialler reduces the number of calls made per user to reduce the possibility of answered abandoned calls. If the percentage of answered abandoned calls reaches or exceeds this limit then the dialler only makes 1 call per free user until the percentage drops below the threshold again. Additionally the ability to provide an extension number to transfer abandoned answered calls is given. This is general an extension that has a recorded message for the called party. This field may be left blank if no such extension is available.
September 2008
Each predictive dialler session you set up must have a Dialler name. This name is limited to seven (7) characters and cannot contain spaces. The dialler name is used to identify your campaign when viewing the statistics in the Adaptive Management Console.
September 2008
The best way to minimise the time between a customer answering a call and a user starting to talk to the customer is to configure your users handsets to autoanswer inbound calls. That way, the moment the dialler transfers the live call to the user, the user is automatically talking on the call, rather than hearing an inbound call ring and having to answer it manually. You must make sure that your users are aware that this will happen, so that they are not confused when a customer suddenly starts talking to them. You also need to minimise the number of extraneous, non-campaign, inbound calls users receive, because those will also be auto-answered.
The Adaptive Desktop campaign call dialog for predictive dialler calls
When the predictive dialler transfers a call to a user, that users Adaptive Desktop will display the same type of campaign call dialog as it does for a progressive dialler call (see section 7.16). The obvious difference is that the call is already in a talking state when the campaign call dialog appears, so there is never any call preparation time and the Dial now button is always greyed out. Apart from that, the user can treat the call in exactly the same way as a progressive campaign call. If the user uses the Reschedule button on the campaign call dialog, the call will be put back into the queue as a either a progressive or predictive call depending on the campaign setting selected. If calls are placed back in the queue as progressive then its recommended that a non-predictive user is assigned to that queue to handle these calls.
September 2008
As well as using hyperlinks for the special URLs, as in the above example, you can also use push buttons or any other standard HTML navigation method. You can even use the navigate() command in JavaScript, or the equivalent command in your preferred scripting language in the HTML (e.g. VBScript, if you prefer).
September 2008
At the very least, include Set result code, Reschedule and End call controls. If you dont, your users may end up stranded during a call.
##AdaptiveDesktopSetMakeThisMyLastCall=<1 or 0>
September 2008
The telephone number and contact name are the standard fields that are required for any campaign call. The user name is the displayed name of the user who makes the call. Custom call data fields You can also insert placeholders for any of your custom fields, for calls in the campaign. For example, suppose your first custom field is called AccountCode. The following line in your template HTML file: <p>Account code: [AccountCode]</p> would show the user something like the following, when the call was presented: Account code: DC44581 Tip: placeholders are case-sensitive! Make sure your custom field names exactly match your placeholders, including both case and spaces in names.
11.2 Use the Adaptive Campaign Editors Show the script viewer option
Using the Adaptive Campaign Editor, display the Campaign Settings dialog and go to the Call Dialogs page:
Clear the Show the standard campaign call dialog box and instead, check the Show the script viewer option. Select your folder from the HTML script folder drop list. If your folder does not appear, make sure you put it in the correct path, as described in section 11.1 above. Note that although you can show both the standard campaign call dialog and the script viewer, you are very likely to confuse your users if you do so. Remember that you can create your script HTML files so that all the call controls from the standard campaign call dialog are available from the script viewer.
September 2008
11.3 Import or create the required custom fields for your campaign call data
If you want your script viewer to display custom field data for your campaign calls, you need to make sure that your custom field names match the placeholders you use in your template files. When you import your call data into your campaign, use the Fields page in the Campaign Settings dialog to confirm that the correct field names appear. Remember that placeholders are case-sensitive. Note that, unlike campaign screen-pop macros using custom fields, the order of custom fields does not matter for call scripts. However, the field names, including their case and punctuation, DO matter. The custom field names must match precisely the placeholders you use.
11.5 Passing data from the script viewer into the campaign results
As we saw in the preceding sections, when the script viewer appears, the user sees real call data field values substituted for the placeholders you used in the HTML template files. Conversely, you can construct your HTML files so that your
September 2008
users can enter data that will be stored in the campaign results as the values for custom fields for the call. Create an input element (e.g. a text box) and give it an ID that corresponds to a custom field name. For example, if your call data includes a custom field called Amount, then you might use the following line in your HTML template file: <input type=text id=Amount size=40></input> The value the user types into this box during the call will be saved in the Amount field for that call. The campaign report (in the Adaptive Management Console) will show the value the user entered; when you export the report to a csv file, the value will be included. To combine placeholder substitution and user input, then, you could use the following line in your HTML template file:
<input type=text id=Amount size=40 value=[Amount]></input>
When the script appears, the user will see an edit box whose initial value is the value of the Amount custom field for the call as imported into the campaign. The user can amend the value and when the call appears in the campaign report, it will show the amended value in the results for that call.
September 2008
12 Adaptive Messaging (Adaptive Desktop SMS, Adaptive Web Assist and the Adaptive Contact Centre)
Your Adaptive Server software set-up procedure (see section 3) will install the core components of Adaptive Messaging if your licence includes any of the following modules: - Adaptive Desktop SMS - Adaptive Messaging (email) - Adaptive Web Assist - Adaptive Contact Centre The most important differences from the Adaptive CTI family of products are: - The server software includes the Adaptive Message Processor service. The Adaptive Message Processor downloads inbound emails and sends outbound emails. - The Adaptive Message Database Administrator tool allows you to perform maintenance on your Message Database.
September 2008
The Adaptive Message Pair Viewer shows the inbound message on the left and the associated draft reply on the right. You can type into the body of the reply and add or change recipients and the subject line as required.
September 2008
When the reply is ready, click the Send button on the toolbar or use the File | Send menu command, to put the reply into the outbound queue for the Message Processor to upload to the server. To schedule the reply to be sent to the recipient at a specific time, use the Schedule button. (See section 7.7.1 for more details). You can use the FwdQ toolbar button or the File | Forward to Queue menu command to forward the inbound message and its associated draft reply to a queue, for another user to handle. You can also forward an inbound email message by email to a personal email account. If the message does not require a reply, you can use the NFA toolbar button or the File | No Further Action menu command to close the message pair viewer without sending a reply. Note that this does not delete the inbound message from the Message Database. You can still review the message using the Message Database Browser.
Message viewer macros and the Block Insert Text macro function
As with all Adaptive message viewers, you can have macro buttons configured on a special toolbar. A typical use for these macros would be to type words, phrases or even whole paragraphs into the outbound reply at the click of a button. When using the Adaptive Macro Editor (see section 4.4.4.5) to create suitable custom macros, the Block Insert Text macro function is particularly useful. Block Insert Text macros immediately insert the text of the macro, verbatim, into the body (or subject) of the outbound message, at the current location of the text cursor (the flashing caret symbol). This is much more efficient for large blocks of text than simply having the macro type characters one at a time in the normal way. Block Insert Text macros only work in Adaptive message viewers. You should always assign them to buttons in message viewers, never to screen-pops or to buttons on the Adaptive Desktop.
September 2008
As mentioned above, neither abandoning nor NFA-ing an inbound message will in any sense delete it. The message will still be present in the Message Database and you can review it using the Message Database Browser.
September 2008
September 2008
15.3 Prerequisites
Adaptive Web Assist typically runs using two server PCs: i) The web server, hosting the website and the Adaptive Web Assist pages. ii) The Adaptive server, running the Adaptive Web Gateway and the normal Adaptive server software (e.g. the Queues Server service). The web server must be running on a Windows server operating system, i.e. one of: - Windows 2000 Server (service pack 4 or higher) - Windows Server 2003 The web server software must be capable of running server-side ASP (Active Server Pages) scripts. Microsoft Internet Information Server is suitable. The Adaptive server software must run on a PC running one of the following Microsoft operating systems: - Windows 2000 Server (service pack 4 or higher) - Windows Server 2003 The Adaptive server PC must have at least one Concurrent Access Licence (CAL) per user.
September 2008
Can the Adaptive server software and the web server run on the same server PC?
Yes, but for security reasons, this is generally inadvisable. Your web server is by definition available to anyone, via a web connection across the Internet. All public-facing servers are to some extent vulnerable to attack. If you host internal server systems, such as your Adaptive server software, on a PC that can be attacked across the Internet, then a successful attack can access or destroy all your Adaptive data and software as well as your website. You do not need to have a new, separate web server just to host the Adaptive Web Assist web pages. You can use your existing web server and easily add the Web Assist pages to your existing website.
The web server, the Adaptive server PC and all client PCs must be on the same LAN. You will need to map a drive letter from the Adaptive server PC onto the web server PC. There is no need to map a connection in the other direction, so you will not be compromising your site security or firewalls by doing this. Communication between the Adaptive system and your web server is done solely by means of the Adaptive server software reading text files from one directory on your web server PC. There is no direct communication between the web server and the Adaptive software, so even if your web server is compromised by an Internet attack, your Adaptive system can remain secure.
Network connections
September 2008
On the Adaptive server PC, log into Windows as an Administrator and run the executable. Enter your serial number and select your executables folder and data folder. Again, see section 3 for more information.
15.4.3 Install the Adaptive Web Assist files on the web server
Go to www.nms-adaptive.com and from the Downloads | Current Software area, download the zipped file WebAssist.zip. (Note about zip files: if your web server is hosted on Windows 2000 Server, you will need WinZip or an equivalent tool to unzip the file. Windows Server 2003 can unzip .zip files without the need for extra software.) Log into your web server PC as Administrator. You will need to be able to create folders, change folder permissions and change your web server software settings. If you already have a website on your web server Unzip WebAssist.zip to a sub-folder of the folder containing the main files for your website. For instance, if your web server is Microsoft IIS, the Default Web Site folder is typically C:\Inetpub\wwwroot In this case, you would unzip the files so that you created a folder here: C:\Inetpub\wwwroot\WebAssist If you want to create a new website containing only Adaptive Web Assist For ease of administration, unzip WebAssist.zip to the root of any drive on your web server PC. For example, you might choose: C:\WebAssist In your web server software, create a new web site. Set the Home Directory for the site to be the folder into which you have just unzipped WebAssist.zip. Make sure the default document for the new site is default.htm.
Create a folder on your web server for the Adaptive software to use
Create a new, empty folder called AMASPTemp on your web server PC. A good location would be: C:\AMASPTemp The Adaptive server PC needs to be able to read, write, create and delete files in this folder. Share the folder and grant appropriate permissions. On your Adaptive server PC, map a drive letter to the AMASPTemp folder on your web server PC.
September 2008
If you do NOT see this message, check that you unzipped all the files successfully, that you changed the current directory to the one containing those files and that you are logged into Windows as Administrator.
In the WebAssist folder, you will find a file called global.asa. Open this file in a text editor, e.g. Notepad. If you have added the WebAssist folder as a sub-folder of your existing website, you will need to copy the contents of the supplied global.asa file into the existing file of the same name, which you will find in the Home Directory folder for your existing website. When you have done this, rename or delete the supplied global.asa file, to avoid confusion in the future. In your global.asa file, find the line that looks like this: Application("AMWebGatewayDirPath") = "C:\AMASPTemp" The path (in the example above, C:\AMASPTemp) refers to the temporary folder you have created on your web server PC, as described above. If you did not choose the C: drive for your temporary folder, make sure you change the drive letter in this entry in your global.asa file.
September 2008
You can request a web call-back or a web chat by clicking on the appropriate hyperlink. You can also preview what the visitor will see on success or failure of such requests, by clicking the test links included on the sample page. If you get the service unavailable page when you request a call-back or a chat as a visitor, the most likely reason is that the Adaptive Web Gateway is not running, or its configuration settings are incorrect. Review the settings discussed in section 4.4.9 above.
September 2008
If you change True to False, then your chat sessions will show entries at the bottom of the chat as they are typed, instead of at the top. Change the colours of text typed by visitors and users Find the following lines in your global.asa file: Application("VisitorChatTextColour") = "#AA6622" Application("AdviserChatTextColour") = "#40FF30" The values #AA6622 and #40FF30 are simply standard HTML colours (RGB red, green, blue values in hexadecimal format). You can change these numbers, or you can replace them with words, to use different colours for the entries typed by your visitors and/or your users.
Style sheets
All the sample Web Assist pages use a style sheet. You can find the sheet here: <your path>\WebAssist\css\global.css The file as supplied contains only one line, which simply changes the default font face of all elements in the body of the web pages. All the sample pages use standard HTML elements and you can change the appearance of those elements as required by simply changing the contents of the style sheet.
September 2008
September 2008
17 Troubleshooting
This section will help you to diagnose and fix problems you may be having using your Adaptive software. If your problem does not appear in this section, contact your dealer or distributor, or send an email to support@nms-adaptive.com.
17.2 Where do I find my site code, serial number and other licence information?
i) ii) iii) iv) v) Go to the Windows Start | Programs > Adaptive menu. Run the Adaptive Management Console. Use the Help | About menu command to display the About dialog. Click the Licence button to display the Current Licence Information dialog. Your serial number and site code are displayed in the Licence details section.
September 2008
17.4.2 The server set-up program didnt accept the serial number
Did you copy and paste the entire serial number?
September 2008
Did you add any spaces or punctuation characters by mistake? If your software supplier sent you the number by email and there was a line break in the middle of the serial number, you will have to remove that line break. Are you trying to use an older serial number with newer software? If your serial number is for a version of Adaptive software prior to v7.60, or if you are upgrading your software but upgrades are not included in your maintenance contract with your dealer or distributor, then you may not be able to use the old serial number with the new software.
17.4.3 The Adaptive programs folder on the server PC doesnt appear to include all the modules your licence allows
If you are installing on a new PC, did you enter the correct serial number? If you are upgrading your old Adaptive software, did you enter your new serial number before running the server software? Try entering your latest serial number (from your dealer or distributor) and then running the set-up program again, choosing keep current settings.
September 2008
September 2008
Make sure the telephone system is working properly. Try making and receiving calls using the telephone handsets. Check for any major or minor error conditions on your telephone system. Make sure that the telephone system software is correctly installed, configured and running. Check that no other application is running which has exclusive access to the telephone system software. If there is a test application for your telephone system software, e.g. Microsoft Phone Dialler for TAPI telephone systems, try running it on the PC on which Adaptive CTI is installed.
17.6.1 Are you using the local copy of the Adaptive Desktop?
For the initial test, make sure you use only the copy of Adaptive Desktop on the server PC, installed automatically by the set-up program as part of the Adaptive CTI Server installation.
September 2008
17.6.2.2 The Adaptive Desktop cannot access some files in the AM Data directory. Please check that your network file paths are correctly set up. Try using Windows Explorer to browse to the AM Data directory from this PC, using the mapped drive letter that the Adaptive Desktop is configured to use. You may also need to check that the server was correctly installed and is running. - Check that the client PCs mapped drive letter to the AM Data folder on the server is still correctly configured. As the message suggests, try using Windows Explorer to browse to that directory, from the client PC. - Do you have enough CALs (Concurrent Access Licences) on the server to allow all your client PCs to connect? - Have you changed any of the permissions (read, write, create, delete, etc.) for clients accessing the AM Data folder or its sub-folders? Remember that all client PCs must have full access rights to the AM Data folder and all its sub-folders and files. 17.6.2.3 The Adaptive Desktop cannot write to the registry. You need to be logged into Windows as a user with permission to write to HKEY_CURRENT_USER." During the course of its normal operation, the Adaptive Desktop needs to write information to a sub-key of the HKEY_CURRENT_USER key in the registry. If you are logged in as a Windows user who does not have permission to write to the HKEY_CURRENT_USER registry key or its subkeys, then the Adaptive Desktop will not work correctly. 17.6.2.4 There are no configured retrieval queues! Ask your manager to check your configuration on the server. Note that this error is not critical and you can still use the Adaptive Desktop, with reduced functionality. If your Adaptive software includes permission for messages (e.g. email, SMS, scheduled call-backs or Web Assist conversations) but you log in as a user who has no configured retrieval queues, then the Adaptive Desktop will display this message once at log-in time. To prevent this message from appearing, use the Configuration Editor to assign one or more retrieval queues to this user. (See section 4.4.1 for more information.) 17.6.2.5 There is no configured user of that name or Incorrect password Use the Configuration Editor (the Users and teams option from the File menu in the Adaptive CTI Gateway) to check that you are entering a valid user ID and password. Remember that the user ID may not be the same as the displayed user name. When you log into the Adaptive Desktop, enter the user ID, not the displayed name. If the user has a password, make sure you enter it correctly when you log into the Adaptive Desktop. Note that although user IDs are not case-sensitive, passwords are. For instance, if your user ID is Fred and your password is ABC123, then you can enter FRED, Fred or fred as your user ID, but you must enter exactly ABC123 as your password; abc123 will be rejected. 17.6.2.6 There are too many users logged in at the moment Your licence limits the number of users who can log in simultaneously. Try logging out one or more users. If no users at all are logged in and you still see this message, then on the server PC, try shutting down the Adaptive CTI Gateway and restarting it. Make very sure that ALL users are logged out first.
September 2008
17.6.2.7 Warning: unable to store telephone extension settings" When you set your telephone extension using the Set Telephone Extension menu command, the Adaptive Desktop tries to store the extension number in a text file stored in the local programs directory on the client PC (typically C:\Program Files\Adaptive). If this directory is read-only, you will see this message. To prevent the Adaptive Desktop from displaying this message: - Enable write permissions in the executables directory. - Run the Adaptive Desktop and use the Set Telephone Extension command. Make sure you check the box labelled Remember this extension on this computer. - Close the Adaptive Desktop and set the directory permission back to readonly (if absolutely necessary). 17.6.2.8 "Warning: unable to read company contacts list" - Check that the mapped drive letter to the AM Data folder is still pointing to the correct folder on the server PC. - Check that the file ContactsList.txt exists in <AM Data>\Agents. 17.6.2.9 This account is not enabled On the Users page of the Configuration Editor, make sure that the check box next to the users name is checked. If the box is not checked, you cannot log into the Adaptive Desktop using that user name. 17.6.2.10 "Another user is already logged into the queues server under this name. Do you wish to terminate that session in favour of this one?" Make sure that nobody else is already logged into another Adaptive Desktop using the same user ID as the one you are trying to use. If you are CERTAIN that no other use is logged in under the same user ID, click OK. 17.6.2.11 Unable to terminate existing queues server session with this user name. Please ask your manager to check that the Adaptive Server software is running correctly. Shut down the Adaptive Desktop and then try again. If you still see this message, you must log out all users and then stop and restart the Adaptive Queues Server service on the server PC. Make sure that ALL users are logged out before stopping and restarting the Adaptive Queues Server service. 17.6.2.12 "Unable to set user name on queues server. Please ask your manager to check that the Adaptive Server software is running correctly." If you have only just installed the server software, remember that after entering your licence number and initial configuration, you will have to start the Adaptive Queues Server service by hand on the server PC. See section 3.6.3 for more information. Then check the following: - Make sure the Adaptive Queues Server service is running on the server PC. - Make sure the client PC has full file access rights to the AM Data folder on the server. - Check that TCP/IP is installed and correctly configured both on the server PC and on the client PC. - Make sure there are no firewall settings preventing the client PC from communicating with the server PC. - Try logging in on a different client PC but using the same user ID. - Try logging in on the same client PC but using a different user ID.
September 2008
17.6.2.13 Unable to contact the Adaptive CTI Gateway - Make sure the Adaptive CTI Gateway is running. - Is the Adaptive CTI Gateway communicating successfully with the telephone system? Check that you have entered the correct configuration settings for your system. - Try using a different telephone extension for this Adaptive Desktop. Make sure the extension number you are trying to use is valid for your telephone system. Use a digital extension, not an analogue extension: some analogue extensions on some telephone systems will not work with the Adaptive Desktop. 17.6.2.14 Another user is already logged into the Adaptive CTI Gateway under this name. Do you wish to terminate that session in favour of this one? Make sure that nobody else is already logged into another Adaptive Desktop using the same user ID as the one you are trying to use. If you are CERTAIN that no other use is logged in under the same user ID, click OK. 17.6.2.15 Unable to reconnect after terminating existing Adaptive CTI Gateway session. Please ask your manager to check that the Adaptive CTI Gateway is running correctly" or Unable to terminate existing Adaptive CTI Gateway session with this user name. Please ask your manager to check that Adaptive CTI Gateway is running correctly. Shut down the Adaptive Desktop and then try again. If you still see this message, you must log out all users and then shut down and restart the Adaptive CTI Gateway on the server PC. Make sure that ALL users are logged out before shutting down and restarting the Adaptive CTI Gateway. 17.6.2.16 The specified extension number is already in use. Please log off and check that you have entered the extension correctly - Is another user logged into a copy of the Adaptive Desktop using the extension number you are trying to use? - Have you entered a valid extension number for your telephone system? - Are you using a digital extension? Some analogue extensions on some telephone systems will not work correctly with the Adaptive Desktop. In Adaptive Desktop, go to the Set Telephone Extension dialog and make sure you entered a valid extension number that is NOT currently being used by any other Adaptive CTI user. If you are sure you have done so, go to the Adaptive CTI Gateway and look at the list of connected users, to see if the extension is listed as being in use. If it is, ask that user using it to log out and select a different extension number. 17.6.2.17 The Adaptive CTI Gateway reports that the telephone system returned a failure code. Make sure that your telephone extension is valid. If it is, ask your manager to check that the telephone system is running correctly. OR The Adaptive CTI Gateway reports that it cannot connect to the telephone system. Please ask your manager to check that the Adaptive CTI Gateway and telephone system are running correctly. OR "The Adaptive CTI Gateway reports that the telephone system returned an error. "Please ask your manager to check that the telephone system is running correctly.
September 2008
Is the Adaptive CTI Gateway communicating successfully with the telephone system? Have you entered a valid extension number for your telephone system? Are you using a digital extension? Some analogue extensions on some telephone systems will not work correctly with the Adaptive Desktop.
17.6.2.18 Unable to initialise the telephone connection. Please tell your manager about this at once. This message usually indicates that the Adaptive Desktop client software did not install correctly on the client PC. Uninstall the client software, log into Windows on the client PC as a user with administrator rights and then reinstall the client software. See section 6.2 for more information. 17.6.2.19 Did you set the local telephone extension for your Adaptive Desktop? You must set the telephone extension that will be used by the Adaptive Desktop BEFORE you log in as a user. See section 7.4 for more information on how to set the local telephone extension. Make sure you entered the extension number correctly. Check that the telephone handset for that extension is working properly on the telephone system.
17.6.3 It takes a very long time to log into the Adaptive Desktop
17.6.3.1 Did you see any error messages during login? If the Adaptive Desktop displayed any dialog boxes indicating errors relating to the Adaptive CTI Gateway, the queues server, network files, paths, etc., then login was not successful. Check through the other questions in this troubleshooting guide to diagnose the fault. 17.6.3.2 How big is your company contacts list? If your company contacts list (see section 8) contains many thousands of entries, then it can take a long time for users to log in, because the Adaptive Desktop has to read the large ContactsList.txt file across the network and store it in memory on the client PC.
17.6.4 After logging into the Adaptive Desktop, the Telephone number combo is greyed out
17.6.4.1 Did you remember to set the local telephone extension? If you do not set a local telephone extension, the Adaptive Desktop cannot use any CTI functionality and it will not connect to the Adaptive CTI Gateway. 17.6.4.2 Is the Adaptive CTI Gateway running? Make sure the Adaptive CTI Gateway is running BEFORE you log into the Adaptive Desktop. 17.6.4.3 Did you get any error messages during or after login? If you did, go through the questions in this troubleshooting guide. 17.6.4.4 Are you sure EVERYTHING is greyed out? Remember that the Answer, Hang Up, Hold/Retrieve and Transfer buttons are bound to be greyed out when you first log into the Adaptive Desktop, because there is no telephone call to which they could be applied. The Telephone Number combo and the Dial and Grab + Dial buttons to the right of it should be enabled, if CTI functionality is installed, licensed and working.
September 2008
17.6.5 After entering a telephone number and striking Enter, nothing happens
17.6.5.1 Did you make sure that the digits you typed appeared in the combo? If the keyboard input focus was not in the telephone number combo on the Adaptive Desktop, the number will not appear, so striking Enter will do nothing. Make sure you have typed the number into the box and that it appears, then strike Enter. 17.6.5.2 If you dial the same number using the telephone handset, does it work? If you cant make a call using the handset for the local extension, you wont be able to use the Adaptive Desktop to make the call either. 17.6.5.3 Did you dial a valid number? Make sure you entered a number you know will work and that you can tell whether its ringing! Try entering exactly the same number in the same way using the telephone handset. Check that the local extension is allowed to make outbound calls. 17.6.5.4 Was the extension already busy? Trying to make a call when the extension is already handling a call (except when the call is on hold) will fail, just as trying to dial a number on the handset while talking to someone will fail. Make sure there are no active calls at the extension and try again. Some telephone systems can queue multiple calls for an extension and they can be configured not to alert (make a ringing noise) even when a call is being delivered or established. 17.6.5.5 Are there any obvious error messages displayed on the Adaptive CTI Gateway? Check the Telephone events and status box on the Adaptive CTI Gateway to see whether any error messages or warnings have been displayed. Check the telephone system software for error messages.
September 2008
Remember that entries in your personal contacts list, if you have one, will take precedence over your company contacts list. See section 7.13 for more information. 17.6.6.1 When the extension rings for an inbound call, the Adaptive Desktop doesnt show any information at all Make sure the Adaptive Desktop is associated with the local extension. Try dialling out using the Adaptive Desktop; ringing: <number> should appear. Go through the checklist in section 17.6.5. 17.6.6.2 When the extension rings for an inbound call, all I see in the title bar is ringing; theres no number and no other information Make sure CLI (Caller Line Identification) is enabled and works for your extension. Make sure the telephone thats dialling in isnt set up to withhold its number (e.g. entering 141 before the number, on a BT telephone). Use a normal land line on the same telephone network as your telephone system, to avoid possible incompatibilities (e.g. between BT and NTL). Try dialling in from a different telephone, preferably from a different network than the problem telephone. 17.6.6.3 When the extension rings, the Adaptive Desktop does show ringing <number> but it doesnt show any other information Make sure there is an entry for that number in the Contacts List. Make sure the Contacts List file is in the right place (see section 8.1). Check that the file is in the correct format (see section 8.2). Try opening the file using Notepad; make sure the file can be opened. Try a different number for which there IS an entry and see if that works. Try dialling the problem number as an outbound call from the local extension and see if the information appears in the Adaptive Desktop title bar. Make sure the telephone number in the Contacts List is in the format you expect: for instance, if it says +44 (0) 845 612 4000 and your CLI is reporting 08456124000 then the Adaptive Desktop isnt going find the entry in the list (see section 8.2 above). 17.6.6.4 I see some information but it doesnt look right Remember that entries in your personal contacts list, if you have one, will take precedence over your company contacts list. Provided youre seeing an entry in the company contacts list and not your personal contacts list, what you see is whats in the contacts list file. Open the file using Notepad and look at the information for that number. Check that you have entered the fields in the correct order (see section 8.2). If you exported the company contacts list file from your external application, try exporting it again, but this time examine the applications options for exporting each field in a different format. Dont include the postal address or any multi-line fields in the exported file. 17.6.6.5 It works for some numbers but not for others Remember that entries in your personal contacts list, if you have one, will take precedence over your company contacts list.
September 2008
Make sure the company contacts list does actually contain entries for all the numbers you expect. Dont take your external applications word for it: open the Contacts List file in Notepad and check that the numbers are there. Make sure the telephone numbers are in the correct format. 17.6.6.6 Log out and log in again Remember, whenever you change the company contacts list file, to log out of the Adaptive Desktop and log in again, before you conduct your test. If you do not log out, then changes to your company contacts list will not take effect.
17.6.7.1 Does the status bar of the Adaptive Desktop say, *ERROR* unable to get queue sizes from queues server? This message indicates that the Adaptive Desktop has lost communication with the Adaptive Queues Server on the server computer. Check the following: - Is the Adaptive Queues Server still running? Use the Windows Services Control Panel applet on the server PC to check. - Are too many users trying to connect, requiring more CALs than your server supports? (CAL is Concurrent Access Licence, part of Microsofts Windows Server licensing. Your server must have one CAL per user.) - Has your firewall started to block traffic? - Is your anti-virus software starting to produce warning messages? If the problem occurs only on one particular PC, make sure the drive letter is still mapped to the correct path to the AM Data folder on the server PC. If necessary, uninstall and reinstall the Adaptive client software on that PC. If you used a UNC path when installing the Adaptive Desktop software on the client PC, instead of a mapped drive letter, then Windows may be taking a long time to resolve the UNC path, causing timeout failures when the client communicates with the server. Use a mapped drive letter, not a UNC path: you may need to uninstall and reinstall the client software.
September 2008
Never try to run tests on an existing queue or using existing campaign data. It is almost impossible to obtain meaningful diagnostic results from a campaign already in progress.
17.7.1 The Campaign Editor says it has assigned the campaign to the queue, but the users arent getting them
Make sure you performed the test sequence above. Use the Management Console Real Time Queues Report to see whether your test campaign call is in your test queue. - Try logging out all users and shutting down ALL Adaptive software, including the Campaign Editor and the Queues Server service. Then restart the Queues Server, run the Campaign Editor and try assigning your single-call test campaign to your new queue again. Then run the Adaptive Management Console and use the Real-Time Queues report to see if the call is now in the queue. If you still find that the Campaign Editor says it has assigned the call but the call does not appear in the Real-Time Queues report, then your Queues Server was unable to store the call reference in the AM Data area. Your Queues Server must have full file access permissions to all files and sub-folders in the AM Data folder. See section 17.3 above. There are only two ways to fix the problem. You must: - Either give the localsystem user account on your server full file access rights to <AM Data> and all its subfolders; - Or change the Adaptive Queues Server service log on as account setting from localsystem to administrator. Note that if you choose the second approach, you must set the log on account for the service to administrator. It is not sufficient to make the service log on as a user with administrator rights. It must log on as the administrator user itself.
17.7.2 Campaign calls are in the queue, but Adaptive Desktop users arent being presented with them
Have you added the queue to your users Retrieval queues? See section 4.4.1. - Have you set a blending time in your Adaptive CTI Gateway? See section 4.4.7. - Are you sue the calls are in the queue? Use the Real-Time Queues report in the Management Console to make sure. - Are the calls rescheduled ones from earlier in the campaign? See the section below about rescheduled calls. If none of the above helps, try logging out of the Adaptive Desktop and then back in again. If that still does not fix the problem, try the test sequence in section 17.7 above. -
17.7.3 Campaign calls are in the queue, but Adaptive Desktop users arent being presented with them
Did the user who rescheduled the calls check the Reserve this call for me check box? Only that user will be able to retrieve those calls. Has the time for which the calls were rescheduled been passed? If the real-time clock on your client PCs differs widely different from that on your server PC, then you may experience timing issues with rescheduled calls. Try the test sequence in section 17.7 above and when the call is initially presented, reschedule it for one minute later.
September 2008
17.7.4 Data controller - assigned campaigns are not placing calls in the queue
Check that the schedule for the campaign is live: Is it the correct day? Is it the correct time? Is the queue server running?
Make sure that the Data Controller service has the correct permission to logon to the database you have selected. You may need to change the login that the Data Controller is running under in the Services panel. See the Data Controller section for more details.
September 2008
September 2008
make a note in its error log file and then proceed, having skipped the step that would ordinarily have written the data.
18.4 Moving your Adaptive server software from one server PC to another
Moving your Adaptive server software is a large undertaking. The process involves performing an entire Adaptive installation and a restore from a backup and reconfiguration. If a specialist installation engineer installed the Adaptive software at your site, it is strongly recommended that you contact the same engineer to perform the server software move.
WARNING
You will need permission from your software dealer or distributor, or directly from New Media Software Ltd, to transfer your Adaptive software licence from one server to another.
September 2008
Shut down ALL your Adaptive software on ALL PCs. You cannot move the server software while any Adaptive software is running. Take a full backup of all your Adaptive software (see section 18.2 above). Make sure your new server PC meets all the prerequisites for your Adaptive software. [Adaptive CTI and diallers] Install any telephone system driver software and TSPs required for Adaptive CTI to work with your telephone system. You should take careful note of the telephone system driver settings on your old server PC, so that you can correctly configure the drivers on the new server PC. After noting all the driver settings, you may need to shut down or even uninstall the corresponding drivers on your old server PC for the drivers on the new server PC to work correctly. Perform a full installation of the Adaptive server software on your new target server PC. See section 3 of this guide. Use the serial number for your existing Adaptive licence, but do not request an activation code yet. Make sure you are logged into Windows on the server PC as a user with administrator rights. Shut down all Adaptive software on your new server and copy the data from your backup onto your new server. See section 18.3 above and follow all the steps in that section: in particular, note that you almost certainly will have to change the host name or IP address for the Queues Server (and the Adaptive CTI Gateway, for Adaptive CTI and dialler sites). Do not attempt to copy data from the old server onto the new one while any Adaptive software is running on either server. Use the backup and restore procedures described in this guide. After the restore, pay particular attention to the file access permissions of the copied AM Data folder and its files and subfolders. [Adaptive Messaging, Desktop SMS and Contact Centre] Remember to merge the backup registry key into the registry on your server. Afterwards, you must use the Configuration Editor to go to the Email Server Pairs page and check that all the settings for all your inbound and outbound email servers are correct. In the Configuration Editor, go to the Users and Teams pages to check that all your users, queues and teams were successfully transferred. If they were not, the most likely cause is that one or more files was not properly copied from your backup, when you performed the restore procedure. Remember to check that no Adaptive software is running on your server PC and that you are logged into Windows on that PC as an administrator. Check your licence dialog. Make sure that the serial number and permissions are correct, i.e. the same as they were on your old server PC. Shut down all Adaptive software on the old server PC. You should also shut down any telephone system driver software on that PC; you may need to uninstall such software, if it conflicts with the equivalent drivers on the new server PC.
On the new server PC: - Try starting the Adaptive Queues Server service. Make sure that it shows as started in the Services page of the Windows Control Panel. (If you were not able to empty your queues before performing your backup, then you may find that it takes several minutes for the Queues Server service to start fully.) - Shut down and restart your Adaptive CTI Gateway. - [Adaptive CTI and diallers] Try logging into the Adaptive Desktop local to the (new) server PC. Check that basic call control works. If all the above steps are successful: - Uninstall all the Adaptive software from your old server and rename the AM Data folder on your old server (to avoid confusion on client PCs).
September 2008
Visit each client PC and re-map your drive letter to point to the new server's AM Data folder.
Finally, go to the website www.nms-adaptive.com to request a new Product Activation Code for the Adaptive software on your new server PC. If you did not obtain permission to perform the move, as discussed above, then there may be a delay in receiving your new activation code.
September 2008
September 2008
directory. To do this simply click Next and respond Yes to the Are you sure question. Alternatively click Finish to complete the archiving process.
September 2008
Trunk
A connection from the telephone system to ISDN, i.e. to the external, public, telephone network.
TAPI
Telephony Application Programming Interface. It is an industry-standard method of communicating between a PC and a telephone system. Not all telephone systems support TAPI.
A chargeable extra service offered by ISDN suppliers (e.g. BT, in the U.K.). When a caller rings you, the callers number is supplied to your telephone system. If your telephone system is correctly configured, you can display this number on your handset, so that you can see who is calling before answering the call. The see who is calling features of Adaptive CTI rely on this information. If your telephone system does not provide CLI for a call, there is no way that Adaptive CTI can show the number or any related contact information. Make sure you test your telephone system for CLI before you install and test any Contacts List functionality in Adaptive CTI. When you conduct your test, be sure to dial in using an external telephone and that the external line does not withhold the number!
September 2008
Avaya IP Office
Inter-Tel CS5000 Inter-Tel Axxess v8 or higher Inter-Tel Axxess v7 Inter-Tel 5000 series LG LDK / IPLDK 50 / 100
OAI level 2 licence TAPI licence (part number R2085), LANU (Network Interface Card) (part number R2050); for Single Cabinet, ASMU1 (part number R2060E) or for Double Cabinet, ASMU2 (part number R2065E) TAPI licence (part number B2085) TAPI licence MiTAI licence applied to the telephone system USB cable for USB connection type, or CTI Link card for IP connection type Open TAPI licence 3rd-party TAPI licence applied to the telephone system; licence for the TSP; serial
LG LDK 300 LG IPECS Mitel 3300 ICP Panasonic KXTDA Samsung OfficeServ 7200 Siemens HiPath
LG TSP LG TSP for IPECS MiTAI run-time library Panasonic KX-TDA TSP; Panasonic USB driver, for USB connection type OfficeServ Link and Open TAPI TSP Siemens HiPath TSP or ESTOS ECSTA TSP
IP address of telephone system IP address of telephone system IP address of telephone system For IP connection type, IP address of telephone system IP address of telephone system For IP connection type, IP address of telephone system
September 2008
September 2008
Alcatel OmniOCX Avaya IP Office Inter-Tel Axxess Inter-Tel CS5000 series LG LDK / IPLDK / 50 / 100 LG IPECS Mitel 3300 ICP ** Panasonic KX-TD Panasonic KX-TDA
Samsung OfficeServ 7200
Adaptive CTI Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
Progressive Dialler Yes Yes Yes Yes Yes Yes, but blending requires manual DND * Yes, but blending requires manual DND * Yes Yes Yes Yes Yes
Predictive Dialler Yes No Yes Yes Yes Yes, but blending requires manual DND * No No No No No Yes
Siemens HiPath
* The LG LDK series will not support blending inbound and outbound calling work by means of automatically setting and clearing Do-Not-Disturb for telephone extensions. If users are likely to be interrupted by inbound calls while they are doing outbound dialling work, they will have to set and clear DND manually on their extensions. ** Mitel 3300 ICP is only supported up to version 3.3 of the switch operating system. Subsequent versions are not currently supported.
September 2008
20.4.2 Physical connection from the telephone system to the Adaptive server PC
Your telephone system must be connected to the same LAN segment as the Adaptive server PC.
September 2008
September 2008
20.5.2 Physical connection from the telephone system to the Adaptive server PC
Your telephone system must be connected to the same LAN segment as the Adaptive server PC.
Telephone system on the OmniPCX, connect it to the LAN and make sure it has fully booted. The OmniPCX can take up to ten minutes to boot fully. Unzip the TSP zip file into a temporary directory., then run the setup.exe file. Choose your language from the set-up language dialog, then click OK.
September 2008
At the configuration dialog (shown above), enter your telephone systems IP address into the edit box. Then click OK. Finish the set-up, then reboot your server PC.
September 2008
20.6.2 Physical connection from the telephone system to the Adaptive server PC
Your telephone system must be connected to the same LAN segment as the Adaptive server PC.
September 2008
20.7.2 Physical connection from the telephone system to the Adaptive server PC
Your telephone system must be connected to the same LAN segment as the Adaptive server PC.
September 2008
20.8 LG LDK/IPLDK
Adaptive connects to the LG using the LG TSP.
You need to purchase and apply a 3rd-party TAPI licence on your LDK / IPLDK telephone system.
20.8.2 Physical connection from the telephone system to the Adaptive server PC
Your telephone system must be connected to the same LAN segment as the Adaptive server PC.
You will need the LG TSP. You can download it from the Adaptive website, www.nms-adaptive.com. Go to the Downloads section and click on the 3rd Party Drivers item on the right-hand menu.
At the configuration dialog (shown above), select LDK-50/100/300/300e. Select 3rd Party Connection. Select LAN and enter your telephone systems IP address in the edit box. Then click Next. Finish the set-up, then reboot your server PC.
September 2008
Once you have successfully installed the MiTAI run-time software, your system is ready for Adaptive CTI.
Connect the Mitel 3300 ICP to the LAN, using a standard Cat5 (Ethernet) cable. Connect the PC to the same LAN segment. You will need to know the IP address of the telephone system.
20.9.2 Physical connection from the telephone system to the Adaptive server PC
Before installing the Adaptive software, you will need to install the MiTAI run-time software onto the server PC. The software is supplied free with your Mitel telephone system. To install the run-time software: - Telephone system on and fully boot both the Mitel 3300 and the server PC. - Unzip the file MiTAI Runtime.zip into a temporary directory and run the setup.exe program. Follow the instructions to complete the installation; reboot the PC if necessary. - Go to Control Panel and run the MiTAI run-time applet. - Make sure the IP address and password are correct for your Mitel 3300. Once you have successfully installed the MiTAI run-time software, your system is ready for Adaptive CTI.
September 2008
20.10
Panasonic KX-TD
The Panasonic KX-TD must be connected to the PC using a standard serial cable from the serial port of the PC to the CTI port of the KX-TD. This cable is sometimes called a V24 cable, having 24 pins on the KX-TD end.
20.10.3 Physical connection from the telephone system to the Adaptive server PC
Please note that you MUST follow the above steps in full, in the exact order given. If you attempt to reboot the telephone system or the PC while the other unit is still rebooting, the TSP may not be correctly installed and your Adaptive software may not work properly. Once you have successfully installed the TSP and carefully followed the rebooting sequence described above, your system is ready for Adaptive CTI.
September 2008
20.11
Panasonic KX-TDA
20.11.2 Physical connection from the telephone system to the Adaptive server PC
There are two ways of connecting the KX-TDA to the Adaptive server: a direct USB connection, or a CTI Link LAN card.
20.11.3 USB
Connect the USB port of the PC to the USB port of the KX-TDA. This will require a standard USB peripheral cable, available for purchase from any electronics or computer retailer. At the time of writing, the USB port on the PC must support USB 1.1.
20.11.6 Installing the TSP 20.11.7 If you are using a direct USB connection
To install the USB driver: - N.B. Make sure the PC and the KX-TDA are both telephone system on and fully booted but NOT connected to each other via the USB cable. - Download and unzip the KX-TDA USB Drivers (zip file) onto the server PC. - Plug the USB cable into the server PC and the KX-TDA. - When the New hardware / new USB device wizard appears and prompts you for driver files for the new USB device, choose Search specified location and browse to the directory where you unzipped the downloaded USB drivers. Select the appropriate .inf file for your operating system (Windows 2000 or Windows XP; if you are using Windows Server 2003, use the Windows XP USB driver). - The new USB device wizard may ask you to reboot your PC; if it does, then reboot the PC, but make sure that you leave the USB cable connected and the KX-TDA switched on. To install the TSP: - Make sure you have connected the PC and the KX-TDA using the USB cable and that the USB driver was installed correctly, as above. - Run the installation program (e.g. panasonic_kx-tda_tsp_inst1027.exe) on the server PC and follow the instructions on the screen.
September 2008
During installation, the program will display a dialog that includes a Check location button: select the USB option (NOT the LAN option) is selected, then click the Check location button and make sure that the program finds the telephone system. If it does not, check that your USB cable is working and properly connected and that the driver installation was successful (and that you chose the correct USB driver see previous section). When the TSP installation program has finished, whether or not it asked you to reboot the PC, do so anyway.
Once you have successfully installed the TSP and rebooted the server PC, your system is ready for Adaptive CTI.
September 2008
20.12
Adaptive connects to the Samsung OfficeServ and 7200 series telephone systems via the LAN port, OfficeServ link and OfficeServ Open TSP.
20.12.2 Physical connection from the telephone system to the Adaptive server PC
The Adaptive server connects to the OfficeServ telephone system via a LAN connection. During installation, your reseller should assign an IP address to the telephone system.
Install the OfficeServ Link software. Once installed, use the Start Menu, All Programs, OfficeServ, Licence Tools option to apply your Open TSP Licence. Once OfficeServ Link has been successfully installed, install the Open TSP by running the OpenTSP32DriveSetup.exe file that will have been supplied by your reseller. During installation, you will be asked for the IP Address of the telephone system.
12.12.5
Use the File | Settings menu command to display the configuration dialog. From the Telephone system drop list, select TAPI 3rd Party. Click the Settings button and click the Samsung OfficeServ button.
September 2008
20.13
Siemens HiPath
Adaptive connects to the Siemens HiPath using either the Siemens HiPath TAPI Base TSP or the ESTOS ECSTA TSP.
20.13.2 Physical connection from the telephone system to the Adaptive server PC
If you are using the direct serial cable connection method, then the Adaptive server PC must be connected to one end of the cable and the Siemens HiPath connected to the other end. If you are using a LAN card in your HiPath, then your telephone system must be connected to the same LAN segment as the Adaptive server PC.