# Trabalhando com variáveis

## Como obter valores de variáveis do cliente

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

<details>

<summary>Descrição</summary>

<mark style="color:padrão;background-color:blue;">**Para obter o valor de uma única variável**</mark>

**get\_client\_var(client\_id, variável)**

Parâmetros:\ <mark style="color:vermelho;">**!**</mark>**&#x20;client\_id -** ID do cliente\ <mark style="color:vermelho;">**!**</mark>**&#x20;variable -** nome da variável

<mark style="color:padrão;background-color:blue;">**Para obter os valores de várias variáveis**</mark>

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

Parâmetros:\ <mark style="color:vermelho;">**!**</mark>**&#x20;client\_id -** ID do cliente\ <mark style="color:vermelho;">**!**</mark>**&#x20;names-** array de variáveis

</details>

<details>

<summary>Exemplo</summary>

Vamos enviar ao gerente uma mensagem com o número da lição que um dos participantes do nosso projeto está fazendo:

<div data-with-frame="true"><figure><img src="/files/66af574e4d7bce6a38f50aa1d908a69a9c68b55e" alt="" width="563"><figcaption><p>Exemplo de uso da função para obter o valor de uma variável</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/58c1f04f91b5cfbd0d898c7513cecadd5ad34066" alt="" width="375"><figcaption><p>Resultado da função</p></figcaption></figure></div>

A mesma opção, mas com a saída, por exemplo, do nível e da lição dentro dele:

<div data-with-frame="true"><figure><img src="/files/0c7b14a2d3c91e15d7bdfc8b26fa6130fb66b23d" alt=""><figcaption><p>Exemplo de uso da função para obter vários valores</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/b2b780f23a04e00a343da12f922f544dc82ea7c6" alt="" width="350"><figcaption><p>Resultado da função</p></figcaption></figure></div>

</details>

<details>

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

```
/*Obtendo uma única variável*/
trial=get_client_var(64732310, 'lesson')

/*Obtendo várias variáveis*/
names=["level","lesson"]
trial=get_client_vars(64732310, names)
```

</details>

## Como atribuir uma variável do cliente

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

<details>

<summary>Descrição</summary>

<mark style="color:padrão;background-color:blue;">**Para atribuir o valor de uma única variável**</mark>

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

Parâmetros:

**client\_id** — ID do cliente MaviBot\
**variable** — nome da variável a ser atribuída\
**value** — valor da variável

<mark style="color:padrão;background-color:blue;">**Para atribuir várias variáveis**</mark>

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

Parâmetros:

**client\_id** — ID do cliente MaviBot\
**variables\_dict** — dicionário; contém todos os nomes das variáveis e seus valores a serem adicionados. \
Formato:\
'{"var\_name1": "var\_value1", "var\_name2": "var\_value2", "var\_name3": "var\_value3"}'

</details>

<details>

<summary>Exemplo</summary>

Exemplo 1:

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

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

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

Exemplo 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/502d56354e86b1542f735d890209d91b0d99d1f2" alt=""><figcaption></figcaption></figure></div>

Seção de variáveis no cartão do cliente

<div data-with-frame="true"><figure><img src="/files/72603512a2e4c5143aad76e5d61b8328e7c11125" 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/pt/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.