# Cómo trabajar con las hojas de MaviBot

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

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

**Funciones:**

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

**Ventajas:**

* **Simplifica la gestión de datos:** puedes introducir información en una tabla directamente desde el bot.&#x20;
* **Flexible y fácil de usar:** crea tantas tablas como necesites y personalízalas para las tareas de tu negocio.

{% hint style="success" %}

#### **Gestiona tus tablas sin salir de Mavibot**

Las tablas ayudan a las empresas a estructurar sus datos y acelerar los procesos.
{% endhint %}

## Cómo crear hojas

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

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

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

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

Introduce un nombre para la tabla y haz clic en **"Hecho"**. Luego, la nueva tabla se creará en el proyecto y aparecerá en la **"Hojas"** sección.

### Configuración de hojas

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

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

Verás la siguiente configuración:

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

1. Función para añadir columnas:

a) para añadir columnas con letras

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

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

b) para añadir columnas con nombres personalizados

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

Al hacer clic en el botón, se abre una ventana modal donde puedes poner nombre a la nueva columna.

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

Introduce un nombre y haz clic en **"Hecho"** para añadir la columna a la tabla.

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

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

2. Botón para añadir filas:

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

3. Exportación de la hoja

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

Te 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.

4. El **Importar CSV** la función te permite cargar datos desde un servicio externo.

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

### Otras funciones

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

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

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

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

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

Luego, encuentra el **Eliminar** botón en la tarjeta de la tabla que quieres quitar.

{% hint style="danger" %}
¡Advertencia!

Las tablas eliminadas no se pueden restaurar.
{% endhint %}

### Cómo introducir valores en la hoja

Puedes introducir valores en la hoja manualmente:

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

O usando funciones en el chatbot.

### **Cómo encontrar el ID de una hoja**

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

1. **Ve a tu tabla.** Busca 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.

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

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

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

### 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 introducir. Ejemplo: {"column\_name1": "value1", "column\_name2": "value2"}. Si una columna no existe, se creará. Respuesta: el ID de la nueva entrada

### Ejemplo

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

### 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 que se va a editar

data – un diccionario que contiene los datos que se actualizarán. 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

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

### 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 que se va a eliminar

Respuesta:

{'message': 'Entradas eliminadas: 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 que se va 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 desde la que devolver el valor

Respuesta: Si se especifica return\_from, se devolverá el valor de la columna indicada (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

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

### Cómo obtener valores del registro especificado

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

table\_id – el ID de la tabla

record\_id – el ID de la entrada de la que se van a recuperar valores

return\_column – opcional. El nombre de la columna desde la que 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 varias columnas&#x20;

find\_records\_multiple\_cols\_list(table\_id, column\_data, return\_col, with\_index, delimiter, algorithm) – usa esta función cuando necesites buscar en varias columnas a la vez y recuperar una lista de valores de una columna en las filas donde se encuentran todos los valores. (Esto es similar a la función sheet\_search\_in\_multiple\_cols\_return\_list de 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 la columna de la que se devolverán los 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 por 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"]

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

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

{"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 o descripción"}

### Cómo recuperar el primer valor al buscar en varias columnas

find\_first\_record\_multiple\_cols\_row(table\_id, column\_data, algorithm) – usa esta función cuando necesites buscar en varias columnas a la vez y recuperar la primera fila coincidente. (Esto es similar a la función sheet\_search\_in\_multiple\_cols\_return\_row de 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 por 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"]

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

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 o descripción"}


---

# 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/es/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.