Compartilhar via


Talkdesk (Preview)

Talkdesk provides a better way for organizations to intelligently unlock the promise and potential of great customer experience with end-to-end cloud solutions. Connect to other external systems already supported by Microsoft to be able to execute actions in Talkdesk like create an agent, create a callback, get a user by email, etc. or trigger your own flows when a contact is created/updated, note is created, inbound call starts, etc. in Talkdesk.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Talkdesk Support
URL https://support.talkdesk.com/
Email support@talkdesk.com
Connector Metadata
Publisher Talkdesk
Website https://www.talkdesk.com/
Privacy policy https://www.talkdesk.com/terms-of-service/privacy-policy/
Categories Communication;Sales and CRM

The Talkdesk connector provides a better way for organizations to intelligently unlock the promise and potential of great customer experience with end-to-end cloud solutions. Connect to other external systems already supported by Microsoft(within Power Apps and Power Automate) to be able to execute actions in Talkdesk like create an agent, create a callback, get a user by email, etc. or trigger your own flows when a contact is created/updated, note is created, inbound call starts, etc. in Talkdesk.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Talkdesk account name string Enter Talkdesk account name True
Talkdesk Client Id string Enter Talkdesk Client Id True
Talkdesk Client Secret securestring Enter Talkdesk Client Secret True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create a callback

Create a new callback in Talkdesk.

Create a new agent (deprecated) [DEPRECATED]

Create a new agent in Talkdesk.

Create a new user

Create a new user in Talkdesk

Create a workspace notification (deprecated) [DEPRECATED]

Create a new workspace notification in Talkdesk.

Get account configured custom status used by agents [DEPRECATED]

Get account configured custom status used by agents in Talkdesk (deprecated).

Get contact by Id

Get contact by Id from Talkdesk.

Get user by email

Get user by email from Talkdesk.

Get user presence (deprecated) [DEPRECATED]

Get user presence in Talkdesk.

Get user status [DEPRECATED]

Get user status in Talkdesk (deprecated).

Suscribe presence for all users (deprecated) [DEPRECATED]

Subscribe to the presence of all users from the authenticated account. This actions has to be used before UpdateUserStatus action.

Update user status [DEPRECATED]

Update user status in Talkdesk (deprecated).

Create a callback

Create a new callback in Talkdesk.

Parameters

Name Key Required Type Description
Talkdesk phone number
talkdesk_phone_number True string

The E.164 compliant phone number that will receive the call.

Contact phone number
contact_phone_number True string

The E.164 compliant phone number of the contact requesting the callback.

Name
name string

Identifier for the field, in the scope of the entire context.

Display name
display_name string

The field name as it is shown to the user

Tooltip text
tooltip_text string

A tooltip regarding the field, shown to the user

Data type
data_type string

Data_type of an enumeration of possible values (these enums can imply validation of the 'value' field and detailed error responses will be provided for the fields we discard).

Value
value string

Field value

Returns

Name Path Type Description
Success
code boolean

Response message.

Create a new agent (deprecated) [DEPRECATED]

Create a new agent in Talkdesk.

Parameters

Name Key Required Type Description
Active
active boolean

A boolean whether the agent is active or not.

Active
active boolean

A boolean whether after call work is enabled or not for the agent.

Timeout
timeout string

A timeout in seconds.

Show
show boolean

A boolean whether the inbound dispositions codes are to be shown or not.

Show
show boolean

A boolean whether the outbound dispositions codes are to be shown or not.

Agent ivr enabled
agent_ivr_enabled boolean

A boolean whether agent's ivr is enabled or not.

Email
email True string

Agent's email.

Extension number
extension_number string

Agent's extension number following the /\A\d+\z/ regex format.

Full name
full_name True string

Agent's full name.

Enabled
enabled boolean

A boolean whether the mood settings are enabled or not.

outbound_caller_id
outbound_caller_id string

Outbound caller id for the agent. (>= 5 characters,<= 40 characters)

Outbound caller id selection enabled
outbound_caller_id_selection_enabled boolean

A boolean whether the outbound caller id selection is enabled or not.

Phone number
phone_number string

The phone number associated to the agent. (>= 5 characters,<= 40 characters)

Role name
role_name True string

Agent's role.

Returns

Name Path Type Description
Success
success array of object

An array of successful agent creations.

Id
success.id string

The id of the successfully created agent.

Email
success.email string

The email of the successfully created agent.

Failure
failure array of object

An array of unsuccessful agent creations.

Email
failure.email string

