Skip to main content
The @guildai-services/guildai~zendesk package gives your agents access to Zendesk support tickets and customer data through Guild’s Zendesk integration.

​
Authentication

  • Type: API token
  • Token management: API tokens do not expire

​
Setup

1

Open Credentials

Go to Credentials in Guild.
2

Connect Zendesk

Click Zendesk and enter your Zendesk subdomain (e.g. yourcompany), agent email address, and API token. Generate the token from Admin Center → Apps and Integrations → APIs → Zendesk API.

​
Usage

import { zendeskTools } from "@guildai-services/guildai~zendesk"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that manages Zendesk support tickets",
  tools: { ...zendeskTools },
})

​
Selecting specific tools

Tools are named with the zendesk_ prefix. Use pick() to include only what your agent needs. Commonly used tools include zendesk_list_tickets, zendesk_create_ticket, zendesk_update_ticket, and zendesk_search. 
import { zendeskTools } from "@guildai-services/guildai~zendesk"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that triages incoming support tickets",
  tools: {
    ...pick(zendeskTools, [
      "zendesk_list_tickets",
      "zendesk_create_ticket",
      "zendesk_update_ticket",
      "zendesk_search",
    ]),
  },
})