# Consultas SQL

> Consultas SQL

Source: https://docs.plazbot.com/kb/consultas-sql

En **Consultas** le haces tus propias preguntas a los datos del workspace usando SQL. Lo encuentras en el menú principal.

[Watch the video on YouTube](https://www.youtube.com/watch?v=9USOeHvtBkA)

## Sincronizar los datos

Las consultas no leen la base en vivo: leen una **copia** de tus datos. Presiona **Sincronizar datos** (arriba a la derecha) para actualizarla.

- La primera vez trae los contactos, mensajes y conversaciones de los **últimos 30 días**. Después, cada sincronización trae solo lo nuevo.
- Mientras corre ves cada paso (_Sincronizando contactos 3/8_…). Al terminar aparece **Sincronizado en N s**.
- No se sincroniza sola: vuelve a presionar el botón cuando necesites datos recientes.

## Tablas

En **Tablas**, abajo a la izquierda, tienes las seis disponibles:

Tabla

Contenido

`contacts`

Contactos del workspace

`messages`

Mensajes enviados y recibidos (incluye costo y tokens de agentes IA)

`conversations`

Envíos de plantillas y campañas

`opportunities`

Oportunidades de venta

`users`

Miembros del equipo

`campaigns`

Campañas masivas

- Despliega una tabla para ver sus columnas. Un clic en una columna la inserta en el editor.
- El botón **▶** abre una vista previa en una pestaña nueva: `SELECT * FROM tabla LIMIT 100`.

## Escribir y ejecutar

- El editor sugiere tablas y columnas mientras escribes (también después de un alias, como `c.`).
- Presiona **Run** o **Ctrl + Enter** (⌘ + Enter en Mac).
- Si seleccionas una parte del texto, solo se ejecuta esa parte.
- Puedes tener varias consultas abiertas en pestañas; con **+** abres una nueva.

Ejemplo, contactos y resueltos por agente:

```sql
SELECT assigned_agent_name AS agente,
       count(*) AS contactos,
       count(*) FILTER (WHERE is_solved) AS resueltos
FROM contacts
GROUP BY assigned_agent_name
ORDER BY contactos DESC;
```

## Resultados

- Arriba del resultado ves cuántas filas y columnas trajo y cuánto tardó.
- Haz clic en el nombre de una columna para ordenar.
- **Exportar**: copiar como CSV, JSON o Markdown, o descargar el archivo `.csv` o la consulta `.sql`.

## Ejemplos y consultas guardadas

- El botón de **ejemplos** (birrete) trae consultas listas: contactos entre dos fechas, mensajes de un contacto, contactos por agente, costo de agentes IA por día, entre otras.
- **Guardar** (o Ctrl + S) la deja en **Consultas**, en el panel izquierdo. Desde su menú **⋯** puedes abrirla, renombrarla, marcarla como favorita o eliminarla.

## Reglas

- Solo se permiten consultas **SELECT**: leen sin modificar nada.
- Cada consulta ve únicamente los datos de **tu workspace**.
- Devuelve hasta **1000 filas** y la consulta puede tener hasta 5000 caracteres.