Revision as of 17:37, March 26, 2020

Enabling Internal Communications

The following procedures enable internal communication features in Workspace Agent Desktop.

Enabling Team Communicator

Team Communicator is a universal lookup tool. Agents use the Team Communicator to start phone calls and emails. The following procedures enable features in Team Communicator.

You can enable agents to use Team Communicator to call a contact that is stored in the Universal Contact Server (UCS).

Before you begin, ensure that the following prerequisites are met:

A working knowledge of Genesys Administrator Extension (GAX).
A Cloud_Cluster application object exists in the Configuration Database.
The Cloud_Cluster application has a connection to Universal Contact Server.
Enabling Agents To Manage Contacts.
Provisioning Workspace Agent Desktop for the Voice channel.

To enable agents to use Team Communicator to call a contact:

Grant the privilege.teamcommunicator.can-use privilege.
Optional. Grant one or more of the following privileges:
- privilege.teamcommunicator.can-view-all: Allow an agent to search within all internal targets and contacts in Team Communicator.
- privilege.teamcommunicator.can-view-recent-calls: Allow an agent to view recently contacted resources in Team Communicator.
- privilege.teamcommunicator.display-agent-groups-availability: Allow an agent to view the number of agents who are ready for voice in agent groups in Team Communicator.
- presence.evaluate-presence: Allow an agent to view the status of agents, agent groups, and Routing Points in Team Communicator.
- privilege.teamcommunicator.can-manage-favorites: Allow an agent to add, edit, and remove personal favorites in Team Communicator.
Configure the Team Communicator and related options in the interaction-workspace section of the Cloud_Cluster application object:
- teamcommunicator.add-recent-filters.voice: Specifies what interaction types to store in the Recent buffer.
- teamcommunicator.always-clear-textbox-on-new-interaction: Specifies whether Workspace clears the team communicator search text box when the interaction is initiated by pressing 'Enter' or by clicking on one of the medias of team communicator results. When it is set to false, this option clears the team communicator search text box only when the interaction is initiated by pressing 'Enter'.
- teamcommunicator.list-filter-showing: Specifies the list of filters that an agent can use to search for contacts and internal targets.
- teamcommunicator.load-at-startup: Specifies if all the configuration objects related to favorites (Agents, Agent Groups, Queues, Routing Points, Skills) needed by Teamcommunicator are loaded at login.
- teamcommunicator.max-size: Specifies the maximum size of the default list when the value of teamcommunicator.show-all-internal-targets} is set to true.
- teamcommunicator.max-suggestion-size: Specifies the maximum size of the suggestion list that is displayed while an agent is entering a contact or target name.
- teamcommunicator.recent-max-records: Specifies the number of recent internal targets to display in the list of recent targets.
- teamcommunicator.request-start-timer: Specifies the request start timer wait interval, in milliseconds, between the last key pressed and the beginning of the search through the contact database.
- teamcommunicator.show-all-internal-targets: Specify whether all internal targets are displayed by default in the Team Communicator when an agent is searching for a transfer or conference target, including all Agents, Agent Groups, Skills, and Routing Points. Enabling this option could affect the performance of Team Communicator.
- teamcommunicator.voice.consultation.exclude-numbers: Specifies the format for phone numbers to be excluded on consultation.
- teamcommunicator.voice.list-status-reachable: Specifies the list of unavailable statuses for which a target agent can be contacted for consultation, transfer, and conference requests.
- teamcommunicator.voice.make-call.exclude-numbers: Specifies the format for phone numbers to be excluded on making a call.
- teamcommunicator.voice.single-step-conference.exclude-numbers: Specifies the format for phone numbers to be excluded on single-step conference.
- teamcommunicator.voice.single-step-transfer.exclude-numbers: Specifies the format for phone numbers to be excluded on single-step transfer.
- expression.phone-number.supported-characters: Specifies the characters that are permitted when building a request to the T-Server that relies on a phone number. Any other characters from the original string coming from the User Interface are removed.
- expression.validate.email-address: Specifies the regular expression used to recognize an email address of a target entered in the Team Communicator.
- expression.validate.phone-number: Specifies the regular expression used to recognize a phone number of a target entered in the Team Communicator when it is used to start a call, transfer, or conference. If the number entered by the agent in the Team Communicator edit box matches this expression, the 'Call' or 'Start Voice Consultation' or 'Instant Transfer' or 'Instant Conference' action is enabled for this number. When the agent executes the action, the entered phone number is modified by the logic specified by the expression.phone-number.supported-characters option before the telephony operation is executed.
  - interaction-management.move-to-workbin.restrict-to-my-team: Specifies if the search applied in Team Communicator for Move to Workbin action should be restricted to the workbins of the logged agent team.