The email of the unsuccessfully created agent.

Message
failure.message string

The error message resulted from the unsuccessful agent creation.

Create a new user

Create a new user in Talkdesk

Parameters

Name Key Required Type Description
Active
active True boolean

The user's administrative status.

ExternalId
externalId string

The user's external identifier.

FamilyName
familyName True string

The family name of the User, or Last Name in most Western languages (for example, Jensen given the full name Ms. Barbara J Jensen, III.)

GivenName
givenName True string

The given name of the User, or First Name in most Western languages.

schemas
schemas True array of string

URN schemas for User resource.

RolesString
rolesString string

A list of roles for the user that collectively represent who the user is separated by semicolons, e.g., 'Student;Faculty'.

TeamsString
teamsString string

The user's team list separated by semicolons.

UserName
userName True string

The user's email.

Returns

Name Path Type Description
Active
active boolean

The user's administrative status.

ExternalId
externalId string

The external id for the user.

Id
id string

The ID for the object. Immutable.

Created
meta.created string

Date and time the resource was created.

LastModified
meta.lastModified string

Date and time the resource was last modified.

Location
meta.location string

The location (URI) of the resource.

ResourceType
meta.resourceType string

The resource Type.

Version
meta.version string

The version of the resource.

FamilyName
name.familyName string

The family name of the User, or Last Name in most Western languages (for example, Jensen given the full name Ms. Barbara J Jensen, III.).

GivenName
name.givenName string

The given name of the User, or First Name in most Western languages.

Schemas
schemas array of string

URN schemas for User resource.

RolesString
urn:ietf:params:scim:schemas:extension:talkdesk:2.0:User.rolesString string

A list of roles for the user that collectively represent who the user is separated by semicolons, e.g., 'Student;Faculty'.

TeamsString
urn:ietf:params:scim:schemas:extension:talkdesk:2.0:User.teamsString string

The user's team list separated by semicolons.

UserName
userName string

The user's email. Immutable.

Create a workspace notification (deprecated) [DEPRECATED]

Create a new workspace notification in Talkdesk.

Parameters

Name Key Required Type Description
Event id
eventID True string

Select the type of notification to trigger.

Dynamic list schema
dynamicListSchema dynamic

Details for the selected item.

Returns

The outputs of this operation are dynamic.

Get account configured custom status used by agents [DEPRECATED]

Get account configured custom status used by agents in Talkdesk (deprecated).

Returns

Name Path Type Description
Custom status
custom_status array of object

The list of the custom statuses.

Id
custom_status.id string

The id of the custom status.

Display name
custom_status.display_name string

The presentation name of the custom status.

Get contact by Id

Get contact by Id from Talkdesk.

Parameters

Name Key Required Type Description
Contact Id
contact_id True string

This is the id of the Talkdesk contact.

Returns

Name Path Type Description
Id
contact.id string

Contact ID.

Name
contact.name string

Contact name.

Company
contact.company string

Contact company.

Phones
contact.phones array of object

The list of the contact's phones.

Label
contact.phones.label string

Phone number label.

Number
contact.phones.number string

Phone number in E.164 format.

Get user by email

Get user by email from Talkdesk.

Parameters

Name Key Required Type Description
User email
email True string

User email for the query.

Returns

Name Path Type Description
Users
_embedded.users array of object

The user data.

Id
_embedded.users.id string

The Id of the user.

Email
_embedded.users.email string

The e-mail of the user.

Name
_embedded.users.name string

The name of the user.

Active
_embedded.users.active boolean

Ahe activation state of the user.

Gender
_embedded.users.gender string

The gender of the user.

Extension
_embedded.users.extension string

The phone extension for the user.

External phone number
_embedded.users.external_phone_number string

The external phone number for the user.

Created at
_embedded.users.created_at string

The date for the creation of the user.

Get user presence (deprecated) [DEPRECATED]

Get user presence in Talkdesk.

Parameters

Name Key Required Type Description
User id
id True string

The user id.

Returns

Name Path Type Description
Id
id string

A unique id for the event.

Account id
account_id string

The id of the account.

User id
user_id string

The ID of the user.

Status
status string

The user current status.

Custom status
custom_status string

The user current custom status.

Custom status id
custom_status_id string

The user current custom status id.

Occupancy
occupancy integer

The user occupancy level.

Channels
channels array of object

The list of channels available.

Name
channels.name string

The name of the channel.

Occupancy
channels.occupancy integer

The channel occupancy level.

Devices
channels.devices array of string

The list of devices available.

