[Beta]{class="badge informative"}

Crear una conexión de origen Chatlio en la interfaz de usuario

NOTE
El origen Chatlio está en la versión beta. Lea información general de orígenes para obtener más información sobre el uso de orígenes etiquetados como beta.

Este tutorial proporciona los pasos para crear una conexión de origen Chatlio mediante la interfaz de usuario de Adobe Experience Platform.

Introducción getting-started

Este tutorial requiere una comprensión práctica de los siguientes componentes de Experience Platform:

Requisitos previos prerequisites

La siguiente sección proporciona información sobre los requisitos previos que se deben completar para poder crear una conexión de origen de Chatlio.

Ejemplo de JSON para definir el esquema de origen de Chatlio prerequisites-json-schema

Antes de crear una conexión de origen de Chatlio, necesitará que se proporcione un esquema de origen. Puede utilizar el siguiente JSON.

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

Crear un esquema de plataforma para Chatlio create-platform-schema

También debe asegurarse de crear un esquema de Platform para utilizarlo con el origen. Lea el tutorial sobre creación de un esquema de Platform para ver los pasos detallados sobre cómo crear un esquema.

Interfaz de usuario de Platform que muestra un esquema de ejemplo para Chatlio

Conectar su cuenta de Chatlio connect-account

En la interfaz de usuario de Platform, seleccione Sources en el panel de navegación izquierdo para acceder al área de trabajo Sources y ver un catálogo de orígenes disponibles en el Experience Platform.

Utilice el menú Categorías para filtrar orígenes por categoría. También puede introducir un nombre de origen en la barra de búsqueda para buscar un origen específico del catálogo.

Vaya a la categoría Automatización de marketing para ver la tarjeta de origen Chatlio. Para empezar, seleccione Agregar datos.

El catálogo de IU de Platform con tarjeta Chatlio

Seleccionar datos select-data

Aparecerá el paso Seleccionar datos, que proporciona una interfaz para que pueda seleccionar los datos que desea llevar a Platform.

  • La parte izquierda de la interfaz es un explorador que le permite ver los flujos de datos disponibles en su cuenta;
  • La parte derecha de la interfaz de le permite previsualizar hasta 100 filas de datos de un archivo JSON.

Seleccione Cargar archivos para cargar un archivo JSON desde su sistema local. También puede arrastrar y soltar el archivo JSON que desee cargar en el panel Arrastrar y soltar archivos.

Paso para agregar datos del flujo de trabajo de orígenes.

Una vez cargado el archivo, la interfaz de vista previa se actualiza para mostrar una vista previa del esquema cargado. La interfaz de vista previa permite inspeccionar el contenido y la estructura de un archivo. También puede usar la utilidad Campo de búsqueda para acceder a elementos específicos desde el esquema.

Cuando termine, seleccione Siguiente.

Paso de vista previa del flujo de trabajo de orígenes.

Detalles del flujo de datos dataflow-detail

Aparecerá el paso Detalle del flujo de datos, que le proporcionará opciones para usar un conjunto de datos existente o establecer uno nuevo para su flujo de datos, así como la oportunidad de proporcionar un nombre y una descripción para su flujo de datos. Durante este paso, también puede configurar las opciones de Ingesta de perfiles, diagnósticos de error, ingesta parcial y alertas.

Cuando termine, seleccione Siguiente.

Paso de detalle del flujo de datos del flujo de trabajo de origen.

Asignación mapping

Aparecerá el paso Mapping, que le proporcionará una interfaz para asignar los campos de origen del esquema de origen a sus campos XDM de destino adecuados en el esquema de destino.

Platform proporciona recomendaciones inteligentes para campos asignados automáticamente en función del esquema o el conjunto de datos de destino seleccionado. Puede ajustar manualmente las reglas de asignación para adaptarlas a sus casos de uso. En función de sus necesidades, puede elegir asignar campos directamente o utilizar funciones de preparación de datos para transformar los datos de origen y derivar valores calculados o calculados. Para ver los pasos detallados sobre el uso de la interfaz de asignador y los campos calculados, consulte la guía de la interfaz de usuario de la preparación de datos.

