Required Genesys Information

In order to provide the integration between Knovvu Analytics and Genesys, the necessary information should be obtained from Genesys Cloud admin panel and entered into Knovvu Analytics' Genesys Integration Settings page.

Genesys information required for Knovvu Analytics can be shown below.

Creating a Role

1. As the first step you need to create a role with required permissions. Go to Admin page in your Genesys Cloud account.

2. Click on Add Role.

3. Give your Role a name you want (you may use Knovvu Analytics).

4. Click on Permissions tab. For the created role all Analytics, Conversation and Recording permissions should be given. Then click on Save.

Creating an OAuth Client

Next step is to create an OAuth client. In order for Genesys to generate a clientID and client secret, an oAuth client must first be created by the customer. And the role created in the previous step should be defined in the client.
5. Click on OAuth under Integrations.

6. Click on Add Client.
7. Give your oAuth client a name you want (you may use Knovvu Analytics). Select Grant type as Client Credentials.

8. Click on Roles tab.
9. Find the role you previously created and assign to the OAuth client and click on Save.

When you enter the OAuth client you created, you will see the ClientID and Client Secret values generated by Genesys, that shoul be entered into Knovvu Analytics.

Learning your OrganizationID

10. Click on Organization Setings under Account Settings.

11. You can see your Company Name, which is the Organization Name that needs to be entered into Knovvu Analytics. Click on Advanced to learn your Organization ID.

Creating a Group

Final step is to create a group in Genesys for Knovvu Analytics to access. The integration service will follow the events of the agents in this group. Therefore, the customer must first create a group, and then add the agents whose calls will be analyzed.

12. Click on Groups under Directory.

13. Click on Add General Group.
14. Give your group a name you want (you may use Knovvu Analytics-Agents). Select Type as Official, Visibility as Public and click on Save.

Genesys does not display GroupID in its interface. So the user must use Genesys APIs for this information.
15. Go to Genesys API Explorer.
16. Click on Account Selection and add your account as shown below. The user must select its Genesys region and then automatically login.

17. Use the related endpoint to get your Genesys groups' IDs: https://developer.genesys.cloud/devapps/api-explorer#get-api-v2-groups
18. Switch out of reading mode to execute a request.

19. Click on Execute Request.

20. In the response you get, you can see all your Genesys groups' entities. Find the ID of the group you previously created in the response as you can see below. This is the groupID that needs to be entered into Knovvu Analytics.