To restrict which agents can be seen in Team Communicator search results, you can specify which groups an agent can or cannot see by specifying them in these configuration options:
- teamcommunicator.permissions.agent.restrict-to-agent-groups — Agents who belong to at least one of these agent groups or virtual agent groups will be included in the list.
- teamcommunicator.permissions.agent.exclude-from-agent-groups — Agents who belong to at least one of these agent groups or virtual agent groups will be excluded from the list (This overrides the teamcommunicator.permissions.agent.restrict-to-agent-groups filter where there is overlap).
Ensure that the UCS application to which Cloud_Cluster is connected is configured to support index searches in the Contact database:
- Set the index\enabled option to true.
- Set the index.contact\enabled option to true.
For more details about these settings, refer to the eServices 8.1 Reference Manual.

Enabling call routing and voice call, conference, or transfer

You can enable agents to use Team Communicator to call, conference, or transfer to an agent, agent group, skill, or a routing point using a strategy. This procedure is mandatory for agent groups and skill targets.

Tip

No extra configuration is required to transfer an interaction to an agent.

Before you begin, ensure that the following prerequisites are met:

A working knowledge of Genesys Administrator Extension (GAX).
A working knowledge of Genesys Designer.
A Cloud_Cluster application object exists in the Configuration Database.
To transfer to skills, you must have skills defined in the Configuration Database.
To transfer to agent groups, you must have agent groups defined in the Configuration Database.

To enable agents to use Team Communicator to call, conference, or transfer to an agent, agent group, skill, or a routing point:

Set up your system infrastructure:
1. In the Configuration tab of the Cloud_Cluster application, add connections to Stat Server.
2. In the connections, add a reference to the T-Server associated with the switch to which the agent logs in.
3. Configure the Team Communicator options in the interaction-workspace section of the Cloud_Cluster application object.
Set up your agents to be able to use the Team Communicator to call or transfer to other agents or other internal targets:
1. To let your agents make voice calls, set the value of the privilege.voice.can-use option, to true.
2. To ensure that the status of your agents, agent groups, and Routing Point is displayed in the Team Communicator of other agents who might be trying to call them, set the value of the presence.evaluate-presence option to true.
3. To enable your agents to view the number of targets who are in Ready status in an agent group, allow the privilege.teamcommunicator.display-agent-groups-availability privilege.
4. For small contact centers, where the number of potential transfer targets is low, you can configure Workspace to display all of the possible targets in the Team Communicator search results when an agent initiates a transfer or conference by searching in the Team Communicator.
  To enable this functionality, set the value of the teamcommunicator.show-all-internal-targets option to true.
  This option is limited by the value that is specified for the teamcommunicator.max-size option.
  Important
  Genesys strongly recommends that only small contact centers use this option. Agents in large contact centers will experience system performance issues if the teamcommunicator.show-all-internal-targets option is enabled.
