Información general sobre la extensión API de eventos Zendesk
Zendesk es una solución de servicio al cliente y una herramienta de ventas. La extensión de Zendesk reenvío de eventos aprovecha Zendesk Events API para enviar eventos del Edge Network de Adobe Experience Platform 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 el 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 recopiló 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.
Instalación de la extensión install
Para instalar la extensión de Zendesk en la interfaz de usuario, vaya a Reenvío de eventos y seleccione una propiedad a la que agregar la extensión o cree una nueva propiedad en su lugar.
Una vez seleccionada o creada la propiedad deseada, vaya a Extensiones > Catálogo. Busque "Zendesk" y luego seleccione Install en la extensión de Zendesk.
Configuración de la extensión configure
Seleccione 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 de su 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
Comience a crear una nueva regla de reenvío de eventos rule y configure sus condiciones como desee. Al seleccionar las acciones de la regla, seleccione la extensión Zendesk y, a continuación, seleccione el tipo de acción Crear evento.
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
claves
event
es un objeto JSON que representa el evento activado por el usuario. Consulte el documento de Zendesk sobre la anatomía de un evento para obtener detalles sobre las propiedades capturadas por el objeto event
.
Se puede hacer referencia a las siguientes claves dentro del objeto event
al asignar elementos de datos:
event
source
arc.event.xdm._extconndev.event_source
Zendesk
como valor, ya que es un nombre de origen protegido para los eventos estándar de Zendesk. Si intenta usarlo, se producirá un error.La longitud del valor no debe exceder 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
claves
profile
es un objeto JSON que representa al usuario que activó el evento. Consulte el documento de Zendesk sobre la anatomía de un perfil para obtener detalles sobre las propiedades capturadas por el objeto profile
.
Se puede hacer referencia a las siguientes claves dentro del objeto profile
al asignar elementos de datos:
profile
source
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
. 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, Zendesk 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: