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.

​

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

​

Best Practices

​

Troubleshooting

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 support@langdock.com