# Trabajar con variables

## Cómo obtener los valores de las variables del cliente

get\_client\_var() | get\_client\_vars()

<details>

<summary>Descripción</summary>

<mark style="color:predeterminado;background-color:blue;">**Para obtener el valor de una sola variable**</mark>

**get\_client\_var(client\_id, variable)**

Parámetros:\ <mark style="color:rojo;">**!**</mark>**&#x20;client\_id -** ID del cliente\ <mark style="color:rojo;">**!**</mark>**&#x20;variable -** nombre de la variable

<mark style="color:predeterminado;background-color:blue;">**Para obtener los valores de varias variables**</mark>

**get\_client\_vars(client\_id, names)**

Parámetros:\ <mark style="color:rojo;">**!**</mark>**&#x20;client\_id -** ID del cliente\ <mark style="color:rojo;">**!**</mark>**&#x20;names-** array de variables

</details>

<details>

<summary>Ejemplo</summary>

Enviemos al administrador un mensaje con el número de lección que está tomando uno de los participantes de nuestro proyecto:

<div data-with-frame="true"><figure><img src="/files/a96ea3f691cc1f1273cb71d35342d640c75d1b52" alt="" width="563"><figcaption><p>Ejemplo de uso de la función para obtener el valor de una variable</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/b0789028ec0618b5af743b98f398fd20539370c9" alt="" width="375"><figcaption><p>Resultado de la función</p></figcaption></figure></div>

La misma opción, pero con salida, por ejemplo, del nivel y la lección dentro de él:

<div data-with-frame="true"><figure><img src="/files/e2ed9bc406d1610e14a0cd567269452cdb7a61b7" alt=""><figcaption><p>Ejemplo de uso de la función para obtener varios valores</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/50f87657d803bf27240fccb267b0957428650afd" alt="" width="350"><figcaption><p>Resultado de la función</p></figcaption></figure></div>

</details>

<details>

<summary>Ejemplo de código para copiar</summary>

```
/*Obteniendo una sola variable*/
trial=get_client_var(64732310, 'lesson')

/*Obteniendo varias variables*/
names=["level","lesson"]
trial=get_client_vars(64732310, names)
```

</details>

## Cómo asignar una variable del cliente

set\_client\_var() | set\_client\_vars()

<details>

<summary>Descripción</summary>

<mark style="color:predeterminado;background-color:blue;">**Para asignar el valor de una sola variable**</mark>

**set\_client\_var(client\_id, variable, value)**

Parámetros:

**client\_id** — ID del cliente MaviBot\
**variable** — nombre de la variable que se asignará\
**value** — valor de la variable

<mark style="color:predeterminado;background-color:blue;">**Para asignar varias variables**</mark>

**set\_client\_vars(client\_id, variables\_dict)**

Parámetros:

**client\_id** — ID del cliente MaviBot\
**variables\_dict** — diccionario; contiene todos los nombres de variables y sus valores que se añadirán. \
Formato:\
'{"var\_name1": "var\_value1", "var\_name2": "var\_value2", "var\_name3": "var\_value3"}'

</details>

<details>

<summary>Ejemplo</summary>

Ejemplo 1:

set\_client\_var(client\_id, "new", "yes")

<div data-with-frame="true"><figure><img src="/files/b728296998f4abd201da657cf5af815583c9d6b8" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/d0ad6aa245e9e7e9cdc9c304e861ec50f0abd066" alt=""><figcaption></figcaption></figure></div>

Ejemplo 2:

set\_client\_vars(1136, '{"var\_name1": "var\_value1", "var\_name2": "var\_value2", "var\_name3": "var\_value3"}')

<div data-with-frame="true"><figure><img src="/files/378768d7a646ade14c0a067691d0e05e2c025c3b" alt=""><figcaption></figcaption></figure></div>

Sección de variables en la tarjeta del cliente

<div data-with-frame="true"><figure><img src="/files/db2914588bbe2781eb8b73ad1cdd173ab6c20937" alt=""><figcaption></figcaption></figure></div>

&#x20;

</details>


---

# 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://docs.mavibot.ai/doc/es/chatbot/functions/calculadora/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.