Saltar al contenido

Integración con Zendesk

Conecta Threada con Zendesk para la creación y actualización gobernada de tickets desde WorkItems, con una pista de auditoría completa.

Descripción general

La integración con Zendesk permite a Threada crear, actualizar y resolver registros de Zendesk como acciones gobernadas dentro de tus flujos de trabajo. Las credenciales con alcance definido aseguran que cada espacio de trabajo opera con los privilegios mínimos necesarios.

Capacidades

  • Crear registros Zendesk desde escalaciones de WorkItem con contexto completo
  • Actualizar tickets de Zendesk (estado, campos, etiquetas) desde acciones gobernadas de WorkItem
  • Mapear campos personalizados y etiquetas entre sistemas
  • Enrutar por prioridad, equipo y clasificación de políticas
  • Registro de auditoría para cada operación de Zendesk

Un ejemplo práctico

Un flujo de principio a fin que Threada ejecuta con Zendesk:

  1. Llega un ticket de Zendesk y se convierte en un WorkItem gobernado, normalizado en un esquema tipado con el ticket adjunto.
  2. Threada redacta una respuesta fundamentada en modo de citación estricta, o deriva el ticket a un responsable cuando la política exige una persona.
  3. Una respuesta o actualización aprobada se ejecuta como una acción gobernada de vuelta en Zendesk —con el estado, los campos y las etiquetas asignados— con idempotencia.
  4. Cada operación en Zendesk se ejecuta como una acción gobernada con idempotencia y queda registrada en la pista de auditoría inmutable del WorkItem.

Configuración

Configura la integración en Studio bajo la gobernanza del pack. Proporciona credenciales de API con alcance limitado y asigna campos al esquema de workflow. La conexión se valida antes de activarse.

  1. En Studio, añade la integración de Zendesk dentro de la gobernanza del paquete.
  2. Proporciona credenciales de la API de Zendesk con alcance limitado y acceso de privilegio mínimo.
  3. Asigna los campos, etiquetas y estados de Zendesk a tu esquema de WorkItem.
  4. Valida la conexión; la integración se activa solo después de que la prueba se complete con éxito.

Permisos y acceso a datos

Zendesk usa credenciales que tú proporcionas — no una app de OAuth alojada por Threada.

  • Threada se autentica con credenciales de la API de Zendesk con alcance limitado que tú proporcionas, almacenadas en Secret Manager.
  • Threada llama a la REST API de Zendesk (/api/v2/tickets.json) para crear y actualizar tickets; la sincronización entrante del estado de Zendesk de vuelta al WorkItem no es compatible hoy.
  • Cada operación sobre tickets se ejecuta como una acción gobernada y queda registrada en la pista de auditoría del WorkItem.

Preguntas frecuentes

¿Threada responde en Zendesk automáticamente?
Solo bajo política. Las respuestas y actualizaciones se ejecutan como acciones gobernadas, así que si se envían automáticamente o esperan a un aprobador lo decide tu capa de política. Cualquier cosa que no esté respaldada por evidencia se deriva a una persona en lugar de responderse.
¿Threada lee el estado de Zendesk de vuelta en el WorkItem?
Por ahora no. Threada escribe en Zendesk —creando y actualizando tickets como acciones gobernadas. La sincronización entrante del estado de Zendesk de vuelta al WorkItem no es compatible hoy; el WorkItem refleja las acciones que Threada ha realizado.
¿Qué acceso necesita la integración?
Credenciales de la API de Zendesk con alcance limitado y acceso de privilegio mínimo. La conexión se valida antes de activarse, y cada operación en Zendesk queda registrada en el registro de auditoría.