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, consulte[Métodos de autenticación](quick-action-auth.md). ## 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 en[Configurar integraciones en la consola](integration-console-setup-process.md). ## Verifica tu cuenta de Zendesk Antes de configurar Amazon Quick, compruebe que su cuenta de Zendesk cumple los siguientes requisitos. + Su cuenta de Zendesk está activa y puede iniciar sesión en la [página de inicio de sesión de Zendesk en el sitio](https://www.zendesk.com/login/) web de Zendesk. + Puede acceder a los tickets y a los datos de soporte a los que desea acceder desde su cuenta. ## 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.** 1. **Selecciona Añadir cliente OAuth.** 1. 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`. 1. 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. 1. 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](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) 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**. 1. Selecciona **Añadir token de API**. 1. En **Descripción**, introduce una descripción breve del token de API. 1. 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](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) 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**. 1. Selecciona la pestaña **Crear para tu equipo**. 1. Elige **Zendesk Suite** entre las opciones disponibles. 1. 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**. 1. 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 1. Elija **Siguiente**. 1. **Revisa las acciones de Zendesk Suite y selecciona Siguiente.** 1. 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**. 1. 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, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations). ### 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](https://www.zendesk.com/login/) 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.