# Como trabalhar com planilhas do MaviBot

O **"Planilhas"** A seção em MaviBot é uma ferramenta para armazenamento e gerenciamento de dados de forma prática dentro da plataforma. Você não precisa mais alternar entre diferentes serviços — todas as suas planilhas agora estão disponíveis em um único projeto.

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

**Recursos:**

* Crie planilhas com qualquer quantidade de linhas e colunas.
* Armazene e edite dados sem ferramentas ou serviços de terceiros.
* Insira valores, edite linhas e colunas ou exclua-os diretamente pelo chatbot usando funções.

**Vantagens:**

* **Simplifica o gerenciamento de dados:** você pode inserir informações em uma tabela diretamente pelo bot.&#x20;
* **Flexível e fácil de usar:** crie quantas tabelas precisar e personalize-as para as tarefas do seu negócio.

{% hint style="success" %}

#### **Gerencie suas tabelas sem sair do Mavibot**

As tabelas ajudam as empresas a estruturar seus dados e acelerar processos.
{% endhint %}

## Como criar planilhas

Para começar, vá até a **"Planilhas"** seção no projeto necessário:

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

Em seguida, você verá o **"Criar uma planilha"** botão. Clique nele para abrir uma janela modal na qual você precisa inserir o nome da tabela:

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

Digite um nome para a tabela e clique em **"Concluir"**. A nova tabela será então criada no projeto e aparecerá na seção **"Planilhas"** .

### Configurações da planilha

Depois de criar a planilha, você precisa adicionar linhas e colunas. Para isso, encontre o botão "Ir para" na tabela desejada e clique nele:

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

Você verá as seguintes configurações:

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

1. Função para adicionar colunas:

а) para adicionar colunas com letras

<div data-with-frame="true"><figure><img src="/files/03947a9ea3bd345254d6999df02d44a981dc6036" alt="" width="350"><figcaption></figcaption></figure></div>

O botão adiciona à tabela colunas rotuladas de A a Z.

b) para adicionar colunas com nomes personalizados

<div data-with-frame="true"><figure><img src="/files/721d33feed03c4c14df1233ca7ee4ff483347112" alt="" width="339"><figcaption></figcaption></figure></div>

Ao clicar no botão, abre-se um modal onde você pode nomear a nova coluna.

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

Digite um nome e clique em **"Concluir"** para adicionar a coluna à tabela.

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

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

2. Botão para adicionar linhas:

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

3. Exportação da planilha

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

Permite exportar a planilha no formato CSV com todos os dados e valores, por exemplo, para mover a planilha para outro projeto do Mavibot ou para outro serviço de planilhas.

4. O **Importar CSV** o recurso permite que você carregue dados de um serviço externo.

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

### Outros recursos

Há um menu suspenso que permite navegar rapidamente entre as planilhas sem sair da seção principal.

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

Você também pode criar novas tabelas diretamente pelo menu lateral.

Para excluir uma planilha, vá para a seção principal:

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

Depois, encontre o **Excluir** botão no cartão da tabela que você deseja remover.

{% hint style="danger" %}
Atenção!

Tabelas excluídas não podem ser restauradas.
{% endhint %}

### Como inserir valores na planilha

Você pode inserir valores na planilha manualmente:

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

Ou usando funções no chatbot.

### **Como encontrar o ID de uma planilha**

Você precisará de um ID da planilha para usar funções do chatbot relacionadas a esta tabela.

1. **Navegue até a sua tabela.** Encontre a tabela desejada na lista e clique no nome dela para abri-la.
2. **Localize o ID da tabela na barra de endereços.** Clique na barra de endereços do seu navegador — o ID da tabela é a sequência única de caracteres no final da URL.

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

3. **Exemplo:**\
   Em uma URL como `https://mavibot.ai/projects/11111/table/2`\
   o ID da tabela é **`2`**.
4. **Copiar o ID**\
   Selecione e copie este número da barra de endereços para usar na configuração do seu chatbot.

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

### Como criar um novo registro na planilha

new\_record(table\_id, data) – cria uma nova entrada na tabela com os valores especificados.

table\_id – o ID da tabela

data – um dicionário contendo os dados a serem inseridos. Exemplo: {"column\_name1": "value1", "column\_name2": "value2"}. Se uma coluna não existir, ela será criada. Resposta: o ID da nova entrada

### Exemplo

<div data-with-frame="true"><figure><img src="/files/747ed5c874c0e947f2a456645135a84ed8874d5f" alt="" width="375"><figcaption></figcaption></figure></div>

### Como editar um registro existente na planilha

edit\_record(table\_id, record\_id, data)

table\_id – o ID da tabela

record\_id – o ID da entrada a ser editada

data – um dicionário contendo os dados a serem atualizados. Exemplo: {"column\_name1": "value3", "column\_name2": "value4"}. Se uma coluna não existir, ela NÃO será criada.

Resposta: Retorna todos os dados da entrada editada no formato {"column\_name1": "value3", "column\_name2": "value4"}

### Exemplo

<div data-with-frame="true"><figure><img src="/files/23972017220dacc564bfe9c71c93e586a6fda2e4" alt="" width="375"><figcaption></figcaption></figure></div>

