La sección "Hojas" en MaviBot es una herramienta para el almacenamiento y gestión de datos conveniente dentro de la plataforma. Ya no necesitas cambiar entre diferentes servicios: todas tus hojas ahora están disponibles en un solo proyecto.

Características:

  • Crea hojas con cualquier número de filas y columnas.
  • Almacena y edita datos sin herramientas o servicios de terceros.
  • Ingresa valores, edita filas y columnas, o elimínalos directamente a través del chatbot usando funciones.

Ventajas:

  • Simplifica la gestión de datos: puedes ingresar información en una tabla directamente desde el bot.
  • Flexible y fácil de usar: crea tantas tablas como necesites y personalízalas para tus tareas comerciales.

Gestiona tus tablas sin salir de MaviBot

Las tablas ayudan a las empresas a estructurar sus datos y acelerar los procesos.

Cómo crear hojas

Para comenzar, ve a la sección "Hojas" en el proyecto requerido:

A continuación, verás el botón "Crear una hoja". Haz clic en él para abrir una ventana modal donde debes ingresar el nombre de la tabla:

Ingresa un nombre para la tabla y haz clic en "Hecho". La nueva tabla se creará en el proyecto y aparecerá en la sección "Hojas".

Configuración de hojas

Después de crear la hoja, debes agregar filas y columnas. Para hacerlo, busca el botón "Ir a" en la tabla deseada y haz clic en él:

Verás la siguiente configuración:

  1. Función para agregar columnas:

a) para agregar columnas con letras

El botón agrega columnas etiquetadas de la A a la Z a la tabla.

b) para agregar columnas con nombres personalizados

Al hacer clic en el botón se abre una ventana modal donde puedes nombrar la nueva columna.

Ingresa un nombre y haz clic en "Hecho" para agregar la columna a la tabla.

  1. Botón para agregar filas:

  1. Exportación de hoja

Permite exportar la hoja en formato CSV con todos los datos y valores, por ejemplo, para mover la hoja a otro proyecto de MaviBot o a otro servicio de hojas de cálculo.

  1. La función Importar CSV te permite cargar datos desde un servicio externo.

Otras funciones

Hay un menú desplegable que te permite navegar rápidamente por las hojas sin salir de la sección principal.

También puedes crear nuevas tablas directamente desde el menú lateral.

Para eliminar una hoja, ve a la sección principal:

Luego, busca el botón Eliminar en la tarjeta de la tabla que deseas eliminar.

¡Advertencia!

Las tablas eliminadas no se pueden restaurar.

Cómo ingresar valores en la hoja

Puedes ingresar valores en la hoja manualmente:

O usando funciones en el chatbot.

Cómo encontrar un ID de hoja

Necesitarás un ID de hoja para usar las funciones del chatbot relacionadas con esta tabla.

  1. Navega a tu tabla. Encuentra la tabla deseada en la lista y haz clic en su nombre para abrirla.
  2. Localiza el ID de la tabla en la barra de direcciones. Haz clic en la barra de direcciones de tu navegador: el ID de la tabla es la cadena única de caracteres al final de la URL.

  1. Ejemplo:
    En una URL como https://mavibot.ai/projects/11111/table/2
    el ID de la tabla es 2.
  2. Copia el ID
    Selecciona y copia este número de la barra de direcciones para usarlo en la configuración de tu chatbot.

Cómo crear un nuevo registro en la hoja

new_record(table_id, data) – crea una nueva entrada en la tabla con los valores especificados.

table_id – el ID de la tabla

data – un diccionario que contiene los datos a ingresar. Ejemplo: {"column_name1": "value1", "column_name2": "value2"}. Si una columna no existe, se creará. Respuesta: el ID de la nueva entrada

Ejemplo

Cómo editar un registro existente en la hoja

edit_record(table_id, record_id, data)

table_id – el ID de la tabla

record_id – el ID de la entrada a editar

data – un diccionario que contiene los datos a actualizar. Ejemplo: {"column_name1": "value3", "column_name2": "value4"}. Si una columna no existe, NO se creará.