Devices
devices array of object

The list of devices available.

Id
devices.id string

The id of the device.

Interactions
interactions array of object

The list of ongoing interactions.

Id
interactions.id string

The id of the interaction.

Device id
interactions.device_id string

The id of the device.

Channel name
interactions.channel_name string

The name of the channel.

Cost
interactions.cost integer

The cost of the interaction.

Updated by
updated_by string

The resource that made the last update.

Updated at
updated_at string

The time the last status was updated.

Get user status [DEPRECATED]

Get user status in Talkdesk (deprecated).

Parameters

Name Key Required Type Description
user_ids
user_ids array of string

user_ids

Returns

Name Path Type Description
array of object
Status
status string

User's current status.

Id
id string

User ID.

Suscribe presence for all users (deprecated) [DEPRECATED]

Subscribe to the presence of all users from the authenticated account. This actions has to be used before UpdateUserStatus action.

Returns

Name Path Type Description
Url
url string

The url for the broker.

Username
username string

The username to access the broker.

Password
password string

The password to access the broker.

Client id
client_id string

The client identification to the broker.

Topic
topic string

The topic to subscribe.

Update user status [DEPRECATED]

Update user status in Talkdesk (deprecated).

Parameters

Name Key Required Type Description
User id
id True string

The user id.

Current status
current_status string

The (assumed) current user status. (only Available or Custom Busy)

New status
new_status string

The desired new user status. (only Available or Custom Busy)

Triggers

When a contact is created

When a contact is created.

When a contact is updated

When a contact is updated.

When a note is created

When a note is created.

When agent logs in

When agent logs in.

When agent logs out

When agent logs out.

When inbound call ends

When inbound call ends.

When inbound call reaches contact center

When inbound call reaches contact center.

When inbound call starts

When inbound call starts.

When outbound call ends

When outbound call ends.

When a contact is created

When a contact is created.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

When a contact is updated

When a contact is updated.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

When a note is created

When a note is created.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Note's title
title string

This is the title of the Talkdesk note.

Note's content
content string

This is the content of the Talkdesk note.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

When agent logs in

When agent logs in.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Agent id
agent_id string

This is the id of the Talkdesk agent.

Agent name
agent_name string

This is the name of the Talkdesk agent.

Agent email
agent_email string

This is the email of the Talkdesk agent.

Agent ringing groups
agent_tags string

This is are the ringing groups of the Talkdesk agent.

When agent logs out

When agent logs out.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Agent id
agent_id string

This is the id of the Talkdesk agent.

Agent name
agent_name string

This is the name of the Talkdesk agent.

Agent email
agent_email string

This is the email of the Talkdesk agent.

Agent ringing groups
agent_tags string

This is are the ringing groups of the Talkdesk agent.

When inbound call ends

When inbound call ends.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Call id
call_id string

This is the id of the Talkdesk call.

Interaction id
interaction_id string

This is the id of the Talkdesk interaction.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Interaction context id
interaction_context_id string

This is the interaction context id of the Talkdesk call.

Contact center number
talkdesk_phone_number string

This is the contact center number of the Talkdesk call.

Called number
contact_phone_number string

This is the called number of the Talkdesk call.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

VIP phone number
phone_vip string

This is the VIP phone number of the Talkdesk call.

Using IVR
phone_ivr string

This is the using IVR of the Talkdesk call.

Interaction type
interaction_type string

This is the interaction type of the Talkdesk call.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

Agent id
agent_id string

This is the id of the Talkdesk agent.

Total duration
total_duration string

This is the total duration of the Talkdesk call.

Call duration
duration string

This is the duration of the Talkdesk call.

Waiting time
waiting_time string

This is the waiting time of the Talkdesk call.

Holding time
hold_time string

This is the holding time of the Talkdesk call.

In business hours?
in_business_hours string

This is the in business hours of the Talkdesk call.

Recording URL
recording_url string

This is the recording URL of the Talkdesk call.

Hang up reason
hangup string

This is the hang up reason of the Talkdesk call.

Call start time
start_time string

This is the call start time of the Talkdesk call.

Call end time
timestamp string

This is the call end time of the Talkdesk call.

Launched by outbound dialer
proactive_outbound string

This is the launched by outbound dialer of the Talkdesk call.

Call ringing groups
tags string

This are the call ringing groups of the Talkdesk call.

Agent name
agent_name string

This is the name of the Talkdesk agent.

Agent email
agent_email string

This is the email of the Talkdesk agent.

Agent ringing groups
agent_tags string

