Integración Zendesk n8nAutomatiza Zendesk con n8n.

Abre un ticket en Zendesk con datos que ya viajan por el flujo y devuelve el ticket creado con su identificador para los nodos siguientes.

• Description: el primer comentario del ticket y el único campo obligatorio. Suele venir del item entrante, por ejemplo {{ $json.message }}.
• Subject: está en Additional Fields, es opcional para la API pero es la línea que el agente lee en su cola.
• Type: Question, Incident, Problem o Task, lo que orienta la clasificación.
• Group Name or ID: el grupo al que se asigna el ticket.

Borra un ticket de forma definitiva. Zendesk guarda los tickets normales y los suspendidos en sitios distintos, por eso el nodo pregunta en qué montón buscar antes de eliminar nada.

• Ticket Type: Regular o Suspended. Equivocarse no devuelve nada que borrar, en lugar de borrar el ticket que no era.
• Ticket ID: el identificador numérico, no el asunto, muchas veces arrastrado como {{ $json.id }}.

Lee un ticket y devuelve su contenido completo: estado, solicitante, grupo, etiquetas y valores de los campos personalizados, disponibles en JSON para el resto del flujo.

• Ticket Type: Regular para la cola activa, Suspended para revisar un mensaje retenido antes de decidir qué hacer con él.
• Ticket ID: el identificador del ticket que se lee, normalmente el que acaba de entregar el trigger.

Lista tickets en bloque y acepta la sintaxis de búsqueda de Zendesk, lo que la convierte en la operación de reporting del nodo.

• Ticket Type: obligatorio, y cambia todo el conjunto de resultados.
• Return All: activado, n8n recorre todas las páginas; desactivado, Limit pone el techo de tickets devueltos.
• Query: en Options, la cadena de búsqueda de Zendesk que acota la lista.
• Status y Group Name or ID: filtran por estado o por equipo.
• Sort By y Sort Order: orden por Created At, Priority, Status o Updated At, ascendente o descendente.

Devuelve un ticket suspendido a la cola normal, donde vuelve a ser un ticket como cualquier otro: se asigna, se responde y se cierra.

• Suspended Ticket ID: el identificador de la lista de suspendidos, que no es el que llevará el ticket una vez recuperado.

Aplica cambios a un ticket que ya existe, desde un cambio de estado de una palabra hasta una respuesta pública redactada por otro nodo.

• Ticket ID: obligatorio, el ticket afectado.
• Public Reply: la respuesta que ve el solicitante. Internal Note queda entre agentes y acepta HTML.
• Status: New, Open, Pending, On-Hold, Solved o Closed.
• Assignee Email: entrega el ticket a un agente por su dirección.
• Tag Names or IDs: ojo, Zendesk reemplaza la lista entera de etiquetas, así que la que no viaje en la llamada se pierde. Lee el ticket y fusiona antes.

Devuelve la definición de un campo de ticket: su título, su tipo y, si es un desplegable, los valores de opción que Zendesk acepta.

• Ticket Field ID: el identificador numérico del campo, visible en la URL de administración de ese campo.

Lista los campos de sistema y los personalizados en una sola llamada, la vía más rápida para descubrir qué guarda realmente una instancia de Zendesk en cada ticket.

• Return All: activado para el catálogo completo de campos; desactivado, Limit corta la lista antes.

Añade una persona a Zendesk como usuario final, agente o admin, y devuelve la ficha con el identificador que se reutiliza en todo lo demás.

• Name: el único campo obligatorio, el nombre que se muestra.
• Email: la dirección principal, en Additional Fields, la que Zendesk usa para enlazar el correo entrante.
• Role: End User, Agent o Admin.
• Organization Name or ID: la organización por defecto de esa persona.
• Verified: activado, Zendesk da la identidad por confirmada y no manda el correo de verificación.

Quita a una persona de Zendesk. Sus tickets siguen ahí, la ficha desaparece: esta operación va al final de un flujo, nunca en medio.

