Granular Permissions Guide

Genesys Cloud API allows the creation of tenant accounts with finely tuned permissions and roles. This feature enables Authenticx to access only the data explicitly permitted by you.

To set up the OAuth client for sourcing conversations via the Genesys Cloud API, follow the steps outlined below. Ensure you have an Authenticx-specific role with the necessary permissions assigned to the appropriate divisions containing the queues you need to source.

OAuth Configuration

  1. Create an OAuth client in Genesys Cloud with the Client Credentials grant type for conversation sourcing.

Genesys API Endpoints and Role Permissions Required

1. Conversations API

  • Get /api/v2/Conversations

    • Required Permission:
      • Conversation > Communication > View
  • Post /api/v2/Analytics/Conversations/Details

    • Required Permissions:
      • Analytics > Conversation Detail > View
      • Analytics > Agent Conversation Detail > View

2. Recording API

  • Get /api/v2/conversations/{conversationId}/recordings

  • Post /api/v2/recording/batchrequests

  • Get /api/v2/recording/batchrequests/{jobId}

    • Required Permissions:
      • Recording > Annotation > View
      • Recording > Recording > View
      • Recording > Recording Segment > View
      • Recording > Screen Recording > View

3. Routing API

  • Get /api/v2/routing/queues

    • Required Permissions:
      • Routing > Queue > View

4. Users API

  • Get /api/v2/users/{userId}

    • Required Permissions:
      • None

Role Division Assignment

  • Ensure the Authenticx-specific role is granted permissions to the division(s) containing the queues that need to be sourced from Genesys Cloud.