Acción (Action)
A menudo, al final de un flujo, se configurará una llamada de back-end de API para, por ejemplo, guardar un billete de tren en el sistema de pedido de billetes. Posteriormente, los usuarios deberían poder reservar un nuevo billete a una ubicación diferente.
Puede lograr esto con la acción 'borrar sesión'. Esta acción elimina los valores de las variables de sesión establecidas. Esto es útil cuando un usuario solicita corregir un valor o comenzar de nuevo y eliminar todas las variables.
Un usuario que llegue a esta acción será transferido a un agente de soporte al cliente humano. Para que esto funcione, debe habilitar la descarga.
Dependiendo de su proveedor de descarga seleccionado, es posible que se requiera una configuración adicional.
Esta acción se puede utilizar para integrar servicios de back-end en su bot. Puede encontrar más detalles en nuestro tutorial.
El editor de código permite a los desarrolladores crear rápidamente una lógica personalizada sobre el bot escribiendo sus propios bloques de código JavaScript. Normalmente, el editor de código se utiliza para realizar solicitudes a sistemas externos o para realizar operaciones con variables.
Puede encontrar más información sobre el editor de código aquí:
Editor de código /integrations/code-action
También hay dos tutoriales en los que le mostramos cómo se puede utilizar el editor de código:
Recuperando datos de Airtable (GET) /integrations/retrieving-data-from-airtable-get
Envío de datos a Airtable (POST) /integrations/airtable
Un iframe es un elemento personalizado que se puede utilizar para mostrar una página web diferente en la conversación de chat. También se puede utilizar para comunicarse con la ventana principal mediante la API postMessage.
Eche un vistazo a este ejemplo básico:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
</head>
<body>
<button onClick="window.parent.postMessage(JSON.stringify({target:'CL_API',type:'SEND_MESSAGE', payload:{text: 'You clicked the button'} }),'*')">
SEND_MESSAGE
</button>
</body>
</html>
Si este bloque de código está alojado e incrustado dentro de nuestro complemento iframe, enviará al usuario un mensaje de chat cuando haga clic en el botón.
La API postMessage también puede manejar eventos
ACTUALIZAR_SESION y IR_A_ESTADODEDIALOGO.Si su bot está publicado en el canal de la API de Webhook, puede usar la acción JSON Builder para enviar mensajes a la conversación que no necesitan generar un mensaje real para el usuario. Normalmente, se utiliza para enviar información sobre la conversación del usuario o del bot al sitio web en el que está publicado el bot.
Puede utilizar la acción del JSON Builder en combinación con el canal del widget web para recibir eventos de ventana en su página web. Estos eventos contendrán los datos configurados en su acción de construcción JSON.
He aquí un ejemplo:
Configure la acción del JSON Builder para enviar una clave de idioma, con una variable recuperada de la sesión, y la opción "Enviar configuración a la ventana principal" activada.
Acción del JSON Builder con un campo de idioma
Su widget activará un evento para esa configuración en su ventana principal como MessageEvent. El MessageEvent contendrá un campo `data` que contiene el resultado de la “cadena” de la configuración del JSON Builder. A continuación, se muestra un ejemplo de cómo escuchar estos eventos:
// Chatlayer JSON Builder Event Handler
window.addEventListener('message', (event) => {
const data = event && event.data && JSON.parse(event.data) || {}
const { type, payload } = data
if (type !== 'CL_DISPATCH_EVENT') return;
console.log('Chatlayer language received: ' + payload.language)
})