Configure UI Plugins for WebAgent
Introduction
The AnywhereNow UI plugins allow you to load UI components into
WebAgent—for example, an iframe to display external websites directly inside WebAgent.
Notes
-
UI plugins are enabled for all WebAgent users in a region.
-
UI plugins can only be activated by AnywhereNow.
Available UI Plugins
Iframe plugin
Use the iframe plugin to embed any website as a panel within WebAgent—for example, your company’s Twitter feed or an internal support chat room.
Note
Custom iframe plugin configuration is available for the WebAgent URL used with Dialogue Cloud Neo (Connect). Customer-configured UI plugins are not currently available on the WebAgent URL used with Dialogue Cloud Neo (Unify). If your implementation requires a custom iframe plugin, use the Connect WebAgent URL.
Prerequisites
-
The target URL must permit embedding in an iframe.
-
The target URL must render correctly at a width of approximately 250 px.
Add conversation variables to the URL
When a conversation is active, WebAgent can append conversation metadata to your configured URL. This allows the embedded page to prefill fields or load customer‑specific information.
Available variables:
-
conversationId — The session identifier for the agent’s current WebAgent session. Each hunt or transfer creates a new
conversationId.Note
From DC2025.02a,
<conversationId>uses the platform dialogue or call ID instead of the previous hunting conversation ID. Before updating to DC2025.02a or higher, change iframe plugin configurations that use<conversationId>as a lookup key to use<correlationId>instead. The<correlationId>placeholder is available from DC2025.01. -
correlationId — The internal conversation correlation value. Use
<correlationId>as the lookup key when your iframe plugin must keep using the previous internal conversation identifier.Introduced in DC2025.01
-
agent — The signed‑in agent’s UPN In Windows Active Directory, a User Principal Name (UPN) is the name of a system user in an email address 'like' format. A UPN (for example: john.doe@domain.com) consists of the user name (logon name), separator (the @ symbol), and domain name (UPN suffix)..
Note
The
sip:prefix is removed. -
customer — The customer’s URI (phone number or email address) of the active dialogue.
Note
The
sip:ortel:prefix is removed. -
skills — The names of all skills the agent belongs to.
Introduced in DC2025.01
-
Introduced in DC2025.01
-
uccIds — The IDs of all UCCs the agent belongs to.
Introduced in DC2025.01
Build the URL with variable values
Insert variables using angle brackets, for example:
https://golive.anywhere.now?correlationId=<correlationId>&agentUri=<agent>&customerUri=<customer>
Note
URL‑encoded:
https%3A%2F%2Fgolive.anywhere.now%3FcorrelationId%3D%3CcorrelationId%3E%26agentUri%3D%3Cagent%3E%26customerUri%3D%3Ccustomer%3E
At runtime this might resolve to:
https://golive.anywhere.now?correlationId=3f38d814-77d8-472a-9591-e23f539edf68&agentUri=adelev@contoso.com&customerUri=customer@anywhere.now
How to activate
UI plugins can only be activated by AnywhereNow. Share the URL you want to enable with your AnywhereNow representative.
Teams meeting plugin
The Teams meeting plugin lets agents escalate a AnywhereNow WebChat session to a Microsoft Teams meeting. During the meeting, the conversation supports web audio, web video, and screen sharing.
Notes
- The Teams meeting is not logged in Power BI reporting or any other AnywhereNow data source.
- Audio from the Teams meeting is not recorded by the AnywhereNow recording feature.
- During the Teams meeting, the customer can see the other participant, i.e., the agent’s Teams identity.
How to activate
UI plugins can only be activated by AnywhereNow. Contact your AnywhereNow representative to enable this plugin.