For the convenience of software integration for our customers, we have designed this function, which allows users to segment the page and adjust the layout of some pages through URL parameters. Through this function, users can use their imagination and inspiration to customize the system with their style.
Parameter: noLayout
This parameter controls the display and hiding of the left menu and top bar in the Admin Console, and this parameter has the highest priority.
noLayout=true
This means hiding both the left menu and the top bar in the Admin Console.
Example:
URL: https://{{your_domain}}/#/admin/widget/dashboard?noLayout=true
noLayout=false
This means displaying both the left menu and the top bar in the Admin Console.
Example:
URL: https://{{your_domain}}/#/admin/widget/dashboard?noLayout=false
Parameter: topLayout
This parameter controls the display and hiding of the top bar in the Agent Panel.
topLayout=true
This means displaying the top bar in the Agent Panel.
Example:
URL: https://{{your_domain}}/#/agentConsole/visitor?includeWs=true&topLayout=true
topLayout=false
This means hiding the top bar in the Agent Panel.
Example:
URL: https://{{your_domain}}/#/agentConsole/visitor?includeWs=true&topLayout=false
Parameter: noPopupMenu
This parameter controls the display style of all widgets in the Admin Console.
noPopupMenu=true
This means that all widgets will be displayed in the Chat Plan submenu of the Admin Console.
Example:
URL: https://{{your_domain}}/#/admin/widget/myWidget/chatPlan?noPopupMenu=true
noPopupMenu=false
This means that all widgets will be displayed in the pop-up menu of the Admin Console.
Example:
URL: https://{{your_domain}}/#/admin/widget/myWidget/chatPlan?noPopupMenu=false
Parameter: navigationStyle
This parameter controls the menu display style in the Agent Panel.
navigationStyle=Left
This is the default style. The menu will be displayed on the left side of the page. If no navigationStyle parameter is set, the default value of "Left" is used.
navigationStyle=TopLeft
This means that the menu will be displayed on the top left side of the page.
It will take effect when topLayout=false.
Example:
URL: https://{{your_domain}}/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=TopLeft
navigationStyle=TopCenter
This means that the menu will be displayed on the top center of the page.
It will take effect when topLayout=false.
Example:
URL: https://{{your_domain}}/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=TopCenter
navigationStyle=TopRight
This means that the menu will be displayed on the top right of the page.
It will take effect when topLayout=false.
Example:
URL: https://{{your_domain}}/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=TopRight
navigationStyle=None
When the value of navigationStyle is set to none, the menu will no longer be displayed.
It will take effect when topLayout=false.
Example:
URL: https://{{your_domain}}/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=none
Parameter: showAgentProfile
This parameter controls whether to display the Agent Profile in the Agent Panel. If no showAgentProfile parameter is set, the default value of "false" is used.
It will not take effect when "topLayout=false&navigationStyle=none".
showAgentProfile=true
When navigationStyle=Left, the Agent Profile will display in the bottom left corner of the page.
When navigationStyle=TopLeft or navigationStyle=TopCenter or navigationStyle=TopRight, the Agent Profile will display in the top right corner of the page.
showAgentProfile=false
The Agent Profile will not be displayed in the Agent Panel.
Parameter: autoLogon
This parameter controls whether the Agent automatically logs into the CX system. It is usually used for ifram embedding.
autoLogon=true
The agent will be automatically logged into the CX system with the unique ID (userID).
autoLogon=false
By default, agents will not be automatically logged in to the CX system. Agents need to enter the necessary credentials on the login page to log in to the CX system.
Parameter: displayMode
Although we already have some personalized parameter configurations as above, it is still lengthy to use. For this reason, we have defined some parameter combination patterns to simplify user configuration and use.
For displayMode parameter, the autoLogon parameter will be hide and is true by default.
displayMode= ModeName
The parameter combinations represented by this mode are as follows:
AgentMode1 :autoLogon=true&topLayout=false&navigationStyle=TopLeft AgentMode5 :autoLogon=true&topLayout=false&navigationStyle=left&showAgentProfile=true InboxMode1 :autoLogon=true&isTicket=true
AgentMode1
AgentMode5
InboxMode1
Example URL:
https://domain/#/agentConsole/message?includeWs=true&company=cloudfon&userId=2&displayMode=AgentMode5 convert to https://domain/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=left&showAgentProfile=true
Parameter: lang
This parameter sets the default language used for the Agent Panel.
Value Range
Value: en, fr, pt, es, it
en--English
fr--French
pt--Portuguese
es--Spanish
it--Italian
Example
https://domain/#/agentConsole/message?includeWs=true&company=cloudfon&userId=2&displayMode=AgentMode5&lang=en
Iframe Permission Parameter
For an iframe, when the child page wants to access the resources of the parent page, the corresponding permissions need to be set. If the permissions are not set, some functions will not work properly on the child page. Here are several common permissions:
Permissions | CX Usage | Description |
camera | Used for Video Chat | Allows the embedded content to access the camera. |
microphone | Used for WhatsApp Audio msg | Allows the embedded content to access the microphone. |
geolocation | Used for remote login reminder. | Allows the embedded content to access geolocation. |
clipboard-write | Used for all channels | Allows writing to the clipboard. |
autoplay | Option | Allows media to autoplay. |
encrypted-media | Option | Allows the use of encrypted media. |
fullscreen | Option | Allows the iframe to enter fullscreen mode. |
picture-in-picture | Option | Allows video to be played in picture-in-picture mode. |
screen-wake-lock | Option | Allows preventing the device from sleeping. |
storage-access-api | Option | Allows access to third-party storage. |
usb | Option | Allows access to USB devices. |
Here is an example of the 'allow' parameter usage:
<iframe src="https://example.com/#/agentConsole/message?includeWs=true&topLayout=false&navigationStyle=TopLeft&company=Example&userId=123456789&showAgentProfile=false&autoLogon=true&lang=es" width="100%" height="1000px" frameborder="0" allow="geolocation; microphone; camera; encrypted-media; clipboard-write; autoplay"> </iframe>