Envío de datos a una API mediante flujos de Oracle Infinity (heredado)

Introducción

En este tutorial se demostrará la recopilación de datos en Infinity y el envío a una API de ejemplo (mediante Streams (Legacy) y Action Center (Legacy) Webhooks) para un caso de uso ficticio de reducción de volúmenes del centro de llamadas.

¿Qué es un webhook?: un webhook es una forma de enviar datos a un punto final en tiempo real (por ejemplo, enviar datos de conversión a una API externa).

Objetivos

En este tutorial, completará un caso de uso ficticio de enviar por correo electrónico al cliente contenido de ayuda relevante cuando haga clic en el enlace "contacto" de su sitio web para reducir el número de consultas a las que se enfrenta su centro de contacto.

Usted:

Consulte el siguiente diagrama para ver una ilustración del caso de uso ficticio:

Ilustración del caso de uso

Imagen en la que se muestra dónde seleccionar una región.

Requisitos

Creación de un punto final ficticio

Crearemos un punto final ficticio para recibir nuestros datos de Infinity (que representa la API de una plataforma de correo electrónico para disparar correos electrónicos). Utilizaremos Beeceptor para nuestro punto final simulado.

  1. Visite Beeceptor, introduzca un nombre para el punto final y, a continuación, haga clic en Crear punto final.

    Seleccione un nombre de punto final único para este tutorial

    Imagen en la que se muestra dónde seleccionar una región.

  2. Copie la URL de punto final con Haga clic para copiar.

    Al abrir la URL de punto final en otra ventana/separador, debería ver las solicitudes que se muestran en la ventana/separador Beeceptor existente:

    Solicitudes en la ventana de Beeceptor original

    Imagen en la que se muestra dónde seleccionar una región.

  3. Pruebe el punto final.

    Visite la URL de punto final que ha copiado en la nueva ventana/separador del explorador para validar que está recibiendo datos correctamente.

    Copiar en el portapapeles

    Imagen en la que se muestra dónde seleccionar una región.

Creación de una conexión de webhook en el centro de acción (heredado)

