El catálogo/Zendesk
Zendesk
app.zendesk
Manage tickets, users, organizations, and support workflows in Zendesk
Versión2.0.0
Categoríaother
AutenticaciónClave de API
Herramientas25
Transportestdio
LicenciaMIT
01
Qué hace
La aplicación, en sus propias palabras.
Zendesk support integration — manage tickets, users, organizations, views, groups, triggers, automations, attachments, webhooks, and satisfaction ratings via the Zendesk REST API v2 with rate limiting.
02
Herramientas
25 herramientas que el agente puede llamar.
Todas se declaran con parámetros tipados y devuelven resultados estructurados, así que el anfitrión puede renderizarlas en vez de narrarlas.
- add-comment-with-attachmentAdd a comment to a Zendesk ticket with file attachments. Uses upload tokens from upload-attachment. Returns the updated ticket. Params: ticketId, body, uploadTokens?, public?.
- add-ticket-commentAdd a comment to a Zendesk ticket. Can be public (customer-visible) or internal note. Returns the updated ticket. Params: ticketId, body, public?.
- create-organizationCreate a new Zendesk organization. Returns the created organization. Not retryable. Params: name, domainNames?, tags?.
- create-ticketCreate a new Zendesk ticket. Returns the created ticket. Not retryable (no idempotency key). Params: subject, description, requesterEmail?, priority?, status?, assigneeId?, tags?, customFields?.
- create-userCreate a new Zendesk user (end-user, agent, or admin). Returns the created user. Not retryable. Params: name, email, role?, phone?, organizationId?, tags?.
- delete-ticketDelete (soft-delete) a Zendesk ticket by ID. Returns { success, ticketId }.
- get-attachmentGet details of a Zendesk attachment by ID. Returns { id, fileName, contentUrl, size, contentType, createdAt }.
- get-organizationGet a single Zendesk organization by ID with full details including domain names and tags.
- get-ticketGet a single Zendesk ticket by ID with full details including description, custom fields, and tags.
- get-userGet a single Zendesk user by ID with full details.
- get-view-ticketsGet tickets from a specific Zendesk view. Returns curated ticket rows. Params: viewId, limit (1-100, def 30), page.
- list-automationsList Zendesk automations (time-based business rules). Read-only for agents. Returns curated rows { id, title, active, position, createdAt }.
- list-groupsList Zendesk groups (ticket assignment groups). Returns curated rows { id, name, default, createdAt }.
- list-organizationsList Zendesk organizations. Returns curated rows { id, name, domainNames, tags, createdAt }. Params: limit (1-100, def 30), page.
- list-satisfaction-ratingsList Zendesk satisfaction ratings (CSAT scores). Returns curated rows { id, score, comment, ticketId, requesterId, createdAt }. Params: score?, limit (1-100, def 30), page.
- list-ticket-commentsList all comments (public and internal notes) on a Zendesk ticket. Returns curated rows { id, authorId, body, public, createdAt }. Params: ticketId.
- list-ticketsList Zendesk tickets with optional filters. Returns curated rows { id, subject, status, priority, requester, assignee, createdAt, updatedAt }. Params: status?, priority?, assigneeId?, requesterId?, organizationId?, limit (1-100, def 30), page.
- list-triggersList Zendesk triggers (business rules that fire on ticket events). Read-only for agents. Returns curated rows { id, title, active, position, createdAt }.
- list-usersList Zendesk users with optional filters. Returns curated rows { id, name, email, role, active, createdAt }. Params: role?, query?, limit (1-100, def 30), page.
- list-viewsList Zendesk views (ticket filters). Returns curated rows { id, title, active, position, createdAt }.
- list-webhooksList Zendesk webhooks (HTTP endpoints that receive real-time event notifications). Returns curated rows { id, name, status, endpoint, createdAt }.
- search-ticketsSearch Zendesk tickets using Zendesk Search API. Supports query syntax (e.g. "status:open type:ticket", "assignee:me", "tags:urgent"). Returns curated results. Params: query, limit (1-100, def 30), page.
- update-ticketUpdate an existing Zendesk ticket. Only provided fields are changed. Returns the updated ticket. Params: ticketId, subject?, description?, priority?, status?, assigneeId?, tags?, customFields?.
- update-userUpdate an existing Zendesk user. Only provided fields are changed. Returns the updated user. Params: userId, name?, email?, role?, phone?, organizationId?, tags?, active?.
- upload-attachmentUpload a file attachment to Zendesk for use in ticket comments. Returns upload token. Params: filePath, fileName?.
03
Autenticación y permisos
Qué pide.
Declarado en el manifiesto y por adelantado. La aplicación no puede alcanzar nada que no haya pedido aquí.
Secretos de usuario
SUBDOMAINEMAILAPI_TOKEN
Seguir leyendo
El manifiesto y el código de Zendesk están en el monorepo, junto al resto de aplicaciones.