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.
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.
Flexível e fácil de usar: crie quantas tabelas precisar e personalize-as para as tarefas do seu negócio.
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á até a "Planilhas" seção no projeto necessário:
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:
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:
Você verá as seguintes configurações:
Função para adicionar colunas:
а) para adicionar colunas com letras
O botão adiciona à tabela colunas rotuladas de A a Z.
b) para adicionar colunas com nomes personalizados
Ao clicar no botão, abre-se um modal onde você pode nomear a nova coluna.
Digite um nome e clique em "Concluir" para adicionar a coluna à tabela.
Botão para adicionar linhas:
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 do Mavibot ou para outro serviço de planilhas.
O Importar CSV o recurso permite que você carregue dados de um serviço externo.
Outros recursos
Há um menu suspenso que permite navegar rapidamente entre as planilhas sem sair da seção principal.
Você também pode criar novas tabelas diretamente pelo menu lateral.
Para excluir uma planilha, vá para a seção principal:
Depois, encontre o Excluir botão no cartão da tabela que você deseja remover.
Atenção!
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 o ID de uma planilha
Você precisará de um ID da planilha para usar funções do chatbot relacionadas a esta tabela.
Navegue até a sua tabela. Encontre a tabela desejada na lista e clique no nome dela para abri-la.
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.
Exemplo: Em uma URL como
https://mavibot.ai/projects/11111/table/2o ID da tabela é2.Copiar 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 todos os dados da entrada editada no formato {"column_name1": "value3", "column_name2": "value4"}
Exemplo
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
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 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
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"]
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": "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"]
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"}
Atualizado