You can choose to set up call routing to direct calls to specific agents based on strategies. To transfer to Skills and Groups, you must also specify a routing point by using the intercommunication.voice.routing-points option.
1. First determine which call flow scenarios you want handled by a routing-based mechanism based on targets, such as language or product skills, level of training, or availability, and types of calls, such as high priority customers, inquiries, sales, and so on.
2. Use Genesys Designer, to create a routing strategy that uses routing targets (agents, agent groups, skills, and so on) to process routing-based actions by using the following attached data:
  - IW_RoutingBasedOriginalEmployeeId — The employee ID of the agent who is transferring the interaction.
  - IW_RoutingBasedTargetId — The ID (employee ID of another agent, AgentGroup name, Skill name, Routing Point name) of the target.
  - IW_RoutingBasedTargetType — The type of the target (Agent, AgentGroup, Skill, or RoutingPointl)
  - IW_RoutingBasedRequestType — Informs the strategy of the type of action is to be done (MakeCall,OneStepConference,InitConference,OneStepTransfer,InitTransfer)
3. Depending on the type of target for which you want to use routing-based transfer, use Configuration Manager or Genesys Administrator to set the value of the intercommunication.voice.routing-based-targets options as follows:
  - To use T-Server to handle transfers to Agent, Routing Point, and Directly Dialed (Type Destination), and have all other transfers handled by a strategy, set the value of this option to "" (empty)
  - To use routing-based transfer for Agents, add the value Agent to this option.
  - To use routing-based transfer for Routing Point, add the value RoutingPoint to this option.
  - To use routing-based transfer for Directly Dialed (Type Destination), add the value TypeDestination to this option.
  - For agent groups and skills, it is not mandatory to set the routing-based target option because these target always use routing-based transfer.
4. To specify whether a specific call type is to be handled by the routing-based mechanism, set the value of the intercommunication.voice.routing-based-actions option.
  - MakeCall: Use the routing-based mechanism for external calls.
  - OneStepTransfer: Use the routing-based mechanism for single-step transfers.
  - InitTransfer: Use the routing-based mechanism for two-step transfers.
  - InitConference: Use the routing-based mechanism for two-step conferences.
  - OneStepConference: Use the routing-based mechanism for single-step conferences.
5. Load the routing strategy on the Routing Point that is defined by the intercommunication.voice.routing-points option.
6. If contact.lookup.enable is enabled, and intercommunication is configured as above, use the contact.lookup.voice.intercommunication.use-dialed-phone-number option to specify that contact lookup is performed on the phone number typed by an agent for an outgoing call to Routing Point.
Fine-tune the settings for contacting specific targets (Agent, AgentGroup, RoutingPoint, Contact, and/or TypeDestination) that are using a routing-based mechanism by configuring action-specific options:

Enabling multimedia interaction transfer

You can enable agents to use Team Communicator to transfer a multimedia interaction (Email and Chat) to an agent, agent group, or skill by using a strategy. This procedure is mandatory to transfer to agent groups and skills.

Before you begin, ensure that the following prerequisites are met:

A working knowledge of Genesys Administrator Extension (GAX).
A working knowledge of Genesys Designer.
A Cloud_Cluster application object exists in the Configuration Database.
To transfer to skills, you must have skills defined in the Configuration Database.
To transfer to agent groups, you must have agent groups defined in the Configuration Database.

To enable agents to use Team Communicator to transfer a multimedia interactions:

By using Genesys Designer, configure a routed-based transfer workflow by using these steps:
1. Create an Interaction Queue/Interaction View pair. The Interaction Queue is used as a part of the workflow; however, Interaction Queues are not available as transfer targets in the agent interface.
2. Create a routing strategy to process routing-based actions. To help you write the appropriate strategy, Workspace Web Edition adds the following attached data to the interaction:
  - IW_RoutingBasedOriginalEmployeeId — The employee ID of the agent who is transferring the interaction.
  - IW_RoutingBasedTargetId — The ID (employee ID of another agent, AgentGroup name, Skill name) of the target.
  - IW_RoutingBasedTargetType — The type of the target (Agent, AgentGroup, or Skill)
  - IW_RoutingBasedRequestType — Informs the strategy of the type of action is to be done. This attached data has only one value available for this release: OneStepTransfer
