Contact Center AI Platform (CCAI Platform) admite la integración con el CRM de Zendesk. En esta guía, se explican los pasos necesarios para realizar esta integración. Se admiten las siguientes aplicaciones de Zendesk:
Llamada: Versión más reciente: v1.4.0
Chat: Versión más reciente: v1.3.0
Antes de comenzar
Estos son los requisitos previos para la integración del CRM de Zendesk:
Accede al portal de CCAI Platform como administrador.
Cuenta de Zendesk en el plan Professional o Enterprise
Descarga los archivos de la app de Zendesk.
Lee las instrucciones antes de la instalación.
Instalación
Las apps de Zendesk son privadas. No aparecen en el Zendesk Marketplace público. Puedes comunicarte con tu representante de Zendesk para obtenerlos e instalarlos en tu cuenta de Zendesk.
Las apps de Zendesk se pueden instalar siguiendo estas instrucciones o haciendo clic en el vínculo de las apps de Zendesk. Para subir e instalar una app privada en el servicio de asistencia de Zendesk, sigue estos pasos:
Accede a Zendesk y haz clic en el ícono de Administrador en la barra lateral.
Selecciona Apps > Administrar.
Haz clic en Subir app.
Ingresa un nombre para la app. Te recomendamos que uses Llamadas para la app de llamadas y Chat para la app de chat.
Haz clic en Elegir archivo y selecciona el archivo ZIP de tu app privada.
En el caso de la app de llamadas, el nombre de archivo es zendesk-call-v1.4.zip.
En el caso de la app de chat, el nombre del archivo es zendesk-chat-v1.3.zip.
Haz clic en Subir.
En la ventana que aparece, haz clic en Aceptar y subir esta app.
Ingresa el subdominio de tu cuenta.
Habilita las restricciones de rol o grupo y, si es necesario, ingresa el rol o el grupo.
Cuando se te solicite, haz clic en Instalar.
Cuando finalice el proceso, tu app privada aparecerá en la lista de apps instaladas en la página Administrar apps.
Repite los pasos si es necesario instalar las apps de llamadas y chat.


