Las variables están diseñadas para almacenar información relacionada con una conversación. Esta información puede proceder del chatter, de una API externa o del canal de usuario en uso.
Detalles sobre las variables
Creación y gestión: Las variables de Flow Builder pueden crearse y editarse desde la página de gestión de variables.
Alcance global: Las variables de Flow Builder tienen un alcance global dentro de un chatbot. Una vez que una variable se crea o se importa (mediante clonación) en un chatbot, estará disponible para su uso en cualquier Use Case dentro de ese chatbot.
Integración con Advanced Builder: Las variables recopiladas mediante Flow Builder pueden utilizarse en Advanced Builder, incluso imprimirse en una respuesta, usarse en condiciones o enviarse mediante una conexión API. Si una variable de Flow Builder y una variable de Advanced Builder comparten el mismo nombre, el sistema dará prioridad a la variable de Flow Builder.
Uso unidireccional: Las variables recopiladas con Advanced Builder no pueden utilizarse en Flow Builder.
Eliminación: Las variables de Flow Builder pueden eliminarse siempre que no estén en uso dentro de un flujo (las variables del sistema no pueden eliminarse).
Categorías de variables
Las variables de Flow Builder se clasifican en tres tipos:
1. Variables personalizadas
Color: Morado en ViaSay Platform.
Creación: Pueden declararse desde la página de gestión de variables o desde los pasos de entrada del usuario, carga de archivos y API.
Actualización del valor: Los valores pueden actualizarse desde los pasos de entrada del usuario, carga de archivos y API.
2. Variables del canal de usuario
Color: Amarillo en ViaSay Platform.
Creación: Solo pueden declararse desde la página de gestión de variables.
Actualización del valor: Los valores solo pueden actualizarse desde el lado del canal de usuario (por ejemplo, en el script de integración del widget o desde WhatsApp Push). Flow Builder no puede modificar el valor de user_channel_variables.
Ejemplo: Si el estado de un usuario cambia durante una conversación (por ejemplo, inicia sesión), el sitio web puede transmitir variables adicionales a través del canal de usuario para ofrecer una experiencia más personalizada.
Restricciones de nomenclatura: No se permiten letras mayúsculas, espacios ni símbolos (excepto guiones bajos). La convención de nomenclatura recomendada es lower_snake_case.
Coherencia: La nomenclatura del script de integración del widget o de WhatsApp Push debe coincidir exactamente con la nomenclatura de la plataforma.
👍 Las variables del canal de usuario son ideales para crear escenarios más rápidos y personalizados para los usuarios o para acceder a recursos de API (por ejemplo, pasar parámetros como user_id o tokens desde tu sitio web al chatbot).
Consulta esta página para saber cómo funciona.
3. Variables del sistema
Color: Rojo en ViaSay Platform.
Restricciones: No pueden editarse (cambiarles el nombre ni eliminarse).
Creación y actualización: Solo pueden ser declaradas y actualizadas por los equipos de ViaSay.
Lista completa de variables del sistema
Nombre | Descripción | Ejemplos de formatos de valor |
|---|---|---|
bot_language | Idioma que utiliza el chatbot para una conversación determinada. | "fr_FR"; "en_US" |
chatter_browser_language | Idioma configurado como preferido en el navegador del chatter. | "fr_FR"; "en_US" |
user_channel_type | Tipo de canal a través del cual se comunica el chatter. | "widget"; "whatsapp"; "facebook_messenger"; "message_trigger_interface" |
user_channel_uuid | ID del canal de usuario a través del cual habla el chatter. | "0a3e08d1-1111-48fb-84b6-e22d011573a9" |
chatter_start_url | URL de la página del sitio web donde comenzó la conversación. | |
fb_messenger_first_name | Nombre del chatter en el contexto de Facebook Messenger. | "Mickey" |
fb_messenger_last_name | Apellido del chatter en el contexto de Facebook Messenger. | "Mouse" |
fb_messenger_id | ID de usuario del chatter en el contexto de Facebook Messenger. | "5778711235598645" |
fb_messenger_ref | Parámetros de URL compartidos por Facebook Messenger. | Objeto JSON convertido en cadena: "{\"key\":\"value\"}" |
last_user_message | Mensaje más reciente del usuario. | "Can I connect from my iPhone?" |
last_bot_message | Mensaje más reciente del bot | "Yes — you can log in from your iPhone by tapping 'Sign In' on the home screen." |
conversation_history | Una única cadena concatenada de los últimos 10 mensajes (tanto del agente como del usuario) para conservar un contexto más completo. | "agent: Hello! user: Hi, I have a question. agent: Sure, what is it? user: ..." (hasta 10 intercambios) |
*Las variables de memoria se convierten en cadenas para las llamadas a la API.
💡 Cómo encontrar "user_channel_uuid"
En ViaSay Platform, ve a Integrate > Channels > User Channels y selecciona el canal. Encontrarás el
user_channel_uuiden la URL, por ejemplo, https://chatbot.ViaSay.com/channels/user_channel_uuid.