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 |
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 |
---|
All Outbound Permissions listed must be selected, even if your organization does not use outbound campaigns. |
# | Type | Permission Name | Permission Level |
---|---|---|---|
1 | Analytics | Conversation Detail | View |
2 | Analytics | Conversation Aggregate | View |
3 | Analytics | Conversation properties | All Permissions |
4 | Analytics | Evaluation Aggregate | View |
5 | Analytics | Queue Observation | View |
6 | Analytics | User Aggregate | View |
7 | Analytics | User Detail | View |
8 | Analytics | User observation | View |
9 | Authorization | Grant | View |
10 | Directory | User | View |
11 | Directory | User profile | View |
12 | Outbound | Campaign sequence | View |
13 | Outbound | Campaign | View |
14 | Outbound | Contact list | View |
15 | Outbound | Contact | View |
16 | Outbound | Response set | View |
17 | Outbound | Wrap up code mapping | View |
18 | Routing | Queue | View |
19 | Routing | Queue | Join |
20 | Routing | Queue | Search |
21 | Routing | Wrap up code | View |
22 | Quality | Evaluation Form | View |
23 | Quality | Evaluation | View |
24 | WFM | Agent | View |
25 | WFM | Agent | Edit |
26 | WFM | Historical Adherence | View |
27 | WFM | Realtime Adherence | View |
28 | WFM | Adhoc Forecast | View |
29 | WFM | Agent Schedule | View |
30 | WFM | Intraday | View |
31 | WFM | Agent Schedule Notification | View |
32 | WFM | Activity Code | View |
33 | WFM | Management Unit | View |
34 | WFM | Management Unit | Edit |
7. Add the newly created eMite Data Integration role to yourself.
...
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.
There are two different modules used by eMite to poll Workforce Management data in order to cover scheduling and adherence. This requires that two separate OAuth Clients are generated for use with WFM, as outlined in the previous 2 sections.
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.
It is a data onboarding license, rather than an application access license.
To make your agents compliant, please login to your Genesys Cloud org with administrative privileges. You need to have the ability to create roles, assign permissions to those roles, and assign those roles to users.
In There are currently two methods to add the eMite permission to all of your agents:
1) The Manual Method:
Create a division specific Role for each Division that is utilizing eMite, using the format eMite_DivisionName (if it does not already exist). In the example screenshot above, the role would be named eMite_Home.
Add the integration > emiteApps > View permission to the above role.
Assign the above role to all agents (Genesys Cloud 1, 2 or 3 users) in the division.
Repeat steps 1 to 3 for all remaining Divisions in your org that eMite is onboarding data for / providing reporting for.
Info |
---|
Please refer to the following instructions from Genesys on how to create roles, assign permissions and assign roles to users:
|
2) The Automated Method:
Note |
---|
Note: The Automated Method is only supported in 6 out of 12 Genesys Cloud regions. If your Genesys Cloud Org is not within one of these regions, please use the manual method to assign the eMite permission to your agents. You can check your region based on your corresponding login URL, here: https://help.mypurecloud.com/articles/aws-regions-for-purecloud-deployment/. |
Login to your Genesys Cloud org with administrative privileges. You need to have the ability to create roles, assign permissions to those roles, and assign those roles to users within each division.
In another browser tab, open one of the following links based on your Genesys Cloud org
...
region: (You can check your region based on your corresponding login URL, here: https://help.mypurecloud.com/articles/aws-regions-for-purecloud-deployment/ )
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. |