3. Link the above Queue to the strategy.
4. Activate the strategy.
Using GAX, set the values of the following configuration options to the Queue that you created in Step 1:
- interaction-workspace/ intercommunication.email.queue
- interaction-workspace/intercommunication.chat.queue
- interaction-workspace/intercommunication.<media-type>.queue
Use the following options to specify the routing-based actions that are permitted:
Depending on the type of target for which you want to use routing-based transfer, use GAX to set the values of the intercommunication.chat.routing-based-targets, intercommunication.email.routing-based-targets, and/or intercommunication.<media-type>.routing-based-targets configuration options as follows:
- To use Interaction Server to handle agent-to-agent transfer and have all other transfers handled by a strategy, set the values of these options to "" (empty)
- To use routing-based transfer for Agents, set the values of these options to Agent.
- For agent groups and skills, it is not mandatory to set the routing-based target options because these target always use routing-based transfer.
Log out agents and log them back in again.

Enabling an agent to view routing point presence information in Team Communicator

This section describes how you can configure Workspace to display presence information, including warning and error levels, in the Team Communicator for Routing Point Objects.

Each object or group of objects for which you want to define presence must have its own section defined in the Workspace Application object in the Configuration Database. In this example configuration, a section named routing-point-presence has been created and the AverageWaitingtime statistic has been specified. "seconds." is defined as the display text and the values 5 and 10 have been specified for the warning and error levels that determine when the presence icons change from ready to warning to error levels:

The statistic-name option references AverageWaitingTime, the "name" value of the statistics.definitions.v2v3_AverageWaitingTime_RP option, defined in the Statistics_Definitions.cfg file and found in the Workspace application options in Genesys Administrator Extension:

Defining a Presence Object section

Use Genesys Administrator Extension to define a new section in the options of Workspace Application object.

Use any string representing the Routing Point object concatenated with any logical identifier as the name of the section.
Define the values that are to be displayed for the Routing Point as the Options and Values of the section.

Refer to the Table - Mandatory and Optional Options for Presence Sections for a complete list of the mandatory and optional options that you can define for each presence Object.

**Mandatory and Optional Options for Presence Sections**
Key	Mandatory
statistic-name	Yes
statistic-text	Yes
warning-level	No
error-level	No
object-ids	No
associated-object-type	No
associated-object-ids	No

Displaying object statistics

Workspace enables you to assign the Object presence statistics that you have defined on the Application object at one or more of the following levels:

Application level — Display Object Statistic to all agents
Tenant level — Display Object Statistic to all the agents of the Tenant
Agent Group level — Display Object Statistic to all the agents of the Agent Group
Agent level — Display Object Statistic to the agent

To assign an Object presence statistic to a specific configuration hierarchy level, define and configure the teamcommunicator.routing-point-presence-metrics option for Routing Points in the interaction-workspace section of the level. The value of this option is a comma-separated list of Presence Object sections that are to be interpreted.

Use the following Team Communicator option to assign Routing Point object presence to Team Communicator:

presence.evaluate-presence: Specifies whether the presence (availability) of agents, agent groups, and Routing Points (when configured) is shown in Team Communicator search results.

Display precedence rules:

When there is a presence section that does not have a specified object-ids key and a presence section which applies to object "queue 1", the second section will apply to "queue 1"; the presence of all other objects is defined by the first section.
When there are multiple presence sections that do not have object-ids, only the first presence section in the list is taken into account.
When an object is listed in multiple presence sections, only the first one in the list is taken into account.
When all presence sections have explicit object-ids keys, the objects that are not explicitly listed in any presence section are displayed without presence information.

Example

The following is an example of a contact center that displays routing points in Team Communicator and also uses virtual queues to calculate statistics for presence on routing points.

