CyDesk Manager Guide
- 1 Configuring CyDesk
- 2 How to log-in to CyDesk Manager
- 3 CyDesk to automatically login to an extension upon start up
- 4 How to launch the General Settings Tab in CyDesk Manager
- 5 Configuring Integrations:
- 6 CRM Compatibility for CyDesk
- 7 Configuring CRM Configurations:
- 7.1 Configuring CRM Configurations - ACT!
- 7.2 Configuring CRM Integrations - Generic
- 7.3 Configuring CRM Integrations – HEAT Help Desk Logging
- 7.4 Configuring CRM Integrations - Goldmine®
- 7.5 Configuring CRM Integrations – HEAT Help Desk Logging
- 7.6 Configuring CRM Integrations - SalesLogix
- 7.7 Configuring CRM Integrations - Simpro
- 7.8 Configuring CRM Integrations – Xplan
- 7.9 Configuring CRM Integrations - Hubspot
- 8 CyDesk Tray Utility
- 9 Call Control with CyDesk
- 10 Call Account Codes
- 11 Do Not Call
- 12 Auto Callback and SMS Alerts in CyCX: Enhancing Customer Experience
- 13 Smart Callback Filter (SCF)
- 14 Callback Assurance System (CAS) & After Hours Call Management System
- 15 Avaya ACO Embedded and ACO Desktop Client
Configuring CyDesk
Using CyDesk Manager
CyDesk Manager allows administrators to configure system settings in real-time. To access the configuration screen, click on ‘Options’ and select ‘Configure’. You will be required to login as a CyDesk user with administrator privileges. By default 'Administrator' password is CyTrack
The configuration area is presented in a tree/node layout which will be described in the next sections. Some nodes may not be available on your system due to insufficient software license.
Agents
The Agents tab maintains the list of usernames for CyDesk. A new agent profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
By default the list is sorted by agent names in alphabetical order. You can change the sort method of this list by double-clicking on the column names.
Name – The CyDesk username.
Integration – The CRM / database application that CyDesk will integrate with for this user.
Profile – The integration profile, according to the Integration mode selected.
Auto Break – CyDesk will be placed on this break when the screensaver becomes active.
User Level – Controls the security and feature accessibility for each CyDesk agents.
Standard User – for agents. No access to configuration or monitoring with CyDesk Manager. Unable to manage conference rooms, silent monitor, Send Notes or change other users’ status.
Supervisor – for team leaders. Able to Send Notes or change other user’s status. Full access to CyDesk Manager monitoring features, but access to the configuration area is not allowed.
Administrator – full access.
CyRecord Profile – agent recording profiles. The profile is configured in the CyRecord tab.
Calendar Profile – provides presence information by integrating a calendar application to CyDesk. The profile is configured in the Calendar tab
Hotkey Profile – the keyboard shortcut profile enabled / disabled for the agent. The profile is configured in the Hotkeys tab.
Mobile – Can be used to store the mobile phone number of the agent.
Home – Can be used to store the home phone number of the agent.
Other1 – An alternative phone number the agent may be contacted on.
Other2 – A second alternative phone number the agent may be contacted on.
IM Type – The Instant Messaging application to integrate with. Currently supported options are Windows Messenger or Office Communicator.
IM Signin - The email address entered here is used to identify the agent into the IM application.
Enable ‘Copy to Dial’ – When phone number is highlighted with the mouse then copied a screen will be displayed asking if you wish to dial that number.
Confirm Before Dialling – Prompts for confirmation before dialling.
Leave Number in Clipboard – Leaves the number in the clipboard so it can be copied as a speed dial for future use.
Disable Manual Numbers – Disables the manual dialling of numbers using the ‘Dial Another Number’ option within CyDesk.
Allow SMS Sending – If this checkbox is enabled, the user will be allowed to send SMS via the CySMS module. This requires a subscription to the CySMS service.
Show Queued Calls – Allows the user to see calls waiting in their queues. This is useful for monitoring the queues, particularly for supervisors to be able to route those calls to other places.
Skill Set – This option allows skill sets and skill levels to be added to the agent, with level 1 (beginner) to 5 (expert).
Queues – This list the queues the agent is assigned to.
Individual Wrap-up Time – custom wrap-up timer for each agent. Wrap-up is activated at the end of each call and overrides any wrap-up configuration in queues or completion codes.
Allow login/out of specific queues – when this option is enabled, agents can choose to add / remove themselves from queues that they are assigned to.
Maximum Chats – This option allows the number of maximum chats to be set.
Allow send/receive notes for anyone – This options allows the agent to send and receive notes from anyone.
Only see ‘my team’ - This option disables editing the team in the CyDesk Client and only agents part of the team are in CyDesk Client.
Other Functions
Existing agent profiles can be copied by selecting an agent to copy from and click the ‘Make Copy’ button. All settings are copied across and the new agent will be created with the name ‘Copy of X’ which can be modified further.
Selected agent can have their password reset by clicking the ‘Reset Password’ button and enter the new password.
Teams could also be setup in the Agents tab by clicking the Setup 'My Team' button. Agents could be added/removed in a team by clicking the left/right arrow buttons.
An agent’s Teams setting can be copied to other agents by using the ‘Copy Teams’ button. Select the agent to copy from and highlight one or more agents to copy into.
Speed Dials
CyDesk includes functionality for providing a list of speed dials that are available to and shared by all agents. These are managed in the Speed Dials node in CyDesk Manager under Administration node. A new speed dial can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Each speed dial entry can contain up to five numbers, as shown below.
Speed dials entered in this screen will become immediately available to all logged on agents, and any agents that log on in future.
Speed dials can also be entered, using a SQL script, directly into the CyTrack SQL Database ‘ctiSystemSpeedDials’ table. The ‘Reload’ button must be clicked before the agents can see them.
Example SQL script:
INSERT INTO ctiSystemSpeedDials (Name, Company, Main Phone, Mobile, Home, Other1, Other2)
VALUES (‘John Smith’, ‘ABC’, ‘1300 111 11, ‘+61 4 2321 0989’, ‘+61 7 3242 1122, ‘’, ‘’)
HotKeys
CyDesk includes functionality to allow the user to press a specific key sequence to perform actions such as answering a call, going on a break etc. The Hotkeys node within CyDesk Manager under Administration node contains a list of the keyboard shortcut profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
The check box enables the specific function, and pressing the Change button allows you to select the actual key sequence. Basic alphabets and numeric keys cannot be used as part of the key sequence e.g. A, LCTRL+A, LSHIFT+A, LCTRL + LSHIFT + A, etc.
Answer – to answer a call.
Hold – to put a call on hold or unhold.
Hangup – to end a call.
Dial – to open the dial window in the Active Call panel.
Transfer – to complete the transfer.
Park – to put the call on park.
Speed Dials – to open the Speed Dials panel.
History – to open the History panel.
Break / Ready – to switch between Ready status and the Auto-Break status configured in the agent’s profile.
Speed Dials – to open the Speed Dials panel
Show CyDesk – to bring the CyDesk interface to the foreground.
Dial Highlighted – make a call using the highlighted number. Copy to Dial must be enabled in the agent’s profile.
CyQ ‘Next Call’ – requests the next call in the queue, even when the agent is on a break or wrap-up.
How to log-in to CyDesk Manager
Below are the steps on how to launch and login to the CyDesk Manager to manage the CyDesk Client configuration and settings, as follows:
You have 2 options in launching your CyDesk Manager:
Clicking on the desktop shortcut; or
Through the Start menu ► go to All Programs ► CyTrack Folder ► Select CyDesk Manager
Go to the File tab and select Login
Select the username on the drop-down menu and type in the password ► Click OK.
Your Username should be displayed on the top of the window, if you are logged-in.
CyDesk to automatically login to an extension upon start up
Right click on CyDesk shortcut, select Properties and go to Shortcut.
In the field Target add the parameters user, extension and break and "/AutoLogin".
i.e. "C:\Program Files\CyTrack\CyDesk\DeskClient.exe" U:John E:106 B:Ready /AutoLogin
Then add the shortcut to the windows start up folder, so it launches the application upon log in.
How to launch the General Settings Tab in CyDesk Manager
This article will show you a step-by-step procedure on how to launch the General Settings Tab in CyDesk Manager. This window contains the general settings of the queue type you have set up.
Log-in to CyDesk Manager. The user must have administrator rights.
2. Go to Options and select Configure.
Under Administration, select Queues
Select the Queue Type on the drop-down menu. In this guide, select 'Queue.'
Select the Queue you want to configure or view the settings.
This will launch the General Tab of the Configure Queue on CyDesk Manager.
Configuring Integrations:
Configuring Maximizer Integration
When CyDesk is integrated with Maximizer, it provides services such as popping a contact record on an incoming call, dialing contact numbers from within Maximizer etc. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The Maximizer tab within CyDesk Manager contains a list of the Maximizer integration profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Incoming Calls
Screen Pop Known Numbers – If the contact’s number is found in the Maximizer address book, the contact record will be opened in Maximizer.
‘Write a Note’ when answered – When an incoming call is answered, the ‘Write a Note’ window will be opened to allow agent to enter details of the call they are receiving, to be stored in the Notes section for that contact.
New Number ‘Search Company’ – If the caller cannot be identified, this option will enable Maximizer to display the ‘Search by Company’ screen.
Log Answered Calls – Generate automatic entries into the Maximizer Notes for incoming calls that are answered. These notes are formatted to appear in the Phone Log report within Maximizer. One of the fields in this report is Result. You can enter the appropriate Result Code for each of the different call types so they can be identified in the Phone Log report.
Log Unanswered Calls – Generate automatic entries into the Maximizer Notes for incoming calls that are missed. These notes are formatted to appear in the Phone Log report within Maximizer. One of the fields in this report is Result. You can enter the appropriate Result Code for each of the different call types so they can be identified in the Phone Log report.
Schedule Call Back – When enabled, a telephone call task will be scheduled to return the missed call.
Link CyRecord Files in History - When enabled, a link to the call recording file will be added to the Documents tab to allow subsequent playback of the recording.
Outgoing Calls
Screen Pop Known Numbers – If the contact’s number is found in the Maximizer address book, the contact record will be opened in Maximizer.
‘Write a Note’ when answered – When the outgoing call is answered, the ‘Write a Note’ window will opened to allow agent to enter details of the call they are making, to be stored in the History for that contact.
New Number ‘Search Contact’ – If the caller cannot be identified, this option will enable Maximizer to display the ‘Search by Contact’ screen.
Log Outgoing Calls – Generate automatic entries into the Maximizer Notes History for all outgoing calls. These notes are formatted to appear in the Phone Log report within Maximizer. One of the fields in this report is Result. You can enter the appropriate Result Code for each of the different call types so they can be identified in the Phone Log report.
Link CyRecord Files in History - When enabled, a link to the call recording file will be added to the Documents tab to allow subsequent playback of the recording.
The ‘Integration’ setting must be changed to Maximizer and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and Maximizer must be running for this integration to work.
Additional Client Configuration
Each CyDesk client must be configured with the Maximizer ODBC data source name, username and password. The ‘Maximizer Option’ button will be activated in the Configure section of CyDesk client, when this integration type is assigned in the agent profile.
(CyDesk Maximizer Integration requires a ‘CYTRACKMAX’ user in the SQL with password ‘CYTRACKMAX ‘ with read only permissions to the Maximizer DB)
Database – The ODBC data source name to the Maximizer database.
Username – The name of a valid Maximizer account.
Password – The password to the Maximizer account.
Configuring Microsoft Outlook® Integration
When CyDesk is integrated with Outlook, it provides services such as popping a contact record on an incoming call, logging the call to the journal etc. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The Outlook tab within CyDesk Manager contains a list of the Outlook integration profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Incoming Calls
Pop Contact – If the contact’s number is found in the Outlook, the contact record will be opened in Outlook.
Pop Contact Journal Entry – A new window will be opened to create a journal for selected contact.
Log Call To Journal – A new journal entry will automatically be entered with every incoming call.
Log Unknown Number / No Number – Creates a new journal entry even when the contact is not found.
*Unanswered Callback Task – Creates a new Outlook task for calls missed from a contact.
*Callback Unknown Numbers – Creates a new callback task even for numbers not found in Outlook’s contacts.
Ignore Internal Calls – Internal calls do not cause screen pop or actions.
*The unanswered callback feature should only be selected if an incoming call rings on one CyDesk agent only. Otherwise all the agents who did not answer the call will receive a missed call record and a call back scheduled.
Outgoing Calls
Pop Contact – If the contact’s number is found in the Outlook, the contact record will be opened in Outlook.
Pop Contact Journal Entry – A new window will be opened to create a journal for selected contact.
Add CyDesk Button to Outlook – A button will be added to Outlook toolbar for dialing.
Log Call to Journal – A new journal entry will automatically be entered with every outgoing call.
Log Unknown Numbers – Creates a new journal entry even when the contact is not found.
The ‘Integration’ setting must be changed to Outlook and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and Outlook must be running for this integration to work.
Additional Client Configuration
CyDesk Outlook Integration does not automatically use every possible Contact folder in a user’s Outlook. By default, it will only use the ‘Contacts’ folder. To use contacts from folders other than the ‘Contacts’ folder, run the OutlookFolderSelector.exe application which can be found in the installation folder for CyDesk.
This application allows the agent to select any other Contact folders that are to be used. The ‘Contact’ folders are shown in Bold font. Simply check the folders that contain the contacts you wish to integrate. The next time you restart CyDesk, the contacts inside the selected folders will be used as part of the Outlook integration.
This is a local setting that applies only to the local workstation and must be repeated if agent has multiple workstations.
Updated Outlook Calendar Integration with Office 365
Office365 credentials with access to everyone's calendar are required to set up Calendar profile.
Configuring Microsoft Outlook® Calendar Integration for Presence
Calendar
CyDesk can be configured to set an agents status to a break according to appointments in their Outlook Calendar. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
Currently Outlook is the only calendar application that is integrated.
The Calendar tab within CyDesk Manager contains a list of the Calendar Integration profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
When a profile is added or edited, the profile displays with a list of entries that can cause an appointment in Outlook to trigger a break in CyDesk.
Adding or editing a Calendar Trigger will display the Edit Calendar Trigger Details screen as below.
Text to match in Appointment - This text can be anywhere in the text of the subject of the appointment, and is case insensitive. However the search is full-word. For example:
Lunch Meeting or With Phil meeting Jim & Pam would match.
Meetings all day would not cause a match
Break to Activate - This is the break that will be activated for the CyDesk user when the ‘Text to match in Appointment’ text is found in the appointment subject.
Priority - The priority is used to assist in the situation where more than one match is found, the match with the highest number in the priority field will be used.
Overwrite - If the agent is already on a break when this appointment becomes active, the break will change to the one selected here only if this tick box is ticked.
Auto-off - When the appointment finishes, the user will be taken off a break (or returned to the previous break they were on) only if this tick box is ticked.
Any of the profiles created for Calendar Integration can be selected from the ‘Calendar Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and Outlook must be running for this integration to work.
Configuring CRM Integrations - Dynamics CRM 2011
Configuring CRM Integrations -
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
General Settings
CRM Discovery Service – The address of the web service for authentication.
Organization – The name of the organization configured in Dynamics CRM 2011.
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the Dynamics CRM 2011 account to use.
Domain – The domain name of the Dynamics CRM 2011 account, if applicable.
Password – The password to the Dynamics CRM 2011 account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM.
Create Callback Task – Creates a Task to remind agent of the missed call.
Create Unlinked Callback – Creates a Task to remind agent of the missed call, even when contact is not found in CRM.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Email in History – Creates a log of the email in History
Configuring ODBC Database Integrations
CyDesk can be integrated with any application that supports ODBC and DDE. CyDesk has the option to integrate with other applications such as Microsoft Access etc than just the applications listed in the CyDesk Manager.
The ODBC tab within CyDesk Manager contains a list of the ODBC integration profiles. A new integration profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Name – The name of the ODBC integration profile.
Datasource – The ODBC name that connects to the data source
Primary ID – The field in the ODBC data source that will be used as the contact identifier.
Additional Tables – Link multiple tables.
Name Field – The field in the ODBC data source that will be used as the name of the contact.
Company Field – The field in the ODBC data source that will be used as the company name of the contact.
Verification Settings – The field in the ODBC data source that will be used to verify the validity of the record.
Phone Number Fields – The field in the ODBC data source that contains phone numbers of the contact. This will be matched against the caller number of the active call. Multiple fields can be added into the list
The ‘Integration’ setting must be changed to ODBC and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Call Event Functions
The Call Event Functions table is used to trigger actions to occur when certain events are fired, such as when an incoming call starts ringing, when an incoming call is answered and when campaign calls are presented.
A new function can be added by clicking on the ‘Add’ button in the ‘Call Event Functions’ list, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Name – The name of the action.
Description – Text to describe the configured action.
Action – The list of actions that can be performed. We will not explain every action in detail with this document.
DDEExecute – Connects to a third party DDE Service and send commands.
Pop Access 2007 – Opens a form in Microsoft Access
ShellExecute – Starts an external application.
SendKeys – A well documented function within languages such as Visual Basic or C#, where ‘special keys’ are enclosed in curly braces, such as {TAB}.
Additional Client Configuration
The ODBC data source, with the exact same name and configuration, must exist in each agent machines.
CyTrack Integration for SalesForce
Salesforce
CyTrack supports integration of Salesforce CRM for Agents to perform searches and enable screen popping of caller details.
Please see the CyDesk User Guide for details on using this integration.
Prior Configuration
API Access
Your Salesforce instance must be enabled for API access. To use this you must be running a supported version. Please refer to Salesforce documentation for details.
API Tokens and Multi Factor Authentication
You may also need your users to know their API tokens, or you may disable this requirement on your instance. For full details please refer to Salesforce documentation, and details are subject to change, however we provide a basic guide here to configuring this.
Salesforce may enforce 2FA/MFA (Two-factor or Multi-Factor) authentication for your users unless you configure the Trusted IP Ranges. By doing this you can tell your Salesforce instance what range(s) of IP addresses you are defining as safe for users to access Salesforce without extra authentication, such as an API token or Authenticator app.
WARNING – This may reduce your security so do so at your own risk and after careful consideration. CyTrack is not responsible for your site security. |
To set trusted IP range(s) so users do not need to use API token or 2FA:
In Salesforce, select Setup
Enter Network Access in the quick find box then select Network Access
Click New
Enter a valid IP range in the Start and End IP range fields. Must be valid IPv4 range.
Click Save
If you choose to continue to use API tokens as part of your security or for access outside the Trusted IP ranges, please note:
Users will need to know their API token. If they do not know this they can reset their token using the following procedure:
o Open Settings
o Enter Reset My Security Token into the Quick Find box and select Reset My Security Token
o Read the notice and if you wish to reset your token click the Reset Security Token button
o Follow the steps.
Once users know their token, they simply append it to their regular password when logging in to CRM, such as when challenged in CyDesk for CRM login details.
For example, if your regular password is MyP@ssword and your API token is zElJwHtYIOghetsJTS then you would use MyP@sswordzElJwHtYIOghetsJTS as the password for logging in.
Configure CyTrack
To begin, you need to open CyDesk Manager, and proceed to the configuration screen.
CyDesk Manager->Options->Configure
Then Integration -> CyDesk Web -> Web CRM Integration
Press Add (or double-click an existing entry)
Type in a name for the integration, and select the Integration type.
Select Requires User Login, then press Configure Integration
General Settings
Credentials – Optional credentials to test the API interface. Press the [..] button to expand the fields below.
Username – The name of the Salesforce CRM account to use.
Domain – The domain name of the Salesforce CRM account, if applicable.
Password – The password to the Salesforce CRM account. Unless this requirement is disabled as noted earlier, you will need to append the API token to the regular password, as described in the Prior Configuration section above.
i.e. <LoginPassword><API Token>
The [Login] button will test the credentials and advise when successful.
If you receive this message, then you most likely do not have API access enabled for your Salesforce instance.
If you receive this message, you need to ensure you have included the correct API Token appended to the regular password for the Salesforce CRM account you supplied. You may need to follow the Salesforce documentation to reset this token.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM.
Create Callback Task – Creates a Task to remind agent of the missed call.
Create Unlinked Callback – Creates a Task to remind agent of the missed call, even when contact is not found in CRM.
Do not log Unanswered Calls – Ignores logging of unanswered calls.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Email in History – Creates a log of the email in History.
Press OK when done to save
Agent Configuration
Now configure an Agent to use that CRM
In CyDesk Manager, navigate to Agents and open the Agent (double-click)
Select the Integration type and set the Profile. Press OK to save.
Once the Agent logs out of CyDesk and back in again they will pick up this new setting.
CRM Compatibility for CyDesk
Below is the CRM compatibility table for CyDesk and functions that we are capable of delivering:
To download the file, click below.
CRM Integration Matrix.pdf (80 KB)
Configuring CRM Configurations:
Configuring CRM Configurations - ACT!
When CyDesk is integrated with ACT!, it provides services such as popping a contact record on an incoming call, dialing contact numbers from within ACT! etc. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The ACT! tab within CyDesk Manager contains a list of the ACT! integration profiles. A new profile can be added by clicking on the ‘Add’ button and an existing one can be deleted by clicking on the ‘red bin’ icon.|
Incoming Calls
Screen Pop Known Numbers – If the contact’s number is found in ACT!, the contact record will be opened in ACT!. The screen pop will not occur if the users current record in ACT! requires saving.
‘Record History…’ when answered – When an incoming call is answered, the ‘Record History…’ windows will be opened to allow agent to enter details of the call they are receiving, to be stored in the History for that contact.
New Number ‘Lookup Contact’ – If the caller cannot be identified, this option will enable ACT! to display the ‘Lookup Contact’ screen.
Log Answered Calls – Generate automatic entries into the ACT! History for incoming calls that are answered.
Log Unanswered Calls – Generate automatic entries in the ACT! History for incoming calls that are missed.
Schedule Call Back – When enabled, a ‘Call’ Activity will be scheduled to return the missed call.
Link CyRecord Files in History - When enabled, a link to the call recording file will be added to the ACT! History Tab to allow subsequent playback of the recording.
Outgoing Calls
Screen Pop Known Numbers - If the contact’s number is found in ACT!, the contact record will be opened in ACT!
‘Record History…’ when answered – When the outgoing call is answered, the ‘Record History…’ windows will opened to allow agent to enter details of the call they are making, to be stored in the History for that contact.
New Number ‘Lookup Contact’ – If the caller cannot be identified, this option will enable ACT! to display the ‘Lookup Contact’ screen.
Log Outgoing Calls – Generate automatic entries into the ACT! History for all outgoing calls.
Link CyRecord Files in History - When enabled, a link to the call recording file will be added to the ACT! History Tab to allow subsequent playback of the recording.
The ‘Integration’ setting must be changed to ACT! and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and ACT! must be running for this integration to work.
Additional Client Configuration
DESK.ACT.Plugin.dll can be found in the installation folder of CyDesk, and it will need to be manually copied to the Plug-ins folder of ACT to enable the integration. Note that this integration will only work with the .NET Versions of ACT!, i.e. ACT! Version 7, 2005 etc and subsequent versions.
Configuring CRM Integrations - Generic
CyDesk has a Generic CRM layer that simplifies the configuration and expected behaviour of the integration. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The Generic CRM tab within CyDesk Manager contains a list of the integration profiles to different applications. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Name – The name of the integration profile.
Static – The integrations already supported by this layer.
DynamicsCRM2011Integration.Dynamics – Microsoft Dynamics CRM 2011 local / hosted / online.
DynamicsCRM41Integration.Dynamics –Microsoft Dynamics CRM 4 local / hosted / online.
HeatIntegration.HeatInterface - When CyDesk is integrated with Heat, it provides services such as popping a contact record on an incoming and outgoing call and so forth.
SimproIntegration.Simpro – Workforce Management application called Simpro.
XplanIntegration.Xplan – Investment Trends Planning application called Xplan.
All current built-in integration such as MSCRM, Goldmine, SalesLogix, Maximizer, ACT! will be moved to this layer in future versions. For now search for existing built in CRM integrations in the forum under each product name
Requires User Login – Enable this checkbox if local authentication is required.
The ‘Configure Integration’ button will open the next configuration screen.
Additional Client Configuration
The ‘Integration’ setting must be changed to Generic Integration and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
If ‘Requires User Login’ is ticked, the Generic CRM integration window will be displayed when CyDesk client is launched. Use the credentials section to configure the correct username, password and domain. None of the other the settings are configurable from this screen.
Configuring CRM Integrations – HEAT Help Desk Logging
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
General Settings
HEAT DSN – The address of access HEAT.
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the HEAT account to use.
Domain – The domain name of the HEAT account, if applicable.
Password – The password to the HEAT account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Log Email in History – Creates a log of the email in HEAT database.
HEAT Remote Integration
General Settings
HEAT Gateway Server – The address of access HEAT Gateway Server.
Screen Pop URL – Url of Heat Application to allow screen pops
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the HEAT Remote account to use.
Domain – The domain name of the HEAT Remote account, if applicable.
Password – The password to the HEAT Remote account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in HEAT Remote.
Log Unlinked Call History – Creates a log of the call in HEAT Remote even when contact is not found in HEAT Remote.
Create Callback Task – Creates a Task to remind agent of the missed call.
Create Unlinked Callback – Creates a Task to remind agent of the missed call, even when contact is not found in HEAT Remote Gateway.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HTEAT database.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in HEAT Remote.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Email in History – Creates a log of the email in HEAT database.
Configuring CRM Integrations - Goldmine®
When CyDesk is integrated with GoldMine, it provides services such as popping a contact record on an incoming call, allowing dialling of contact numbers within GoldMine etc. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The Goldmine tab within CyDesk Manager contains a list of the Goldmine integration profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Incoming Calls
Screen Pop Existing Number – Display their Goldmine contact record if the number of the caller is known.
Use New Contact Window – A new contact window will be opened when a screen pop occurs, rather than the existing record being changed
New Number Lookup Contact - In the case that the number of an incoming call is not found in the contact database, a Lookup Contact window to be displayed.
Complete Scheduled Call – When an incoming call results in an identified contact, a complete schedule call item is opened, linked to the contact.
Complete Unscheduled Call – When an incoming call results in an identified contact, a completed unscheduled call item is created, linked to the contact.
Auto-Restore When Minimised – This option will restore the CyDesk client when an incoming call is received and minimised when the call ends.
Ignore Internal Calls – GoldMine will not pop the contact of a call that is on an internal extension.
Outgoing Calls
Screen Pop Existing Number – Display their Goldmine contact record if the number of the caller is known.
Use New Contact Window – A new contact window will be opened when a screen pop occurs, rather than the existing record being changed.
New Number Lookup Contact - In the case that the number of an outgoing call is not found in the contact database, a Lookup Contact window to be displayed.
Completed Scheduled Call – Completes a pending action for the contact.
Complete Unscheduled Call – Creates a new unscheduled call action for the contact.
Goldmine Fields to Search
This specifies the phone number fields in GoldMine that CyDesk will search for a contacts number. Additional contacts can only be searched if the SQL version of GoldMine is installed.
Goldmine History Settings
The GoldMine History Settings group together options describing what information on call history should be automatically logged into GoldMine.
For each row the ‘Log’ checkbox determines if calls of that type should be logged. The ‘Code’ box determines which history code that the event is given, and the ‘Result’ box describes the result that the history item is given.
If the ‘Callback’ check box is checked, a pending call action is automatically created. This feature should only be selected if an incoming call rings on one CyDesk agent only. Otherwise all the agents who did not answer the call will receive a missed call record and a call back scheduled.
If the ‘Campaign Name’ option is enabled for the CyCall row, when a CyCall Campaign Call is logged in the History of GoldMine, the name of the Campaign will be inserted at the start of the Reference text.
Miscellaneous
Lookup Incoming Number (DNIS) – This option tells CyDesk to use the number the caller dialled rather than the callers own number, for the GoldMine searches on incoming calls.
Start GoldMine Timer – CyDesk will start the Goldmine timer when a call begins.
The ‘Integration’ setting must be changed to Goldmine and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and Goldmine must be running for this integration to work.
Additional Client Configuration
The following DLL files must be copied from the Goldmine program files folder to the Windows System folder i.e. C:\Windows\System32. The name of the files may differ slightly depending upon the version of Goldmine.
GM7S32.DLL
GM7TP32.DLL
GMSSL32.DLL
GMXML.DLL
Configuring CRM Integrations – HEAT Help Desk Logging
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
General Settings
HEAT DSN – The address of access HEAT.
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the HEAT account to use.
Domain – The domain name of the HEAT account, if applicable.
Password – The password to the HEAT account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Log Email in History – Creates a log of the email in HEAT database.
HEAT Remote Integration
General Settings
HEAT Gateway Server – The address of access HEAT Gateway Server.
Screen Pop URL – Url of Heat Application to allow screen pops
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the HEAT Remote account to use.
Domain – The domain name of the HEAT Remote account, if applicable.
Password – The password to the HEAT Remote account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in HEAT Remote.
Log Unlinked Call History – Creates a log of the call in HEAT Remote even when contact is not found in HEAT Remote.
Create Callback Task – Creates a Task to remind agent of the missed call.
Create Unlinked Callback – Creates a Task to remind agent of the missed call, even when contact is not found in HEAT Remote Gateway.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HTEAT database.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in HEAT Remote.
Log Unlinked Call History – Creates a log of the call in HEAT, even when contact is not found.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Call History – Creates a log of the call in the HEAT database.
Attach Recording – Creates a link to the call recording file in the HEAT database.
Email
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Email in History – Creates a log of the email in HEAT database.
Configuring CRM Integrations - SalesLogix
When CyDesk is integrated with SalesLogix, it provides services such as popping a contact record on an incoming call, dialing contact numbers from within SalesLogix etc. Sets of configuration options can be grouped into profiles, and these profiles are assigned to agents. This ensures that a set of agents all have the same options set and allows flexibility in the options agents can possess.
The SalesLogix tab within CyDesk Manager contains a list of the SalesLogix integration profiles. A new profile can be added by clicking on the ‘Add’ button, and an existing one can be deleted by clicking on the ‘red bin’ icon.
Incoming Calls
Display Contact if known – Display their SalesLogix contact record if the number of the caller is known.
Use New Contact Window – A new contact window will be opened when a screen pop occurs, rather than the existing record being changed
New Number Lookup Contact - In the case that the number of an incoming call is not found in the contact database, a Lookup Contact window to be displayed.
Show ‘Complete Activity’ menu screen – When an incoming call results in an identified contact, a complete activity item is opened, linked to the contact.
Show new ‘Complete Phone Call’ screen – When an incoming call results in an identified contact, a complete phone call item is created, linked to the contact.
Log Calls to History – Generate automatic entries into the SalesLogix History.
Schedule Activity for missed calls - When enabled, an Activity will be scheduled to return the missed call.
Outgoing Calls
Display Contact if known – Display their SalesLogix contact record if the number of the caller is known.
Use New Contact Window – A new contact window will be opened when a screen pop occurs, rather than the existing record being changed
New Number Lookup Contact - In the case that the number of an incoming call is not found in the contact database, a Lookup Contact window to be displayed.
Show ‘Complete Activity’ menu screen – When an incoming call results in an identified contact, a complete activity item is opened, linked to the contact.
Show new ‘Complete Phone Call’ screen – When an incoming call results in an identified contact, a complete phone call item is created, linked to the contact.
Log Calls to History – Generate automatic entries into the SalesLogix History.
Other Options
Contact Phone Fields – Tick all SalesLogix contact phone fields that will be integrated with CyDesk.
Use Account if no Contact found – When enabled, the system searches Account if there is no match with Contact.
Account Phone Fields – Tick all SalesLogix account phone fields that will be integrated with CyDesk.
The ‘Integration’ setting must be changed to SalesLogix and the profile can be selected from the ‘Profile’ drop down list in the Agent configuration screen as shown below.
Both CyDesk and SalesLogix must be running for this integration to work.
Configuring CRM Integrations - Simpro
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
General Settings
SimPro URL – The address of access SimPro.
Organization – The name of the organization configured in SimPro.
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the SimPro account to use.
Domain – The domain name of the SimPro account, if applicable.
Password – The password to the SimPro account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the SimPro database.
Attach Recording – Creates a link to the call recording file in the SimPro database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Log Unlinked Call History – Creates a log of the call in SimPro, even when contact is not found.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the SimPro database.
Attach Recording – Creates a link to the call recording file in the SimPro database.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Log Unlinked Call History – Creates a log of the call in SimPro, even when contact is not found.
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the SimPro database.
Attach Recording – Creates a link to the call recording file in the SimPro database.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Log Email in History – Creates a log of the email in SimPro database.
Configuring CRM Integrations – Xplan
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
General Settings
Xplan Server URL – The address of access Xplan.
Credentials – This will be filled automatically according to the other settings below it.
Username – The name of the SimPro account to use.
Domain – The domain name of the SimPro account, if applicable.
Password – The password to the SimPro account.
The ‘Login’ button will test the credentials and advise when successful.
Incoming Call
Screen Pop – Displays the contact information when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the Xplan database.
Attach Recording – Creates a link to the call recording file in the Xplan database.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Log Unlinked Call History – Creates a log of the call in Xplan, even when contact is not found.
Outgoing Call
Screen Pop – Displays the contact information when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the Xplan database.
Attach Recording – Creates a link to the call recording file in the Xplan database.
Ignore Internal Calls – Disables all integration features when dialing an internal destination.
Log Unlinked Call History – Creates a log of the call in Xplan, even when contact is not found.
Campaign Call
Screen Pop – Displays the contact information when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Log Call History – Creates a log of the call in the Xplan database.
Attach Recording – Creates a link to the call recording file in the Xplan database.
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Log Email in History – Creates a log of the email in the Xplan database.
Configuring CRM Integrations - Hubspot
Configuring CRM Integrations
Please refer to the steps explained in configuration settings ‘Generic CRM’ Tab before reading below information
Integration Editor
Name – The Hubspot profile name.
Integration – Select from dropdown list ‘Hubspot CRM’
Requires User Login – Leave unchecked
Configure Integration – Refer to section below
Runs in Local Mode – Leave unchecked
Configure Integration
General Settings
Access Token – Refer to Hubspot article for creating access token: Migrate an API key integration to a private app (hubspot.com). Also refer to Configuring CRM Integrations - Hubspot | Create a new private app and generate Access Token and Configuring CRM Integrations - Hubspot | Hubspot Softphone Integration
Credentials – This will be filled automatically according to the other settings below it.
Username – Not required
Domain – Not required
Password – Not required
The ‘Login’ button will test the credentials and advise when successful - Not required
Incoming Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when the incoming call comes from an internal source.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM.
Create Callback Task – Creates a Task to remind agent of the missed call.
Create Unlinked Callback – Creates a Task to remind agent of the missed call, even when contact is not found in CRM.
Outgoing Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Ringing – When the call is still ringing.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Create Journal before Pop – Saves the Phone Call Activity before it is popped. This option is available only when ‘Pop Journal Entry’ is checked.
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
Ignore Internal Calls – Disables all integration features when calling an internal number.
Pop Unlinked Journal – Displays new Phone Call Activity even when contact is not found in CRM.
Log Unlinked Call History – Creates an entry to History even when contact is not found in CRM
Campaign Call
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the next campaign call is assigned to agent.
When Ringing – As soon as the call rings.
When Answered – When the agent has answered the call.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered
Log Call History – Creates an entry in History.
Attach Recording – Creates a link to the call recording file in History.
OmniChannel
Screen Pop – Displays the Contact screen when the caller is found.
Never – The feature is disabled.
When Presented – When the email is assigned to agent.
Pop Journal Entry – Displays the new Phone Call Activity screen once the call is answered.
Log Integration in History – Creates a log of the interaction in History
Create a New Private App & Generate Access Token
In your HubSpot account, click the settings icon in the main navigation bar.
In the left sidebar menu, navigate to Integrations > Private Apps.
Click Create private app.
On the Basic Info tab, configure the details of your app:
Enter your app's name.
Hover over the placeholder logo and click the upload icon to upload a square image that will serve as the logo for your app.
Enter a description for your app.
Click the Scopes tab.
Next, select following scopes
crm.lists.read
crm.lists.write
crm.objects.contacts.read
crm.objects.contacts.write
account-info.security.read
oauth
After you're done selecting your scopes, click Create app in the top right. You can always make changes to your app after you create it.
In the dialog box, review the info about your app's access token, then click Continue creating.
With your private app created, click Show token under your access token to reveal it.
Insert this access token to CyDesk (instead of old API Key)
HubSpot Softphone Integration
This section covers the requirements for enabling CyDesk click to dial functionality from within Hubspot.
Step 1: Create a developer account in HubSpot
If you don't already have a HubSpot developer account, sign up for one here.
Step 2: Create a an app in HubSpot
For this we need a developer account (which we created in step 1)
Once you’re set up and signed in, you'll start on the developer account homepage, where you'll have the option to create your first app or create a test account. Click “Create an app."
You can also start from the Apps dashboard using the “Create app” button.
In create app page you will two tabs i.e. App info and Auth
Next, you’ll fill out some basic information and settings for your app.
In the next tab i.e., Auth, we will get App Id which we need to copy and store
In Auth page enter redirectURL to “cytrack.io”. It is important to copy the URL exactly as in quotes otherwise the verification will fail.
At the bottom of the page to add new scopes to app, from the available scopes select crm.objects.contacts with Read access
Step 3: Install the app on customers main hubspot portal
In step 2 we created an App, now we get an OAuth URL
Copy that OAuth URL and enter it in new browser tab and install it to the customers main account.
After successful install it will redirect to redirectURL (https://www.cytrack.io/ ) and provide code in url. Copy this code and insert it into script1 file found in Configuring CRM Integrations - Hubspot | Script Files.
Also update the ClientId and ClientSecret in script1.
Then execute the script1 file.
Step 4: Now generate HubSpot API key.
Go to the developer account homepage then click on Apps in top menu. It will take you to Apps page. On this click on “Get HubSpot API key”.
This will generate the Hubspost API key. Store this api key.
Step 5: Now Add SoftPhone in Hubspot
For this we need to execute the script2 file found in Configuring CRM Integrations - Hubspot | Script Files.
Update App Id that we got in step 2 into script 2 file.
Update hapikey (the the api key which we generated in step 4) that into script 2 file.
Update url script 2 file to "https://server-teams-production.azurewebsites.net/hubspot-integration?url=https://server:5000" (after URL enter customers DeskWeb path)
Script Files
CyDesk Tray Utility
From Release 21-2-3 onwards,
The CyDesk pop alerts on activity have been moved to a new tray utility for anyone who has installed the client side tools (Or desk manager)
Note: Any users wishing to install the client side tools can find instructions here: CyDesk User Guide | Configuring DeskTools
You should have an icon in your tray tools with a Cytrack logo on a white background.
If you open this it’ll launch a tray tool that will persist a notification in the bottom right of your screen if there are calls or alerts present
You can use the little cog button form the dark pane to pop the configuration pane where you select which alerts you wish to receive
Which should then get you persistent alerts in the bottom right which you can click to clear (Rather than having them disappear after a few seconds)
There’s also an option for sound on Ring – which will enable agents to have their PC make a noise when a call is ringing rather than just ringing in their headphones
Call Control with CyDesk
The active call window automatically appears when you are on a call. This is how you can see the information about the call, and control the call.
Answer
| When an incoming call is received externally or internally, CyDesk will be displayed. It also shows the name and company of the person if CyDesk is integrated to a contact database e.g. MS Outlook or MS Dynamics. When CyCC system is used, agents will also be able to see the name of the queue for that http://call.To answer the call, click on the ‘Answer’ button. |
Hang-up
| Once the call is answered, to end the call click the ‘Hang-up’ button |
Hold and Unhold
|
To hold a call, click the ‘Hold’ button when there is an active call. Press the same button, or the bigger button, or double click on the Held call to pick up the call again. |
DialTo dial manually open the Active Call window and click on the Dial button.
Please note that it is possible for this ability to dial a number manually to be configured as disabled by the CyDesk Administrator.
Transfer
| A call can be supervised transferred to a team member by dragging the call in the ‘Active Call’ screen and dropping it on the team member. Press the Transfer button to complete it.
|
Other Call Related Features
Agent can access the list of CyDesk functions and telephony controls by clicking on the drop-down arrow at the active window. |
Pop Contact – When integrated to CRM application, this option is available to manually open the CRM contact screen.
Edit Call Info – Modify the call details name, company and notes information of the call. |
Dial pad – Allows user to send additional digits once the call has connected.
Park Call – Puts the call on the PBX park device (if park device is configured on PABX).
Notify Call – Sends additional information to the XML Gateway.
Agent can also access the list of recent calls in relation to the phone number by clicking on the magnifying glass icon in the active call window. |
Call Account Codes
CyDesk supports the notion of Call Account Codes, which are used to keep track of calls made for an account.
When a call is active, the user can select ‘Enter the Account Code’ from the drop-down menu on the Active Call Window.
The user will then be prompted to enter an account code, which will be stored against that call in CyReport. |
Do Not Call
Description
The Do Not Call feature allows Administrators to Add/ Remove/ View numbers of customers on a register who do not want to be called on the CyDesk Manager. The register is intended to regulate and minimize the number of unsolicited calls from within your country or anywhere overseas.
How it works
Every time an outbound call is made, the dialer verifies dialed number on the system. Once the number is manually added to the Do Not Call list, the dialer automatically blocks the number, barring the system from dialing it again. It also provides the option of deleting the number from the list.
Functions and Features
Search – It allows you to search for the number and confirm if the number is already on the list or not.
Delete – You can delete and remove the number from the list
Add – You can add the new number to the list
Add From Calls – It allows you to add numbers from your database to the Do Not Call List.
What's in this article
How to launch the Do Not Call List window
How to add numbers
Adding numbers from calls
How to delete numbers from the list
I. How to launch the Do Not Call List window
Step 1: Login to CyDesk Manager as an Administrator and go to Options > Configure
This will open Configuration window.
Step 2: Go to Configuration > System on left side pane. Then, click on Do Not Call list.
It will open Do Not Call list window. Here, you can Search, Delete, and Add numbers accordingly.
II. How to add numbers
Step 1: On the Do Not Call window, click on Add button to open the Editor window.
Step 2: On the editor window, manually input the number on the field and add notes on the Reason field accordingly.
Note: The user can also “unbar” the number temporarily by ticking the Unbar box (highlighted in green).
III. How to add numbers from calls
Step 1: On the Do Not Call List window, click on Add From Calls button.
It will open Add Numbers From Calls window.
Step 2: Search the number from all Campaigns or any specific item according to your requirement.
Step 3: Select the Completion Code from the drop down as per your requirement and click on the Find button. It will give you the search result in the pane.
Step 4: Select all the Numbers by ticking the Select All option at the bottom or you can select a specific number as per your requirement.
Step 5: Click on Add button to make them available in your list and close the window.
IV. How to delete a number from the list
1: On the Do Not Call list window, simply highlight the row of the number.
Step 2: Click Delete, located on the buttons on top of the columns.
Auto Callback and SMS Alerts in CyCX: Enhancing Customer Experience
Auto Callback Feature
In the fast-paced world of customer service, every interaction counts. However, it is difficult to retain callers who hang up while waiting in the queue, resulting in missed opportunities. The Auto Callback feature reduces disappointments and is a game-changer in enhancing customer engagement and satisfaction.
Use Case one:
Consider a scenario where a customer hangs up while waiting in the queue. With Auto Callback, they are seamlessly added to the callback queue, ensuring their query is addressed promptly.
Use Case two:
Now imagine a customer who has selected the callback in queue option but decides to hang up before speaking to an agent. In this case, Auto Callback ensures that the customer receives a prompt callback without any hassle.
Description:
The Auto Callback feature offers a dynamic solution to the challenge of managing dropped calls effectively. Administrators can leverage this feature to automate callback scheduling, ensuring that customers are promptly contacted after hanging up in the queue.
How it Works:
Auto Callback simplifies the process of scheduling callbacks for customers who abandon calls while in the queue. Here’s how it operates:
Seamless Callback Integration: Customers who hang up while waiting in the queue are automatically added to the callback queue, ensuring their queries are addressed promptly.
Effortless Customer Experience: Customers who opt for the callback in queue option are assured of receiving a prompt callback, eliminating the need for them to take any additional steps.
Administrator Control: Administrators can customize callback scheduling parameters to meet specific business needs, ensuring efficient management of customer inquiries.
SMS Alerts in CyCX
Use case one: Customer hangs up in the queue and will receive an SMS such as “Sorry we missed your call, we have added you to our callback in queue and will be in touch with you shortly. If you wish you to opt out, reply ‘Stop’.”
Use Case two: Customer has selected callback in queue while awaiting an agent, the customer hangs up and will receive and SMS such as “Thank you for using our callback in queue feature, one of our agents will ring you shortly. If you wish you to opt out, reply ‘Stop’.”
Description:
The SMS Alert feature in CyCX empowers administrators to automate SMS notifications based on specific triggers within the system. This functionality ensures efficient communication with customers while offering control and flexibility in managing communication preferences.
How it works:
This feature automatically schedules callbacks and sends SMS notifications to clients who abandon calls after waiting in the queue. Whether the wait was short or prolonged, clients receive:
Callback scheduling notification: Informs them of their status and assures them of an impending callback.
Client-side flexibility: Clients can opt out of the callback by replying to the SMS with a customizable keyword.
Administrator control:
Triggering events: Specify situations that trigger SMS notifications, such as failed callback attempts or meeting defined criteria.
Tailored notifications: Customize triggers and personalize message content to fit specific needs.
Benefits:
Improved customer experience
Leverage abandoned calls
Increased operational efficiency
Enabling and Configuring the Auto Callback Feature with SMS Notifications
Enabling Auto Callback:
Set Callback Queue:
Right-click the desired queue and select "Edit."
In the queue configuration interface, navigate to the "Auto Callback" tab under "Other."
Choose the specific auto callback queue for SMS notifications.
Auto Callback Features:
Alerted by Abandoned Calls:
When a caller waits without assistance and presses 9, they are automatically added to the callback in queue. (CBIQ)
Hanging up also triggers auto callback registration, capturing potential lost business opportunities.
Callback Tab in Campaign:
A dedicated "Callback" tab facilitates configuring SMS notifications for callers who opt for a callback or drop out of the queue.
Configuring Callback Settings:
Access Callback Configuration:
Right-click the callback associated with the chosen queue and select "Edit."
Access and adjust callback settings in the "Callbacks" tab.
Callback Campaign Features:
Number Validation Table: The validation table allows for the creation of validation rules to ensure that the caller's number is valid. For example, if a caller's number is private or suppressed, the validation table prevents the registration of callback requests with invalid numbers, thereby optimizing the callback process by ensuring that valid contact details are available for follow-up.
Send SMS on Receipt checkbox: Upon enabling the auto callback feature, the system automatically registers callers who hang up in the auto callback queue. In addition to this, by checking the "Send SMS on Receipt" checkbox, administrators can configure the system to send an SMS to the caller when they are placed in the auto callback queue. The text of the SMS message to be sent can be customized.
SMS Validation: The validation table allows for the creation of validation rules to ensure that the caller's number is valid. For example, if a caller's number is private or a landline number, the validation table prevents the registration of the number as sending an SMS to that number would be futile.
Send SMS on Unsuccessful Callback checkbox: When a callback attempt is unsuccessful, typically due to the client not answering the call, the system can be configured to send an SMS notification to the client. This notification informs the client of the unsuccessful attempt to reach them and provides options such as trying again later or opting out by replying with the word "cancel". Administrators can customize the content of this SMS message and provide clear instructions to the caller.
Text to Stop SMS and calls: The "Text to Stop SMS and calls" field allows administrators to specify the keyword that callers should use if they wish to opt out of receiving further SMS notifications and callback attempts. The specified keyword, such as "cancel", (it could be any word of your choosing) must be used for this purpose. Once a caller responds with the designated keyword, the system acknowledges the cancellation, the system sends a confirmation message, such as "Thank you, your callback has been cancelled". Administrators can tailor the message in this field.
Smart Callback Filter (SCF)
Overview
The Smart Callback Filter (SCF) is feature designed to streamline call management and enhance customer service efficiency. By intelligently filtering and eliminating duplicate callback requests, SCF ensures that customer calls are handled in the most efficient manner, especially in high-volume or after-hours scenarios.
Use Case One: Efficient Handling of Repeated Calls
A customer, in an attempt to reach support, makes multiple calls to the queue without getting through to an agent. Using the Auto Call Back feature each attempt automatically triggers a callback request. With SCF, only the first request is registered, preventing duplicate callbacks and optimizing agent workload.
Scenario:
Customer calls the support queue and opts for a callback.
Customer hangs up and calls again, repeating this several times.
SCF registers only the first callback request, ensuring the customer receives a single callback, thus preventing any frustration or confusion from multiple calls.
Use Case Two: Preventing Duplicate Callbacks in High-Volume Periods
During peak times, a significant increase in call volume leads to many customers opting for callbacks. SCF intelligently identifies and filters duplicate requests from the same number, ensuring each customer is scheduled for just one callback.
Scenario:
Several customers call into the support queue during a peak period, with some making multiple callback requests.
SCF detects and filters out duplicate requests from the same phone numbers.
Agents are then able to manage callbacks more efficiently, focusing on reaching out to each customer without handling multiple calls to the same number.
Description
SCF leverages advanced algorithms to identify duplicate callback requests within a campaign, ensuring that customers are not overwhelmed with multiple callbacks for the same query. This feature is crucial for maintaining operational efficiency and improving customer satisfaction by addressing their concerns promptly and effectively.
Benefits
Improved Customer Experience: By eliminating repeated callbacks, SCF ensures a smoother and more satisfactory interaction for customers.
Leverage Abandoned Calls: Converts potential missed opportunities into a single, effective callback, thereby capturing and retaining customer interest.
Increased Operational Efficiency: Streamlines the callback process, allowing agents to focus on delivering quality service rather than managing excessive callback requests.
Setting Up the Smart Callback Filter
Enabling SCF:
Access Queue Settings:
Navigate to the queue settings and right-click on the desired queue and select "Edit."
Configure Callbacks:
Within the queue configuration, locate the "Callbacks" section, check the “Don’t add if already in this campaign” box and select the appropriate completion code to avoid adding duplicate numbers in the Call Back in Queue for agents.
For example in the campaign view below the second duplicate call has been automatically completed by SCF.
Callback Assurance System (CAS) & After Hours Call Management System
Overview
The Callback Assurance System (CAS) is tailored to enhance customer service efficiency, especially for businesses operating across various time zones or requiring round-the-clock support, such as the hospitality industry. CAS ensures that every customer call, regardless of when it's made, receives the attention it deserves, seamlessly bridging the gap between customer expectations and service availability.
Use Case One: Direct Callback Registration
A customer contacts a hotel booking platform to inquire about a booking but reaches the service outside normal operation hours. Unable to connect with an agent immediately, the customer is presented with the option to request a callback. Once confirmed, a callback is registered and CAS can be configured to send an SMS to the customer: "We've received your request and will call you back shortly. To cancel, reply 'STOP'."
Use Case Two: After-Hours Callback Handling
When an agent receives a call during after-hours but is unable to answer it (i.e the agent does not press1 to accept the call after the call is answered or the call rings out for 20secs), the customer can leave a callback request. The assigned after-hours agent will receive the customer's callback number via text message and can return the call. Upon successfully making the callback, the system removes the customer's number from the callback queue and marks it as completed by an agent. (Call back needs to happen on from Avaya IX Workplace app on the mobile to remove the customers number from call back).
Use Case Three: Agent-Aided Callback Decision
An agent, upon receiving a call notification through CAS, is prompted to press 1 to accept the call. This action (of pressing 1) can also trigger the call to start recording. If the agent is in an environment not conducive to a professional call (e.g., a noisy background), choosing not to respond or pressing another key reroutes the call to the callback queue. If SMS service is configured, the customer is then informed via SMS: "Your call is important to us. We'll reach out to you soon. Reply 'STOP' to cancel the callback."
Description
CAS intelligently handles incoming calls by offering a callback option when immediate connection with a service agent is not possible. This feature is crucial for service-oriented businesses, ensuring that customer inquiries are addressed promptly, even outside traditional working hours. Upon opting for a callback, customers are reassured with an SMS notification, confirming their request, and providing peace of mind.
How It Works
The Callback Assurance System employs sophisticated logic to manage customer calls effectively:
Callback Scheduling Notification: Automates the notification process to inform customers of their callback status, ensuring transparency and reliability.
Client-Side Flexibility: Allows customers to easily opt-out of the callback service with a simple SMS command, providing control over their communication preferences.
Administrator Control:
Triggering Events: Administrators can define specific triggers for sending out SMS notifications, adapting the system to various operational scenarios.
Tailored Notifications: Customizable SMS templates enable personalization according to the business's tone and customer service strategies.
Supervisor Control:
Remote Mobile Login/Logout: Supervisors can manage agent availability during after-hours by remotely logging agents in or out on their mobile devices, ensuring that calls are directed to the right agents at the right times.
Supervisor-Controlled Remote Mobile Login
The CAS includes a feature that allows supervisors to manage after-hours call handling effectively:
Remote Agent Login: Supervisors can log in to the system after hours to manage agent availability. If a customer calls and needs to speak to someone, the call can be directed to an after-hours queue. The supervisor can then log in an agent remotely to ensure the call is handled.
For instance, if the supervisor knows that "Cytrack" is scheduled to handle after-hours calls:
1. They can search for Cytrack in the system.
2. Click the three lines.
3. Select the option for remote mobile login, and ensure that Cytrack's mobile device receives the after-hours calls.
This setup remains active until the agent's roster period ends.
Remote Agent Logout: Once the agent's after-hours shift is over, the supervisor can remotely log out the agent, using the same steps to login the agent but instead of login they can select log out agent option. This ensures that Cytrack will no longer receive after-hours calls, effectively managing agent availability and preventing unnecessary disruptions.
Benefits
Enhanced Customer Experience: CAS guarantees that customers receive timely support, significantly improving their interaction with the business.
Optimization of Missed Calls: By converting potential missed opportunities into scheduled callbacks, businesses can maintain engagement with their customers.
Streamlined Operations: Automates the management of incoming calls during peak times or outside standard hours, optimizing resource allocation and agent productivity.
The Callback Assurance System is a strategic addition to businesses like the hospitality industry, where customer satisfaction is paramount. CAS not only ensures efficient call management but also reinforces the company's commitment to exceptional service delivery.
Avaya ACO Embedded and ACO Desktop Client
The Embedded RC with Pop feature Allows ACO users to seamlessly integrate their telephony functions within CyDesk.
Overview of ACO Embedded RC with Pop Feature
How to enable Embeded RC from CyDesk Manager
Open CyDesk Manager and edit the agent you would like to enable Embeded RC.
Select the “Options” tab, click on the “Embedded RC” drop down and select “With Popup”.
Pop up Icon & Dial Pad
Click on the Pop up Icon to open the Avaya Cloud Phone within CyDesk. When using CyDesk with the embedded RC mode, the dial pad is only accessible on the pop up for dialing and selecting call menus.
Call History, Messages & Settings
Users can also access Call History, Messages for Voice, Fax and Text, Contacts including Calender Integration and Avaya profile settings for Avaya Cloud Phone from within the Pop up.
Setting up Audio on ACO Embedded RC with Pop
Follow the steps below to access and configure the RC Embedded Audio.
Click on pop up icon to open the Avaya Cloud Phone
Click on More Menu denoted by the 3 elipses on the Avaya Cloud Phone Header and select Settings
Click on Audio in Settings
Select the correct Output and Input devices and click on Save
Diagnostics
In the ‘Help’, there is a number of information that helps during a troubleshooting session.
About CyDesk Manager – Displays the CyDesk banner where you can see the software version. This must always match the CyDesk Manager version when opened on the server.
Create Diagnostic Snapshot on Server – Instructs CyDesk Server to create a diagnostic XML file of all the system configurations and information. The XML file is named CyTrackStats plus creation timestamp and stored in the ‘Log File Path’ folder.
Setting up an ACO Desktop App:
Access CyDesk:
Launch the CyDesk application.
Click on the RC pop-up icon.
Navigate to Settings:
Upon clicking the pop-up, the dialing pad interface will appear.
Locate and click on the cogwheel icon to access settings.
Access Calling Settings:
Within the settings menu, locate and click on "calling".
Select Call Source:
In the calling settings, find the drop-down list that allows to make and receive calls using the computer's microphone and speaker.
By default, the setting might be configured to use the browser for calls.
Change it to "Avaya Cloud app" from the embedded browser option.
Save Settings:
After making the change, click on the "save" button.
A prompt will appear to confirm the settings have been saved and to make sure that you have the Avaya Cloud Desktop Application is installed on your computer.
Launch Avaya Cloud Desktop App:
Locate the Avaya Cloud Desktop Application icon on your computer's desktop or in the applications menu.
Double-click to launch the application.
Log In and Initiate Calls:
Enter your credentials to log in to the Avaya Cloud Desktop Application.
Once logged in, you are ready to start receiving and making calls using the ACO Desktop App.
Suggested Reading:
CyDesk User Guide