Integrar Zendesk
Integre con Zendesk para enviar y supervisar solicitudes desde cualquier dispositivo, intranet o aplicación de mensajería.
Utilice el siguiente proceso para habilitar la integración de Zendesk. Compruebe que cumple los requisitos previos y obtenga su ID de cliente y token secreto. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.
Para obtener una lista completa de las microaplicaciones de Zendesk de uso inmediato, consulte Usar microaplicaciones de Zendesk.
Revisar requisitos previos
Cree una cuenta dedicada de Zendesk y úsela para configurar la integración de Zendesk. Esta cuenta debe tener asignado un rol, como Administrador, con privilegios de pleno acceso a los datos. Tras configurar esta integración en Zendesk, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:
- dirección URL
- ID de cliente
- Secreto del cliente
- Cuenta
- Password
Se deben cumplir los siguientes requisitos previos antes de comenzar el proceso de integración:
- Configure Citrix Gateway para que admita Single Sign-On para Zendesk, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Siga las instrucciones indicadas en Configuración de Single Sign-On de Zendesk. Para obtener más información acerca de la configuración de Single Sign-On, consulte Citrix Gateway Service.
Configurar la integración de Zendesk
- Inicie sesión en www.zendesk.com con la cuenta de usuario dedicada.
- Seleccione Admin (el icono de configuración) en la barra lateral izquierda. En la sección Channels, seleccione API.
- Seleccione la ficha OAuth Clients y, a continuación, el icono + (más).
- En el campo Client Name, introduzca un nombre de cliente para su aplicación.
- (Optativo) Complete los campos Description, Company y Logo.
- Copie el valor de Unique Identifier rellenado automáticamente para su uso posterior.
- Establezca las URL de redireccionamiento como se describe más adelante.
- Seleccione Save y OK.
- Después de actualizar la página, aparece un nuevo campo Secret rellenado previamente. Copie el token secreto generado para su uso posterior. Este no está disponible después de salir de la pantalla.
- Seleccione Guardar.
Ya está listo para completar la integración en microaplicaciones de Citrix Workspace.
Agregar direcciones URL de respuesta
Agregue una URL personalizada a la configuración de la instancia para dar acceso a datos privados y habilitar acciones de usuarios autenticados por OAuth. La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
Inicie sesión en Zendesk como administrador y agregue las siguientes URL de redirección autorizadas para esta integración:
https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.zendesk.ZendeskService/auth/serverContexthttps://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
Agregar la integración a las microaplicaciones de Citrix Workspace
Agregue la integración de Zendesk a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.
Siga estos pasos:
-
En la página de descripción general, seleccione Introducción.
Se abrirá la página Administrar integraciones.
- Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
- Elija el mosaico de Zendesk.
-
Introduzca un nombre para la integración.
- Introduzca los parámetros del conector que recopiló como requisitos previos.
- Introduzca la URL de la instancia.
- Introduzca el ID de cliente. Este valor es el identificador único que obtuvo al registrar su solicitud en Zendesk.
- Introduzca el secreto del cliente. Este valor es el secreto que copió cuando registró su solicitud en Zendesk.
- Seleccione un valor para el número de meses de tíquets que se van a cargar.
- Seleccione Iniciar sesión con su cuenta de Zendesk para habilitar la autorización de OAuth. Se abrirá una página de inicio de sesión de Zendesk en una nueva ficha. Se le pedirá que introduzca un nombre de cuenta, confirme el acceso e introduzca una contraseña.
- Seleccione Agregar.
Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.
Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización.
Para obtener más información, consulte Verificar las entidades necesarias y Establecer sincronización de datos en el artículo Configurar la integración.
Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Zendesk.
Usar microaplicaciones de Zendesk
Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.
Nuestra integración de Zendesk incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:
Agregar tíquet: Permite enviar tíquets de Zendesk.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Página Enviar tíquet | Proporciona un formulario para enviar un tíquet. |
Tíquets: Permite ver tíquets de Zendesk con detalles.
| Notificación o página | Flujos de trabajo por caso de uso |
|---|---|
| Notificación Se le ha asignado un nuevo tíquet (cambiado) | Cuando un tíquet existente se asigna a un usuario, este recibe una notificación. |
| Notificación Se le ha asignado un nuevo tíquet (nuevo) | Cuando se asigna un tíquet nuevo a un usuario, este recibe una notificación. |
| Notificación Cambio de estado de tíquet | Cuando se cambia el estado de un tíquet, el usuario que haya enviado el tíquet recibe una notificación. |
| Notificación Tíquet actualizado | Cuando se actualiza un tíquet, el usuario que lo haya enviado recibe una notificación. |
| Página Mis tíquets | Proporciona una lista personalizada de los tíquets relacionados con un usuario y un enlace a los detalles de cada tíquet. |
| Página Detalles del tíquet | Proporciona una vista de solo lectura de un tíquet con detalles. |