/talkdesk | Type: Application | PCID required: Yes
Contact center agents, calls, queues, and recordings
Tools
| Tool | Description |
|---|---|
talkdesk_get_users | Get list of users in the Talkdesk account. Uses the Users API (users:read scope). |
talkdesk_get_user | Get detailed information about a specific user by ID. |
talkdesk_get_contact | Retrieve a contact by ID (returns single contact) or search by phone number (returns paginated list). |
talkdesk_request | Make a raw API request to any Talkdesk endpoint. Use when you need to call APIs not covered by the specialized tools (e.g. ring-groups, data/reports/calls/jobs, recordings). Provide the path (with optional query string) and HTTP method. Access is gated by the connection’s OAuth scopes - 401 means the token lacks the required scope for that path. Common paths: users, users/{id}, users/me, contacts, contacts/{id}, ring-groups, data/reports/calls/jobs, calls/{id}/recordings, recordings/{id}. |
talkdesk_get_users
Get list of users in the Talkdesk account. Uses the Users API (users:read scope). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | No | — | Page number (default 1) |
perPage | number | No | 20 | Results per page (1-200) |
active | boolean | No | — | Filter by activation status |
email | string | No | — | Filter by email address |
talkdesk_get_user
Get detailed information about a specific user by ID. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID to retrieve |
talkdesk_get_contact
Retrieve a contact by ID (returns single contact) or search by phone number (returns paginated list). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
contactId | string | No | — | Contact ID (returns single contact) |
phoneNumber | string | No | — | Phone number in E.164 format (returns paginated list) |
talkdesk_request
Make a raw API request to any Talkdesk endpoint. Use when you need to call APIs not covered by the specialized tools (e.g. ring-groups, data/reports/calls/jobs, recordings). Provide the path (with optional query string) and HTTP method. Access is gated by the connection’s OAuth scopes - 401 means the token lacks the required scope for that path. Common paths: users, users/{id}, users/me, contacts, contacts/{id}, ring-groups, data/reports/calls/jobs, calls/{id}/recordings, recordings/{id}. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
path | string | Yes | — | API path (e.g. users, users/123, ring-groups, data/reports/calls/jobs). Include query params in path if needed (e.g. users?page=2&per_page=10). |
method | string | No | "GET" | HTTP method |
body | object | No | — | Request body for POST/PUT (JSON object) |