Zendesk Información general sobre la extensión API Events
Zendesk es una solución de servicio al cliente y una herramienta de ventas. El Zendesk reenvío de eventos La extensión de aprovecha Zendesk Events API para enviar eventos desde Adobe Experience Platform Edge Network a Zendesk para un procesamiento posterior. Puede utilizar la extensión para recopilar interacciones de perfil del cliente para utilizarlas en análisis y acciones posteriores.
Este documento explica cómo instalar y configurar la extensión en la interfaz de usuario de.
Requisitos previos
Debe tener una cuenta de Zendesk para utilizar esta extensión. Puede registrarse para obtener una cuenta de Zendesk en la Sitio web de Zendesk.
También debe recopilar los siguientes detalles para su configuración de Zendesk:
xxxxx.zendesk.com
(donde xxxxx
es el valor proporcionado durante la creación de la cuenta)cwWyOtHAv12w4dhpiulfe9BdZFTz3OKaTSzn2QvV
Finalmente, debe crear un secreto de reenvío de eventos para el token de API. Establezca el tipo secreto en Token y establezca el valor en el token de API que haya recopilado de su configuración de Zendesk. Consulte la documentación sobre secretos en el reenvío de eventos para obtener más información sobre la configuración de secretos.
Instalar la extensión install
Para instalar la extensión de Zendesk en la interfaz de usuario de, vaya a Reenvío de eventos y seleccione una propiedad a la que añadir la extensión o cree una nueva propiedad.
Una vez seleccionada o creada la propiedad deseada, vaya a Extensiones > Catálogo. Buscar "Zendesk", y luego seleccione Install en la extensión de Zendesk.
Configuración de la extensión configure
Seleccionar Extensiones en el panel de navegación izquierdo. En Instalado, seleccione Configurar en la extensión de Zendesk.
En Dominio de Zendesk, introduzca el valor del subdominio de Zendesk. En Token de Zendesk, seleccione el secreto que creó anteriormente que contiene el token de API.
Configuración de una regla de reenvío de eventos
Empezar a crear una nueva regla de reenvío de eventos regla y configure sus condiciones como desee. Al seleccionar las acciones para la regla, seleccione Zendesk extensión y, a continuación, seleccione la Crear evento tipo de acción.
Al establecer la configuración de la acción, se le pedirá que asigne elementos de datos a las distintas propiedades que se enviarán a Zendesk.
Estos elementos de datos deben asignarse como se hace referencia a continuación.
event
teclas
event
es un objeto JSON que representa el evento activado por el usuario. Consulte el documento de Zendesk en la anatomía de un evento para obtener más información sobre las propiedades capturadas por event
objeto.
Se puede hacer referencia a las siguientes claves dentro de la variable event
al asignar elementos de datos:
event
keysource
arc.event.xdm._extconndev.event_source
Zendesk
como un valor, ya que es un nombre de fuente protegido para los eventos estándar de Zendesk. Si intenta usarlo, se producirá un error.La longitud del valor no debe superar los 40 caracteres.
type
arc.event.xdm._extconndev.event_type
description
arc.event.xdm._extconndev.description
created_at
arc.event.xdm.timestamp
properties
arc.event.xdm._extconndev.EventProperties
profile
teclas
profile
es un objeto JSON que representa al usuario que activó el evento. Consulte el documento de Zendesk en la anatomía de un perfil para obtener más información sobre las propiedades capturadas por profile
objeto.
Se puede hacer referencia a las siguientes claves dentro de la variable profile
al asignar elementos de datos:
profile
keysource
arc.event.xdm._extconndev.profile_source
Support
, CompanyName
, o Chat
.type
arc.event.xdm._extconndev.profile_type
name
arc.event.xdm._extconndev.name
user_id
arc.event.xdm._extconndev.user_id
identifiers
arc.event.xdm._extconndev.identifiers
identifiers
matriz. Todos los campos y valores deben ser únicos.attributes
arc.event.xdm._extconndev.attrbutes
Validación de datos en Zendesk validate
Si la recopilación de eventos y la integración de Adobe Experience Platform son exitosas, entonces los eventos dentro de la consola de Zendesk deberían aparecer como se muestra a continuación. Esto indica una integración correcta.
Perfiles:
Eventos:
Límites de solicitudes limits
Según el tipo de cuenta, el Events API puede gestionar el siguiente número de solicitudes por minuto:
Consulte la Documentación de Zendesk para obtener más información sobre estos límites.
Errores y solución de problemas errors-and-troubleshooting
Al utilizar o configurar la extensión, la API de eventos de Zendesk podría devolver los errores siguientes:
{"error": [{"code":"InvalidProfileTypeLength","title": "Profile type length > 40 chars"}]}
{subdomain}.zendesk.com
{"error": [{"description": "No route found for host {subdomain}.zendesk.com","title": "RouteNotFound"}]}
{"error": [{"code":"MissingOrInvalidAuthentication","title": "Invalid or Missing Authentication"}]}
{"error": [{"code":"PermissionDenied","title": "Insufficient permisssions to perform operation"}]}
{"error": [{"code":"TooManyRequests","title": "Too Many Requests"}]}
Pasos siguientes
Este documento explica cómo instalar y configurar la extensión de reenvío de eventos de Zendesk en la interfaz de usuario. Para obtener más información sobre la recopilación de datos de eventos en Zendesk, consulte la documentación oficial: