Zendesk conexión

Zendesk es una solución de servicio al cliente y una herramienta de ventas.

Este Adobe Experience Platform destino aprovecha la API Zendesk Contactos para crear y actualizar identidades dentro de una audiencia como contactos dentro de Zendesk.

Zendesk usa tokens de portador como mecanismo de autenticación para comunicarse con la API de contactos de Zendesk. Las instrucciones para autenticarse en su instancia de Zendesk se encuentran más abajo, en la sección Autenticar en destino.

Casos de uso use-cases

El departamento de servicio al cliente de una plataforma B2C multicanal quiere garantizar una experiencia personalizada sin problemas para sus clientes. El departamento puede generar audiencias a partir de sus propios datos sin conexión para crear perfiles de usuario nuevos o actualizar la información de perfil existente de diferentes interacciones (por ejemplo, compras, devoluciones, etc.) y enviar estas audiencias de Adobe Experience Platform a Zendesk. Tener la información actualizada en Zendesk garantiza que el agente de servicio al cliente tenga disponible de inmediato la información reciente del cliente, lo que permite respuestas y resolución más rápidas.

Requisitos previos prerequisites

Requisitos previos de Experience Platform prerequisites-in-experience-platform

Antes de activar datos en el destino Zendesk, debe tener un esquema, un conjunto de datos y segmentos creados en Experience Platform.

Consulte la documentación de Experience Platform para el grupo de campos de esquema Detalles de pertenencia a audiencias si necesita instrucciones sobre los estados de audiencia.

Zendesk requisitos previos prerequisites-destination

Para exportar datos de Experience Platform a su cuenta de Zendesk, necesita tener una cuenta de Zendesk.

Recopilar Zendesk credenciales gather-credentials

Observe los elementos siguientes antes de autenticarse en el destino Zendesk:

Credencial
Descripción
Ejemplo
Bearer token
El token de acceso que generó en su cuenta de Zendesk.
Siga la documentación para generar un Zendesk token de acceso si no dispone de uno.
a0b1c2d3e4...v20w21x22y23z

Mecanismos de protección guardrails

La página Precios y límites de tarifas detalla los límites de API Zendesk asociados con su cuenta. Debe asegurarse de que los datos y la carga útil se encuentren dentro de estas restricciones.

Identidades admitidas supported-identities

Zendesk admite la actualización de las identidades descritas en la tabla siguiente. Más información sobre identidades.

Identidad de destino
Ejemplo
Descripción
Obligatorio
email
test@test.com
Dirección de correo electrónico del contacto.

Tipo y frecuencia de exportación export-type-frequency

Consulte la tabla siguiente para obtener información sobre el tipo y la frecuencia de exportación de destino.

Elemento
Tipo
Notas
Tipo de exportación
Profile-based
  • Va a exportar todos los miembros de un segmento, junto con los campos de esquema deseados (por ejemplo: dirección de correo electrónico, número de teléfono, apellidos), según la asignación de campos.
  • Cada estado de segmento de Zendesk se actualiza con el estado de audiencia correspondiente de Experience Platform, según el valor de Mapping ID proporcionado durante el paso de programación de audiencias.
Frecuencia de exportación
Streaming
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform basado en la evaluación de audiencias, el conector envía la actualización de forma descendente a la plataforma de destino. Más información sobre destinos de streaming.

Conectar con el destino connect

IMPORTANT
Para conectarse al destino, necesita los View Destinations y Manage Destinations permisos de control de acceso. Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.

Para conectarse a este destino, siga los pasos descritos en el tutorial de configuración de destino. En el flujo de trabajo de configuración de destino, rellene los campos enumerados en las dos secciones siguientes.

En Destinations > Catalog buscar Zendesk. También puede ubicarlo en la categoría CRM.

Autenticarse en el destino authenticate

Rellene los campos obligatorios siguientes. Consulte la sección Recopilar Zendesk credenciales para obtener instrucciones.

  • Bearer Token: el token de acceso que generó en su cuenta de Zendesk.

Para autenticarse en el destino, seleccione Connect to destination.
Captura de pantalla de la interfaz de usuario de Experience Platform que muestra cómo autenticarse.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Connected con una marca de verificación verde. A continuación, puede continuar con el paso siguiente.

Rellenar detalles de destino destination-details

Para configurar los detalles del destino, rellene los campos obligatorios y opcionales a continuación. Un asterisco junto a un campo en la interfaz de usuario indica que el campo es obligatorio.
Captura de pantalla de la interfaz de usuario de Experience Platform que muestra los detalles del destino.

  • Name: un nombre con el cual reconocerá este destino en el futuro.
  • Description: una descripción que le ayudará a identificar este destino en el futuro.

Habilitar alertas enable-alerts

Puede activar alertas para recibir notificaciones sobre el estado del flujo de datos a su destino. Seleccione una alerta de la lista a la que suscribirse para recibir notificaciones sobre el estado del flujo de datos. Para obtener más información sobre las alertas, consulte la guía sobre suscripción a alertas de destinos mediante la interfaz de usuario.

Cuando termine de proporcionar detalles para la conexión de destino, seleccione Next.

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los permisos de control de acceso View Destinations, Activate Destinations, View Profiles y View Segments 5}. ​ Lea la descripción general del control de acceso o póngase en contacto con el administrador del producto para obtener los permisos necesarios.
  • Para exportar identidades, necesita el View Identity Graph permiso de control de acceso.
    Seleccione el área de nombres de identidad resaltada en el flujo de trabajo para activar audiencias en los destinos. {width="100" modal="regular"}

