Configuration for SDK Only Integrations

To configure SDK only integrations, follow the steps in this section:

1. Click Menu on the home page.

   

2. Navigate to the IT and Integrations section. Expand the section and click Integrations.

3. Click Add integration in the integrations page, and the list of integrations is displayed.

   

4. Navigate to the Client Application integration tab and click Install. The Details tab will be displayed.

   Note:

   You can also search using the search option.

5. Enter the following information in the Details tab:

   1. In the Integration Name field, enter the name of the client application. This is a mandatory field.

   2. In the Notes field, enter the additional information on the client application. This is optional.

   

6. Click Save.

7. Navigate to the Configuration tab and click the Properties section.

   

8. Enter the following client application properties in the Properties section,

   1. In the Application URL field, enter the layout URL that was created in the configurator section of the Workspace Admin application. This is a mandatory field.

   2. In the Application type field, select the default type as Standalone. This is a mandatory field.

   3. In the Application Category field, select the type of behavior for the client application.

   4. In the Iframe Sandbox Options field, enter the list of limited HTML5 sandbox options separated by commas if applicable.

   5. In the Iframe Feature/Permissions Policy field, enter the list of features or permissions to control the client application.

      Note:

      Avoid adding unnecessary permissions to prevent potential security issues.

   6. In the Group Filtering field, enter the list of groups whose members can see this specific application. If no group is specified, it is hidden from the members.

9. Click Save and navigate back to the Details tab.

   

10. Activate the client application using the Active toggle button.

11. You can also click Save & Activate to save all the changes and activate the client application. Click Cancel to undo all the changes.

12. To remove the added client application, click Uninstall Integration.

13. The integration created is displayed on the Integrations page.

OAuth Configurations for SDK Integrations

OAuth (Open Authorization) in the Genesys Console app allows administrators to create and manage OAuth clients to securely authenticate and authorize third-party or internal application integrations with Genesys, without exposing user credentials.

To configure OAuth for SDK Integration, follow the steps in this section:

1. Navigate to the IT and Integrations section from the Menu option, expand it, and click OAuth. The OAuth page is displayed.

   

2. Click Add Client. The New OAuth Client page is displayed.

   

3. Complete the following fields to create a new client:

   1. In the App Name field, enter the name of the application. This is a mandatory field.

   2. In the Description field, enter a description for the client.

   3. In the Grant Types field, select the Token Implicit Grant (Browser) option. This is a mandatory field.

   4. Click Next to view the next step.

   

4. In the Token Duration in Seconds field, enter the token expiry time (in seconds) as required for the OAuth client. This is a mandatory field.

5. In the Authorized redirect URLs field, enter the Genesys Core URL. This is a mandatory field.

6. In the Scope field, enter the events subscribed from the Genesys SDK. This is a mandatory field.

   The mandatory event details that must be added for the application to work are listed below:

   • conversations

   • conversations:readonly

   • notifications

   • outbound:readonly

   • presence:readonly

7. Click Save to save all the changes. You can also click Back to navigate to the previous step. Click Cancel to undo the changes.

8. The client created is displayed on the OAuth page. You can edit the client by clicking the name of the Client application or by clicking the Actions option.