Ir al contenido principal

Integración con Zendesk - Guía de configuración

Conecta tu cuenta de Zendesk a Goodweek para gestionar tickets de soporte, organizaciones, usuarios, macros y vistas directamente desde tu espacio de trabajo de IA.

A
Escrito por Antoine Stempien

Conecta tu cuenta de Zendesk a Goodweek para gestionar tickets de soporte, organizaciones, usuarios, macros y vistas directamente desde tu espacio de trabajo de IA.

ℹ️ Nota sobre gobernanza

Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Zendesk, garantizando la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.

📋 Requisitos previos

Antes de que cualquier usuario pueda ver y conectar la integración de Zendesk, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Configuración administrativa

La integración de Zendesk utiliza OAuth 2.0. El usuario que realiza la conexión debe tener el rol de Zendesk adecuado para autorizar aplicaciones de terceros. Se requiere acceso de nivel administrador para determinadas herramientas, como la configuración de disparadores, automatizaciones o campos personalizados.

Conexión del usuario

  1. En Goodweek, ve a Integraciones.

  2. Busca Zendesk y haz clic en Conectar.

  3. Se te pedirá que introduzcas tu subdominio de Zendesk (por ejemplo, yourcompany de yourcompany.zendesk.com).

  4. Serás redirigido a Zendesk, donde se te pedirá que inicies sesión y autorices el acceso.

  5. Haz clic en Permitir para conceder acceso y regresar a Goodweek.

Notas importantes

  • Cada usuario debe conectar su propia cuenta individualmente.

  • Goodweek solo puede acceder a los tickets, organizaciones y datos que tu cuenta individual de Zendesk tiene permiso para ver. Se aplican las restricciones de visibilidad del agente.

  • Algunas herramientas (disparadores, automatizaciones, campos personalizados, vistas) requieren el rol de administrador de Zendesk. Los agentes habituales no tendrán acceso a estas herramientas.

  • Puedes revocar el acceso de Goodweek en cualquier momento desde Zendesk → Centro de administración → Apps e integraciones → Conexiones → Composio → Revocar.


Herramientas disponibles

Herramienta

Descripción

Tipo

Create Zendesk Ticket

Crea un nuevo ticket de soporte en Zendesk con soporte completo para todos los campos del ticket.

Escritura

Create Many Zendesk Tickets

Crea hasta 100 tickets en una sola solicitud como tarea en segundo plano.

Escritura

Get Zendesk About Me

Recupera información sobre el usuario de Zendesk autenticado actualmente.

Lectura

Show Changes to Ticket

Muestra los cambios que resultarían en un ticket al aplicar una macro específica.

Lectura

Get Incremental Tickets

Recupera los tickets modificados desde una hora de inicio especificada para una sincronización incremental.

Lectura

List Deleted Tickets

Lista los tickets que se han eliminado de forma reversible (soft-delete) en Zendesk, mostrando hasta 100 por página.

Lectura

Create Zendesk Request

Crea una nueva solicitud de soporte de usuario final a través de la API.

Escritura

Create Side Conversation

Crea una conversación paralela privada en un ticket de Zendesk para la comunicación entre agentes.

Escritura

Upload Zendesk Attachment

Sube un archivo adjunto a Zendesk, devolviendo un token de adjunto para usarlo en los comentarios del ticket.

Escritura

Create Zendesk User

Crea un nuevo usuario (agente o usuario final) en Zendesk.

Escritura

Create Many Zendesk Users

Crea hasta 100 usuarios en una sola solicitud, gestionada de forma asíncrona.

Escritura

Create or Update User

Crea o actualiza un usuario de Zendesk según la coincidencia por email o external_id.

Escritura

Autocomplete Users

Busca usuarios de Zendesk por prefijo de nombre para una búsqueda rápida de usuarios.

Lectura

Get Incremental Users

Recupera los usuarios modificados desde una hora de inicio especificada para una sincronización incremental.

Lectura

Create Zendesk Organization

Crea una nueva organización en Zendesk.

Escritura

Get Zendesk Organizations

Lista todas las organizaciones en Zendesk con paginación.

Lectura

Create or Update Organization

Crea o actualiza una organización de Zendesk utilizando external_id como clave de coincidencia.

Escritura

Merge Zendesk Organizations

Combina dos organizaciones de Zendesk, uniendo usuarios, tickets y datos.

Escritura

Create Organization Membership

