> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/dapta-mcp/skills/dapta-databases.md).

# Bases de Datos Dapta

Pídele a Claude que lea y cambie las bases de datos Dapta donde tus automatizaciones guardan su estado: encontrar tablas, leer filas, agregar, actualizar y eliminar filas, y crear nuevas bases de dato

Las bases de datos Dapta son donde las automatizaciones guardan su estado entre ejecuciones: los bloqueos que pone un flujo, cuántos intentos ha tenido un lead, cuándo llamar la próxima vez. Una vez que Dapta está conectado, puedes pedirle a Claude que las lea y las cambie.

{% hint style="info" %}
Cada escritura usa un flujo de **vista previa y luego confirmación**. Después de un cambio, Claude vuelve a leer las filas para confirmar lo que se escribió.
{% endhint %}

## Encuentra y lee datos

Pregúntale a Claude qué bases de datos y tablas tienes, qué columnas tiene una tabla y qué hay en ella. Claude describe las columnas antes de confiar en ellas, y pagina y filtra las tablas grandes para que una sola página nunca se confunda con la tabla completa.

**Prueba decir:**

* "¿Qué bases de datos Dapta tiene este workspace?"
* "¿Qué columnas tiene la tabla de leads?"
* "Muéstrame las filas donde los intentos son más de 3."

**Lo que recibes:** La lista de bases de datos y tablas, las columnas de una tabla, o las filas que pediste, con una nota cuando hay más filas de las que se muestran.

**¿Escribe datos?** No, solo lectura.

**Detrás de escena:** `list_dapta_databases`, `list_dapta_database_tables`, `describe_dapta_table`, `query_dapta_table_rows`.

***

## Agrega, actualiza y elimina filas

Pídele a Claude que cambie las filas de una tabla.

Cuando agregas filas, también puedes indicar una columna que identifica cada fila, como un número de teléfono. Una fila nueva cuyo valor ya existe en la tabla actualiza esa fila en lugar de agregar una segunda copia, y una fila sin coincidencia se agrega. Esa columna tiene que apuntar a una sola fila, porque las tablas de Dapta no exigen valores únicos: Claude rechaza el cambio si un valor coincide con más de una fila existente, si dos de las filas nuevas comparten un valor, o si una fila no tiene valor en esa columna. Elimina primero los duplicados, o usa una columna cuyos valores sean únicos. Puedes agregar hasta 100 filas a la vez.

**Prueba decir:**

* "Agrega estos tres leads a la tabla de seguimiento."
* "Agrega estos leads, y actualiza los que ya tienen su número de teléfono en la tabla."
* "Reinicia el contador de intentos de este número de teléfono."
* "Elimina las filas marcadas como prueba."

**Lo que recibes:** Una vista previa de exactamente qué filas se van a agregar, cambiar o eliminar. Cuando agregas filas por una columna clave, la vista previa muestra cuáles son nuevas y cuáles actualizan una fila existente. Después de que confirmas, Claude aplica el cambio y vuelve a leer las filas.

**¿Escribe datos?** Sí, con vista previa y luego confirmación. Actualizar y eliminar filas cambia o elimina datos existentes, y agregar filas por una columna clave puede cambiar filas existentes.

**Detrás de escena:** `preview_insert_dapta_rows` (con un `upsert_key` para actualizar las filas que coinciden) y `commit_insert_dapta_rows`, `preview_update_dapta_rows` y `commit_update_dapta_rows`, `preview_delete_dapta_rows` y `commit_delete_dapta_rows`.

***

## Crea una base de datos o una tabla

Pídele a Claude que cree una nueva base de datos Dapta, o una nueva tabla en una existente.

**Prueba decir:**

* "Crea una base de datos Dapta llamada Estado de Campaña."
* "Crea una tabla de intentos de llamada con teléfono, intentos y fecha de la próxima llamada."

**Lo que recibes:** Una vista previa de la base de datos o la tabla y sus columnas. Después de que confirmas, se crea.

**¿Escribe datos?** Sí, con vista previa y luego confirmación. Crear agrega datos nuevos y no cambia nada de lo que existe.

**Detrás de escena:** `preview_create_dapta_database` y `commit_create_dapta_database`, `preview_create_dapta_table` y `commit_create_dapta_table`.

***

## Relacionado

{% content-ref url="/pages/UENPgBo3u9wgM3P32W4e" %}
[Flow Studio](/dapta-docs-es/dapta-mcp/skills/flow-studio.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/dapta-mcp/skills/dapta-databases.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.