• User ID: el identificador numérico de la ficha, obtenido con una búsqueda previa y no escrito a mano.

Lee una ficha y devuelve todo lo que contiene: rol, organización, etiquetas, idioma, notas y campos de usuario personalizados.

• User ID: el identificador de la ficha que se lee, a menudo {{ $json.requester_id }} tomado de un ticket.

Lista los usuarios de la cuenta, con filtro por rol cuando solo interesa una parte del directorio.

• Return All: activado para recorrer el directorio entero; desactivado, Limit fija el máximo.
• Roles: en Filters, conserva End User, Agent, Admin o cualquier combinación de los tres.

Devuelve las organizaciones a las que pertenece una persona. Zendesk permite varias pertenencias por usuario, y esta operación las muestra todas, no solo la predeterminada.

• User ID: la ficha cuyas pertenencias se listan.

Trae los datos que Zendesk mantiene alrededor de una persona, es decir lo que rodea a la ficha en lugar de la ficha misma.

• User ID: la ficha que se inspecciona.

Encuentra personas sin conocer su identificador de Zendesk, que es la situación real de casi todos los flujos.

• Query: en Filters, texto libre comparado con el directorio, en la práctica una dirección de correo.
• External ID: el identificador de tu propio sistema, si se guardó en la ficha al crearla.
• Return All y Limit: controlan cuántas coincidencias vuelven, útil cuando una consulta abarca más de lo previsto.

Reescribe campos de una ficha existente, uno a uno o por lotes, y devuelve la ficha ya actualizada.

• User ID: obligatorio, la ficha que se edita.
• Email, Phone, Name: los datos de contacto, en Update Fields.
• Organization Name or ID: mueve a la persona a otra cuenta.
• Role y Ticket Restriction: cambian lo que puede hacer y qué tickets ve, entre Organization, Groups, Assigned y Requested.
• Suspended: activado, la persona no puede entrar y sus tickets también quedan suspendidos.

Devuelve cuántas organizaciones tiene la cuenta, como una cifra suelta y no como una lista. Es la llamada más ligera del nodo: nada que paginar, nada que filtrar.

Registra una empresa en Zendesk y la devuelve con su identificador, lista para colgar de ella usuarios y tickets.

• Name: obligatorio, y es la etiqueta por la que buscan los agentes.
• Domain Names: los dominios separados por comas. Zendesk los usa para asociar automáticamente los contactos nuevos a esta organización.
• Details y Notes: la dirección y el contexto que conviene leer antes de responder.
• Tag Names or IDs: las etiquetas de la organización, desde la lista o por identificador.

Elimina una organización de la cuenta. Sus miembros no se van con ella, simplemente se quedan sin empresa asociada.

• Organization ID: el identificador numérico de la ficha que se retira.

Lee una ficha de empresa y devuelve todo lo que guarda: dominios, notas, etiquetas y campos de organización personalizados.

• Organization ID: el identificador de la ficha que se lee, a menudo salido de user.getOrganizations antes en el flujo.

Lista las empresas de la cuenta, que es como un sistema externo consigue la foto completa del parque de clientes en Zendesk.

• Return All: activado, se recuperan todas las páginas de organizaciones; desactivado, Limit decide dónde se corta la lista.

Trae los datos relacionados que Zendesk mantiene alrededor de una empresa, en lugar de la ficha de la empresa en sí.

• Organization ID: la empresa que se inspecciona.

Edita una ficha de empresa en su sitio, lo que mantiene los tickets y las pertenencias mientras cambian los detalles.

• Organization ID: obligatorio, la ficha que se edita.
• Name: en Update Fields, para un cambio de marca o una errata corregida.
• Domain Names: la lista de dominios separados por comas, que conviene actualizar cuando una empresa añade un segundo.
• Notes y Details: el contexto que leen los agentes antes de responder.
• Tag Names or IDs: las etiquetas que lleva la organización.