> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

> Software de atención al cliente para gestionar tickets, usuarios, organizaciones y adjuntos mediante tu cuenta conectada.

# Zendesk

Usa esta app cuando necesites trabajar con tickets, usuarios u organizaciones de Zendesk en un flujo de trabajo. Puedes listar, buscar, crear y actualizar registros desde tu cuenta conectada.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de Zendesk que se usará para este paso. |
| Action | Yes | La acción de Zendesk que se realizará (por ejemplo List Tickets, Search Zendesk, Create Ticket, List Ticket Audits). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Zendesk en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay una conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **List Tickets** | Lista tickets con filtrado y paginación. |
| **Search Zendesk** | Busca tickets, usuarios, organizaciones y grupos con sintaxis de consulta. |
| **Create Ticket** | Crea un ticket nuevo con un asunto y una descripción. |
| **List Ticket Audits** | Lista el historial de cambios de un ticket. |
| **Get Ticket Metrics** | Obtiene métricas de un ticket específico. |
| **Create Side Conversation** | Crea una conversación lateral privada en un ticket. |
| **Download Attachment** | Descarga los bytes del archivo de un adjunto de ticket. |
| **Get Attachment** | Recupera los detalles de un adjunto de ticket. |
| **List Users** | Lista usuarios con paginación. |
| **Get User** | Obtiene un solo usuario por ID numérica. |
| **List Organizations** | Lista todas las organizaciones de la cuenta. |
| **Reply to Zendesk Ticket** | Responde a un ticket de Zendesk añadiendo un comentario. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso guarda la respuesta de Zendesk como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Abre **Integrations** y conecta Zendesk si aún no lo has hecho.
2. Añade un paso de **Zendesk** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **List Tickets** en **Action**.
5. Rellena los campos requeridos. Usa **Insert Variable** para hacer referencia a la salida de un paso anterior para cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Use cases

### Create a ticket from a form

1. Create Ticket
2. List Tickets
3. Search Zendesk

### Follow up on a ticket

1. List Ticket Audits
2. Get Ticket Metrics
3. Make Comment Private

### Manage customer records

1. List Users
2. Get User
3. Create Or Update Organization

## Notes

* Este paso depende de una integración conectada de Zendesk en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta de Zendesk pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar marca de autorización de terceros.

## Using Zendesk as an Agent Tool

También puedes añadir Zendesk como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Zendesk**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a las acciones de Zendesk cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creación y edición](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Pruebas e iteración](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.