### Como excluir um registro da planilha pelo ID

delete\_record(table\_id, record\_id)

table\_id – o ID da tabela

record\_id – o ID da entrada a ser excluída

Resposta:

{'message': 'Entradas excluídas: 1'}

### Como encontrar o primeiro registro com o valor especificado em uma planilha

find\_record(table\_id, value, find\_in, return\_from)

table\_id – o ID da tabela

value – o valor a ser pesquisado

find\_in – opcional. O nome da coluna em que será feita a busca. Se não for especificado, a busca será realizada em todas as colunas

return\_from – opcional. O nome da coluna da qual retornar o valor

Resposta: Se return\_from for especificado, o valor da coluna especificada será retornado (se ela existir na tabela). Se return\_from não for especificado ou a coluna não existir, serão retornados todos os dados da entrada encontrada: {"column\_name1": "value3", "column\_name2": "value4"}

### Exemplo

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

### Como obter valores do registro especificado

get\_record\_data(table\_id, record\_id, return\_column )&#x20;

table\_id – o ID da tabela

record\_id – o ID da entrada da qual recuperar os valores

return\_column – opcional. O nome da coluna da qual retornar o valor

Resposta: Se a entrada for encontrada, retorna um dicionário como {"column\_name1": "value1", "column\_name2": "value2"}. Se return\_column for fornecido e a coluna existir, apenas o valor dessa coluna será retornado.

### Como recuperar todos os valores ao pesquisar em várias colunas&#x20;

find\_records\_multiple\_cols\_list(table\_id, column\_data, return\_col, with\_index, delimiter, algorithm) – Use esta função quando precisar pesquisar em várias colunas ao mesmo tempo e recuperar uma lista de valores de uma coluna nas linhas em que todos os valores são encontrados. (Isso é semelhante à função sheet\_search\_in\_multiple\_cols\_return\_list do Google Sheets.)

**table\_id** — o ID da tabela

**column\_data** — a consulta de pesquisa, ou seja, o que você deseja encontrar

**return\_col** — o número da coluna de onde retornar os valores

**with\_index** — índice ou numeração na lista de valores encontrados (0 – numeração (1, 2, 3,…); 1 – índice da linha; "" – lista de valores em novas linhas sem índices ou numeração)

**delimiter** — separador entre o índice e o valor

**algorithm** — algoritmo de busca (F – correspondência exata, K – correspondência por palavra-chave, R – expressão regular, 1–100 – porcentagem de similaridade (veja os detalhes acima))

Exemplo:

table\_id = 7

data = {"age": "26", "city": "Nova York"}

return\_col = "name"

with\_index = 1

delimiter = " - "

algorithm = "F"

res = find\_records\_multiple\_cols\_list(table\_id, data, return\_col, with\_index, delimiter, algorithm)

res\_list = res\["list"]

<div data-with-frame="true"><figure><img src="/files/34e9a0f7967c070bc4cf9e440abaf0dd7ed8b054" alt="" width="375"><figcaption></figcaption></figure></div>

Se a consulta for executada com sucesso, a resposta é um dicionário contendo o status e todas as células com valores:&#x20;

{"status":true,"rows\_index":\[2,3],"quantity":2,"list":"2 - John\n3 - Anna"}

**status** — o resultado da pesquisa

**rows\_index** — um array com os números das linhas encontradas

**quantity** — o número de linhas encontradas

**list** — uma string com todos os valores da coluna selecionada

Se ocorrer um erro, a resposta será status: false junto com uma descrição do erro: {"status": false, "error": "Erro ou descrição"}

### Como recuperar o primeiro valor ao pesquisar em várias colunas

find\_first\_record\_multiple\_cols\_row(table\_id, column\_data, algorithm) – use esta função quando precisar pesquisar em várias colunas ao mesmo tempo e recuperar a primeira linha correspondente. (Isso é semelhante à função sheet\_search\_in\_multiple\_cols\_return\_row do Google Sheets.)

**table\_id** — o ID da tabela

**columns** — a consulta de pesquisa, ou seja, o que você deseja encontrar

**algorithm** — o algoritmo de busca (F – correspondência exata, K – correspondência por palavra-chave, R – expressão regular, 1–100 – porcentagem de similaridade (veja os detalhes acima))

Exemplo:

table\_id = 7

data = {"age": "26", "city": "Nova York"}

algorithm = "F"

res = find\_first\_record\_multiple\_cols\_row(table\_id, data, algorithm)

row\_data = res\["row\_data"]

row\_id = row\_data\["ID"]

row\_name = row\_data\["name"]

row\_age = row\_data\["age"]

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

Se a consulta for executada com sucesso, a resposta é um dicionário contendo o status e todas as células com valores.

{"status":true,"rows\_index":\[2,3],"quantity":2,"row\_data":{"ID":2,"name":"John","age":"26","city":"Nova York"},"row":2}

**status** — o resultado da pesquisa

**rows\_index** — um array com os números das linhas encontradas

**row\_data** — dados da linha encontrada

**row** — o número da linha encontrada

Se ocorrer um erro, a resposta será status: false junto com uma descrição do erro: {"status": false, "error": "Erro ou descrição"}


---

# 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/sheets/settings.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.