Asigna un usuario a una organización de Zendesk.

Escritura

Create Zendesk Group

Crea un nuevo grupo de agentes en Zendesk.

Escritura

List Assignable Groups

Lista todos los grupos que se pueden asignar a tickets o usuarios.

Lectura

List Group Users

Lista todos los usuarios que pertenecen a un grupo específico de Zendesk.

Lectura

Create Zendesk Group Membership

Asigna un agente a un grupo de Zendesk.

Escritura

List Macros

Lista todas las macros compartidas y personales de la cuenta de Zendesk.

Lectura

Show Macro

Recupera los detalles de una macro específica mediante su ID.

Lectura

Apply Zendesk Macro Preview

Muestra una vista previa de cómo una macro afectaría a un ticket sin aplicarla.

Lectura

Create View

Crea una nueva vista de tickets (filtro guardado) en Zendesk.

Escritura

Preview View

Muestra una vista previa de qué tickets cumplen un conjunto de condiciones de vista antes de guardarla.

Escritura

List Active Triggers

Lista todos los disparadores (triggers) de tickets activos en la cuenta de Zendesk.

Lectura

Create Trigger

Crea un nuevo disparador (trigger) de regla de negocio que actúa sobre los tickets que cumplen las condiciones especificadas.

Escritura

List Automations

Lista todas las automatizaciones configuradas en la cuenta de Zendesk.

Lectura

Create Automation

Crea una nueva automatización que realiza acciones sobre los tickets según condiciones basadas en el tiempo.

Escritura

List Brands

Lista todas las marcas configuradas en la cuenta de Zendesk.

Lectura

Create Ticket Field

Crea un nuevo campo de ticket personalizado con varios tipos de campo.

Escritura

Create Custom Object Record

Crea un nuevo registro para un tipo de objeto personalizado en Zendesk.

Escritura

Get Account Settings

Recupera la configuración de la cuenta de Zendesk y la configuración de funciones.

Lectura

Get Attachment

Recupera los detalles de un único adjunto de Zendesk mediante su ID.

Lectura

List Guide Surveys

Lista las encuestas CSAT disponibles en Zendesk Guide.

Lectura

List Guide Survey Responses

Lista las respuestas de las encuestas CSAT de Zendesk Guide.

Lectura

Delete Zendesk Ticket

Elimina permanentemente un ticket, incluido todo su historial de conversación. Esta acción es irreversible.

⚠️ Destructivo

Delete Zendesk User

Elimina permanentemente un usuario de Zendesk. Esta acción no se puede deshacer.

⚠️ Destructivo

Delete Zendesk Organization

Elimina permanentemente una organización de Zendesk. Esta acción es irreversible.

⚠️ Destructivo

Bulk Delete Zendesk Suspended Tickets

Elimina permanentemente varios tickets suspendidos en una sola acción.

⚠️ Destructivo

Casos de uso

  • Crea y gestiona tickets de soporte desde las conversaciones. Registra nuevos tickets de Zendesk con el asunto, la descripción, el solicitante y la prioridad correctos directamente desde una conversación de Goodweek, manteniendo las operaciones de soporte en el mismo contexto que el resto de tu trabajo.

  • Gestiona usuarios y organizaciones. Crea o actualiza usuarios y organizaciones de Zendesk, asigna usuarios a grupos y gestiona las membresías de organizaciones desde Goodweek para mantener precisa tu estructura de soporte.

  • Revisa macros y disparadores antes de aplicarlos. Previsualiza cómo afectarían a los tickets las macros o las condiciones de vista desde Goodweek antes de confirmar los cambios, reduciendo el riesgo de una configuración incorrecta accidental.

  • Supervisa el CSAT y las respuestas a encuestas. Recupera los resultados y las respuestas de las encuestas CSAT de Zendesk Guide dentro de una conversación de Goodweek para revisar los datos de satisfacción del cliente sin tener que navegar por el panel de Zendesk Explore.


Solución de problemas

Algunas herramientas no funcionan después de conectar

Ciertas herramientas de Zendesk requieren el rol de administrador. Si te conectas con una cuenta de agente, no podrás acceder a las herramientas de nivel administrador. Ponte en contacto con tu administrador de Zendesk para ajustar tu rol si es necesario.

La integración no es visible en Goodweek

Asegúrate de que el administrador de tu organización haya habilitado la integración de Zendesk desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Referencias

¿Ha quedado contestada tu pregunta?