Se necesita una conexión de webhook para enviar datos al punto final simulado recién creado.

  1. Abra la interfaz de usuario de Oracle Infinity.

  2. Haga clic en el menú superior izquierdo y vaya a Centro de acciones.

  3. Haga clic en Gestionar conexiones (en la esquina superior derecha).

  4. Haga clic en Conexión +New > Webhook (en la parte superior izquierda).

  5. Introduzca los detalles del punto final.

    • Nombre: My Email platform.

    • Protocolo de conexión: seleccione HTTP.

    • Seguridad (HTTPS/WSS): active esta casilla.

    • FQDN del servidor: introduzca el punto final de Beeceptor del portapapeles (menos https://). Por ejemplo, YOURENDPOINT.free.beeceptor.com.

    • Puerto : 443

    • Tipo de autenticación: None

      Detalles de la Conexión

    Imagen en la que se muestra dónde seleccionar una región.

  6. Haga clic en Conectar.

Creación de un destino en la conexión

Un destino dentro de una conexión permite formatear datos antes de enviarlos a una ubicación específica de la conexión.

  1. Seleccione la conexión y, a continuación, haga clic en Nuevo en Destinos.

  2. Introduzca los siguientes detalles:

    • Nombre: Website Actions
    • Punto final de URI: / (se utiliza para enviar a una ruta de acceso opcional en el punto final (por ejemplo, myinfinitytest.free.beeceptor.com/ con / al final es lo que se especifica aquí).
    • Agrupación de eventos: Single
    • Método HTTP: POST
    • Tipo/contenido de carga útil: application/json
    • Solicitar formateador: Twig

  3. Pegue la siguiente plantilla de código en la plantilla de solicitud de conexión:

    \{\% autoescape 'json' \%\}
{
 "customer_id":"\{\{events[0]['customer_id']\}\}",
 "event_name":"\{\{events[0]['event_name']\}\}"
}
\{\% endautoescape \%\}

    ¿Qué es Twig?: Twig es un lenguaje de plantilla que permite manipular la carga útil antes de enviarla al punto final. Es muy potente que el formato de las cargas útiles esté en el formato correcto para el punto final.

    Detalles de Destino

    Imagen en la que se muestra dónde seleccionar una región.

  4. Haga clic en Guardar.

Creación de un flujo

Tendrá que crear, probar y guardar un flujo (heredado) para capturar cuando simulemos un usuario haciendo clic en el botón Contacto en nuestro caso de uso ficticio, de modo que podamos enviarlo a nuestro punto final simulado.

  1. Creación del flujo

    Crearemos un Flujo escribiendo una consulta en busca de usuarios que hagan clic en el botón Contacto (un evento que simularemos en un paso posterior):

    • En la interfaz de usuario de Oracle Infinity, haga clic en el menú superior izquierdo y vaya a Streams.
    • Pegue la siguiente consulta como Consulta: data.wt.event_name AS 'event_name',data.wt.dcsvid AS 'customer_id' WHERE data.wt.event_name='contact us' AND Exists(data.wt.dcsvid) AND session.closed='false'.
    • Pulse Inicio.

    Definición de la consulta

    Imagen en la que se muestra dónde seleccionar una región.

    Consulta Explicación:

    La primera parte de la sentencia es una SELECT de los campos que queremos exponer en el flujo. Este sería el valor actual wt.event_name (Nombre de evento) y wt.dcsvid (ID de cliente).

    Ambos parámetros seleccionados con SELECT utilizan Alias declarando AS para que podamos declararlos como event_name y customer_id (lo que simplifica la creación de nuestra Acción en un paso posterior).

    WHERE que decide cuándo el flujo debe disparar una acción. Esto sería cuando el evento contiene wt.event_name='contact us' AND a wt.dcsvid (ID de cliente). Además, debemos utilizar session.closed=false para permitir que la acción se dispare inmediatamente (no espere hasta que finalice la sesión).

    Sintaxis de consulta de Streams: consulte el centro de ayuda de Oracle Infinity - Streams para obtener soporte de sintaxis de consulta completa.

  2. Prueba del flujo

    Validaremos los datos entrantes en nuestro flujo simulando un clic en el botón Contacto y comprobando si podemos ver los datos entrantes:

    • Vaya a su sitio web con el seguimiento de Infinity implantado (por ejemplo, mediante el uso de la etiqueta Oracle CX).
    • Abra la consola del explorador (por ejemplo, la consola de herramientas para desarrolladores en Google Chrome.
    • Copie el código siguiente y péguelo en la consola del explorador:
    	var cxDataObject = {	
	"wt.event_name":"contact us", // Sample Custom Variable
	"wt.dcsvid":"MYCUSTOMERID"
	}

	// DO NOT EDIT BELOW THIS LINE - ORA.click()
	window.ORA = window.ORA || {productReady: []};
	ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);

    MYCUSTOMERID: este valor representaría el ID del cliente en un despliegue real. En nuestro caso de uso ficticio, esto es lo que una plataforma de correo electrónico utilizaría para saber a quién enviar un mensaje por correo electrónico.

    Página de ejemplo con el código y la solicitud dcs.gif Infinity resultante en el separador Red.

    Imagen en la que se muestra dónde seleccionar una región.

  3. Guarde el flujo

    Guarde el flujo ahora que lo hemos validado correctamente:

    • Arrastre todos los parámetros del lado izquierdo al lienzo principal:

      Arrastrando parámetros

      Arrastrando parámetros.

    • Haga clic en Guardar el flujo y asígnele un nombre, como Contacto.

Cree su acción

Ahora podemos desarrollar la acción que conectará su Flujo a su Conexión para que los datos se muestren en su punto final simulado.

  1. En la interfaz de usuario de Oracle Infinity, haga clic en el menú superior izquierdo y vaya al Centro de acciones.

  2. Haga clic en +Create Action (Acción).

  3. Complete los siguientes campos:

    • Nombre: Contact Us - Email
    • Descripción: Sends Customer ID and Event Name upon Contact Us click
    • Intentar reenvío: déjelo como valor por defecto.

  4. En Destino, seleccione:

    • Webhook
    • Punto final de Beeceptor (o lo que llamó a su conexión).
    • Haga clic en Contacto (o en el que haya llamado Destino).

  5. En Datos, seleccione Contacto (o lo que le haya asignado a su Flujo) y, a continuación, haga clic en Guardar.

    ¿Mis variables ya están asignadas?: Como ha utilizado Alias en la consulta, observará que los parámetros seleccionados ya están asignados.

    Su flujo con asignaciones

    Arrastrando parámetros.

    ¿Qué hacen las asignaciones de campos?: los nombres event_name y customer_id que ha asignado son los que procesará la plantilla Twig configurada en su destino anteriormente en esta guía.

  6. Vuelva al Centro de acciones donde debería ver la nueva Acción.

  7. Haga clic en Iniciar para activar la acción.

Probar el flujo

Una vez completada la configuración, puede enviar datos a su Flujo y recibir la salida en su punto final simulado, simulando el caso de uso del centro de llamadas ficticio.

  1. Abra la ventana de beeceptor original, donde puede ver las solicitudes entrantes (por ejemplo, https://beeceptor.com/console/YOURNAMEOFMOCKENDPOINT).

  2. Abra la página de prueba donde está activa la etiqueta Infinity/CX

  3. Active otra solicitud según el paso 2 en Creación de un flujo:

    	var cxDataObject = {	
	"wt.event_name":"contact us", // Sample Custom Variable
	"wt.dcsvid":"MYCUSTOMERID"
	}

	// DO NOT EDIT BELOW THIS LINE - ORA.click()
	window.ORA = window.ORA || {productReady: []};
	ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);

Ahora debería ver los datos que se muestran en el punto final simulado, donde el punto final simulado simula la plataforma de correo electrónico* que recibe una señal entrante de Infinity:

Sus datos se muestran en el punto final ficticio

Imagen en la que se muestra dónde seleccionar una región.

*Entorno de producción: en un entorno de producción, tendría una carga útil más compleja el envío de datos a la API de una plataforma de correo electrónico real. Sin embargo, para este tutorial solo estamos utilizando un punto final simulado para mostrar la funcionalidad de Infinity.

Más recursos de aprendizaje

Explore otras prácticas en docs.oracle.com/learn o acceda a contenido de aprendizaje más gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de formación de Oracle.

Para obtener documentación sobre los productos, visite Oracle Help Center.