Install WebChat Dialogue Provider 2.0
Note
An Enterprise license or higher is required to access these features.
Note
An Dialogue Cloud WebAgent for Omnichannel license is required.
Requirements
- Install ASP.NET Core 6.0.8 (or a later 6.0 series) Hosting A bundle is a fixed combination of our software platform elements of very specific versions. These are designed and tested to optimally work together to assure their intended function and interoperability. (if you have not already done this)
Bundle 2024.02 and later: Microsoft ASP.NET Core 8.0.0 (or a later 8.0 series) Hosting Bundle installed (may already be installed).
Installation
Deploy package
-
Unzip the WebChat Dialogue Provider package
-
Edit the properties.ps1
-
Domain = Domain of the install account
-
UserName = Username of the install account
-
-
Run install.ps1 in PowerShell as administrator
Add Plugin Settings
-
Open the A Unified Contact Center, or UCC, is a queue of interactions (voice, email, IM, etc.) that are handled by Agents. Each UCC has its own settings, IVR menus and Agents. Agents can belong to one or several UCCs and can have multiple skills (competencies). A UCC can be visualized as a contact center “micro service”. Customers can utilize one UCC (e.g. a global helpdesk), a few UCC’s (e.g. for each department or regional office) or hundreds of UCC’s (e.g. for each bed at a hospital). They are interconnected and can all be managed from one central location. Config page on SharePoint
-
Open the Plugin Settings list
-
Add the following settings:
Setting Value Description Setting: Enabled
Scope: WebChatDialogueProvider2
TRUE
The provider will start, and the background tasks will start running. However, when the tasks to process any data are triggered, they will not execute and be skipped.
Setting: PollingIntervalInSeconds
Scope: WebChatDialogueProvider2
1
The provider will look for data to process each x-seconds. The provider will first check whether there are any active sessions, if so, it will query the database for data.
Setting: CustomerUriDomain
Scope: WebChatDialogueProvider2
Example:
mydomain.com
When there is no customer (sip) URI provided with the chat session, an URI will be generated based on the conversation identifier; this domain will be used as post-fix. For example: generated-id@customerdomain.
Setting: DefaultAgentName
Scope: WebChatDialogueProvider2
Example:
Agent
The default agent name to display to the customer, when the agent's name can not, or has not yet been, retrieved from the database.
Setting: WebChatSipUri
Scope: WebChatDialogueProvider2
Example:
sip:ucc_service_webchat@mydomain.com
The default sip URI that will be used for any purpose when none can be found or none is provided.
Scope: WebChatDialogueProvider2
Example:
https://PUBLIC-FDQN stands for Fully Qualified Domain Name and specifies the exact location in the tree hierarchy of the Domain Name System (DNS). An example for [hostname].[domain].[top level domain] is [www].[microsoft].[com]/WebchatDialogueProvider2_<ucc-name>
Note
URL needs to be EXTERNALLY accessible and from the WebChat Front-end, i.e. the user interface the end-user will be using the WebChat on.
The public accessible location of the WebChatDialogueProvider2
Setting: ForwardUri
Scope: WebChatDialogueProvider2
Example:
http://FQDN/WebchatDialogueProvider2_<ucc-name>/api/v1/dialogue-manager/ucc/presence
Warning
It is important to configure this setting to one main regional URL when using multiple services in the same region. If this is not done, you may experience unexpected behavior.
Warning
Make sure to leave the fqdn to this service configured as a ".local" URL, especially when using multiple UCC services in the same region. If this is not done, the UCC cannot reach the right webserver internally leading to undesired or non-functional WebAgent behavior.
Note
URL needs to be accessible from the Dialogue Manager to the WebChatDialogueProvider2.
Used for the Dialogue Manager to forward presence information to the WebChatDialogueProvider2.
-
For all the available settings to finetune the WebChat Dialogue Provider, see: WebChat Dialogue Provider Plugin Settings Overview
Add Endpoint
-
Open the UCC Config page on SharePoint
-
Open the Plugin Settings list
-
Add DialogueManager settings endpoint to ListsPlugin ListsEndpoints
Note
Add to the existing item and separate with "Enter".
Setting Value Description Setting: ListsEndpoints
Scope: ListsPlugin
http://FQDN/webagentservice/api/v1/settings (should already exist)
http://FQDN/DialogueManager/api/v1/settings (should already exist)
http://FQDN/WebChatDialogueProvider2_<ucc-name>/api/v1/settings
Warning
It is important to configure this setting to one main regional URL when using multiple services in the same region. If this is not done, you may experience unexpected behavior.
Warning
Make sure to leave the fqdn to this service configured as a ".local" URL, especially when using multiple UCC services in the same region. If this is not done, the UCC cannot reach the right webserver internally leading to undesired or non-functional WebAgent behavior.
Note
URL needs to be accessible from the UCC Service to the WebChatDialogueProvider2.
Used by the ListsPlugin to push the settings from the settings from SharePoint to the URL of the service.
Create and assign Skills
-
Create regular skill, see: Standard Skill
-
Add Agents, see: Agents
-
Assign Skills to Agents, see: Skills per Agent
Add Plugin Flow Settings
-
Open the UCC Config page on SharePoint
-
Open the Plugin Flow Settings list
-
Below an example on how to setup the Plugin Flow Settings:
Attribute Operator Value Order Action Skill Channel
Equals
Webchat
1.00
Skill
WebChat
Channel
Not equals
Webchat
2.00
Skill
WebChat
More information, see: Plugin Flow Settings
For more examples, see: Plugin Flow Settings examples for WebChat Dialogue Provider
Restart UCC and validate
-
Login to the AnywhereNow Application Server
-
Start Services
-
Restart "Unified Contact Center"
-
See the logs if Dialogue Manager is successfully loaded
2019-04-18 15:39:30,716 [5] Wsp.Anywhere365.Ucc.Lists.ListsPlugin.ListsRequest DEBUG - ListsPlugin SendRequest Endpoint: http://FQDN/WebChatDialogueProvider2/api/v1/settings - body: {"Version":"1.1.7"...}2019-04-18 16:13:32.7046 DEBUG SettingsManager - Added settings for UCC ucc__webchat 2019-04-18 16:13:32.7075 TRACE ProviderManager - TryAddUcc ucc__webchat
%20hostingbundle.png)