Routing Points RP1, RP2, RP3 are available in Team Communicator as target for voice call transfers.
Virtual Queues VQ1, VQ2 are not available in Team Communicator, but are technical objects that are available for background operations.
The availability of RP1 is based on the "Number of Waiting Calls" on RP1.
The availability of RP2 is based on the "Estimated Waiting Time" of VQ1.
The availability of RP3 is based on the "Estimated Waiting Time" of VQ2.

Use the following configuration to get the expected presence metric of the routing points described above:

Section: routing-point-presence1
- statistic-name=CurrNumberWaitingCalls
- statistic-text=interaction(s) waiting.
- warning-level=5
- error-level=10
- object-ids=RP1@Switch1

Section: routing-point-presence2
- statistic-name=ExpectedWaitTime
- statistic-text=second(s) to wait
- warning-level=30
- error-level=60
- object-ids=RP2@Switch1,RP3@Switch1
- associated-object-type=Queue
- associated-object-ids=VQ1@Switch1,VQ2@Switch1

Section: interaction-workspace
- presence.evaluate-presence=routing-point-presence1,routing-point-presence2

In this configuration, any routing point apart from RP1, RP2, and RP3 will not display presence in Team Communicator.

Creating Corporate Favorites

You can enable the use of corporate favorites in the Team Communicator. Administrators must create, edit, and remove favorites by using Genesys Administrator Extension. You can configure the system so that each agent is assigned one or more quick dial favorites lists. You do not have to assign the same list of favorites to every agent.

Before you begin, ensure that the following prerequisites are met:

A working knowledge of Genesys Administrator Extension (GAX).
An understanding of Configuration options
A Cloud_Cluster application object exists in the Configuration Database.

To enable the use of corporate favorites:

Using GAX, create a new section in the appropriate object (the Cloud_Cluster application, Tenant, Agent Group, or Agent), and name it with the name of the Corporate Favorite that you want to create.
Configure the new Corporate Favorite section to be one of the following types:
- Agent
- Agent Group
- Skill
- Routing Point
- Custom Contact
- Interaction Queue

Attached Data

You can have multiple instances of the same object type, such as a routing point, in corporate favorites with different attached data for each. For example:

[Fav-English]	[Fav-Spanish]
type: RoutingPoint	type: RoutingPoint
id: 6666@MySwitch Note: the following characters are not supported for the id: ?\|{}[]()"\,	id: 6666@MySwitch Note: the following characters are not supported for the id: ?\|{}[]()"\,
display-name: English	display-name: Spanish
attached-data.lang: en	attached-data.lang: es

Corporate Favorite Options by Type

The Table Corporate Favorite Options by Type defines the Corporate Favorite types and the mandatory options.

Important

A corporate favorite that has Custom Contact specified as the type only appears in a Favorites search and the Recent list if the contact was previously called. Search All only searches within targets that specify the following types: Agent, Contact, Routing Point, Skill, Queue, Interaction Queue, and Agent Group.

**Corporate Favorite Options by Type**
Type	Options	Mandatory	Valid values	Example
Agent	type	Yes	Agent	Agent
	id	Yes	<user name of the agent>	User123 Note: the following characters are not supported for the id: ?\|{}[]()"\,
	category	Yes	<a semicolon-separated list of category names>	CorporateCategory1;FavoriteAgents
	display-name	No	<display name of the agent>	Jim Brown
Agent Group	type	Yes	AgentGroup	AgentGroup
	id	Yes	<name of the agent group>	Agent Group Meridian Note: the following characters are not supported for the id: ?\|{}[]()"\,
	category	Yes	<a semicolon-separated list of category names>	CorporateCategory1;FavoriteAgents
	display-name	No	<display name of the agent group>	Meridian
Skill	type	Yes	Skill	Skill
	id	Yes	<name of the skill>	French Note: the following characters are not supported for the id: ?\|{}[]()"\,
	category	Yes	<a semicolon-separated list of category names>	French Speaking Agents;Mandarin Speaking Agents
	display-name	No	<display name of the skill>	French
