> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reportes

> Un análisis escrito de su operación de voz AI, solicitado a pedido y escrito en texto enriquecido.

A **informe** es un análisis escrito de su operación de voz AI, el tipo de cosa que un analista de negocios reuniría en un BPO real.
[hallazgo](/es/docs/findings) es el registro duradero de un *problema* y a
[cambio](/es/docs/changes) es el registro de un *fijar*, un informe responde a un final abierto *pregunta* Acerca de cómo se está ejecutando la operación: "¿Por qué nuestra conversión aumentó en mayo?", "¿Cómo estamos manejando el escenario fuera de horario?", o "¿Qué diferencia hay entre el agente A y el agente B en la prueba A / B?"

Informes en vivo bajo **Reportes** en la barra lateral, con alcance para su organización (no para un solo agente).

**Análisis de transferencias** e **Informe de costos** son informes en vivo con
fechas y alcance exacto por empresa. Consulta los
[flujos operativos](/es/docs/guides/customer-evaluation-workflows) para configuración,
API e interpretación.

Los informes escritos son instantáneas de toda la organización. Su lista y contenido
se ocultan al seleccionar una empresa; vuelve a Todos los agentes para leerlos.

## Reportes guardados de monitores

Abre **Reportes → Reportes de monitores** para reunir hasta 20 monitores. Los propietarios y administradores eligen el nombre, la empresa, los filtros de metadata y la zona horaria. Los filtros se intersectan con el alcance de cada monitor. El reporte usa su configuración guardada, independientemente de la barra lateral, y no cambia qué llamadas evalúan los monitores.

El período predeterminado es la semana completa anterior, de lunes a domingo. Puedes elegir hasta 31 días y exportar todos los monitores juntos en CSV o JSON. La tabla separa llamadas en alcance, evaluadas, sin puntuar y sin resultado. **La tasa de afectadas usa las llamadas evaluadas como denominador**, sin extrapolar el muestreo. Sin evaluaciones se muestra “Sin datos”. Solo cuenta la versión actual del monitor.

Activa **Enviar este reporte cada semana** e ingresa un webhook HTTPS público y un secreto de firma de al menos 16 caracteres. El envío se programa los lunes a las 09:00 en la zona elegida y puede tardar hasta 15 minutos. El historial muestra entregas, reintentos y errores, y permite descargar el contenido conservado de cada entrega. Los reintentos mantienen el mismo reporte e identificador; el receptor debe deduplicarlo.

El webhook incluye `Idempotency-Key`, `X-Zelto-Delivery-Id`, `X-Zelto-Timestamp` y `X-Zelto-Signature`. Verifica la firma `v1=` seguida del HMAC-SHA256 hexadecimal de `timestamp + "." + rawBody`, usando el secreto configurado, y responde con 2xx. El cuerpo es `{ "type": "monitor_report.weekly", "deliveryId": "...", "report": { ... } }`, con agregados y sin transcripciones ni evidencia por llamada.

También puedes consultar `GET https://api.zelto.ai/v1/reports/monitors/REPORT_ID?from=2026-09-07&to=2026-09-13` con la API key de tu organización en `Authorization: Bearer YOUR_API_KEY`. El identificador aparece en el parámetro `id` de la vista guardada. Agrega `format=csv` para exportar o `deliveryId=DELIVERY_ID` para recuperar una entrega histórica. Si omites ambas fechas, se usa la semana completa anterior. Se requiere acceso a la función Reportes.

## Solicitar un informe

Prensa **Solicitar informe** y describe lo que quieres entender:

| Campo | ¿Qué es? |
| - | - |
| **Título** | Título corto para el reportaje (requerido, hasta 255 caracteres). |
| **Solicitud** | Descripción de texto libre de lo que el informe debe cubrir (opcional, hasta 4000 caracteres). |

El informe se crea inmediatamente y se abre a su propia página. El cuerpo comienza vacío: usted (o, más tarde, un trabajo automatizado) completa el análisis.

## Estado de generación

Cada informe lleva una generación **estado** se muestra como una insignia en la lista y páginas de detalles:

| Situación | Significado |
| - | - |
| **Esperando generación** | El informe ha sido solicitado pero el análisis no ha sido generado todavía. |
| **Generación** | Se está produciendo el análisis. |
| **Listo** | El análisis es completo. |
| **Falló** | La generación no terminó. |

