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 crear audiencias a partir de sus propios datos sin conexión para crear nuevos perfiles de usuario o actualizar la información de perfil existente de diferentes interacciones (por ejemplo, compras, devoluciones, etc.) y enviar estas audiencias desde 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 del 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 del 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 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
Basado en perfil
  • 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 Platform, según el valor de ID de asignación proporcionado durante el paso programación de audiencia.
Frecuencia de exportación
Transmisión
  • Los destinos de streaming son conexiones basadas en API "siempre activadas". Tan pronto como se actualiza un perfil en Experience Platform según 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.

Conexión al destino connect

IMPORTANT
Para conectarse al destino, necesita los permisos de control de acceso de Ver destinos] y Administrar destinos[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 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 destinos > catálogo, busque 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.

  • Token de portador: El token de acceso que generó en su cuenta de Zendesk.

Para autenticarse en el destino, seleccione Conectarse al destino.
Captura de pantalla de IU de Platform que muestra cómo autenticarse.

Si los detalles proporcionados son válidos, la interfaz de usuario mostrará el estado Conectado 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 IU de Platform que muestra los detalles del destino.

  • Nombre: Un nombre por el cual reconocerá este destino en el futuro.
  • Descripción: 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 Siguiente.

Activar públicos en este destino activate

IMPORTANT
  • Para activar los datos, necesita los permisos de control de acceso, Activar destinos, Ver perfiles y Ver segmentospara. 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 permiso de control de acceso de] Ver gráfico de identidad[.
    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 Platform y sus equivalentes correspondientes desde el destino de destino.

Los atributos especificados en el campo de destino 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 el campo Source 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 Asignación, seleccione Agregar nueva asignación. Verá una nueva fila de asignación en la pantalla.

  2. En la ventana Seleccionar campo de origen, elija la categoría Seleccionar atributos y seleccione el atributo XDM o elija Seleccionar área de nombres de identidad y seleccione una identidad.

  3. En la ventana Seleccionar campo de destino, elija la categoría Seleccionar área de nombres de identidad y seleccione una identidad de destino, o bien elija la categoría Seleccionar atributos 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:
      |Campo de Source|Campo de destino| Obligatorio|
      |—|—|—|
      |xdm: person.name.lastName|xdm: last_name| Sí |
      |IdentityMap: Email|Identity: email| Sí |
      |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 plataforma 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 Siguiente.

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

En el paso Programar exportación de audiencias del flujo de trabajo de activación, debe asignar manualmente las audiencias de 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 ID de asignación.

A continuación se muestra un ejemplo:
Ejemplo de captura de pantalla de la IU de 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 Destinos > Examinar y vaya a la lista de destinos.

  2. A continuación, seleccione el destino y cambie a la ficha Datos de activación y, a continuación, seleccione un nombre de audiencia.
    Ejemplo de captura de pantalla de IU de 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 IU de Platform que muestra el segmento.

  4. Inicie sesión en el sitio web de Zendesk y luego vaya a la página de Contactos 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 la audiencia​ ID de asignación y los estados de 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 Persona y comprobar la sección de Campos adicionales que muestra el nombre de la audiencia y los estados de la 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