Routing Point	type	Yes	RoutingPoint	RoutingPoint
	id	Yes	The DN number in the following format: <DN number>@<switch>	123@MySwitch Note: the following characters are not supported for the id: ?\|{}[]()"\,
	category	Yes	<a semicolon-separated list of category names>	CorpRoutingPoint
	display-name	No	<display name of the routing point>	Support
	attached-data.<AttachedDataKey>	No	<an attached data key>	attached-data.lang: en
Directly Dialed	type	Yes	CustomContact	CustomContact
	category	Yes	<a semicolon-separated list of category names>	External Resources
	firstname	No	<any string>	First
	lastname	No	<any string>	External
	phonenumber	Yes (one or both)	<a semicolon-separated list of phone numbers>	+1555234567890;+555123454321
	emailaddress	Yes (one or both)	<a semicolon-separated list of email addresses>	external1@mail.dom;external2@mail.dom
	display-name	No	<display name of the custom contact>	Angie Davis

Grant the following privilege: to the agents that you want to enable for favorites:
- privilege.teamcommunicator.can-view-favorites: Allow an agent to view favorites in Team Communicator.
In the configuration layer, in options of the related section (or Tenant/Agent Group/Agent annexes), configure the following options in the interaction-workspace section of agent, agent group, tenant, and/or application annexes:
- teamcommunicator.corporate-favorites -- The list of corporate favorites (quick dial favorites) that are configured in Configuration Server for an Agent, Agent Group, Skill, Routing Point, or Custom Contact in the same tenant as the agent. Favorites that are configured at the agent level take precedence over those that are configured at the agent group level, which take precedence over the tenant level, which takes precedence over the application level.
- teamcommunicator.max-favorites-size -- The maximum number of favorites to display to the agent in the Team Communicator drop-down view.

Assignment of Favorites

When you create corporate favorites, you assign to them a type that is based on the scope to which it is applied: agent, agent group, tenant, or application. You can create multiple favorites and assign them in a hierarchy. For example, you create four favorites: fav1, fav2, fav3, and fav4. You then make the following assignments:

application—teamcommunicator.corporate-favorites="fav1,fav2"
tenant—teamcommunicator.corporate-favorites="fav4"
agent—teamcommunicator.corporate-favorites="fav1,fav3"

The final list of favorites that are assigned to the agent are: "fav1,fav3"

Enabling Agent Feedback

It is useful for administrators to receive feedback from agents about call quality, software behavior, and disconnection events. Use the following options to set up the feedback mechanism. You can enable the Feedback menu item in the Main menu which allows agents to view and use the Feedback dialog box. When an agent clicks Send, their feedback is attached to their log.

system.feedback: Specifies whether the Feedback dialog is available for agents to provide feedback about interaction quality, software behavior, and disconnection events.
system.feedback.log-level: Specifies the feedback log level.
system.feedback.log-size: Specifies the number of characters from the last Log to send with the feedback.
system.feedback.message.max-length: Specifies the maximum number characters allowed for the feedback message from an agent.
system.feedback.submit-after-disconnect: Specifies whether a Feedback dialog box is displayed the next time the agent logs in after a session closed due to the Cometd defense. Managed by the system.cometd.timeout option.

Feedback is stored in Elastic Search. You can access the feedback by using the Feedback microservice or by querying the Elastic Search.

@@ Line 25: / Line 25: @@
 <li>{{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:privilege-teamcommunicator-can-view-recent-calls}}: Allow an agent to view recently contacted resources in Team Communicator.</li>
 <li>{{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:privilege-teamcommunicator-display-agent-groups-availability}}: Allow an agent to view the number of agents who are ready for voice in agent groups in Team Communicator.</li>
-<li>{{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:presence-evaluate-presence}}: Allow an agent to view the status of agents in Team Communicator.</li>
+<li>{{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:presence-evaluate-presence}}: Allow an agent to view the status of agents, agent groups, and Routing Points in Team Communicator.</li>
 <li>{{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:privilege-teamcommunicator-can-manage-favorites}}: Allow an agent to add, edit, and remove personal favorites in Team Communicator.</li>
 </ul>
