Domain-based access control ensures security while also allowing you to define and control which domains can display the Contact Center AI Platform (CCAI Platform) agent adapter.
Specify a domain
The format for specifying a domain can be any valid domain name, and can include
a wildcard (*) to match an arbitrary number of subdomains. The wildcard must be
placed at the beginning of the domain, and it will match any subdomains.
Additionally, you have the option to specify a protocol and a port using the
syntax <protocol>://<domain>:<port>
.
The port can be a wildcard, but the protocol cannot be a wildcard. If a protocol is specified, it will match only that protocol and all other protocols won't be able to display the adapter.
For example:
https://some.example.domain.com
won't match http://some.example.domain.com
or mail://some.example.domain.com
.
Add domains in developer settings
In the CCAI Platform portal, go to Developer Settings > Agent Adapter-Domain Based Access Control.
Enter each domain on a new line. Format is
*.domain
. If no domains are specified, access is granted to all domains.For example,
*.mycompany.com
.
CRM specific domains
Use the following domain naming conventions when entering your CRM domain. If you don't include all of these domains for a specific CRM, the Agent Adapter will immediately break.
Salesforce:
*.visualforce.com
*.force.com
*.salesforce.com
Zendesk:
*.zdusercontent.com
*.zendesk.com
Microsoft Dynamics:
*.crm.dynamics.com
Kustomer:
*.kustomerapp.com
HubSpot:
*.hubspot
Reload frame on the agent adapter
If the agent adapter is not visible to agents after making administrator configuration changes, the agent must right click over the agent adapter and then select the Reload Frame operation.