Para la configuración de la app, especifica los siguientes valores de campo:
- Subdominio: Ingresa el subdominio de tu cuenta de Zendesk, que ya deberías conocer. (cliente, p. ej., cliente.example.com)
-- Nombre de dominio: Déjalo con el valor predeterminado example.com.
Cómo administrar apps
Una vez que se instalen las aplicaciones de chat y llamadas, se podrán administrar a través de Zendesk.
Cómo cambiar la configuración de la app
Para cambiar la configuración de la aplicación, sigue estas instrucciones. Puedes cambiar la configuración de una app, incluido el título.
Accede a Zendesk y haz clic en el ícono de Administrador en la barra lateral.
Selecciona Apps > Administrar.
En la página Mis apps, busca la app que quieres cambiar.
Haz clic en el ícono de la app para abrir su página de configuración.
Realiza los cambios que desees y haz clic en Guardar configuración en la parte inferior de la página. Se guardaron los cambios.
Actualizando apps
Es posible que, periódicamente, sea necesario actualizar las apps instaladas. Para actualizar una app, sigue estas instrucciones:
Puedes encontrar instrucciones para actualizar una app privada o hacer clic en el siguiente vínculo de Zendesk, Private Apps.
Accede a Zendesk y haz clic en el ícono de Administrador en la barra lateral.
Selecciona Apps > Administrar.
En la página My Apps, busca la app que quieres actualizar.
En el ícono de la app, haz clic en el ícono de para abrir el menú de configuración de la app.
Haz clic en Actualizar para abrir la pantalla en la que puedes subir un archivo ZIP actualizado.
Configura un cliente de OAuth
Las apps de Zendesk usan OAuth2 para autenticar las solicitudes a la API de Zendesk. Debes configurar un cliente de OAuth para las apps de Zendesk.
Las siguientes instrucciones te guiarán por el proceso de configuración de OAuth, incluido el registro de tu aplicación en Zendesk.
Registro de la aplicación
En Zendesk Support, haz clic en Administrar .
Selecciona API en la categoría Canales.
Haz clic en la pestaña Clientes de OAuth en la página Canales / API.
Haz clic en el ícono que se encuentra en el lado derecho de la lista de clientes.
Completa los siguientes campos para crear un cliente:
Nombre del cliente: Ingresa un nombre para tu app. Este es el nombre que verán los usuarios cuando se les solicite que otorguen acceso a tu aplicación y cuando consulten la lista de apps de terceros que tienen acceso a su cuenta de Zendesk.
Descripción: (Opcional) Es una descripción breve de tu app que los usuarios verán cuando se les solicite que le otorguen acceso.
Empresa: (Opcional) Es el nombre de la empresa que verán los usuarios cuando se les solicite que otorguen acceso a tu aplicación. Esta información puede ayudar a los usuarios a comprender a quién le otorgan acceso.
Logotipo: (Opcional) Es el logotipo que verán los usuarios cuando se les solicite que otorguen acceso a tu aplicación. La imagen puede ser un archivo JPG, GIF o PNG. Para obtener mejores resultados, sube una imagen cuadrada. Se cambiará el tamaño para la página de autorización.
Identificador único: El campo se completa automáticamente con una versión reformateada del nombre que ingresaste para tu app. Puedes cambiarlo si lo deseas.
URLs de redireccionamiento: Ingresa las URLs que Zendesk debe usar para enviar la decisión del usuario de otorgar acceso a tu aplicación. Las URLs deben ser absolutas y no relativas, https (a menos que sean localhost o 127.0.0.1) y estar separadas por saltos de línea.
Haz clic en Guardar.
Después de que se actualice la página, aparecerá un nuevo campo Secreto completado previamente en la parte inferior. Este es el valor de
client_secretespecificado en la especificación de OAuth2.Copia el valor de Secreto en el portapapeles y guárdalo en un lugar seguro.
Configura la URL de redireccionamiento de OAuth.
https://YOUR_SUBDOMAIN.example.com/v1/zendesk/oauth_callbackDebes reemplazar YOUR_SUBDOMAIN por el subdominio real de tu cuenta de Zendesk.
Establece los campos Identificador único y Secreto, que se completan automáticamente cuando se agrega un cliente de OAuth nuevo. Puedes editar el identificador único si quieres, pero no el secreto. El secreto se muestra completo solo una vez cuando se agrega un cliente nuevo. Asegúrate de que esté a salvo. Estos son los valores de client_id y client_secret en las especificaciones de OAuth2.
Configura los parámetros de configuración de la aplicación de OAuth
Accede al portal de CCAI Platform.
Ve a Configuración > Configuración para desarrolladores.
Selecciona la plataforma de agentes Zendesk en la sección CRM.
Establece Subdominio de Zendesk en el subdominio de tu cuenta de Zendesk.
Establece ID de cliente de OAuth en el Identificador único de tu cliente de OAuth de Zendesk.
Establece Secreto del cliente de OAuth en el Secreto de tu cliente de OAuth de Zendesk.
Haz clic en Guardar.
Genera un token de API
La API de Zendesk aprovecha los tokens para la seguridad. Para generar un token de API en Zendesk, sigue estos pasos:
En Zendesk, haz clic en el ícono de Administrador en la barra lateral.
Selecciona Canales > API.
Haz clic en la pestaña Configuración y asegúrate de que el acceso con token esté habilitado.
Haz clic en el ícono a la derecha de Tokens de API activos.
De manera opcional, ingresa una descripción en Descripción del token de API.
Se generará y mostrará el token:

Copia el token y pégalo en un lugar seguro. Una vez que cierres esta ventana, el token completo ya no se volverá a mostrar.
Haz clic en Guardar para volver a la página de la API.
Se muestra una versión truncada del token:

Configura el token de API
Para asignar el token de API a la configuración del CRM de Zendesk, sigue estos pasos:
Accede al portal de CCAI Platform con una cuenta de administrador.
Ve a Configuración > Configuración para desarrolladores.
Establece API Token en el token de API que copiaste de tu cliente de Zendesk.
Crea campos de clientes y tickets
De manera opcional, se pueden crear los campos de cliente y ticket. Lleva a cabo los pasos siguientes:
Crea una cuenta de Zendesk que tenga el rol de administrador y de agente.
En Zendesk, ve a Configuración > Equipo de agentes y administradores.
Selecciona Agregar un administrador.
Marca Este administrador también es agente.
Activa la cuenta desde el correo electrónico de invitación.
Sal de la cuenta de administrador actual y accede con la cuenta nueva.
Accede a Zendesk con un rol de administrador que no sea de agente.
En Zendesk, accede con el widget con credenciales, que es un administrador con rol de agente.
Haz clic en Autorizar.
Abre el portal de la Plataforma de CCAI y ve a Configuración > Configuración para desarrolladores.
Haz clic en el botón Crear en la sección CRM > Campos del cliente para el contacto y el ticket.
Verifica si los campos personalizados del ticket se crearon desde Administrador > Administrar > Campos de usuario y administrador > Administrar > Campos de ticket de Zendesk.
Estos deben incluir los siguientes campos:
Campos de usuario:
Identificador
Campos de tickets:
Verificación (casilla de verificación)
Comentarios de texto del cliente (texto de varias líneas)
Calificación de satisfacción del cliente (numérica): del 1 al 5
Calificación del cliente compartida (texto): Twitter o Facebook