View a markdown version of this page

Integración con Zendesk Suite - Amazon Quick

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Integración con Zendesk Suite

Administre sus tickets de soporte de Zendesk directamente desde Amazon Quick utilizando un lenguaje natural. Con el conector de acción de Zendesk Suite, puede crear, actualizar, buscar y enumerar los tickets de soporte sin salir de Amazon Quick.

Zendesk Suite está disponible como conector integrado en Amazon Quick. Para configurar esta integración, complete los dos pasos siguientes. Primero, prepare su cuenta de Zendesk con el acceso requerido. A continuación, cree el conector en Amazon Quick y autentíquese con sus credenciales de Zendesk.

Este conector admite la autenticación de usuarios de OAuth y la autenticación del servicio de claves de API. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Requisitos previos

Antes de configurar la integración, compruebe que dispone de los siguientes recursos y accesos.

  • Una cuenta de Zendesk activa con un rol de administrador.

  • Permisos para acceder a los tickets y a los datos de soporte de su instancia de Zendesk.

  • Una suscripción que cumpla con los requisitos descritos enConfigurar integraciones en la consola.

Verifica tu cuenta de Zendesk

Antes de configurar Amazon Quick, compruebe que su cuenta de Zendesk cumple los siguientes requisitos.

Configure la cuenta de Zendesk

El método de autenticación de la aplicación OAuth personalizada en Amazon Quick requiere un cliente OAuth configurado en Zendesk. El método de autenticación con clave de API requiere un token de API.

Para configurar un cliente OAuth

  1. En su instancia de Zendesk, vaya al Centro de administración, luego a Aplicaciones e integraciones y, por último, a los clientes de OAuth en la API.

  2. Selecciona Añadir cliente OAuth.

  3. Rellena el formulario con los siguientes campos:

    • Nombre: introduce un nombre para la aplicación.

    • Descripción: introduce una descripción breve.

    • Identificador: introduce un identificador único para el cliente OAuth.

    • URL de redireccionamiento: introduzca. https://region.quicksight.aws.amazon.com/sn/oauthcallback Reemplace region con su AWS región, por ejemplo,us-east-1.

  4. Seleccione Save. Zendesk genera un secreto de cliente.

    importante

    Registre ahora el secreto del cliente. No podrá recuperarlo después de salir de esta página.

  5. Tras capturar el secreto, vuelve a seleccionar Guardar para crear el cliente OAuth.

El identificador y el secreto sirven como ID de cliente y secreto de cliente al configurar el conector de acciones en Amazon Quick con el método de autenticación de la aplicación OAuth personalizada.

Para obtener más información, consulte Usar la autenticación OAuth con su aplicación en el sitio web de Zendesk.

Para configurar un token de API

  1. Ve al Centro de administración, luego a Aplicaciones e integraciones y, por último, a los tokens de API.

  2. Selecciona Añadir token de API.

  3. En Descripción, introduce una descripción breve del token de API.

  4. Seleccione Save. Zendesk genera un token de API.

    importante

    Registre el token de API ahora. No podrá recuperarlo después de salir de esta página.

Si elige el método de autenticación de la clave de API en Amazon Quick, utilice este token de API como valor de la clave de API.

Para obtener más información, consulte Administrar el acceso de los tokens de API a la API de Zendesk en el sitio web de Zendesk.

Configurar la integración en Amazon Quick

Después de verificar el acceso a su cuenta de Zendesk, cree el conector en Amazon Quick.

  1. En la consola Amazon Quick, selecciona Connectors.

  2. Selecciona la pestaña Crear para tu equipo.

  3. Elige Zendesk Suite entre las opciones disponibles.

  4. En el cuadro de diálogo de Zendesk Suite, introduzca los siguientes campos:

    • Nombre: un nombre descriptivo para el conector de Zendesk.

    • Descripción (opcional): elija + Agregar descripción para agregar notas sobre cómo se usará este conector.

    • Tipo de conexión: elija Red pública.

  5. Elija su método de autenticación y configure los ajustes del conector:

    • Aplicación OAuth personalizada: introduzca los siguientes campos para su instancia de Zendesk:

      • URL base

      • ID de cliente

      • Secreto de cliente

      • URL del token

      • URL de autorización

      • URL de redireccionamiento

    • Clave de API: introduzca los siguientes campos:

      • URL base

      • Clave de API (token de API de Zendesk)

      • Correo electrónico asociado a su cuenta de Zendesk

  6. Elija Siguiente.

  7. Revisa las acciones de Zendesk Suite y selecciona Siguiente.

  8. Especifique quién puede acceder al conector:

    • Para compartir con un equipo, introduce el nombre del equipo o el correo electrónico del grupo.

    • Para mantenerlo privado, deja el campo en blanco.

    • Para compartir con todos los usuarios, activa la opción Todos los miembros de tu organización.

  9. Elija Publicar.

El conector aparece en el panel Disponible con el estado Conectado.

Acciones disponibles

Tras configurar el conector, puede utilizar las siguientes acciones de gestión de tickets.

Acciones disponibles de Zendesk Suite
Action Description (Descripción)
Crear ticket Crear un nuevo ticket
Listar los resultados de la búsqueda Buscar entradas
Lista de entradas Ver todas las entradas
Mostrar entrada Ver detalles de la entrada
Actualizar el billete Edita los detalles del billete
nota

Las acciones que puede usar dependen de los permisos configurados en su cuenta de Zendesk.

Resolución de problemas

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas de autenticación

  • Sign-in falla: compruebe que su cuenta de Zendesk esté activa y que pueda iniciar sesión en la página de inicio de sesión de Zendesk en el sitio web de Zendesk. Si su organización usa el inicio de sesión único (SSO), confirme que su proveedor de identidad esté configurado correctamente.

  • Acceso denegado: confirme que su usuario de Zendesk tiene un rol de administrador con permisos para acceder a los tickets y a los datos de soporte. En el caso de las conexiones con claves de API, compruebe que el token de API sea válido y que la dirección de correo electrónico asociada sea correcta.