Variables

Las variables son objetos reutilizables que contienen un valor enviado por el usuario.

Las variables son esenciales para capturar y utilizar los datos de forma dinámica en la conversación. Con las variables, puedes personalizar la experiencia de chat pudiendo decir "¡Hola Hardik!", en lugar de "¡Hola!".

Tipos de variables:

• Variable de sistema: creada de forma predeterminada por TopBots. Contiene cosas como ciudad, país, os etcétera.

• Variable de contacto: almacena el valor de la variable para las conversaciones recurrentes. Por lo general, se utiliza para recopilar nombres, correo electrónico, etcétera.

• Variable de conversación: almacena el valor de la variable solo para esa conversación.

Creación de variables

Puede crear variables desde dos lugares:

1 - De la lista de variables

En Configuración > variables, encontrará todas las variables en su espacio de trabajo. Puede hacer clic en "Crear" para crear una nueva variable y proporcionar detalles como: nombre, descripción y tipo.

2 - Desde el constructor de bots

En los bloques de acción que le permiten guardar la entrada del usuario como "Recopilar entrada", "Botones", etc., etcétera, tiene la opción de crear una nueva variable.

Primero, elige el tipo de variable, luego proporciona los detalles como nombre, descripción, tipo.

Edición de variables

Vaya a Configuración > variables > haga clic en "Editar" en la variable.

Solo se le permitirá editar la descripción y el tipo de datos.

Eliminación de variables

Las variables solo se pueden archivar y no eliminar.

Vaya a Configuración > Variables y haga clic en "Archivar" en la variable que desea archivar.

Uso de una variable

Puede invocar una variable escribiendo # para obtener una vista previa del menú desplegable de variables en el generador de bots.

Tipo de datos en variables

Puede almacenar el siguiente tipo de datos en variables:

Tipo de dato	Descripción
Mensaje de texto	Almacena cualquier entrada de texto.
Número	Almacena solo dígitos numéricos del 0 al 9.
Booleano	Almacena solo 0, 1, verdadero, falso.
Fecha	Almacena formatos de fecha como DD/MM/AAAA y MM/DD/AAAA
Correo electrónico	Almacena direcciones de correo electrónico.
Teléfono	Almacena números de teléfono.
Regex	Almacena la entrada en función de la regla de validación.

Variables del sistema ofrecidas

Estas son las variables del sistema que se ofrecen de forma predeterminada:

Variable	Descripción
nombre	Nombre del visitante
Correo electrónico	Correo electrónico del visitante
Teléfono	Número de teléfono del visitante
ip_address	Dirección IP del visitante
ciudad	Ciudad detectada a través de la dirección IP del visitante
estado	Estado detectado a través de la dirección IP del visitante
Código postal	Código postal detectado a través de la dirección IP del visitante
país	País detectado a través de la dirección IP del visitante
Zona horaria	Zona horaria del navegador del visitante
sistema operativo	Sistema operativo del visitante
referrer_url	Dominio de referencia para el visitante.
unsubscribed_phone_numbers	Si el número de teléfono se ha dado de baja de la mensajería saliente.
utm_source	Fuente Utm
utm_medium	Medio Utm
utm_campaign	Campaña Utm
utm_content	Contenido Utm
utm_term	Término Utm
Explorador	Navegador utilizado durante el chat
contact_id
bot	Nombre del bot con el que interactuó el visitante.
browser_language	Idioma establecido en el navegador.
Explorador	Nombre del navegador.
canal	Nombre del canal en el que se realizó el chat.
contact_created_by	Quién creó el contacto.
conversation_url	Enlace a la conversación.
country_code	Código de país ISO del país desde donde se originó el chat.
created_at	Fecha en la que se creó el chat.
gcal_selected_slot_day	Día seleccionado al reservar la reunión en Google Calendar.
gcal_selected_slot_time	Hora seleccionada al reservar la reunión en Google Calendar.
Zona horaria	Zona horaria del dispositivo.
URL	URL de la página web en la que el usuario interactúa con el bot.

Prácticas recomendadas para la gestión de variables

• Use nombres descriptivos: elija nombres de variables que reflejen claramente los datos que contienen, como "userEmail" o "orderTotal".

• Documenta con un propósito: Escribe descripciones claras que expliquen el papel de la variable dentro del flujo de trabajo de tu agente de IA.

• Mantenga la coherencia: utilice una convención de nomenclatura coherente para las variables a fin de que sean fácilmente identificables y manejables.

• Revisa y perfecciona regularmente: A medida que tu agente de IA evoluciona, revisa tus variables para ver si todavía sirven para su propósito previsto o si necesitan ajustes.