Configuración de Zendesk

Versión preliminar pública: La búsqueda federada está en versión preliminar pública. Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección de Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo configurar la autenticación y los permisos antes de crear el almacén de datos de Zendesk.

Habilita el acceso al token

Para permitir que Zendesk se autentique y pueda interactuar con tu instancia de Zendesk, debes habilitar el acceso con token. Sigue estos pasos para habilitar el acceso a los tokens:

1. Navega a tu instancia de Zendesk y accede con una cuenta de administrador.
2. En el menú de navegación, expande Apps y servicios y, luego, selecciona Configuración de la API en APIs.
3. Selecciona la casilla de verificación Permitir el acceso con tokens de API.
4. Haz clic en Guardar.

Configura la autenticación y los permisos

Para una integración segura con OAuth 2.0, debes registrar tu aplicación en Zendesk para obtener el ID de cliente y el secreto del cliente necesarios.

Crea un cliente de OAuth y obtén credenciales de autenticación

Para crear un cliente de OAuth en Zendesk y obtener las credenciales de autenticación, sigue estos pasos:

1. Navega a tu instancia de Zendesk y accede con una cuenta de administrador.

   Nota: La URL de tu instancia tiene el formato https://<var>your-subdomain</var>.zendesk.com.

2. Haz clic en el ícono de Productos de Zendesk y, luego, selecciona Centro de administración.

   

   Centro de administración de Zendesk

3. En el menú de navegación, expande Apps and integrations y selecciona OAuth clients en APIs.

4. Haz clic en Agregar cliente de OAuth.

5. Ingresa los siguientes detalles del cliente:

   • Nombre: Ingresa un nombre descriptivo para tu aplicación.
   • Opcional: Descripción: Ingresa una descripción breve.
   • Opcional: Empresa: Ingresa el nombre de tu empresa.
   • Opcional: Logotipo: Proporciona un logotipo que aparecerá en la pantalla de consentimiento.
   • Identificador único (ID de cliente): Proporciona un nombre único para tu cliente. Puedes editar la sugerencia inicial, pero debe ser única.
   • Tipo de cliente: Selecciona Público para las aplicaciones que se ejecutan en un navegador o en un dispositivo móvil, o Confidencial para las aplicaciones que se ejecutan en servidores seguros.
   • Redireccionar las URLs (obligatorio): Ingresa https://vertexaisearch.cloud.google.com/oauth-redirect. Esta es la URL a la que Zendesk redirecciona después de la autorización, cuando recibe el código de autorización.

6. Haz clic en Guardar para obtener el secreto del cliente.

   • ID de cliente: Es el valor del campo Identificador único.
   • Secreto del cliente: Aparecerá un nuevo campo Secreto. Copia este secreto y guárdalo de inmediato en una ubicación segura. Por motivos de seguridad, el secreto completo solo se muestra una vez. Si la pierdes, deberás volver a generarla.

   

   Credenciales de cliente generadas

7. Haz clic en Guardar de nuevo para finalizar los cambios.

Configura los permisos

Para configurar los permisos necesarios, sigue estos pasos:

1. Navega a tu instancia de Zendesk y accede con una cuenta de administrador.
2. Haz clic en el ícono de Productos de Zendesk y, luego, selecciona Centro de administración.
3. En el menú de navegación, expande Apps y las integraciones y selecciona Clientes de OAuth en Conexiones.
4. Haz clic en Add client.

5. Ingresa los siguientes detalles del cliente:

   • Nombre: Ingresa un nombre descriptivo. No se puede cambiar.
   • Tipo de concesión de OAuth: Selecciona Código de autorización.
   • ID de cliente: Ingresa el ID de cliente que obtuviste en la sección Crea un cliente de OAuth en Zendesk.
   • Secreto del cliente: Ingresa el valor del secreto del cliente que obtuviste en la sección Crea un cliente de OAuth en Zendesk.
   • URL de autorización: Por lo general, el extremo de autorización tiene el formato https://<var>your-subdomain</var>.zendesk.com/oauth/authorize. Reemplaza <var>your-subdomain</var> por tu subdominio real de Zendesk.
   • URL del token: Por lo general, el extremo del token tiene el formato https://<var>your-subdomain</var>.zendesk.com/oauth/token. Reemplaza <var>your-subdomain</var> por tu subdominio real de Zendesk.

     

     Agregar permisos

   • Permisos: Ingresa los siguientes permisos separados por espacios, según tu modo de conexión:

   Modo de conexión	Alcance	Objetivo	Se requiere el consentimiento del administrador
   Búsqueda federada	read, users:read	Permite realizar búsquedas en los datos de Zendesk.	No

   Nota: Antes de configurar estos detalles, asegúrate de que el acceso con token esté habilitado en Zendesk.

6. Haz clic en Guardar.