Before you start
You need have access to Talkdesk's Developer Portal and ServiceNow environment to configure this integration.
In addition, to ensure that Plecto receives your data, you need to define scopes in Talkdesk before you connect it to Plecto. Read more about scopes in Talkdesk's developer documentation.
Step 1: Add scopes in Talkdesk Developer Portal
A scope limits the endpoints to which a client has access. It also determines whether a client has read or write access to an endpoint. Our integration with Talkdesk requires you to add scopes in Talkdesk's Developer Portal before you can connect your Talkdesk account to Plecto.
Go to the Talkdesk Developer Portal and sign in.
Navigate to the OAuth Clients tab. Here you should see your company name.
Click to edit your company's client profile and add scopes. Here's a list of scopes that need to be added to each of the data types. Find Talkdesk's documentation on scopes here.
Calls: This data type is fetched from Explore API and requires the following scopes:
data-reports:write
data-reports:read
User Status: This data type is fetched from Explore API and requires the following scopes:
data-reports:write
data-reports:read
Real-time Metrics: This data type is fetched from Live API and it needs the following scopes:
live-queries:read
live-subscriptions:read
live-subscriptions:write
Step 2: Get your Talkdesk credentials from ServiceNow
What do I need?
Client ID
Client Secret
You can obtain the Client ID and Client Secret from your ServiceNow environment:
Log in to ServiceNow and navigate to System OAuth > Application Registry > Talkdesk.
Click on the word "here" in the info message at the top of the page. The message is similar to the following: "This record is in the Talkdesk application, but [Name] is the current application. To edit this record click here."
You can now see both the Client ID and Client Secret under the application name. To copy the Client Secret, click on the lock icon next to it.
You will have to use these credentials to integrate Talkdesk with Plecto.
Step 3: Create Talkdesk data sources in Plecto
Go to Data sources > New data source > Talkdesk.
You will be asked to provide the following details:
Client ID and Client Secret: Copy the information from your ServiceNow environment.
Domain: Provide the full domain, for example:
examplecompany.talkdeskid.com
You can find it in the URL when logged in Talkdesk.Time zone
Click Next to continue.
Select the data you want to import.
Configure your data source settings. Here, you can change the title, choose the default date, select which fields to import, and more.
Click Next to choose how much data to import and how long you want to keep it in the data source.
Click Import to finish.
Available data types
We offer three data types that you can import from Talkdesk to Plecto. For each data type you add, Plecto will create one data source.
Here are all the data types you can currently import from Talkdesk to Plecto:
Calls
User Status
Realtime Metrics: This data type allows you to stream ready-made KPIs on Plecto dashboards directly from Talkdesk by using Live API. This data type is only available per request. Please contact our support team if you'd like us to enable it for you.