Partner App Authentication

Access Token

An access token is the required string to make requests to the Talkdesk® APIs.

Once it is retrieved, it can be used to make requests to the Talkdesk APIs.

It must be used in the Authorization header of the HTTP calls to sign the request.

GET https://api.talkdeskapp.com/reports/calls/jobs/{id} HTTP/1.1
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

curl https://api.talkdeskapp.com/reports/calls/jobs/{id} \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-X GET

🚧

Token Expiration

For security purposes, access tokens are valid for 10 minutes. If a 401 unauthorized error is received, at any point, the Authentication page shows how to retrieve a new access token.

🚧

Region-Agnostic Access to the Talkdesk APIs

When using the Events API to get access to OAuth client credentials, you must make sure to use the value of the root link provided in the events (including app.installed) for the customer.
If you use a hard-coded value of a specific API Gateway, instead, the app will only work for customers using that region's infrastructure. In the example above, accessing the Explore API via https://api.talkdeskapp.com/ would only work for apps running in the US.

Authenticating via AppConnect

Talkdesk AppConnect™ is a marketplace that connects the user with contact center apps, devices and services. Each app operates with a one-click installation and a 30-day free trial. AppConnect apps leverage the Talkdesk authentication mechanisms to provide a fully integrated experience.

Each Talkdesk customer account and corresponding app installation are provided with a distinct set of API credentials:

• Client ID.
• Client secret.
• JWT key-value.

These credentials are leveraged to initiate:

• The Client Credentials grant type to access the Talkdesk API on behalf of the account (including Reporting API, Apps API, Users API, and Recordings API).
• The Authorization Code grant type to enable Talkdesk Single Sign-On. Combined with an authorization code linked to a specific user, it will allow retrieving an access token on behalf of an individual for authorized access to the partner app.

🚧

To validate Events API, from Talkdesk, that allows to subscribe to installation, update, trial expiration events, etc., the signing mechanism must be leveraged.

📘

Troubleshooting

If you have questions or technical issues, please open a ticket using this form.