@@ Line 66: / Line 66: @@
 </li>
 </ol>
+{{AnchorDiv|CallRouting}}
 == Enabling call routing and voice call, conference, or transfer ==
@@ Line 96: / Line 96: @@
 <ol type="a">
 <li>To let your agents make voice calls, set the value of the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:privilege-voice-can-use}} option, to <tt>true</tt>.</li>
-<li>To ensure that the status of your agents is displayed in the Team Communicator of other agents who might be trying to call them, set the value of the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:presence-evaluate-presence}} option to <tt>true</tt>.</li>
+<li>To ensure that the status of your agents, agent groups, and Routing Point is displayed in the Team Communicator of other agents who might be trying to call them, set the value of the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:presence-evaluate-presence}} option to <tt>true</tt>.</li>
 <li>To enable your agents to view the number of targets who are in Ready status in an agent group, allow the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:privilege-teamcommunicator-display-agent-groups-availability}} privilege.</li>
 <li>For small contact centers, where the number of potential transfer targets is low, you can configure Workspace to display ''all'' of the possible targets in the Team Communicator search results when an agent initiates a transfer or conference by searching in the Team Communicator.
@@ Line 137: / Line 137: @@
 </li>
 <li>Load the routing strategy on the Routing Point that is defined by the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:intercommunication-voice-routing-points}} option.</li>
+<li>If {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:contact-lookup-enable}} is enabled, and intercommunication is configured as above, use the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:contact-lookup-voice-intercommunication-use-dialed-phone-number}} option to specify that contact lookup is performed on the phone number typed by an agent for an outgoing call to Routing Point.</li>
 </ol>
 </li>
@@ Line 201: / Line 202: @@
 </ol>
