A seção "Planilhas" no MaviBot é uma ferramenta para armazenamento e gerenciamento conveniente de dados 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.

Recursos:

  • Crie planilhas com qualquer número 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 do bot.
  • Flexível e fácil de usar: crie quantas tabelas precisar e personalize-as para suas tarefas de negócios.

Gerencie suas tabelas sem sair do Mavibot

As tabelas ajudam as empresas a estruturar seus dados e acelerar processos.

Como criar planilhas

Para começar, vá para a seção "Planilhas" no projeto desejado:

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

Insira um nome para a tabela e clique em "Concluído". A nova tabela será então criada no projeto e aparecerá na seção "Planilhas".

Configurações da planilha

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

Você verá as seguintes configurações:

  1. Função para adicionar colunas:

a) para adicionar colunas com letras

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

b) para adicionar colunas com nomes personalizados

Clicar no botão abre uma janela modal onde você pode nomear a nova coluna.

Insira um nome e clique em "Concluído" para adicionar a coluna à tabela.

  1. Botão para adicionar linhas:

  1. Exportação da planilha

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

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

Outros recursos

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

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

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

Em seguida, encontre o botão Excluir no cartão da tabela que deseja remover.

Aviso!

Tabelas excluídas não podem ser restauradas.

Como inserir valores na planilha

Você pode inserir valores na planilha manualmente:

Ou usando funções no chatbot.

Como encontrar um ID de planilha

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

  1. Navegue até sua tabela. Encontre a tabela desejada na lista e clique em seu nome 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.

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

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

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 os dados completos da entrada editada no formato {"column_name1": "value3", "column_name2": "value4"}

Exemplo

Como excluir um registro da planilha pelo seu 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': 'Deleted entries: 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 na qual pesquisar. Se não for especificado, a pesquisa 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 existir na tabela). Se return_from não for especificado ou a coluna não existir, os dados completos da entrada encontrada serão retornados: {"column_name1": "value3", "column_name2": "value4"}

Exemplo

Como obter valores do registro especificado

get_record_data(table_id, record_id, return_column )

table_id – o ID da tabela

record_id – o ID da entrada da qual recuperar 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

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 em linhas onde todos os valores são encontrados. (Isso é semelhante à função sheet_search_in_multiple_cols_return_list para 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 da qual retornar 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 pesquisa (F – correspondência exata, K – correspondência de palavra-chave, R – expressão regular, 1–100 – porcentagem de similaridade (veja detalhes acima))

Exemplo:

table_id = 7

data = {"age": "26", "city": "New 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"]

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,"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": "Error or description"}

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 para Google Sheets.)

table_id — o ID da tabela

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

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

Exemplo:

table_id = 7

data = {"age": "26", "city": "New 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"]

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":"New 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": "Error or description"}