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."
The 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 the ability to delete Facebook posts and comments, you must assign the privileges Facebook - Can Remove Comments and Facebook - Can Remove Posts.
- 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 Workitem 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-queueSpecifies 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-queueSpecifies 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-regexHighlights URLs and makes them clickable.
- <media-type>.hashtag-regexHighlights hashtags and makes them clickable.
- twitter.mention-regexHighlights 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-colorSpecifies the color of the text of the messages that are entered by the agent in the Facebook Session view.
- facebooksession.agent.prompt-colorSpecifies the color of the prompt for the messages that are entered by the agent in the Facebook Session view.
- facebooksession.client.prompt-colorSpecifies the color of the text of the messages that are entered by the target client in the Facebook Session view.
- facebooksession.client.text-colorSpecifies the color of the client text in the Facebook Session view.
- facebooksession.other-agent.prompt-colorSpecifies the color of the text of the messages that are entered by the target agent in the Facebook Session view.
- facebooksession.other-agent.text-colorSpecifies the color of the other agent text in the Facebook Session view.
- facebooksession.system.text-colorSpecifies the color of the text for system messages in the Facebook Session view.
These options specify the names of the workbins in which interactions are placed.
- Inbound interactions are placed in the InProgress workbin; for example, workbin.twitter.in-progress = Twitter Workbin InProgress.
- Outbound interactions are placed in the Draft workbin; for example, workbin.facebook.draft = Facebook Workbin Draft.
- <media-type>.response-wait-timeSpecifies the length of time that Interaction Workspace waits for a response to a request to Interaction Server.
- <media-type>.toast-information-keyThis is an instance of a more general Interaction Workspace option. See, for example, email.toast-information-key.
- <media-type>.auto-answerSpecifies whether the interaction is automatically accepted, and joined if necessary, when an Interaction Server Invite event is received.
- <media-type>.prompt-for-doneSpecifies whether the application prompts a confirmation message when a user clicks the Done button.
- <media-type>.subject-max-charsSpecifies a maximum length of characters for an outbound interaction subject.
- display-format.interaction-<media-type>-nameDefines 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-sizeSpecifies the number of comments (a) shown initially and (b) added when show more is clicked.
- facebook.image-attachment-max-sizeSpecifies the maximum size, in Kilobytes, of a picture that is attached to a post.
- facebook.use-esp-broadcastSpecifies whether the ESP request GetChannelsDescription is sent in broadcast mode.
- facebooksession.time-stampSpecifies whether the time stamp is displayed in the Facebook Session transcript area.
- facebooksession.transcript-time-frameSpecifies 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>.queueUse 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-actionsUse 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-targetsUse 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.transferSpecifies a valid shortcut key. For example: 'Win+A', 'D1', 'SPACE', 'Ctrl+Alt+V', 'Ctrl+Shift+Alt+V'.
- twitter.image-attachment-char-lengthSpecifies the length, in characters, of the shortened URL Twitter uses to replace all images in the outbound message text.
- twitter.image-attachment-max-sizeSpecifies the maximum size, in Kilobytes, of a picture that is attached to a tweet.
- twitter.max-charsSpecifies the maximum number of characters allowed per tweet or direct message.
- twitter.shortened-url-char-lengthSpecifies the length to which Twitter shortens URLs.
- twitter.use-esp-broadcastSpecifies whether the ESP request GetChannelsDescription is sent in broadcast mode.