# Variables

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 <a href="#creating-variables" id="creating-variables"></a>

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 <a href="#editing-variables" id="editing-variables"></a>

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 <a href="#deleting-variables" id="deleting-variables"></a>

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 <a href="#using-a-variable" id="using-a-variable"></a>

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 <a href="#data-type-in-variables" id="data-type-in-variables"></a>

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 <a href="#system-variables-offered" id="system-variables-offered"></a>

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 <a href="#best-practices-for-variable-management" id="best-practices-for-variable-management"></a>

* **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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ayuda.topleads.co/topbots/creador-de-bots/variables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.