This is are the ringing groups of the Talkdesk agent.

When inbound call reaches contact center

When inbound call reaches contact center.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Call id
call_id string

This is the id of the Talkdesk call.

Interaction id
interaction_id string

This is the id of the Talkdesk interaction.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Interaction context id
interaction_context_id string

This is the interaction context id of the Talkdesk call.

Contact center number
talkdesk_phone_number string

This is the contact center number of the Talkdesk call.

Called number
contact_phone_number string

This is the called number of the Talkdesk call.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

VIP phone number
phone_vip string

This is the VIP phone number of the Talkdesk call.

Using IVR
phone_ivr string

This is the using IVR of the Talkdesk call.

Interaction type
interaction_type string

This is the interaction type of the Talkdesk call.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

When inbound call starts

When inbound call starts.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Call id
call_id string

This is the id of the Talkdesk call.

Interaction id
interaction_id string

This is the id of the Talkdesk interaction.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Agent id
agent_id string

This is the id of the Talkdesk agent.

Called number
contact_phone_number string

This is the called number of the Talkdesk call.

Waiting time
waiting_time string

This is the waiting time of the Talkdesk call.

Interaction context id
interaction_context_id string

This is the interaction context id of the Talkdesk call.

Launched by outbound dialer
proactive_outbound string

This is the launched by outbound dialer of the Talkdesk call.

Call ringing groups
tags string

This are the call ringing groups of the Talkdesk call.

Contact center number
talkdesk_phone_number string

This is the contact center number of the Talkdesk call.

Is transfer?
is_transfer string

This is the is transfer of the Talkdesk call.

Agent name
agent_name string

This is the name of the Talkdesk agent.

Agent email
agent_email string

This is the email of the Talkdesk agent.

Agent ringing groups
agent_tags string

This is are the ringing groups of the Talkdesk agent.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

VIP phone number
phone_vip string

This is the VIP phone number of the Talkdesk call.

Using IVR
phone_ivr string

This is the using IVR of the Talkdesk call.

Interaction type
interaction_type string

This is the interaction type of the Talkdesk call.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.

When outbound call ends

When outbound call ends.

Returns

Name Path Type Description
Event name
event string

This is the name of the Talkdesk event.

Call id
call_id string

This is the id of the Talkdesk call.

Interaction id
interaction_id string

This is the id of the Talkdesk interaction.

Contact id
contact_id string

This is the id of the Talkdesk contact.

Account id
account_id string

This is the id of the Talkdesk account.

Agent id
agent_id string

This is the id of the Talkdesk agent.

Total duration
total_duration string

This is the total duration of the Talkdesk call.

Call duration
duration string

This is the duration of the Talkdesk call.

Waiting time
waiting_time string

This is the waiting time of the Talkdesk call.

Holding time
hold_time string

This is the holding time of the Talkdesk call.

Hang up reason
hangup string

This is the hang up reason of the Talkdesk call.

Launched by outbound dialer
proactive_outbound string

This is the launched by outbound dialer of the Talkdesk call.

Call ringing groups
tags string

This are the call ringing groups of the Talkdesk call.

Contact center number
talkdesk_phone_number string

This is the contact center number of the Talkdesk call.

Called number
contact_phone_number string

This is the called number of the Talkdesk call.

Agent name
agent_name string

This is the name of the Talkdesk agent.

Agent email
agent_email string

This is the email of the Talkdesk agent.

Agent ringing groups
agent_tags string

This is are the ringing groups of the Talkdesk agent.

Contact first name
contact_first_name string

This is the first name of the Talkdesk contact.

Contact last name
contact_last_name string

This is the last name of the Talkdesk contact.

Contact name
contact_name string

This is the name of the Talkdesk contact.

Contact email
contact_email string

This is the email of the Talkdesk contact.

Contact phone
contact_phone string

This is the phone of the Talkdesk contact.

Contact company
contact_company string

This is the company of the Talkdesk contact.

Contact title
contact_title string

This is the title of the Talkdesk contact.

Contact address
contact_address string

This is the address of the Talkdesk contact.

Contact website
contact_website string

This is the website of the Talkdesk contact.

VIP phone number
phone_vip string

This is the VIP phone number of the Talkdesk call.

Using IVR
phone_ivr string

This is the using IVR of the Talkdesk call.

Interaction type
interaction_type string

This is the interaction type of the Talkdesk call.

Account email
account_email string

This is the email of the Talkdesk account.

Account name
account_name string

This is the name of the Talkdesk account.