Jump to: navigation, search

Automatic_Number_Identification

Also known as ANI. A feature that passes a caller’s telephone number over the network to the receiving location, so that the caller can be identified. Sometimes referred to as a “Caller ID.” ANI is a North American term, and Calling Line Identification (CLI) is an alternative term that is used elsewhere.



Glossary

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

(Created target blank page For Version: HTCC:8.5.2)
 
(Update with the copy of version: 8.5.2DRAFT)
Line 1: Line 1:
−
<!-- Creation of the target page -->
+
=Gplus Adapter for Salesforce =
 +
__NOTOC__
 +
Review the sections below for more information about how to configure these features in the Gplus Adapter for Salesforce. See [[GPAConfig|Gplus Adapter for Salesforce Configuration Options]] for the full list of options that apply to the adapter.
 +
 
 +
{| class="no-border"
 +
|-
 +
|
 +
* [[GPAA#Activity_history|Activity history]]
 +
* [[GPAA#Attached_data|Attached data]]
 +
* [[GPAA#Call_recording|Call recording]]
 +
* [[GPAA#Chat|Chat]]
 +
* [[GPAA#Direct_outbound_calls_to_a_route_point|Direct outbound calls to a route point]]
 +
* [[GPAA#Disposition|Disposition]]
 +
* [[GPAA#Feedback|Feedback]]
 +
* [[GPAA#Focus_following|Focus following]]
 +
* [[GPAA#Free_seating|Free seating]]
 +
* [[GPAA#In-focus_page_transfers|In-focus page transfers]]
 +
|
 +
* [[GPAA#International_dialing|International dialing]]
 +
* [[GPAA#Login|Login]]
 +
* [[GPAA#Not_Ready_reason_codes|Not Ready reason codes]]
 +
* [[GPAA#Reports_and_statistics|Reports and statistics]]
 +
* [[GPAA#Screen_pop|Screen pop]]
 +
* [[GPAA#Team_communicator|Team communicator]]
 +
* [[GPAA#Toast_and_case_data|Toast and case data]]
 +
* [[GPAA#Transfer_notes|Transfer notes]]
 +
* [[GPAA#Voice|Voice]]
 +
* [[GPAA#Voicemail|Voicemail]]
 +
|}
 +
 
 +
==Activity history==
 +
By default, the adapter updates certain Salesforce activity fields when it saves an activity history entry at the end of a call or chat. Take a look at the table below for the full list of Salesforce activity fields and where the data comes from in the adapter.
 +
 
 +
{|
 +
! '''Salesforece Activity Field'''
 +
! '''Genesys'''
 +
|-
 +
| Assigned To
 +
| Agent accepting Call
 +
|-
 +
| Created By
 +
| "
 +
|-
 +
| Last Modified By
 +
| "
 +
|-
 +
| Subject 
 +
| Text (including the type of call, such as inbound, outbound to #Phonenumber)
 +
|-
 +
| Due Date
 +
| Current Timestamp
 +
|-
 +
| Related To
 +
| Record currently in context when an agent clicks '''Mark Done'''
 +
|-
 +
| Comments
 +
| Text with information from the Subject, Case Data (the full set that comes from the adapter), and Note (note data added by the agent) fields.
 +
|-
 +
| Status
 +
| Values are preset in the Salesforce configuration
 +
|-
 +
| Priority
 +
| Values are preset in the Salesforce configuration
 +
|-
 +
| Call Duration
 +
| Duration in seconds
 +
|-
 +
| Call Object Identifier
 +
| Interaction Id
 +
|-
 +
| Call Type
 +
| Type of call, such as inbound, outbound, or internal
 +
|}
 +
 
 +
You can also define a mapping between {{#Widget:ExtLink|link=https://help.salesforce.com/HTViewHelpDoc?id=adding_fields.htm|displaytext=custom activity field names in Salesforce}} and Genesys UserData keys so that these custom fields are populated when the adapter saves an activity history entry at the end of a call or chat. This is useful when you want to include or use call- or chat-related data in your Salesforce reports.
 +
 
 +
To enable this functionality, set the [[GPAConfig#salesforce.activity-log.field-mapping|salesforce.activity-log.field-mapping]] option to the name of a configuration section that contains the mapping.
 +
 
 +
{{NoteFormat|If you change the value of [[GPAConfig#salesforce.activity-log.field-mapping|salesforce.activity-log.field-mapping]], make sure to validate the change by confirming that Salesforce tasks are created correctly.}}
 +
 
 +
You can control which types of calls and chats are saved to a Salesforce activity history entry by setting the [[GPAConfig#salesforce.activity-log.enabled-call-types|salesforce.activity-log.enabled-call-types]] and [[GPAConfig#salesforce.activity-log.enabled-chat-types|salesforce.activity-log.enabled-chat-types]].
 +
 
 +
====Chat transcript====
 +
The adapter can save chat transcript text either as part of the activity description in Salesforce or it can save the text to a {{#Widget:ExtLink|link=https://help.salesforce.com/HTViewHelpDoc?id=adding_fields.htm|displaytext=custom field name in Salesforce}}.
 +
 
 +
By default, the adapter saves the transcript as part of the description, but you can turn off this functionality with the [[GPAConfig#salesforce.chat.include-transcript-in-desc|salesforce.chat.include-transcript-in-desc]] option. You might want to do this if the transcript and case data are too large for the description field, which has a maximum size of 32K. In this case, you can set the [[GPAConfig#salesforce.chat.transcript-custom-field-name|salesforce.chat.transcript-custom-field-name]] option to the name of a custom field you defined in Salesforce &mdash; the adapter will save chat transcripts to this field instead.
 +
 
 +
{{NoteFormat|If you change the value of [[GPAConfig#salesforce.chat.transcript-custom-field-name|salesforce.chat.transcript-custom-field-name]], make sure to validate the change by confirming that Salesforce tasks are created correctly.}}
 +
 
 +
==Attached data==
 +
You can configure the adapter to save the ID and/or name of the focused Salesforce object to attached data when an agent clicks '''Mark Done'''. To do this, set the  [[GPAConfig#salesforce.user-data.object-id-key|salesforce.user-data.object-id-key]] and/or [[GPAConfig#salesforce.user-data.object-name-key|salesforce.user-data.object-name-key]] to the keys you want the adapter to use when saving the ID or name. Also, make sure the Workspace Web Edition option [[Interaction#interaction.case-data.is-read-only-on-idle|interaction.case-data.is-read-only-on-idle]] is set to <tt>false</tt>.
 +
 
 +
You should consider setting these options if you want to make sure the ID or name is added to attached data when agents create a new object during a call.
 +
 
 +
===Editing attached data===
 +
Agents can add, update, or delete attached data on active calls or chats when you set the [[GPAConfig#interaction.case-data.enable-advanced-view|interaction.case-data.enable-advanced-view]] option to <tt>true</tt>. You can control which attached data fields agents can edit by setting up Business Attributes, as detailed in the [[CustomerCase#Editing_Case_Information|Editing Case Information]] topic.
 +
 
 +
===Displaying clickable links in attached data===
 +
The adapter displays clickable links in attached data when you set the [[GPAConfig#interaction.case-data.enable-advanced-view|interaction.case-data.enable-advanced-view]] option to <tt>true</tt> and set the [[Interaction#interaction.case-data.enable-hyperlink|interaction.case-data.enable-hyperlink]] Workspace option to <tt>true</tt>. You should also make sure the  [[Expression#expression.url|expression.url]] Workspace option is set to a regular expression that identifies URLs. This option is already set by default to match most valid URLs. See [[CustomerCase#Displaying_Active_URLs_in_Case_Information|Displaying Active URLs in Case Information]] for details.
 +
 
 +
===Ordering attached data===
 +
You can define the order of attached data fields in the adapter by setting the [[GPAConfig#interaction.case-data.enable-advanced-view|interaction.case-data.enable-advanced-view]] option to <tt>true</tt>. You'll also need to define Business Attributes for the attached data fields &mdash; see [[CustomerCase#Editing_Case_Information|Editing Case Information]] for details about setting up Business Attributes. Next, create an '''[interaction-workspace]''' section in the annex of the Business Attribute, then add the '''interaction.case-data.order''' option. This option is a comma-separated list of Business Attributes Value Names that specifies the order of the Business Attribute Values. The Business Attributes Values that are not listed in this option are put at the bottom of the list.
 +
 
 +
==Call recording==
 +
You can enable call recording in the adapter by setting the [[GPAConfig#privilege.active-recording.can-use|privilege.active-recording.can-use]] option. If you set this option to <tt>true</tt>, agents see the call recording split button on the voice toolbar, which they can use to start, stop, pause, and resume recordings.
 +
 
 +
==Chat==
 +
The adapter currently offers two media channels: voice and chat. To enable chat in the adapter, just set the corresponding privilege option in Workspace Web Edition: [[Chat#privilege.chat.can-use|privilege.chat.can-use]].
 +
 
 +
As with all Workspace Web Edition options, you can set these options on the Application, Agent Group, Person, and so on. For example, you might want all your agents to be able to access the voice channel, but only some to access the chat channel. In this scenario, you could set [[Voice#privilege.voice.can-use|privilege.voice.can-use]] on the Application so that all agents can use this media channel. At the same time, you could also set [[Chat#privilege.chat.can-use|privilege.chat.can-use]] on a particular Agent Group so that only agents in that group can use the chat channel.
 +
 
 +
{{NoteFormat|You must configure at least one media channel in order for the adapter to work.}}
 +
 
 +
====Chat transfers and consultations====
 +
To enable chat transfers and consultations, see the "Chat" row in the [[GPAConfig#Workspace_Web_Edition_options|Workspace Web Edition Options table]] for the full list of chat privileges the adapter supports.
 +
 
 +
====Sending a URL====
 +
You can configure the adapter so that an agent participating in a chat can push a URL for a customer to click. To enable this feature, just set the [[GPAConfig#privilege.chat.can-push-url|privilege.chat.can-push-url]] option to <tt>true</tt>.
 +
 
 +
==Direct outbound calls to a route point==
 +
You can configure the adapter to direct all outbound calls through a route point. '''Note:''' You need to load a routing strategy that takes responsibility for delivering the call. To enable this functionality in the adapter, set the following Workspace Web Edition configuration options:
 +
<ul>
 +
<li>[[Intercommunication#intercommunication.voice.routing-based-actions|intercommunication.voice.routing-based-actions]]</li>
 +
<li>[[Intercommunication#intercommunication.voice.routing-based-targets|intercommunication.voice.routing-based-targets]]</li>
 +
<li>[[Intercommunication#intercommunication.voice.routing-points|intercommunication.voice.routing-points]]</li>
 +
</ul>
 +
 
 +
For example:
 +
<source lang="text">
 +
intercommunication.voice.routing-based-actions: MakeCall,OneStepConference,InitConference,OneStepTransfer,InitTransfer
 +
intercommunication.voice.routing-based-targets: TypeDestination
 +
intercommunication.voice.routing-points: 9000
 +
</source>
 +
If you use this configuration, the call is delivered to the route point with the following UserData fields:
 +
*IW_BundleUid
 +
*IW_CaseUid
 +
*IW_RoutingBasedOriginalEmployeeId
 +
*IW_RoutingBasedRequestType
 +
*IW_RoutingBasedTargetId
 +
*IW_RoutingBasedTargetType
 +
*PhoneNumber
 +
 
 +
==Disposition==
 +
You can decide whether to hide or show the Disposition section in the voice detail view by setting the [[GPAConfig#interaction.hide-disposition|interaction.hide-disposition]] option. '''Note:''' If you set the Workspace Web Edition option [[Interaction#interaction.disposition.is-mandatory|interaction.disposition.is-mandatory]], then the Disposition will be shown regardless of the value of '''interaction.hide-disposition'''.
 +
 
 +
For details about how to configure Disposition Codes, see [[SettingUpAgents#Enabling_Disposition_Codes|Enabling Disposition Codes]] and [[Documentation:HTCC:API:Dispositioncodes|Disposition Codes]] in the Web Services API Reference.
 +
 
 +
==Feedback==
 +
You can hide or show the Feedback item in the main menu by setting the [[GPAConfig#system.feedback|system.feedback]] option. When an agent submits feedback, the adapter automatically includes supporting information, such as configuration, logs for both the adapter and Workspace, and active interactions.
 +
 
 +
==Focus following==
 +
You can enable focus following in the adapter so that it keeps track of which instance of the adapter is active when there are multiple instances running in multiple browser tabs or windows. Only the active adapter sends screen pop requests to Salesforce, which prevents duplicate requests and multiple screen pops. This can be helpful if you're using Salesforce standard mode and configure screen pops to open in a new tab or window (which opens a new instance of the adapter in the tab or window).
 +
 
 +
To enable this feature, set the [[GPAConfig#salesforce.enable-focus-following|salesforce.enable-focus-following]] option to <tt>true</tt>. You should also set [[GPAConfig#multiple-instance.enable-mark-done-sync|multiple-instance.enable-mark-done-sync]] to <tt>true</tt> so that the agent only has to click '''Mark Done''' once when the call is finished.
 +
 
 +
==Free seating==
 +
The adapter supports free seating, which enables an agent to confirm or change the resources (such as a phone number) he or she will use for a given session. This is important when agents work together in an office where there is no assigned seating or when different agents sit at the same seat on different shifts. Instead of having a specific phone number assigned to the agent by the administrator, the agent instead enters the phone number he or she will use after finding a seat at the beginning of the shift.
 +
 
 +
If the agents work in different locations at different times, you can also use this feature so they can enter a phone number based on where they're working.
 +
 
 +
The adapter provides two modes of free seating:
 +
<ul>
 +
<li>Mode 1 &mdash; The agent can enter a phone number. Enable this mode with the [[LoginVoice#login.voice.prompt-dn-less-phone-number|login.voice.prompt-dn-less-phone-number]] Workspace Web Edition option.</li>
 +
<li> Mode 2 &mdash; The agent can enter a place name. Enable this mode with the [[LoginVoice#login.prompt-place|login.prompt-place]] Workspace Web Edition option.</li>
 +
</ul>
 +
 
 +
{{NoteFormat|If you set both options, <tt>login.prompt-place</tt> takes precedence.}}
 +
 
 +
==In-focus page transfers==
 +
When an agent performs a voice or chat conference or transfer, the adapter can update the UserData with the ID of the object the agent is looking at in Salesforce. This makes sure that the agent who receives the conference or transfer gets a screen pop for the most relevant object.
 +
 
 +
This can be helpful when:
 +
* There are multiple matches for a screen pop search on the initial call and the agent has to select between them
 +
* There are no matches for the initial screen pop search and the agent creates a new record
 +
 
 +
To enable in-focus page transfers, set the [[GPAConfig#salesforce.enable-in-focus-page-transfer|salesforce.enable-in-focus-page-transfer]] option to <tt>true</tt>.
 +
 
 +
When the adapter updates the UserData, any existing UserData keys that begin with "id_" or "cti_" are removed and a new key, called "id_transfer_object", is added with the object ID of the focused page. If the focused page doesn't correspond to a Salesforce object, the adapter does not make an update and the existing UserData is sent with the conference or transfer request.
 +
 
 +
If you configured your environment to use a key other than "id_" or "cti_" (basically if you need to set the '''screenpop.id-key-regex''' option as described in [[GPAA#Screen_pop|Screen pop]]), then you must also set the [[GPAConfig#screenpop.transfer-object-key|screenpop.transfer-object-key]] to your custom key in order for screen pop to work. The adapter will add the key you specify in this option instead of "id_transfer_object".
 +
 
 +
==International dialing==
 +
You can configure the adapter to apply custom pre-processing rules on click-to-dial requests and before initiating screen pops. You can use this to adjust the format of phone numbers or {{Glossaryterm|term=Automatic_Number_Identification|text=ANI}} for international dialing.
 +
 
 +
To support click-to-dial for international numbers, you can set up pre-processing rules so that the adapter examines the phone number it receives from Salesforce to determine if a prefix should be added before making the dial request. This can be helpful when local numbers are stored in Salesforce records, but dialing prefixes are required in order to dial the call. You can configure pre-processing rules with the [[GPAConfig#click-to-dial.preprocessing-rules|click-to-dial.preprocessing-rules]] option.
 +
 
 +
You can also define pre-processing rules for the screen pop to replace a portion of the ANI &mdash; for example, to remove a leading +1. This can be helpful in cases where local phone numbers are stored in Salesforce, but inbound customer calls might include international prefixes. You can configure these rules with the [[GPAConfig#screenpop.preprocessing-rule|screenpop.preprocessing-rule]] option.
 +
 
 +
==Login==
 +
You can configure the adapter to enable an agent to enter or select a queue when logging in for voice. Set the [[LoginVoice#login.voice.prompt-queue|login.voice.prompt-queue]] Workspace Web Edition option to enable this feature.
 +
 
 +
You can also enable an agent to select from a pre-defined list of queues, instead of entering one manually, by setting the [[LoginVoice#login.voice.list-available-queues|login.voice.list-available-queues]] Workspace Web Edition option to a comma-separated list of queue numbers.
 +
 
 +
==Not Ready reason codes==
 +
For details about how to configure Not Ready Reason Codes, see [[SettingUpAgents#Declaring_and_using_new_Not-Ready_Reason_codes|Declaring and using new Not-Ready Reason codes]] and [[Documentation:HTCC:API:AgentStateOperations:8.5.2|Agent State Operations]] in the Web Services API Reference.
 +
 
 +
==Reports and statistics==
 +
The adapter provides reports and statistics through three different options in the main menu:
 +
<ul>
 +
<li>'''Reports''' &mdash; In this view, agents can see details about call activity, call handle time, and routing point metrics, including the maximum and average wait times for the selected routing point. To enable Reports, you should set the [[ContactCenterStatistics#privilege.dashboard.can-use|privilege.dashboard.can-use]] Workspace Web Edition option to <tt>true</tt>. You can also control how often the values are refreshed with the [[ContactCenterStatistics#statistics.refresh-time|statistics.refresh-time]] option. For the routing points view, make sure you configure the routing points you want agents to be able to see by setting the [[ContactCenterStatistics#statistics.routing-points|statistics.routing-points]] Workspace Web Edition option.</li>
 +
<li>'''My Statistics''' &mdash; In this view, agents can see Key Performance Indicators (KPIs) that you configure. For details about how to configure these KPIs, see [[EnablingAgentstoViewKPIs|Enabling Agents to View KPIs and Contact Center Statistics]]. If you don't configure any KPIs, the adapter hides the '''My Statistics''' in the main menu.
 +
<br/>
 +
'''Note:''' The Enabling Agents to View KPIs and Contact Center Statistics page lists a number of attributes that apply to each statistic. The adapter currently only supports the '''statistic-name''' attribute. The adapter also supports the '''display-name''' attribute, which specifies the display text that appears with the value in the '''My Statistics''' view.</li>
 +
<li>'''Contact Center Statistics''' &mdash;  In this view, agents can see statistics you configure that summarize the state of various conditions monitored by your call center, such as the number of abandoned calls, the number of total answered calls, and the average waiting time. For details about how to configure these statistics, see [[EnablingAgentstoViewKPIs|Enabling Agents to View KPIs and Contact Center Statistics]]. If you don't configure any contact center statistics, the adapter hides the '''Contact Center Statisics''' in the main menu.
 +
<br/>
 +
'''Note:''' The Enabling Agents to View KPIs and Contact Center Statistics page lists a number of attributes that apply to each statistic. The adapter currently only supports the '''statistic-name''' attribute. The adapter also supports the '''display-name''' attribute, which specifies the display text that appears with the value in the '''Contact Center Statistics''' view.</li>
 +
</ul>
 +
 
 +
==Screen pop==
 +
When an agent receives an external call, the adapter initiates a screen pop that causes Salesforce to show an appropriate record for the caller. See [[Documentation:HTCC:Dep:GplusSalesforceDeploy#Configuring_screen_pops_in_Salesforce|Configuring screen pops in Salesforce]] for details. By default, the adapter initiates the screen pop when the call is established, but you can set the [[GPAConfig#screenpop.on-ringing|screenpop.on-ringing]] option to initiate a screen pop when the call is ringing instead.
 +
 
 +
{{NoteFormat|You can also enable this feature for internal calls with the [[GPAConfig#screenpop.enable-for-internal-calls|screenpop.enable-for-internal-calls]] option.}}
 +
 
 +
Here's the default way the adapter determines what to ask Salesforce to show in the screen pop:
 +
<ul>
 +
<li>If the UserData for the call has key(s) with the prefix "id_" (such as "id_SalesforceCaseId"), then the first value the adapter finds is sent in the screen pop request to Salesforce. </li>
 +
<li>If the UserData does not include any "id_" keys, the adapter builds a search string using a combination of the ANI, if available, and any UserData values with keys that have the "cti_" prefix (such as "cti_FirstName" or "cti_PhoneNumber"). You can specify whether the search should include the ANI by setting the [[GPAConfig#screenpop.include-ani-in-search|screenpop.include-ani-in-search]] option.</li>
 +
<li>If there are no "id_" keys, no ANI, and no "cti_" keys, then the adapter doesn't send a screen pop request. </li>
 +
<!--
 +
{{NoteFormat|When the adapter creates a search string, any values provided are also included in the URL parameter of the <tt>searchAndScreenPop</tt> Open CTI function, along with their corresponding keys. This allows custom VisualForce pages to access the data and process the screen pop request.}}-->
 +
 
 +
Alternatively, you can configure the expressions the adapter uses to match screen pop UserData keys for the ID and search fields using the [[GPAConfig#screenpop.id-key-regex|screenpop.id-key-regex]] and [[GPAConfig#screenpop.search-key-regex|screenpop.search-key-regex]] options, respectively. Note that these options only change the criteria by which keys are matched from UserData. The existing logic and order between ID-based screen pop and search are unchanged (see the bullet points above). If you use these regular expression options to match your own ID key, then you should also make sure to set the [[GPAConfig#screenpop.transfer-object-key|screenpop.transfer-object-key]] option so that screen pop works with in-focus page transfers.
 +
 
 +
==Team communicator==
 +
Team Communicator can display corporate favorites (quick dial favorites) that you configure using the [[TeamCommunicator#teamcommunicator.corporate-favorites|teamcommunicator.corporate-favorites]] Workspace Web Edition option. You can also let agents add their own favorites by setting the [[TeamCommunicator#privilege.teamcommunicator.can-manage-favorites|privilege.teamcommunicator.can-manage-favorites]] Workspace option to <tt>true</tt>.
 +
 
 +
You can make it easier for your agents to find people in Team Communicator by enabling filters. Use the [[TeamCommunicator#teamcommunicator.list-filter-showing|teamcommunicator.list-filter-showing]] Workspace option to specify the list of filters that an agent can choose from in Team Communicator &mdash; Agent, AgentGroup, Skill, RoutingPoint, and so on.
 +
 
 +
You can also enable your agents to view and search a list of recently contacted resources in Team Communicator by setting the following Workspace options:
 +
* [[TeamCommunicator#privilege.teamcommunicator.can-view-recent-calls|privilege.teamcommunicator.can-view-recent-calls]] &mdash; Turns on the list of recent targets. The default value is <tt>true</tt>.
 +
* [[TeamCommunicator#teamcommunicator.recent-max-records|teamcommunicator.recent-max-records]] &mdash; Sets the maximum number of items to keep in the list.
 +
* [[TeamCommunicator#teamcommunicator.add-recent-filters.voice|teamcommunicator.add-recent-filters.voice]] &mdash; Filters what types of calls (internal, external, consultation) are placed in the list.
 +
 
 +
===Availability for agent groups===
 +
While the adapter automatically shows agent availability, if you also want to display whether there are available agents for a particular agent group on the voice channel, set the following Workspace options to <tt>true</tt>:
 +
*privilege.teamcommunicator.display-agent-groups-availability
 +
*presence.evaluate-presence
 +
 
 +
==Toast and case data==
 +
<!-- Hiding for Iteration 7 -->
 +
<!--You can either hide or show the "Origin" entry in the Case Information section of the voice detail view by setting the [[GPAConfig#interaction.case-data.hide-origin|interaction.case-data.hide-origin]].-->
 +
 
 +
For details about how to configure Toast and Case Data, see [[OutboundContact|Outbound Contact - Provisioning Case Data]] and [[Documentation:HTCC:API:ToastAndCaseData|Toast And Case Data]] in the Web Services API Reference.
 +
 
 +
==Transfer notes==
 +
You can use the call note field to allow one agent to provide information to another agent who will receive a conference or transfer. To enable this feature, make sure you set the Workspace Web Edition option <tt>voice.note.key-name</tt> to the desired attached data key. If you don't set it, the adapter hides the notes section in the voice view.
 +
 
 +
When the agent adds information to the call note before initiating a conference or transfer, that information is added to the value for the attached data key you specified in the <tt>voice.note.key-name</tt> option. Then the agent can proceed with the conference or transfer.
 +
 
 +
When the second agent receives the call, the call note field is populated using the attached data field, which allows the agent to review and pick up where the first agent left off. This is particularly useful in cases where an agent blind transfers a call and isn't able to speak directly with the second agent before hanging up.
 +
 
 +
==Voice==
 +
The adapter currently offers two media channels: voice and chat. To enable voice in the adapter, just set the corresponding privilege option in Workspace Web Edition: [[Voice#privilege.voice.can-use|privilege.voice.can-use]].
 +
 
 +
As with all Workspace Web Edition options, you can set these options on the Application, Agent Group, Person, and so on. For example, you might want all your agents to be able to access the voice channel, but only some to access the chat channel. In this scenario, you could set [[Voice#privilege.voice.can-use|privilege.voice.can-use]] on the Application so that all agents can use this media channel. At the same time, you could also set [[Chat#privilege.chat.can-use|privilege.chat.can-use]] on a particular Agent Group so that only agents in that group can use the chat channel.
 +
 
 +
{{NoteFormat|You must configure at least one media channel in order for the adapter to work.}}
 +
 
 +
====Voice Transfers and Consultations====
 +
To enable voice transfers and consultations, see the "Voice" row in the [[GPAConfig#Workspace_Web_Edition_options|Workspace Web Edition Options table]] for the full list of voice privileges the adapter supports.
 +
 
 +
====Caller ID====
 +
For outbound calling scenarios, you can configure the adapter to allow agents to select from a predefined list of caller IDs; the selected caller ID is then displayed to the person receiving the call.
 +
 
 +
To enable this feature, first create a Business Attribute in Genesys Administrator that contains the possible caller ID values you would like agents to be able to select. In its Business Attribute Values, the name is used to specify the actual phone number the adapter dials. If the Display Name is specified, this is the information the adapter presents to the agent (in alphabetical order).
 +
 
 +
If the Business Attribute doesn't contain any Business Attribute Values, then the feature isn't enabled. Also, if the attribute contains only one value, then the adapter automatically uses that caller ID so the agent doesn't see a popup when making a call.
 +
 
 +
Next, set the Workspace Web Edition option [[Intercommunication#intercommunication.voice.make-call-caller-id-business-attribute|intercommunication.voice.make-call-caller-id-business-attribute]] to the name of your Business Attribute.
 +
 
 +
For example, if you create a Business Attribute named '''CallerID''', then you would set '''intercommunication.voice.make-call-caller-id-business-attribute''' to <tt>CallerID</tt>.
 +
 
 +
==Voicemail==
 +
The adapter supports voicemail if your environment is set up for [[Documentation/FS|Genesys SIP Feature Server]] (previously called [[Documentation/GSV#t-1|Genesys SIP Voicemail]]). To enable voicemail, set the following Workspace options: [[VoiceMail#privilege.voicemail.can-use|privilege.voicemail.can-use]] and [[VoiceMail#voicemail.access-number|voicemail.access-number]].
 +
 
 +
[[Category:V:HTCC:8.5.2]]

Revision as of 19:57, January 22, 2016

Gplus Adapter for Salesforce

Review the sections below for more information about how to configure these features in the Gplus Adapter for Salesforce. See Gplus Adapter for Salesforce Configuration Options for the full list of options that apply to the adapter.

Activity history

By default, the adapter updates certain Salesforce activity fields when it saves an activity history entry at the end of a call or chat. Take a look at the table below for the full list of Salesforce activity fields and where the data comes from in the adapter.

Salesforece Activity Field Genesys
Assigned To Agent accepting Call
Created By "
Last Modified By "
Subject Text (including the type of call, such as inbound, outbound to #Phonenumber)
Due Date Current Timestamp
Related To Record currently in context when an agent clicks Mark Done
Comments Text with information from the Subject, Case Data (the full set that comes from the adapter), and Note (note data added by the agent) fields.
Status Values are preset in the Salesforce configuration
Priority Values are preset in the Salesforce configuration
Call Duration Duration in seconds
Call Object Identifier Interaction Id
Call Type Type of call, such as inbound, outbound, or internal

You can also define a mapping between custom activity field names in Salesforce and Genesys UserData keys so that these custom fields are populated when the adapter saves an activity history entry at the end of a call or chat. This is useful when you want to include or use call- or chat-related data in your Salesforce reports.

To enable this functionality, set the salesforce.activity-log.field-mapping option to the name of a configuration section that contains the mapping.

Important
If you change the value of salesforce.activity-log.field-mapping, make sure to validate the change by confirming that Salesforce tasks are created correctly.

You can control which types of calls and chats are saved to a Salesforce activity history entry by setting the salesforce.activity-log.enabled-call-types and salesforce.activity-log.enabled-chat-types.

Chat transcript

The adapter can save chat transcript text either as part of the activity description in Salesforce or it can save the text to a custom field name in Salesforce.

By default, the adapter saves the transcript as part of the description, but you can turn off this functionality with the salesforce.chat.include-transcript-in-desc option. You might want to do this if the transcript and case data are too large for the description field, which has a maximum size of 32K. In this case, you can set the salesforce.chat.transcript-custom-field-name option to the name of a custom field you defined in Salesforce — the adapter will save chat transcripts to this field instead.

Important
If you change the value of salesforce.chat.transcript-custom-field-name, make sure to validate the change by confirming that Salesforce tasks are created correctly.

Attached data

You can configure the adapter to save the ID and/or name of the focused Salesforce object to attached data when an agent clicks Mark Done. To do this, set the salesforce.user-data.object-id-key and/or salesforce.user-data.object-name-key to the keys you want the adapter to use when saving the ID or name. Also, make sure the Workspace Web Edition option interaction.case-data.is-read-only-on-idle is set to false.

You should consider setting these options if you want to make sure the ID or name is added to attached data when agents create a new object during a call.

Editing attached data

Agents can add, update, or delete attached data on active calls or chats when you set the interaction.case-data.enable-advanced-view option to true. You can control which attached data fields agents can edit by setting up Business Attributes, as detailed in the Editing Case Information topic.

Displaying clickable links in attached data

The adapter displays clickable links in attached data when you set the interaction.case-data.enable-advanced-view option to true and set the interaction.case-data.enable-hyperlink Workspace option to true. You should also make sure the expression.url Workspace option is set to a regular expression that identifies URLs. This option is already set by default to match most valid URLs. See Displaying Active URLs in Case Information for details.

Ordering attached data

You can define the order of attached data fields in the adapter by setting the interaction.case-data.enable-advanced-view option to true. You'll also need to define Business Attributes for the attached data fields — see Editing Case Information for details about setting up Business Attributes. Next, create an [interaction-workspace] section in the annex of the Business Attribute, then add the interaction.case-data.order option. This option is a comma-separated list of Business Attributes Value Names that specifies the order of the Business Attribute Values. The Business Attributes Values that are not listed in this option are put at the bottom of the list.

Call recording

You can enable call recording in the adapter by setting the privilege.active-recording.can-use option. If you set this option to true, agents see the call recording split button on the voice toolbar, which they can use to start, stop, pause, and resume recordings.

Chat

The adapter currently offers two media channels: voice and chat. To enable chat in the adapter, just set the corresponding privilege option in Workspace Web Edition: privilege.chat.can-use.

As with all Workspace Web Edition options, you can set these options on the Application, Agent Group, Person, and so on. For example, you might want all your agents to be able to access the voice channel, but only some to access the chat channel. In this scenario, you could set privilege.voice.can-use on the Application so that all agents can use this media channel. At the same time, you could also set privilege.chat.can-use on a particular Agent Group so that only agents in that group can use the chat channel.

Important
You must configure at least one media channel in order for the adapter to work.

Chat transfers and consultations

To enable chat transfers and consultations, see the "Chat" row in the Workspace Web Edition Options table for the full list of chat privileges the adapter supports.

Sending a URL

You can configure the adapter so that an agent participating in a chat can push a URL for a customer to click. To enable this feature, just set the privilege.chat.can-push-url option to true.

Direct outbound calls to a route point

You can configure the adapter to direct all outbound calls through a route point. Note: You need to load a routing strategy that takes responsibility for delivering the call. To enable this functionality in the adapter, set the following Workspace Web Edition configuration options:

For example: 

intercommunication.voice.routing-based-actions: MakeCall,OneStepConference,InitConference,OneStepTransfer,InitTransfer
 intercommunication.voice.routing-based-targets: TypeDestination
 intercommunication.voice.routing-points: 9000

If you use this configuration, the call is delivered to the route point with the following UserData fields:

  • IW_BundleUid
  • IW_CaseUid
  • IW_RoutingBasedOriginalEmployeeId
  • IW_RoutingBasedRequestType
  • IW_RoutingBasedTargetId
  • IW_RoutingBasedTargetType
  • PhoneNumber

Disposition

You can decide whether to hide or show the Disposition section in the voice detail view by setting the interaction.hide-disposition option. Note: If you set the Workspace Web Edition option interaction.disposition.is-mandatory, then the Disposition will be shown regardless of the value of interaction.hide-disposition.

For details about how to configure Disposition Codes, see Enabling Disposition Codes and Disposition Codes in the Web Services API Reference.

Feedback

You can hide or show the Feedback item in the main menu by setting the system.feedback option. When an agent submits feedback, the adapter automatically includes supporting information, such as configuration, logs for both the adapter and Workspace, and active interactions.

Focus following

You can enable focus following in the adapter so that it keeps track of which instance of the adapter is active when there are multiple instances running in multiple browser tabs or windows. Only the active adapter sends screen pop requests to Salesforce, which prevents duplicate requests and multiple screen pops. This can be helpful if you're using Salesforce standard mode and configure screen pops to open in a new tab or window (which opens a new instance of the adapter in the tab or window).

To enable this feature, set the salesforce.enable-focus-following option to true. You should also set multiple-instance.enable-mark-done-sync to true so that the agent only has to click Mark Done once when the call is finished.

Free seating

The adapter supports free seating, which enables an agent to confirm or change the resources (such as a phone number) he or she will use for a given session. This is important when agents work together in an office where there is no assigned seating or when different agents sit at the same seat on different shifts. Instead of having a specific phone number assigned to the agent by the administrator, the agent instead enters the phone number he or she will use after finding a seat at the beginning of the shift.

If the agents work in different locations at different times, you can also use this feature so they can enter a phone number based on where they're working.

The adapter provides two modes of free seating:

Important
If you set both options, login.prompt-place takes precedence.

In-focus page transfers

When an agent performs a voice or chat conference or transfer, the adapter can update the UserData with the ID of the object the agent is looking at in Salesforce. This makes sure that the agent who receives the conference or transfer gets a screen pop for the most relevant object.

This can be helpful when:

  • There are multiple matches for a screen pop search on the initial call and the agent has to select between them
  • There are no matches for the initial screen pop search and the agent creates a new record

To enable in-focus page transfers, set the salesforce.enable-in-focus-page-transfer option to true.

When the adapter updates the UserData, any existing UserData keys that begin with "id_" or "cti_" are removed and a new key, called "id_transfer_object", is added with the object ID of the focused page. If the focused page doesn't correspond to a Salesforce object, the adapter does not make an update and the existing UserData is sent with the conference or transfer request.

If you configured your environment to use a key other than "id_" or "cti_" (basically if you need to set the screenpop.id-key-regex option as described in Screen pop), then you must also set the screenpop.transfer-object-key to your custom key in order for screen pop to work. The adapter will add the key you specify in this option instead of "id_transfer_object".

International dialing

You can configure the adapter to apply custom pre-processing rules on click-to-dial requests and before initiating screen pops. You can use this to adjust the format of phone numbers or ANI for international dialing.

To support click-to-dial for international numbers, you can set up pre-processing rules so that the adapter examines the phone number it receives from Salesforce to determine if a prefix should be added before making the dial request. This can be helpful when local numbers are stored in Salesforce records, but dialing prefixes are required in order to dial the call. You can configure pre-processing rules with the click-to-dial.preprocessing-rules option.

You can also define pre-processing rules for the screen pop to replace a portion of the ANI — for example, to remove a leading +1. This can be helpful in cases where local phone numbers are stored in Salesforce, but inbound customer calls might include international prefixes. You can configure these rules with the screenpop.preprocessing-rule option.

Login

You can configure the adapter to enable an agent to enter or select a queue when logging in for voice. Set the login.voice.prompt-queue Workspace Web Edition option to enable this feature.

You can also enable an agent to select from a pre-defined list of queues, instead of entering one manually, by setting the login.voice.list-available-queues Workspace Web Edition option to a comma-separated list of queue numbers.

Not Ready reason codes

For details about how to configure Not Ready Reason Codes, see Declaring and using new Not-Ready Reason codes and Agent State Operations in the Web Services API Reference.

Reports and statistics

The adapter provides reports and statistics through three different options in the main menu:

  • Reports — In this view, agents can see details about call activity, call handle time, and routing point metrics, including the maximum and average wait times for the selected routing point. To enable Reports, you should set the privilege.dashboard.can-use Workspace Web Edition option to true. You can also control how often the values are refreshed with the statistics.refresh-time option. For the routing points view, make sure you configure the routing points you want agents to be able to see by setting the statistics.routing-points Workspace Web Edition option.
  • My Statistics — In this view, agents can see Key Performance Indicators (KPIs) that you configure. For details about how to configure these KPIs, see Enabling Agents to View KPIs and Contact Center Statistics. If you don't configure any KPIs, the adapter hides the My Statistics in the main menu.
    Note: The Enabling Agents to View KPIs and Contact Center Statistics page lists a number of attributes that apply to each statistic. The adapter currently only supports the statistic-name attribute. The adapter also supports the display-name attribute, which specifies the display text that appears with the value in the My Statistics view.
  • Contact Center Statistics — In this view, agents can see statistics you configure that summarize the state of various conditions monitored by your call center, such as the number of abandoned calls, the number of total answered calls, and the average waiting time. For details about how to configure these statistics, see Enabling Agents to View KPIs and Contact Center Statistics. If you don't configure any contact center statistics, the adapter hides the Contact Center Statisics in the main menu.
    Note: The Enabling Agents to View KPIs and Contact Center Statistics page lists a number of attributes that apply to each statistic. The adapter currently only supports the statistic-name attribute. The adapter also supports the display-name attribute, which specifies the display text that appears with the value in the Contact Center Statistics view.

Screen pop

When an agent receives an external call, the adapter initiates a screen pop that causes Salesforce to show an appropriate record for the caller. See Configuring screen pops in Salesforce for details. By default, the adapter initiates the screen pop when the call is established, but you can set the screenpop.on-ringing option to initiate a screen pop when the call is ringing instead.

Important
You can also enable this feature for internal calls with the screenpop.enable-for-internal-calls option.

Here's the default way the adapter determines what to ask Salesforce to show in the screen pop:

  • If the UserData for the call has key(s) with the prefix "id_" (such as "id_SalesforceCaseId"), then the first value the adapter finds is sent in the screen pop request to Salesforce.
  • If the UserData does not include any "id_" keys, the adapter builds a search string using a combination of the ANI, if available, and any UserData values with keys that have the "cti_" prefix (such as "cti_FirstName" or "cti_PhoneNumber"). You can specify whether the search should include the ANI by setting the screenpop.include-ani-in-search option.
  • If there are no "id_" keys, no ANI, and no "cti_" keys, then the adapter doesn't send a screen pop request.

    • Alternatively, you can configure the expressions the adapter uses to match screen pop UserData keys for the ID and search fields using the screenpop.id-key-regex and screenpop.search-key-regex options, respectively. Note that these options only change the criteria by which keys are matched from UserData. The existing logic and order between ID-based screen pop and search are unchanged (see the bullet points above). If you use these regular expression options to match your own ID key, then you should also make sure to set the screenpop.transfer-object-key option so that screen pop works with in-focus page transfers.

    Team communicator

    Team Communicator can display corporate favorites (quick dial favorites) that you configure using the teamcommunicator.corporate-favorites Workspace Web Edition option. You can also let agents add their own favorites by setting the privilege.teamcommunicator.can-manage-favorites Workspace option to true.

    You can make it easier for your agents to find people in Team Communicator by enabling filters. Use the teamcommunicator.list-filter-showing Workspace option to specify the list of filters that an agent can choose from in Team Communicator — Agent, AgentGroup, Skill, RoutingPoint, and so on.

    You can also enable your agents to view and search a list of recently contacted resources in Team Communicator by setting the following Workspace options:

    Availability for agent groups

    While the adapter automatically shows agent availability, if you also want to display whether there are available agents for a particular agent group on the voice channel, set the following Workspace options to true:

    • privilege.teamcommunicator.display-agent-groups-availability
    • presence.evaluate-presence

    Toast and case data

    For details about how to configure Toast and Case Data, see Outbound Contact - Provisioning Case Data and Toast And Case Data in the Web Services API Reference.

    Transfer notes

    You can use the call note field to allow one agent to provide information to another agent who will receive a conference or transfer. To enable this feature, make sure you set the Workspace Web Edition option voice.note.key-name to the desired attached data key. If you don't set it, the adapter hides the notes section in the voice view.

    When the agent adds information to the call note before initiating a conference or transfer, that information is added to the value for the attached data key you specified in the voice.note.key-name option. Then the agent can proceed with the conference or transfer.

    When the second agent receives the call, the call note field is populated using the attached data field, which allows the agent to review and pick up where the first agent left off. This is particularly useful in cases where an agent blind transfers a call and isn't able to speak directly with the second agent before hanging up.

    Voice

    The adapter currently offers two media channels: voice and chat. To enable voice in the adapter, just set the corresponding privilege option in Workspace Web Edition: privilege.voice.can-use.

    As with all Workspace Web Edition options, you can set these options on the Application, Agent Group, Person, and so on. For example, you might want all your agents to be able to access the voice channel, but only some to access the chat channel. In this scenario, you could set privilege.voice.can-use on the Application so that all agents can use this media channel. At the same time, you could also set privilege.chat.can-use on a particular Agent Group so that only agents in that group can use the chat channel.

    Important
    You must configure at least one media channel in order for the adapter to work.

    Voice Transfers and Consultations

    To enable voice transfers and consultations, see the "Voice" row in the Workspace Web Edition Options table for the full list of voice privileges the adapter supports.

    Caller ID

    For outbound calling scenarios, you can configure the adapter to allow agents to select from a predefined list of caller IDs; the selected caller ID is then displayed to the person receiving the call.

    To enable this feature, first create a Business Attribute in Genesys Administrator that contains the possible caller ID values you would like agents to be able to select. In its Business Attribute Values, the name is used to specify the actual phone number the adapter dials. If the Display Name is specified, this is the information the adapter presents to the agent (in alphabetical order).

    If the Business Attribute doesn't contain any Business Attribute Values, then the feature isn't enabled. Also, if the attribute contains only one value, then the adapter automatically uses that caller ID so the agent doesn't see a popup when making a call.

    Next, set the Workspace Web Edition option intercommunication.voice.make-call-caller-id-business-attribute to the name of your Business Attribute.

    For example, if you create a Business Attribute named CallerID, then you would set intercommunication.voice.make-call-caller-id-business-attribute to CallerID.

    Voicemail

    The adapter supports voicemail if your environment is set up for Genesys SIP Feature Server (previously called Genesys SIP Voicemail). To enable voicemail, set the following Workspace options: privilege.voicemail.can-use and voicemail.access-number.

Comments or questions about this documentation? Contact us for support!