Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Configure OAuth Client

The following permission is required to configure the OAuth client

  • OAuth > Client > Add permission

Steps to configure OAuth client 

  1. Click Admin.
  2. Under Integrations, click OAuth.
  3. Click Add Client. The Client Details tab appears.

    Client Details tab for OAuth client

  4. Set App Name to a descriptive name of the app.

    App Name is the name shown on the authorized OAuth client. 

  5. (Optional) Type a brief description of the app in the Description box.
  6. Set the duration of time until tokens created with this client expire.

    Accept the default duration, or enter a value between 300 and 172800 seconds. This duration sets the lifetime of the token to a maximum of two days or less.
    Tip: Genesys recommends setting the token duration to 18 hours (64800 seconds). This duration generally causes the token to expire outside an agent’s normal workday.

  7. Under Grant Types, select Implicit Grant (Browser).
  8. Under Authorized redirect URIs, add https://apps.mypurecloud.com/crm/index.html, customized according to the customer Genesys Cloud region.

  9. Under Scope, add all required scopes. 
  10. An OAuth client added to your Genesys Cloud organization (optional for some private versions) with the required scopes.


    • conversations
    • notifications
    • organization:readonly
    • outbound:readonly
    • presence
    • routing:readonly
    • scripts:readonly
    • stations:readonly
    • user-basic-info
    • users
    • voicemail
    • workforce-management
    • external-contacts:readonly
    • quality:readonly
  11. Click Save.
  12. A Client ID will be created that we use in the Framework.js file

...

PermissionRequired or optionalFeatureDescription
ACD Screen Share > Session > ViewOptionalScreen shareAllows an agent to screen share ACD interactions
Analytics > Conversation Aggregate > ViewOptionalEvaluationsAllows an agent to view released evaluations in the User Inbox.
Analytics > Conversation Aggregate > ViewOptionalStatisticsAllows an agent to see conversation statistics in the Agent Performance window.
Analytics > Queue Observation > ViewOptionalStatisticsAllows an agent to see statistics for a queue before contacting the queue or transferring an interaction to the queue.
Analytics > User Aggregate > ViewOptionalStatisticsAllows an agent to see user statistics in the Agent Performance window.
Cobrowse > Chat > EscalateOptionalCo-browseAllows an agent to use co-browse for chat interactions.
Cobrowse > Session > ViewOptionalCo-browseAllows an agent to use co-browse for voice or chat interactions.
Cobrowse > Voice > EscalateOptionalCo-browseAllows an agent to use co-browse for voice interactions.
Conversation > Call > RecordOptionalCall controlsCauses the Record icon to be clickable in the call controls in an agent’s client.
Conversation > Call Forwarding > EditOptionalCall forwardingAllows an agent to use and edit call forwarding.
Conversation > Callback > CreateOptionalCallbacksAllows an agent to schedule callbacks.
Conversation > Cobrowse > AddOptionalCo-browseAllows an agent to use co-browse for web messaging.
Conversation > Email > CreateOptionalEmailsAllows an agent to send emails on behalf of queues.
Conversation > Message > CreateOptionalSMS messagesAllows an agent to send SMS messages on behalf of queues.
Integration > Custom Embeddable Framework > Agent
RequiredCauses This causes the client to appear in a private deployment of a Genesys Cloud Embeddable Framework integration.
Outbound > Contact > ViewOptionalScreen popAllows an agent to see screen pops for outbound dialing.
Quality > Evaluation > Edit Agent Sign-offOptionalEvaluationsAllows an agent to view released evaluation notifications in the User Inbox.
Quality > Evaluation > Edit or Quality > Evaluation > Edit ScoreOptionalEvaluationsAllows a quality evaluator to view assigned evaluation notifications in the User Inbox.
Quality > Evaluation > ViewOptionalEvaluationsAllows an agent to view released evaluation notifications in the User Inbox.
Routing > Agent > On QueueOptionalStatusesCauses On Queue to appear as a status and a status timer to appear in an agent’s client.
Routing > Queue > JoinOptionalQueuesAllows an agent to see which queues the agent is a member of and to select which queues to receive interactions from in the client.
Scripter > Published Script > ViewOptionalScriptsAllows an agent to see a script.
Voicemail > Voicemail > ReceiveOptionalVoicemailsAllows an agent to receive personal voicemail notifications in the User Inbox.
Workforce Management > Agent Schedule > ViewOptionalSchedulingAllows an agent to view schedules in the client.
Workforce Management > Agent Shift Trade Request > ParticipateOptionalSchedulingAllows an agent to view shift trade request notifications in the User Inbox.
Workforce Management > Agent Time Off Request > SubmitOptionalSchedulingAllows an agent to access time off notifications in the client.
Workforce Management > Shift Trade Request > EditOptionalSchedulingAllows an administrator to view shift trade notifications in the User Inbox.

...

    • If we click in the last column the following options appear We can edit, Activate\Deactivate or delete the integration.
    • If we click on the delete option, a pop-up box will appear requiring the confirmation of the deletion.