Interaction Workspace Plugins for Social Media
Genesys provides plugins that add functionality to Interaction Workspace enabling agents to handle social media interactions. The following sections appliy to all Interaction Workspace plugins.
Outline of Deployment
- Configure Interaction Workspace. Note that to use role-based access control, you must use Genesys Administrator to configure Interaction Workspace and the plugins.
- Install Interaction Workspace using the non-ClickOnce deployment procedure, also known as "installing the Interaction Workspace Application." ImportantThe social media plugins do not support ClickOnce deployment.
- Configure and install the social media plugin.
- Open the social media plugin and export its configuration options, then import them into your Interaction Workspace Application, selecting No when asked if you want to overwrite the existing data.
- Assign privileges, if you are using role-based access control.
- You must assign the privilege <socialmedia>-Can Use <socialmedia>.
- For Transfer, you must add the task InteractionWorkspace.TeamCommunicator.canUse.
- For Decline and Disposition Code, the plugin must declare its own task.
- You must also assign the corresponding Workitem task(s). For example, for Transfer, you must assign Workitem - Can One Step Transfer. The "Workitem Privileges" table on the Interaction Workspace Role Privileges page lists the available workitems.
- Provide values for the configuration options that you added to your Interaction Workspace Application, as described in the next section of this page.
This section provides an outline of the options for the Social Media plugins. Full descriptions of all options can be found in the eServices 8.1 Reference Manual. Some options are similar enough for all plugins that they can be described together. In the following descriptions, <media-type> substitutes for twitter, facebook, facebooksession, or rss. For example, <media-type>.response-wait-time stands for facebook.response-wait-time, facebooksession.response-wait-time, rss.response-wait-time,and twitter.response-wait-time. All options are located in the interaction-workspace section.
Queue Options (mandatory)
You must set a value for these options.
- <media-type>.default-queue—Specifies the name of the queue in which outbound interactions are first created. This name must be identical with the the name of the default queue in the Business Process that the plugin uses. In the sample business processes that are provided with Genesys Social Engagement, the names are:
- Facebook Outbound Init Queue
- Twitter Outbound Init Queue
- <media-type>.outbound-queue—Specifies the name of the queue in which an outbound interaction is to be placed when an agent is done editing it.
These options allow for certain strings to be highlighted and made clickable when interactions are displayed.
- <media-type>.url-regex—Highlights URLs and makes them clickable.
- twitter.hashtag-regex—Highlights hashtags in Twitter and makes them clickable.
- twitter.mention-regex—Highlights mentions in Twitter and makes them clickable.
These options allow messages to be displayed in different colors in the Facebook Session view using Hexadecimal color codes.
- facebooksession.agent.text-color—Specifies the color of the text of the messages that are entered by the agent in the Facebook Session view.
- facebooksession.agent.prompt-color—Specifies the color of the prompt for the messages that are entered by the agent in the Facebook Session view.
- facebooksession.client.prompt-color—Specifies the color of the text of the messages that are entered by the target client in the Facebook Session view.
- facebooksession.client.text-color—Specifies the color of the client text in the Facebook Session view.
- facebooksession.other-agent.prompt-color—Specifies the color of the text of the messages that are entered by the target agent in the Facebook Session view.
- facebooksession.other-agent.text-color—Specifies the color of the other agent text in the Facebook Session view.
- facebooksession.system.text-color—Specifies the color of the text for system messages in the Facebook Session view.
- <media-type>.response-wait-time—Specifies the length of time that Interaction Workspace waits for a response to a request to Interaction Server.
- <media-type>.toast-information-key—This is an instance of a more general Interaction Workspace option. See, for example, email.toast-information-key.
- <media-type>.auto-answer—Specifies whether the interaction is automatically accepted, and joined if necessary, when an Interaction Server Invite event is received.
- <media-type>.prompt-for-done—Specifies whether the application prompts a confirmation message when a user clicks the Done button.
- <media-type>.subject-max-chars—Specifies a maximum length of characters for an outbound interaction subject.
- display-format.interaction-<media-type>-name—Defines the format of the tooltip that is presented when hovering the pointer over the Case tab, if the media type of the main interaction is Voice. It is specified by a string that contains a compilation of characters and field codes from the following list: $Interaction.Type$,$Interaction.CaseId$,$Interaction.Id$,$Interaction.MainParty$,$Contact.X$,$AttachedData.Y$ (X: name of contact attribute, Y:attached data key name)
- facebook.comments-pagination-size—Specifies the number of comments (a) shown initially and (b) added when show more is clicked.
- facebooksession.time-stamp—Specifies whether the time stamp is displayed in the Facebook Session transcript area.
- facebooksession.transcript-time-frame—Specifies the range of time, in hours, in which to search for previous interactions by the same contact to populate the Facebook Session transcript from the contact history. A value of 0 means nothing is added to the contact history.
- intercommunication.<media-type>.queue—Use this option as a template for any specific workitem media-type to specify the name of the Interaction Queue that is used by the Routing Based feature for the specified workitem media-type. The following attached data are added by Interaction Worskspace: IW_RoutingBasedOriginalEmployeeId,IW_RoutingBasedTargetId,IW_RoutingBasedTargetType,IW_RoutingBasedRequestType.
- intercommunication.<media-type>.routing-base-actions—Use this option as a template for any specific workitem media-type to define the list of Routing Based actions that an agent is allowed to perform for the specified workitem media-type.
- intercommunication.<media-type>.routingbased-targets—Use this option as a template for any specific workitem media-type to define the list of targets that are contacted through the Routing Based mechanism for the requests that are defined in the intercommunication.<media-type>.routing-based-actions option.
- keyboard.shortcut.interaction.facebooksession.transfer—Specifies a valid shortcut key. For example: 'Win+A', 'D1', 'SPACE', 'Ctrl+Alt+V', 'Ctrl+Shift+Alt+V'.
- twitter.image-attachment-char-length—Specifies the length, in characters, of the shortened URL Twitter uses to replace all images in the outbound message text.
- twitter.image-attachment-max-size—Specifies the maximum size, in Kilobytes, of a picture that is attached to a tweet.
- twitter.max-chars—Specifies the maximum number of characters allowed per tweet or direct message.
- twitter.shortened-url-char-length—Specifies the length to which Twitter shortens URLs.