📘

Adding a Scope

When a scope is added to an OAuth client via Builder, it may take a few minutes for the scope to be effective.

The scope won’t be available instantly: a 401 error message is displayed when requesting a token.

Scopes on General Availability

Scopes constrain the endpoints to which you have access, and whether you have read or write access to an endpoint.

The scopes required for each API are also identified on the corresponding API individual page.

API

Scopes

Accounts API (information about a Talkdesk account)

account:read

Apps API (information about a specific installation of a partner app in a Talkdesk customer's instance)

apps:read

apps:write

Attributes API (allows the configuration of attributes and corresponding proficiency levels for each contact center agent)

attributes:read

attributes:write

Callback API (places a caller in queue without him having to wait on hold)

callback:write

Contacts API (allows getting and editing a contact's information)

contacts:read

contacts:write

Conversation Streams API

call-streaming-settings:read

call-streaming-settings:write

Do Not Call Lists (DNCL) API (allows retrieving, creating and modifying DNCL for Outbound Dialer)

do-not-call-lists:manage

Explore API (provides historical data reports)

data-reports:write

data-reports:read

Events API (exposes events that happen inside Talkdesk as webhook calls, allowing to subscribe to events around an app's lifecycle)

events:write

Flows API (starts an interaction that executes the published version of a given Studio flow)

flows-interactions:start

Guardian Cases API (allows access to the list of cases detected while analyzing Talkdesk platform agents' behavior)

guardian-cases:read

Guardian Sessions API (allows to easily access sessions’ data from the Talkdesk platform agents)

guardian-session:read

Guardian Users API (provides all the information Guardian has about the users of an account - name, role, ring groups, creation place, user activation and status)

guardian-users:read

Guardian Call Quality API - provides all the information Guardian has on the users’ call quality from the previous 30 days.

guardian-call-quality:read

Live API (provides live data in real-time)

live-queries:read

live-subscriptions:read

live-subscriptions:write

Phone Validation API

identity-phone-validation:read

Recordings API (allows recording conversations automatically)

recordings:read

Record Lists API (allows the creation, deletion and cataloging of record lists)

record-lists:manage

Reporting API (provides historical data reports)

reports:write

reports:read

Ring Groups API (facilitates the ring groups management)

ring-groups:read

user-ring-groups:read

Time Off API (allows importing agents' time-off information)

wfm-aion-public:write

Users API (information about users)

users:read

Voice Biometrics Opt-In API (allows the opt-in of contacts enrolled in voice biometrics)

voicebiometrics-consent:write

voicebiometrics-consent:read

Voice Biometrics Opt-Out API (allows the opt-out of contacts enrolled in voice biometrics)

voicebiometrics-enroll:write


Did this page help you?