| Table of Contents | ||
|---|---|---|
|
...
Overview
There are three different integrations between Genesys Cloud and eMite - Application, Data, and Users.
The Application Integrationdescribes the configuration of eMite as an App within Genesys Cloud and shared user authentication for SSO functionality.
The Data Integration describes the configuration of OAuth credentials within Genesys Cloud for access to Genesys Cloud APIs and Notification Service.
The Users Integration describes the configuration of Genesys Cloud groups for shared permissions and data visibility within eMite.
...
Custom Application Configuration
| Note |
|---|
This guide is intended for a Genesys Cloud Administrator and requires Admin privileges within Genesys Cloud. |
| Tip |
|---|
Integration Checkpoint All configuration items configured below must be sent to eMite using the Genesys Cloud Integration Details Form. |
...
Generic Integration Information
Genesys Cloud Region
Your Genesys Cloud region will determine the URLs used in the integrations between eMite and Genesys Cloud. If you do not know your region, please refer to your login URL to determine the corresponding region, as below:
Login Domain | Region Name | Region Code |
Asia Pacific (Sydney) | au | |
Asia Pacific (Tokyo) | jp | |
EMEA (Dublin) | eu | |
EMEA (Frankfurt) | eucentral | |
login.euw2.pure.cloud | EMEA (London) | uk |
Americas (US East) | useast | |
login.usw2.pure.cloud | Americas (US West) | uswest |
login.cac1.pure.cloud | Canada (Central Canada) | cnd |
login.mec1.pure.cloud | Middle East (UAE) | me |
Organization Short Name
The Organization short name is stored in the Account settings. It is a unique name which is used to identify the Genesys Cloud organization.
...
| Tip |
|---|
Generic Integration Checkpoint These details can now be sent to eMite:
|
...
Application Integration
The following processes are required to create an application integration within Genesys Cloud for eMite:
Genesys Cloud user group for application access
Application link in Genesys Cloud Apps menu
OAuth Client for SSO Authentication
...
Create Access Group
1. Select Admin from Genesys Cloud main menu.
...
5. Input the name of each user that you want to add to the group in the Add User field.
6. Click Save.
...
Create Custom Client Application
1. Select Admin from Genesys Cloud main menu.
...
Application URL: This will be in the format
https://<RegionCode>-cloud.emite.com/emite/<organizationShortName>/Auth/OAuthPureCloud?org=<organizationShortName>as defined in General Integration Information above.Application Type: select Standalone
Application Category: <blank>
Iframe Sandbox Options: allow-scripts, allow-same-origin, allow-forms, allow-modals, allow-popups, allow-downloads
Group Filtering: Add the emite_Access group created above
9. Click Save.
...
Create OAuth Client
1. Select Admin from Genesys Cloud main menu.
...
| Tip |
|---|
Application Integration Checkpoint These details can now be sent to eMite:
|
...
Data Integration
The following processes are required for data integration between Genesys Cloud and eMite:
Genesys Cloud Role for OAuth permissions
OAuth Client for API Polls (Historical data)
OAuth Client for Notification Subscription (Real-time data)
Optional OAuth Clients for WFM data
...
Create an eMite Adapter Role
1. Log on to Genesys Cloud and select Admin.
...
| Note |
|---|
Unless you have assigned the role to yourself, you will not be able to assign it to any OAuth later in the process. |
...
Create OAuth Client for API Integration (Historical Data)
1. Select Admin from the Genesys Cloud main menu.
...
| Tip |
|---|
Data Integration Checkpoint These details can now be sent to eMite:
|
...
OAuth Client for Genesys Cloud Channel Subscription (Real-time data)
1. Select Admin from the Genesys Cloud main menu.
...
| Tip |
|---|
Data Integration Checkpoint These details can now be sent to eMite:
|
...
OPTIONAL: OAuth Clients for Genesys Cloud WFM
These additional OAuth Clients are only required if your Organization is using Genesys Cloud WFM.
...
One additional OAuth for API Integration (i.e. Historical) - named emite_WFMLookback
One additional OAuth for Channel Subscription (i.e. Real-time) - named emite_WFMActivity
...
User Integration
Create Groups
1. Select Admin from Genesys Cloud main menu.
...
Note: Users that are added to the _DashboardCreator group will be able to create, edit, and share additional wallboards and dashboards in eMite.
...
Assign Users to Groups
1. Select Admin from Genesys Cloud main menu.
...
| Tip |
|---|
User Integration Checkpoint All configuration items configured above must be sent to eMite using the Genesys Cloud Integration Details Form.
|
...
Assign eMite Roles and Permissions
The eMite application onboards data for every agent in your Genesys Cloud Organization. It utilizes a data onboarding license which is tracked using the integration > emiteApps > View Genesys Cloud permission.
This means that every agent that eMite collects data for must have the integration > emiteApps > View permission assigned, no matter how many users actually access the eMite dashboards.
...
Americas (US East): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=mypurecloud.com
Americas (US West): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=usw2.pure.cloud
EMEA (Frankfurt): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=mypurecloud.de
EMEA (Dublin): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=mypurecloud.ie
Asia Pacific (Sydney): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=mypurecloud.com.au
Asia Pacific (Tokyo): https://em-prod-provision.emitecloud.com/provision/updatepermission.html?langTag=en-us&environment=mypurecloud.jp
...
Integration Checkpoint
| Tip |
|---|
Integration Checkpoint All configuration items configured above must be sent to eMite using the Genesys Cloud Integration Details Form. |