Qué es una variable
Una variable es un elemento de datos al cual se le asigna un nombre y puede almacenar datos.
Por ejemplo, en programación podríamos ver:
animal = “perro”La palabra animal es el nombre o identificador de la variable y perro es el valor o dato que está almacenando.
Las variables se utilizan para:
- Guardar datos
- Asignar valores de una variable a otra
- Representar valores dentro de una expresión matemática
- Mostrar valor en la pantalla
Tipos de datos que se pueden almacenar
Al crear una variable debemos definir qué tipo de dato almacenará, que puede ser un número, un texto o una fecha.
Por ejemplo, si se define que una variable será numérica, no se le puede asignar un valor que no sea numérico, como “perro”. En tal caso el chatbot arrojará un error y la sesión de chatbot finalizará.
Las variables numéricas pueden guardar números positivos y negativos, números enteros y decimales, en este último caso se deberá utilizar el punto como separador decimal. Ej.: 1240.52
Las variables de texto pueden alojar cualquier tipo de valor, sin restricciones.
Las variables de tipo fecha deberán alojar una fecha con el formato dd/mm/aaaa exclusivamente.
Nombre de la variable
El nombre es el identificador de una variable, puede estar compuesto por letras, números y el símbolo _ o guion bajo. Es decir, no puede tener espacios, ni usar caracteres especiales ni letras con acentos.
Tampoco puedes asignarle el mismo nombre que cualquiera de las variables de sistema, que veremos más adelante.
Tener en cuenta que el nombre distingue las mayúsculas y minúsculas. Por ejemplo, puedes crear una variable llamada total y otra llamada Total, y serán variables diferentes.
Tipos de variables
Podemos identificar 3 tipos de variables o elementos de datos:
Variable: como ya hemos visto, es el nombre que se le da a un elemento de datos que aloja un valor básico, como un número, un texto o una fecha
Array: es como una variable, pero puede alojar múltiples valores.
Por ejemplo:
animales = [“perro”, ”gato”, “conejo”]El array animales tiene 3 elementos o ítems
Objeto: es como una variable especial que puede contener más variables en su interior. De esta forma, tenemos la posibilidad de organizar múltiples variables de la misma temática en el interior de un objeto. Las “variables” que se encuentran dentro de un objeto se llaman propiedades.
Ejemplo:
animal = {
tipo: “perro”,
raza: “bulldog”,
fecha_nacimiento: 15/02/2015
}Decimos que tipo, raza y fecha_nacimiento son propiedades del objeto animal.
Cómo crear una variable
Hay diferentes maneras para crear una variable en el chatbot:
- El método por excelencia es a través de la box Set Variable, la cual tiene como fin exclusivamente la creación de variables, array u objetos.
- La box Question, realiza una pregunta al usuario y la respuesta es almacenada en una variable, cuyo nombre deberás definirlo al momento de editar dicha box.
- La box Webhook realiza una solicitud HTTP a un servidor externo, la respuesta de dicho servidor es almacenada en una variable.
Cómo usar variables
Puedes incluir el contenido de una variable tanto en un mensaje a enviar al usuario como en prácticamente cualquier campo de texto de las diferentes boxes del chatbot.
En casi todos los casos, para “imprimir” el contenido de una variable, deberás cerrar su nombre entre doble llave, ej.: {{animal}}
Si tenemos que
animal = “perro”
En un mensaje podremos utilizar dicha variable así:
Tu mascota preferida es el {{animal}} -> Tu mascota preferida es el perro
De la misma manera podremos incluir variables en el texto de una pregunta o de un menú, o dentro del texto de una opción de un menú.
Asimismo, si quisiéramos enviar un mensaje multimedia, en lugar de especificar la URL del archivo que deseamos enviar podremos ingresar una variable. En todos los casos se deberá encerrar el nombre de la variable entre doble llave, para que el sistema pueda comprender que debe reemplazar ese texto por el valor de dicha variable.
Variables de sistema
Existen algunas variables que son proporcionadas por el sistema directamente.
contact
El objeto contact contiene información del contacto con el que estamos hablando. Tiene las siguientes propiedades
first_name: nombre
last_name: apellido
phone: es el número de teléfono del contacto, es el único dato que no se puede editar
email: correo electrónico, únicamente se aceptaran correos válidos.
Address: dirección. Campo de texto libre.
Dni:
cuit
brithdate: fecha de nacimiento, en formato dd/mm/aaaa.
client_number: campo de texto libre, normalmente utilizado por las empresas para identificar internamente a su cliente
is_new: indica, con un valor 1, si es la primera vez que se recibe un chat desde ese número de teléfono4. Todas las sesiones de chat posteriores desde ese teléfono, tendrá un valor 0. Esta propiedad se utiliza normalmente para ofrecer un saludo inicial diferente y consultarle al contacto sus datos personales, para registrarlos en el sistema.
En un mensaje podríamos utilizar:
Hola {{contact.first_name}}! Te estas comunicando desde el teléfono {{contact.phone}}
Variables de fecha
Utilizan el formato dd/mm/aaaa
today: Devuelve la fecha actual
yesterday: Devuelve la fecha de ayer
tomorrow: Devuelve la fecha de mañana