Lea Activar perfiles y audiencias en destinos de exportación de audiencias de streaming para obtener instrucciones sobre cómo activar audiencias en este destino.

Consideraciones sobre asignación y ejemplo mapping-considerations-example

Para enviar correctamente los datos de audiencia de Adobe Experience Platform al destino Zendesk, debe pasar por el paso de asignación de campos. La asignación consiste en crear un vínculo entre los campos de esquema del Modelo de datos de experiencia (XDM) en la cuenta de Experience Platform y sus equivalentes correspondientes desde el destino de destino.

Los atributos especificados en Target field deben tener exactamente el nombre descrito en la tabla de asignaciones de atributos, ya que estos atributos formarán el cuerpo de la solicitud.

Los atributos especificados en Source field no siguen ninguna restricción de este tipo. Puede asignarlo según sus necesidades. Sin embargo, si el formato de datos no es correcto cuando se inserta en Zendesk, se producirá un error.

Para asignar correctamente los campos XDM a los campos de destino Zendesk, siga estos pasos:

  1. En el paso Mapping, seleccione Add new mapping. Verá una nueva fila de asignación en la pantalla.

  2. En la ventana Select source field, elija la categoría Select attributes y seleccione el atributo XDM o elija Select identity namespace y seleccione una identidad.

  3. En la ventana Select target field, elija la categoría Select identity namespace y seleccione una identidad de destino, o bien elija la categoría Select attributes y seleccione uno de los atributos de esquema admitidos.

    • Repita estos pasos para agregar las siguientes asignaciones obligatorias, también puede agregar cualquier otro atributo que desee actualizar entre el esquema de perfil XDM y la instancia Zendesk:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Campo de origen Campo de destino Obligatorio
      xdm: person.name.lastName xdm: last_name
      IdentityMap: Email Identity: email
      xdm: person.name.firstName xdm: first_name
    • A continuación se muestra un ejemplo con estas asignaciones:
      Ejemplo de captura de pantalla de IU de Experience Platform con asignaciones de atributos.

IMPORTANT
Las asignaciones de destino Attribute: last_name y Identity: email son obligatorias para este destino. Si faltan estas asignaciones, se omitirán las demás asignaciones y no se enviarán a Zendesk.

Cuando termine de proporcionar las asignaciones para la conexión de destino, seleccione Next.

Programar exportación de audiencias y ejemplo schedule-segment-export-example

En el paso Schedule audience export del flujo de trabajo de activación, debe asignar manualmente las audiencias de Experience Platform al atributo de campo personalizado en Zendesk.

Para ello, seleccione cada segmento e introduzca el atributo de campo personalizado correspondiente de Zendesk en el campo Mapping ID.

A continuación se muestra un ejemplo:
Ejemplo de captura de pantalla de la IU de Experience Platform que muestra Programar exportación de audiencias.

Validar exportación de datos exported-data

Para comprobar que ha configurado correctamente el destino, siga los pasos a continuación:

  1. Seleccione Destinations > Browse y vaya a la lista de destinos.

  2. A continuación, seleccione el destino y cambie a la pestaña Activation data; luego, seleccione un nombre de audiencia.
    Ejemplo de captura de pantalla de la IU de Experience Platform que muestra datos de activación de destinos.

  3. Monitorice el resumen de audiencia y asegúrese de que el recuento de perfiles corresponde al recuento dentro del segmento.
    Ejemplo de captura de pantalla de la IU de Experience Platform que muestra el segmento.

  4. Inicie sesión en el sitio web de Zendesk y luego vaya a la página de Contacts para comprobar si se han agregado los perfiles de la audiencia. Esta lista se puede configurar para mostrar columnas para los campos adicionales creados con los estados de audiencia​Mapping ID y audiencia.
    Captura de pantalla de la interfaz de usuario de Zendesk que muestra la página Contactos con los campos adicionales creados con el nombre de audiencia.

  5. También puede explorar en profundidad una página individual de Person y comprobar la sección Additional fields que muestra el nombre y los estados de audiencia.
    Captura de pantalla de la interfaz de usuario de Zendesk que muestra la página Persona con la sección de campos adicionales que muestra el nombre y los estados de audiencia.

Uso de datos y gobernanza data-usage-governance

Todos los destinos de Adobe Experience Platform cumplen con las políticas de uso de datos al administrar los datos. Para obtener información detallada sobre cómo Adobe Experience Platform aplica el control de datos, consulte la Información general sobre el control de datos.

Recursos adicionales additional-resources

A continuación encontrará información útil adicional de la documentación de Zendesk:

Changelog

Esta sección recoge la funcionalidad y las actualizaciones significativas de la documentación realizadas en este conector de destino.

Ver registro de cambios
table 0-row-3 1-row-3 2-row-3 layout-auto
Mes de lanzamiento Tipo de actualización Descripción
Abril de 2023 Actualización de documentación
  • Hemos actualizado la sección casos de uso con un ejemplo más claro de cuándo se beneficiarían los clientes de utilizar este destino.
  • Actualizamos la sección mapping para reflejar las asignaciones requeridas correctas. Las asignaciones de destino Attribute: last_name y Identity: email son obligatorias para este destino. Si faltan estas asignaciones, se omitirán las demás asignaciones y no se enviarán a Zendesk.
  • Hemos actualizado la sección asignación con ejemplos claros de asignaciones obligatorias y opcionales.
Marzo de 2023 Versión inicial Versión de destino inicial y publicación de documentación.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6