Respuesta: Devuelve los datos completos de la entrada editada en el formato {"column_name1": "value3", "column_name2": "value4"}

Ejemplo

Cómo eliminar un registro de la hoja por su ID

delete_record(table_id, record_id)

table_id – el ID de la tabla

record_id – el ID de la entrada a eliminar

Respuesta:

{'message': 'Deleted entries: 1'}

Cómo encontrar el primer registro con el valor especificado en una hoja

find_record(table_id, value, find_in, return_from)

table_id – el ID de la tabla

value – el valor a buscar

find_in – opcional. El nombre de la columna en la que buscar. Si no se especifica, la búsqueda se realizará en todas las columnas

return_from – opcional. El nombre de la columna de la cual devolver el valor

Respuesta: Si se especifica return_from, se devolverá el valor de la columna especificada (si existe en la tabla). Si no se especifica return_from o la columna no existe, se devolverán los datos completos de la entrada encontrada: {"column_name1": "value3", "column_name2": "value4"}

Ejemplo

Cómo obtener valores del registro especificado

get_record_data(table_id, record_id, return_column )

table_id – el ID de la tabla

record_id – el ID de la entrada de la cual obtener valores

return_column – opcional. El nombre de la columna de la cual devolver el valor

Respuesta: Si se encuentra la entrada, devuelve un diccionario como {"column_name1": "value1", "column_name2": "value2"}. Si se proporciona return_column y la columna existe, solo se devolverá el valor de esa columna.

Cómo recuperar todos los valores al buscar en múltiples columnas

find_records_multiple_cols_list(table_id, column_data, return_col, with_index, delimiter, algorithm) – Usa esta función cuando necesites buscar en múltiples columnas a la vez y recuperar una lista de valores de una columna en filas donde se encuentren todos los valores. (Esto es similar a la función sheet_search_in_multiple_cols_return_list para Google Sheets.)

table_id — el ID de la tabla

column_data — la consulta de búsqueda, es decir, lo que quieres encontrar

return_col — el número de columna del cual devolver valores

with_index — índice o numeración en la lista de valores encontrados (0 – numeración (1, 2, 3,…); 1 – índice de fila; "" – lista de valores en nuevas líneas sin índices ni numeración)

delimiter — separador entre el índice y el valor

algorithm — algoritmo de búsqueda (F – coincidencia exacta, K – coincidencia de palabra clave, R – expresión regular, 1–100 – porcentaje de similitud (ver detalles arriba))

Ejemplo:

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"]

Si la consulta se ejecuta correctamente, la respuesta es un diccionario que contiene el estado y todas las celdas con valores:

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

status — el resultado de la búsqueda

rows_index — un array con los números de las filas encontradas

quantity — el número de filas encontradas

list — una cadena con todos los valores de la columna seleccionada

Si ocurre un error, la respuesta será status: false junto con una descripción del error: {"status": false, "error": "Error or description"}

Cómo recuperar el primer valor al buscar en múltiples columnas

find_first_record_multiple_cols_row(table_id, column_data, algorithm) – usa esta función cuando necesites buscar en múltiples columnas a la vez y recuperar la primera fila coincidente. (Esto es similar a la función sheet_search_in_multiple_cols_return_row para Google Sheets.)

table_id — el ID de la tabla

columns — la consulta de búsqueda, es decir, lo que quieres encontrar

algorithm — el algoritmo de búsqueda (F – coincidencia exacta, K – coincidencia de palabra clave, R – expresión regular, 1–100 – porcentaje de similitud (ver detalles arriba))

Ejemplo:

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"]

Si la consulta se ejecuta correctamente, la respuesta es un diccionario que contiene el estado y todas las celdas con valores.

{"status":true,"rows_index":[2,3],"quantity":2,"row_data":{"ID":2,"name":"John","age":"26","city":"New York"},"row":2}

status — el resultado de la búsqueda

rows_index — un array con los números de las filas encontradas

row_data — datos de la fila encontrada

row — el número de la fila encontrada

Si ocurre un error, la respuesta será status: false junto con una descripción del error: {"status": false, "error": "Error or description"}