Los informes automatizados generados por IA aún no están disponibles, por lo que un informe solicitado se encuentra en **Esperando generación**Mientras tanto, puede escribir el análisis a mano en el editor: el cuerpo es completamente editable independientemente del estado.

## Creación y edición desde el chat o la API

No tienes que usar el **Solicitar informe** botón. Pregúntale a Zelto en chat "crea un reporte titulado ... sobre ..." y te propone el reporte para que lo confirmes antes de que sea guardado. Las mismas acciones están disponibles para scripts y agentes externos sobre el [Servidor MCP](/es/docs/mcp) Como el `create_report`  `update_report`
herramientas (con `list_reports` / `get_report` para encontrar y leer los existentes), por lo que un flujo de trabajo automatizado puede presentar un informe o actualizar su título, solicitud, cuerpo o estado de forma programática.

## Anatomía de un informe

| Campo | ¿Qué es? |
| - | - |
| **Título** | El titular del informe, editable en línea desde la página de detalles. |
| **Solicitud** | La pregunta original de texto libre, que se muestra como una llamada en la página de detalles. |
| **Cuerpo** | Texto enriquecido (Tiptap / ProseMirror JSON) el mismo editor que [hallazgos](/es/docs/findings)  [cambios](/es/docs/changes), con encabezados, listas, diagramas, `@`- menciones de agentes, hallazgos, llamadas y más, **ejemplos de llamadas** que incrustan la grabación de cualquier llamada y el extracto de transcripción anotado en línea, **imágenes** carga o enlaza por URL (con texto alternativo y un título), y **widgets de datos** (ver abajo) que trazan los números en vivo de sus datos. El cuerpo se guarda automáticamente a medida que escribe. |
| **Situación** | El estado de generación (ver arriba). |
| **Solicitado por** | El miembro de la organización que solicitó el informe. |

## Widgets de datos

A **widget de datos** convierte un informe de un artículo estático en un panel de control activo. Ejecuta una consulta en su tienda de análisis y muestra el resultado como una tabla o gráfico que se vuelve a ejecutar cada vez que se abre el informe, para que los números se mantengan actualizados como nuevos [llamadas](/es/docs/conversations) Pasa.

En el editor de informes, escriba `/` y elegir **Widget de datos**, luego rellene:

| Campo | ¿Qué es? |
| - | - |
| **Título** | Título opcional que se muestra en el encabezado del widget. |
| **Consulta** | Un solo de lectura `SELECT` sobre las tablas de análisis de su organización (conversaciones, transcripciones, análisis, hallazgos, agentes, webhooks). |
| **Mostrar como** | **Cuadro**, o a **Bar** / **Línea** / **Zona** / **Tarta** gráfico. |
| **Columna de categoría** | Para los gráficos, la columna de resultados utilizada como eje X. |
| **Columna(s) de valor** | Para los gráficos, las columnas numéricas separadas por comas para trazar. |

Prensa **Correr** Utilice el botón de actualización en el encabezado del widget para volver a ejecutar a petición, el lápiz para cambiar la consulta y el gráfico/tabla para cambiar de vista. Los resultados se limitan a las primeras 1.000 filas.

Los widgets de datos son de solo lectura y **Alcance de su organización**: cada consulta se limita automáticamente a las filas de su organización en las tablas de análisis, y solo
`SELECT` / `WITH` / `DESCRIBE` / `EXPLAIN` / `SHOW` Se permiten las declaraciones se rechazan las escrituras y el acceso entre organizaciones. La misma capacidad de consulta está disponible conversacionalmente a través de Pregúntale a Zelto y sobre el
[Servidor MCP](/es/docs/mcp).

## Relacionado

* [Hallazgos](/es/docs/findings) los problemas recurrentes que un informante explica a menudo.
* [Cambios](/es/docs/changes) las soluciones que se derivan de lo que descubre un informe.
* [Agentes](/es/docs/agents) los agentes cuyo comportamiento analiza un informe.

Los reportes de monitores también permiten **Descargar PDF**, incluso desde el historial de entregas. El documento incluye empresa, período, zona horaria, filtros guardados, métricas y cobertura de evaluación. Usa `format=pdf&locale=es` en el mismo endpoint; los idiomas disponibles son `en-us`, `es` y `pt`. El webhook semanal envía JSON; con el identificador de entrega y tu API key puedes descargar el PDF de esa entrega.
