TalkDesk Configuration Requirements

Authenticx integrates with TalkDesk to pull call recordings and metadata into our systems using APIs. We connect using an OAuth 2.0 Client Credentials application, which allows us to access call data securely without requiring a named user login.

Authenticx | NiceCX DEVone Application Process

APIs and Endpoints Used

  • Explore API - Retrieve call metadata (agent name, call direction, duration, team, etc.)
  • Recordings API - Access call recordings for processing

Step 1: Create an OAuth Client in TalkDesk

Authenticx connects to TalkDesk using a set of API credentials called an OAuth Client. You will need to create one in your TalkDesk Admin portal.

  1. Log in to your TalkDesk account as an Administrator.
  2. Navigate to AdminIntegrationsOAuth Clients (the exact menu path may vary slightly depending on your TalkDesk version — if you can't find it, search for "OAuth" in the admin search bar).
  3. Click Create OAuth Client (or similar button).
  4. Fill in the form:
    • OAuth Client Name: Something descriptive, e.g. Authenticx Integration
    • Description (if prompted): Third-party access for Authenticx call processing
    • Grant Type: Select Client Credentials
  5. For Scopes, enable the following:
    • data-reports:read
    • data-reports:write
    • recordings:read
    • users:read
    • queues:read
  6. Click the Create button to save the client.

Once saved, TalkDesk will generate a Client ID and Client Secret. Copy these values immediately - the Client Secret is typically only shown once.

🏁

Deliverable: client_id and client_secret, please share them securely with the Authenticx onboarding team.


Step 2: Confirm Reporting and Recording Permissions

For Authenticx to retrieve call data, the OAuth client must have access to your call reports and recordings. In most TalkDesk configurations this is granted automatically by the recordings:read scope, but please confirm the following with your TalkDesk Administrator:

  • Call recordings are enabled and stored for the agents/teams you want Authenticx to process.
  • The Explore Reports feature (sometimes called Talkdesk Explore) is enabled on your account.
⚠️

Note:

If recordings are only retained for a limited period (e.g. 30 days), let your Authenticx onboarding team know so we can set up the integration accordingly.


Step 3: Provide Credentials to Authenticx (Securely)

Please provide the following to your Authenticx onboarding contact:

ItemSource
Client IDOauth Client (Step 1)
Client SecretOauth Client (Step 1)
TalkDesk DomainYour TalkDesk account name (e.g. https://YOURDOMAIN.talkdeskid.com)

⚠️

Note:

Never send credentials over email in plain text. Your Authenticx onboarding contact will provide you with a secure method for sharing these values (e.g. an encrypted form or secure file share).



Did this page help you?