Reportes
Como generar reportes PDF con datos de tus colecciones.
Que es un reporte
Un reporte es un documento PDF generado automaticamente a partir de bloques de contenido estructurado. Los reportes pueden incluir datos de tus colecciones, branding corporativo y multiples tipos de contenido.
Los reportes pueden ser generados desde el dashboard, desde la API, o por un agente de voz/WhatsApp usando la herramienta generate_report.
Tipos de bloques
Un reporte se compone de bloques ordenados:
| Tipo | Descripcion |
|---|---|
| heading | Titulo o subtitulo (nivel 1 o 2) |
| text | Texto de una linea |
| paragraph | Texto largo con saltos de linea |
| table | Tabla con cabeceras y filas |
| key_value | Pares clave-valor (ej: "Cliente: Juan", "Fecha: 2024-03-15") |
Ejemplo de tabla
{
"type": "table",
"headers": ["Equipo", "Serial", "Estado"],
"rows": [
["Laptop HP", "ABC-123", "Activo"],
["Monitor Dell", "DEF-456", "En reparacion"]
]
}Ejemplo de clave-valor
{
"type": "key_value",
"items": [
{"label": "Cliente", "value": "Juan Perez"},
{"label": "Fecha", "value": "15 marzo 2024"},
{"label": "Estado", "value": "Aprobado"}
]
}Branding corporativo
Los reportes soportan branding personalizado:
| Opcion | Descripcion |
|---|---|
| Nombre de empresa | Aparece en el encabezado |
| Logo | Imagen PNG/JPG en el encabezado |
| Lineas de encabezado | Texto adicional junto al logo (ej: division, telefono) |
| Texto derecho | Texto alineado a la derecha del encabezado (ej: "Confidencial") |
| Texto de pie | Aparece en el pie de pagina junto con la fecha y numero de pagina |
Datos automaticos de colecciones
Un reporte puede incluir datos directamente de una coleccion:
- Especifica el ID de la coleccion como fuente de datos.
- Opcionalmente, agrega una consulta de busqueda para filtrar registros.
- Los registros encontrados se insertan automaticamente en una tabla del reporte.
Ver reportes generados
Ve a Datos > Reportes para ver el historial de reportes generados. Cada reporte muestra:
- Titulo
- Cantidad de bloques y paginas
- Fecha de creacion
- Enlace de descarga (URL firmada valida por 1 hora)
Generar con agentes
Cuando configuras la accion generate_report en una herramienta, tus agentes pueden generar reportes durante una conversacion. El agente:
- Recopila la informacion del usuario (titulo, tipo de datos).
- Aplica el branding y estructura configurados como valores por defecto.
- Genera el PDF y lo entrega al usuario.