+{{AnchorDiv|presence}}
+== Enabling an agent to view routing point presence information in Team Communicator==
+This section describes how you can configure Workspace to display presence information, including warning and error levels, in the Team Communicator for Routing Point Objects.
+Each object or group of objects for which you want to define presence must have its own section defined in the Workspace Application object in the Configuration Database. In this example configuration, a section named '''routing-point-presence''' has been created and the '''AverageWaitingtime''' statistic has been specified. "seconds." is defined as the display text and the values <tt>5</tt> and <tt>10</tt> have been specified for the warning and error levels that determine when the presence icons change from ready to warning to error levels:
+[[File:GAPI_900_Routing_Point_Presence_Example.png|400px]]
+The '''statistic-name''' option references '''AverageWaitingTime''', the "name" value of the '''statistics.definitions.v2v3_AverageWaitingTime_RP''' option, defined in the '''[[EnablingAgentstoViewKPIs#Statistics_Definitions.cfg|Statistics_Definitions.cfg]]''' file and found in the Workspace application options in Genesys Administrator Extension:
+[[File:GAPI_900_AverageWaitingTime_Statistic.png|400px]]
+===Defining a Presence Object section===
+Use Genesys Administrator Extension to define a new section in the options of Workspace Application object.
+* Use any string representing the Routing Point object concatenated with any logical identifier as the name of the section.
+* Define the values that are to be displayed for the Routing Point as the Options and Values of the section.
+Refer to the Table - '''Mandatory and Optional Options for Presence Sections''' for a complete list of the mandatory and optional options that you can define for each presence Object.
+{| class="genesystable"
+|+ '''Mandatory and Optional Options for Presence Sections'''
+|- valign="top"
+!'''Key'''
+!'''Mandatory'''
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:statistic-name}}
+| Yes
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:statistic-text}}
+| Yes
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:warning-level}}
+| No
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:error-level}}
+| No
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:object-ids}}
+| No
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:associated-object-type}}
+| No
+|- valign="top"
+| {{Optionslink|link=Options:Genesys_Web_Services:routing-point-presence:associated-object-ids}}
+| No
+|}
+===Displaying object statistics===
+Workspace enables you to assign the Object presence statistics that you have defined on the Application object at one or more of the following levels:
+* '''Application level''' &mdash; Display Object Statistic to all agents
+* '''Tenant level''' &mdash; Display Object Statistic to all the agents of the Tenant
+* '''Agent Group level''' &mdash; Display Object Statistic to all the agents of the Agent Group
+* '''Agent level''' &mdash; Display Object Statistic to the agent
+To assign an Object presence statistic to a specific configuration hierarchy level, define and configure the {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:teamcommunicator-routing-point-presence-metrics}} option for Routing Points in the <tt>interaction-workspace</tt> section of the level. The value of this option is a comma-separated list of Presence Object sections that are to be interpreted.
+Use the following Team Communicator option to assign Routing Point object presence to Team Communicator:
+* {{Optionslink|link=Options:Genesys_Web_Services:interaction-workspace:presence-evaluate-presence}}: Specifies whether the presence (availability) of agents, agent groups, and Routing Points (when configured) is shown in Team Communicator search results.
+Display precedence rules:
+* When there is a presence section that does not have a specified '''object-ids''' key and a presence section which applies to object "queue 1", the second section will apply to "queue 1"; the presence of all other objects is defined by the first section.
+* When there are multiple presence sections that do not have '''object-ids''', only the first presence section in the list is taken into account.
+* When an object is listed in multiple presence sections, only the first one in the list is taken into account.
+* When all presence sections have explicit '''object-ids''' keys, the objects that are not explicitly listed in any presence section are displayed without presence information.
+===Example===
+The following is an example of a contact center that displays routing points in Team Communicator and also uses virtual queues to calculate statistics for presence on routing points.
+* Routing Points RP1, RP2, RP3 are available in Team Communicator as target for voice call transfers.
+* Virtual Queues VQ1, VQ2 are not available in Team Communicator, but are technical objects that are available for background operations.
+* The availability of RP1 is based on the "Number of Waiting Calls" on RP1.
+* The availability of RP2 is based on the "Estimated Waiting Time" of VQ1.
+* The availability of RP3 is based on the "Estimated Waiting Time" of VQ2.
+Use the following configuration to get the expected presence metric of the routing points described above:
+* '''Section:''' <tt>routing-point-presence1</tt>
+** <tt>statistic-name=CurrNumberWaitingCalls</tt>
+** <tt>statistic-text=interaction(s) waiting.</tt>
+** <tt>warning-level=5</tt>
+** <tt>error-level=10</tt>
+** <tt>object-ids=RP1@Switch1</tt>
+* '''Section:''' <tt>routing-point-presence2</tt>
+** <tt>statistic-name=ExpectedWaitTime</tt>
+** <tt>statistic-text=second(s) to wait</tt>
+** <tt>warning-level=30</tt>
+** <tt>error-level=60</tt>
+** <tt>object-ids=RP2@Switch1,RP3@Switch1</tt>
+** <tt>associated-object-type=Queue</tt>
+** <tt>associated-object-ids=VQ1@Switch1,VQ2@Switch1</tt>
+* '''Section:''' <tt>interaction-workspace</tt>
+** <tt>presence.evaluate-presence=routing-point-presence1,routing-point-presence2</tt>
+In this configuration, any routing point apart from RP1, RP2, and RP3 will not display presence in Team Communicator.
 ==Creating Corporate Favorites==

Revision as of 17:37, March 26, 2020

Enabling Internal Communications

Enabling Team Communicator

Enabling call routing and voice call, conference, or transfer

Enabling multimedia interaction transfer

Enabling an agent to view routing point presence information in Team Communicator

Defining a Presence Object section

Displaying object statistics

Example

Creating Corporate Favorites

Attached Data

Corporate Favorite Options by Type

Assignment of Favorites

Enabling Agent Feedback

Contact

Genesys

Customer Care

Legal