Las asignaciones enumeradas a continuación son obligatorias y deben configurarse antes de continuar con la fase Revisar.

Campo de destino
Descripción
UUID
El identificador Chatlio del evento.

Una vez que los datos de origen estén asignados correctamente, seleccione Siguiente.

Paso de asignación del flujo de trabajo de orígenes.

Revisar review

Aparece el paso Revisar, que le permite revisar el nuevo flujo de datos antes de crearlo. Los detalles se agrupan en las siguientes categorías:

  • Conexión: muestra el tipo de origen, la ruta de acceso relevante del archivo de origen elegido y la cantidad de columnas dentro de ese archivo de origen.
  • Asignar campos de conjunto de datos y asignación: muestra en qué conjunto de datos se están ingiriendo los datos de origen, incluido el esquema al que se adhiere el conjunto de datos.

Una vez que haya revisado el flujo de datos, seleccione Finalizar y espere un poco para que se cree el flujo de datos.

Paso de revisión del flujo de trabajo de orígenes.

Obtener la URL del extremo de flujo continuo get-streaming-endpoint-url

Con el flujo de datos de flujo continuo creado, ahora puede recuperar la URL del extremo de flujo continuo. Este punto de conexión se utilizará para suscribirse al webhook, lo que permitirá que el origen de la transmisión se comunique con el Experience Platform.

Para construir la dirección URL utilizada para configurar el webhook en Chatlio, debe recuperar lo siguiente:

  • ID de flujo de datos
  • Extremo de streaming

Para recuperar tu ID de flujo de datos y extremo de transmisión, ve a la página de actividad de flujo de datos del flujo de datos que acabas de crear y copia los detalles desde la parte inferior del panel Propiedades.

Punto final de flujo continuo en la actividad del flujo de datos.

Una vez que haya recuperado su extremo de flujo continuo y el ID de flujo de datos, genere una URL basada en el siguiente patrón: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Por ejemplo, una URL de gancho web construida puede tener el siguiente aspecto: https://dcs.adobedc.net/collection/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983

Configurar webhook en Chatlio set-up-webhook

Con la URL del gancho web creada, ahora puede configurar el gancho web mediante la interfaz de usuario Chatlio.

Inicia sesión en tu cuenta de Chatlio y sigue la guía de instalación para crear un widget.

Una vez creado un widget, vaya a la página de configuración del widget para agregar la URL del gancho web a ese widget.

La página de configuración del webhook en Chatlio.

A continuación, seleccione la pestaña Behavior y agregue la URL del webhook al campo Webhook when a new conversation starts y a cualquier otro campo de eventos de webhook al que desee suscribirse.

Interfaz de usuario de Chatlio que muestra el campo de extremo del gancho web.

TIP
Puede suscribirse a una variedad de eventos diferentes para su webhook Chatlio. Para obtener más información sobre los diferentes eventos, consulte la Chatlio documentación de eventos.

Pasos siguientes next-steps

Al seguir este tutorial, configuró correctamente un flujo de datos de flujo continuo para llevar los datos de Chatlio al Experience Platform. Para supervisar los datos que se están ingiriendo, consulte la guía sobre supervisión de flujos de datos de flujo continuo mediante la interfaz de usuario de Platform.

Recursos adicionales additional-resources

Las secciones siguientes proporcionan recursos adicionales a los que puede hacer referencia al usar el origen Chatlio.

Validación validation

Para comprobar que ha configurado correctamente el origen y que se están introduciendo Chatlio mensajes, siga los pasos a continuación:

  • Puede consultar la página Chatlio Informes > Historial de chat para identificar los eventos que está capturando Chatlio.

Captura de pantalla de la IU Chatlio que muestra el historial de chats

  • En la interfaz de usuario de Platform, seleccione Ver flujos de datos junto al menú de tarjeta Chatlio en el catálogo de fuentes. A continuación, seleccione Vista previa del conjunto de datos para verificar los datos introducidos para los enlaces web que ha configurado en Chatlio.

Captura de pantalla de IU que muestra eventos ingeridos

Para obtener más información sobre Chatlio, visite la Chatlio documentación y preguntas frecuentes.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089