Zendesk

Overview

Customer support platform for managing tickets and service requests. Through Langdock’s integration, you can access and manage Zendesk directly from your conversations.

Authentication: OAuth Category: CRM & Customer Support Availability: All workspace plans

Available Actions

Get Article

zendesk.getArticle Gets a specific article from the Zendesk Help Center by ID

Requires Confirmation: No

Parameters:

• articleId (TEXT, Required): The unique identifier of the article to retrieve

Output: Returns the article details

---

Get Ticket

zendesk.getTicket Gets a specific ticket by ID with basic ticket information

Requires Confirmation: No

Parameters:

• ticketId (TEXT, Required): The unique identifier of the ticket to retrieve

Output: Returns the ticket details

---

Get Ticket Conversation Log

zendesk.getTicketConversationLog Gets a specific ticket by ID along with its complete conversation history and logs

Requires Confirmation: No

Parameters:

• ticketId (TEXT, Required): The unique identifier of the ticket to retrieve

Output: Returns the ticket with complete conversation history

---

Find Help Center Articles

zendesk.findHelpCenterArticles Find articles in the Zendesk Help Center

Requires Confirmation: No

Parameters:

• query (TEXT, Optional): Search for articles containing specific text

  • locales (TEXT, Optional): Filter results by language locale

  • categoryIds (TEXT, Optional): Limit results to articles within a specific category

  • sectionIds (TEXT, Optional): Limit results to articles within a specific section

  • tags (TEXT, Optional): Filter articles by their label names

  • updatedAfter (TEXT, Optional): Filter articles updated after this date

  • updatedBefore (TEXT, Optional): Filter articles updated before this date

  • sortBy (SELECT, Optional): Choose how to sort the article results

  • sortOrder (SELECT, Optional): Choose the direction for sorting results

Output: Returns matching articles from the Help Center

---

Find tickets

zendesk.findtickets Finds existing tickets by searching

Requires Confirmation: No

Parameters:

• searchQuery (TEXT, Optional): A text string for full-text search across all searchable properties

  • sortOrder (SELECT, Optional): Sort order for results

  • sortBy (SELECT, Optional): Sorting parameter for returned results

Output: Returns matching tickets based on search criteria

---

Find users

zendesk.findusers Finds users in Zendesk based on a query string or external ID

Requires Confirmation: No

Parameters:

• query (TEXT, Optional): The search query to find users

  • externalId (TEXT, Optional): Search for a user by their external ID

  • page (TEXT, Optional): The page number for pagination

  • perPage (TEXT, Optional): The number of records to return per page

Output: Returns matching users

---

List users

zendesk.listusers Retrieves a list of users from Zendesk, with optional filtering by role, permission set, or external ID

Requires Confirmation: No

Parameters:

• role (SELECT, Optional): Filters the results by a single role

  • roles (TEXT, Optional): Filters the results by multiple roles

  • permissionSet (TEXT, Optional): For custom roles on Enterprise plan and above

  • externalId (TEXT, Optional): List users by external ID

  • page (TEXT, Optional): The page number for pagination

  • perPage (TEXT, Optional): The number of records to return per page

Output: Returns a list of users

---

Create Help Center Article

zendesk.createHelpCenterArticle Creates a new article in the Zendesk Help Center knowledge base

Requires Confirmation: Yes

Parameters:

• sectionId (TEXT, Required): The ID of the section where the article will be created

  • title (TEXT, Required): The title of the article

  • body (MULTI_LINE_TEXT, Required): The main content of the article in HTML format

  • locale (TEXT, Optional): The language/locale for the article

  • userSegmentId (TEXT, Optional): The ID of the user segment that can view this article

  • permissionGroupId (TEXT, Required): The ID of the permission group that can edit and publish this article

  • draft (SELECT, Optional): Whether the article should be created as a draft

  • promoted (SELECT, Optional): Whether the article should be promoted (featured)

  • position (TEXT, Optional): The position of this article within its section

  • commentsDisabled (SELECT, Optional): Whether to disable comments on this article

  • labelNames (TEXT, Optional): Labels/tags to associate with the article

  • contentTagIds (TEXT, Optional): Content tag IDs to attach to the article

  • authorId (TEXT, Optional): The ID of the user who should be credited as the article author

  • notifySubscribers (SELECT, Optional): Whether to send email notifications to article subscribers

Output: Returns the created article details

---

Create ticket

zendesk.createticket Creates a ticket in Zendesk

Requires Confirmation: Yes

Parameters:

• subject (TEXT, Required): The subject line of the ticket

  • description (TEXT, Required): The main body content of the ticket

  • isPublic (SELECT, Optional): Determines whether the comment is visible to the end-user/requester

  • priority (TEXT, Optional): The urgency level of the ticket

  • status (TEXT, Optional): The current state of the ticket in the support workflow

  • ticketType (TEXT, Optional): The category of the ticket

  • tags (TEXT, Optional): Labels applied to the ticket for categorization

  • customFields (TEXT, Optional): Additional ticket fields specific to the organization’s Zendesk configuration

  • requesterId (TEXT, Optional): The ID of the user who requested the ticket

  • assigneeId (TEXT, Optional): The ID of the agent the ticket should be assigned to

  • groupId (TEXT, Optional): The ID of the support group the ticket should be assigned to

Output: Returns the created ticket details

---

Update ticket

zendesk.updateticket Updates an existing Zendesk ticket with new information

Requires Confirmation: Yes

Parameters:

• ticketId (TEXT, Required): The ID of the ticket to update

  • status (SELECT, Optional): The new status of the ticket

  • customStatusId (TEXT, Optional): The ID of a custom status to apply to the ticket

  • priority (SELECT, Optional): The new priority level of the ticket

  • type (SELECT, Optional): The new type of the ticket

  • assigneeId (TEXT, Optional): The ID of the agent to assign the ticket to

  • groupId (TEXT, Optional): The ID of the support group to assign the ticket to

  • tags (TEXT, Optional): The new tags to apply to the ticket

  • customFields (TEXT, Optional): The new custom field values to apply to the ticket

  • comment (MULTI_LINE_TEXT, Optional): A comment to add to the ticket with this update

  • isPublic (SELECT, Optional): Determines whether the comment is visible to the end-user/requester

  • authorId (TEXT, Optional): The ID of the user who is adding the comment

Output: Returns the updated ticket details

---

Reply to ticket

zendesk.replytoticket Adds a comment/reply to an existing Zendesk ticket

Requires Confirmation: Yes

Parameters:

• ticketId (TEXT, Required): The ID of the ticket to reply to

  • comment (MULTI_LINE_TEXT, Required): The content of the reply/comment to add to the ticket

  • isPublic (SELECT, Optional): Determines whether the comment is visible to the end-user/requester

Output: Returns the reply comment details

---

Common Use Cases

• Data Management — Manage and organize your Zendesk data

• Automation — Automate workflows with Zendesk

• Reporting — Generate insights and reports

• Integration — Connect Zendesk with other tools

Best Practices

1

Getting Started

Enable the Zendesk integration in your workspace settings, authenticate using OAuth, and test the connection with a simple read operation. Then explore available actions for your use case.

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

Troubleshooting

Common issues and solutions

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

Support

For additional help with the Zendesk integration, contact [email protected]