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

# Registros

> Registros en tiempo real para seguir la entrega de los correos y depurar problemas con el proveedor de correo: eventos de los mensajes, datos de los webhooks y el registro de auditoría del espacio de trabajo, con filtros.

## Descripción general

Los registros muestran en tiempo real la actividad de los correos y los eventos de webhook, para que puedas depurar problemas de entrega y seguir el rendimiento de las campañas. La sección también reúne las entregas de tus propios webhooks y el **historial de auditoría** del espacio de trabajo (quién hizo qué y desde dónde), cada uno en su pestaña: **Mensajes**, **Webhooks entrantes**, **Webhooks salientes** y **Registro de auditoría**.

## Tipos de registro

### Pestaña Mensajes

Todos los correos que envió el espacio de trabajo, del más reciente al más antiguo, de las **últimas 24 horas** por defecto. Elige otro periodo (la última hora, 7 días, 30 días o todo el tiempo) en el filtro **Periodo**.

- **Recuentos por estado**: Todos, Entregado, Abierto, Clic realizado, Rebotado, Fallido y Quejas. Haz clic en uno para ver solo esos mensajes. Los recuentos aparecen para periodos de hasta 7 días; para 30 días o todo el tiempo, añade un filtro por dirección de correo, ID de mensaje, newsletter, automatización, notificación transaccional o plantilla. Un espacio de trabajo que solo envía por SMTP no muestra el recuento Entregado, porque SMTP no informa de las entregas.
- **Buscar**: por dirección de correo, ID de mensaje o ID externo, con coincidencia exacta. Si escribes una "@", la búsqueda pasa a la dirección de correo, salvo que hayas elegido el campo tú mismo. Una dirección de correo se busca cuando está completa.
- **Origen**: qué envió el mensaje. Las comprobaciones se hacen en este orden y gana la primera que se cumple; el dashboard usa los mismos orígenes.
  - **Newsletters**: el mensaje pertenece a un envío masivo, incluidos sus envíos de prueba.
  - **Automatizaciones**: lo envió una automatización. Un correo de automatización que además nombra una notificación transaccional (algunos antiguos lo hacen tras la actualización a 28.0) cuenta como de la automatización.
  - **Transaccional**: lo envió una notificación transaccional.
  - **Otro**: ninguno de los tres, como una prueba de plantilla o una confirmación de doble opt-in.
- **Recorrido**: cada fila muestra hasta dónde llegó el mensaje: enviado, entregado, abierto, clic.
- **Error**: cuando se rechazó un envío, la respuesta del propio proveedor: el código SMTP y su texto, como `452: 4.3.1 Daily sending quota exceeded`. Pasa el cursor por encima para leerla completa.
- **Columnas**: muestra u oculta el ID de mensaje, el ID externo, los metadatos, la plantilla, la lista y la fecha de creación desde el selector de columnas.

![Pestaña Mensajes de la página Registros](https://www.notifuse.com/docs/assets/screenshots/logs_messages.png)

![Los recuentos por estado encima de los mensajes y los iconos del recorrido de cada fila](https://www.notifuse.com/docs/assets/screenshots/logs_status_journey.png)

Haz clic en un mensaje para abrirlo en un panel lateral. Pasa al mensaje anterior o al siguiente con **K** y **J**.

- **Eventos**: cuándo se envió, se entregó, se abrió, recibió un clic, rebotó o se marcó como spam.
- **Mensaje**: sus ID, la plantilla y su versión, el remitente, el asunto, el idioma, el seguimiento, la lista, los adjuntos y la newsletter, la automatización o la notificación transaccional que lo envió.
- **Contenido enviado**: el correo renderizado de nuevo a partir de su plantilla y de los datos del mensaje, en el idioma del contacto, en HTML, texto o MJML. Notifuse no guarda el HTML enviado; renderiza la plantilla en la versión que usó el mensaje, así que los cambios posteriores en la plantilla no aparecen.
- **Datos**: los datos de plantilla y los metadatos con los que se envió el mensaje.
- **Abrir el contacto** abre el perfil del contacto.

Cuando se borra un contacto, sus mensajes siguen en el registro como **Contacto borrado**, sin sus datos.

![Un mensaje abierto en un panel lateral de la página Registros, con sus eventos y detalles](https://www.notifuse.com/docs/assets/screenshots/logs_message_detail.png)

### Pestaña Webhooks entrantes

Los eventos que Notifuse guardó de tus proveedores de correo y de Supabase, del más reciente al más antiguo, de las últimas 24 horas por defecto.

- **Filtros**: busca por correo del destinatario o ID de mensaje; filtra por periodo, por **Origen** (Amazon SES, Postmark, Mailgun, SparkPost, Mailjet, SendGrid, SMTP, Supabase) y por **Tipo** (entregado, rebote, queja, baja, respuesta, respuesta automática, correo de autenticación, usuario creado). Los filtros se guardan en el enlace de la página.
- **Mensaje vinculado**: un evento de entrega, rebote, queja o baja enlaza con el mensaje al que se refiere. Una respuesta lleva el ID de mensaje de la propia respuesta, así que no enlaza con nada.
- **Payloads sin procesar**: haz clic en un evento para ver los detalles del rebote o de la queja y sus datos tal como los envió el proveedor. Cuando un proveedor agrupa sus eventos en lotes (SendGrid, SparkPost, Mailjet), cada evento del lote tiene su propia entrada.
- **Correos enviados por Notifuse**: un evento de entrega, rebote, queja o baja solo se muestra y se procesa cuando se refiere a un correo que envió Notifuse, para la dirección a la que fue, y una respuesta solo cuando contesta a un correo que envió Notifuse. Los eventos sobre otro correo, como el de otra aplicación en la misma cuenta del proveedor o el correo de prueba de una integración, se ignoran.

![Pestaña Webhooks entrantes de la página Registros, con eventos de entrega de Amazon SES](https://www.notifuse.com/docs/assets/screenshots/logs_webhooks.png)

### Pestaña Webhooks salientes

Todas las entregas de tus [suscripciones de webhook](https://www.notifuse.com/es/docs/features/webhooks.md), de la más reciente a la más antigua:

- **Filtros**: por suscripción y por estado (Pendiente, Entregando, Entregado, Fallido), guardados en el enlace de la página
- **Reintentando**: una entrega fallida a la que aún le quedan intentos aparece como **Reintentando**, y su panel lateral indica la hora del próximo intento. El filtro **Fallido** también muestra estas entregas
- **Detalle de la entrega**: haz clic en una entrega para ver el código y el cuerpo de la respuesta de tu endpoint, y el payload que envió Notifuse. **Abrir suscripción** lleva a esa suscripción en Configuración → Webhooks

### Pestaña Registro de auditoría

Cada entrada se lee como una frase, por ejemplo "Invitó a **[ann@example.com](mailto:ann@example.com)**", y se filtra por periodo, actor, recurso, acción o resultado, con los filtros guardados en el enlace de la página.

- **Quién hizo qué**: cada acción del plano de control (un miembro invitado, un permiso cambiado, una clave API creada, una integración editada, una plantilla guardada, un envío masivo programado), con el actor, la dirección IP, el resultado y el antes y el después de lo que cambió
- **Solo inserción**: un trigger de la base de datos rechaza cualquier reescritura; la purga por retención es el único borrado
- **Exportable**: descarga el filtro actual en CSV o NDJSON, o tráelo por la API a un SIEM

El registro de acciones es una función de la [clave de licencia](https://www.notifuse.com/es/docs/self-hosting/licence.md) Enterprise; la pestaña, su exportación y su ajuste de retención funcionan en cualquier estado de licencia. Consulta [Registros de auditoría](https://www.notifuse.com/es/docs/features/audit-logs.md) para la referencia completa.

## Actualización de los eventos

Los eventos de los correos se actualizan en tiempo real a medida que llegan los webhooks del proveedor:

- **Entregado**: el correo llegó al destinatario
- **Abierto**: el destinatario abrió el correo
- **Clic realizado**: el destinatario hizo clic en un enlace del correo
- **Rebotado**: la entrega del correo falló
- **Quejado**: el destinatario marcó el correo como spam

## Opciones de filtrado

Además de la búsqueda, el periodo, el origen y los recuentos, **+ Filtro** en la pestaña Mensajes añade:

- **Estado**: entregado, abierto, clic, rebotado, fallido, queja o baja, o su contrario (no entregado, no abierto…)
- **Canal**: el canal por el que salió el mensaje
- **Lista**, **Newsletter** y **Automatización**: se eligen por nombre
- **Plantilla** y **Notificación transaccional**: por ID. La vista de detalle de una notificación abre el registro con este filtro (`transactional_notification_id` en `messages.list`)
- **Enlace clicado**: dentro de una newsletter, muestra solo los mensajes en los que se hizo clic en este enlace exacto. Las estadísticas por enlace de un envío masivo abren el registro con este filtro (**Ver quién hizo clic**). Por la API, pasa `clicked_url` con `broadcast_id` a `messages.list`

Cada filtro se guarda en el enlace de la página, así que puedes compartir una vista filtrada o guardarla en marcadores. Por la API, `messages.list` filtra por origen con `origin` (`broadcast`, `automation`, `transactional` u `other`), y `messages.count` devuelve los mismos recuentos para los filtros de `messages.list`. Necesita `created_after`, o un filtro por ID de mensaje, dirección de correo, newsletter, automatización, notificación transaccional o plantilla. La dimensión `origin` del esquema de analítica `message_history` da los mismos cuatro valores.

## Permisos

La página muestra solo las pestañas que puedes leer, y la entrada Registros del menú aparece en cuanto puedes leer una de ellas. Cada pestaña necesita su propio permiso de lectura:

- **Mensajes** necesita la lectura de **Historial de mensajes**. Las estadísticas de entrega de los envíos masivos (entregas, aperturas, clics, rebotes y recuentos por enlace) también dependen de él, así que un miembro que puede crear y enviar un envío masivo no ve sus resultados sin este permiso. El registro contiene las direcciones de los destinatarios y los datos con los que se renderizó cada mensaje, así que trátalo como datos de contactos.
- **Webhooks entrantes** necesita la lectura de **Eventos de webhook**. Son los payloads de los propios proveedores, con las direcciones de los destinatarios y los diagnósticos del proveedor.
- **Webhooks salientes** necesita la lectura de **Suscripciones de webhook**.
- **Registro de auditoría** necesita la lectura de **Registros de auditoría**, que un propietario concede a propósito. Nunca forma parte del acceso completo, porque el acceso completo no debería implicar leer la dirección de correo, la dirección IP y las acciones rechazadas de cada colega. Los propietarios siempre ven la pestaña, y un usuario root puede cambiarla para ver todo el despliegue.

La escritura de Historial de mensajes, Eventos de webhook y Registros de auditoría no controla nada por ahora: el proceso de envío, las rutas de callback de los proveedores y el registrador de auditoría de la propia plataforma escriben esas filas, y ninguna llamada que puedas hacer lo hace. La escritura de Suscripciones de webhook sí controla algo: permite a un miembro o a una clave API crear, editar, activar o desactivar, eliminar y probar las suscripciones (Configuración → Webhooks en la consola). Consulta [Administradores y claves API](https://www.notifuse.com/es/docs/features/admins-api-keys.md).

## Depurar problemas de correo

Usa los registros para resolver problemas con el proveedor de correo:

- **Fallos de entrega**: identifica los correos rebotados y sus motivos, y lee en la columna Error por qué se rechazó un envío
- **Problemas del proveedor**: detecta patrones en los fallos de los webhooks
- **Seguimiento del rendimiento**: sigue las tasas de apertura y de clics
- **Depuración en tiempo real**: ve los problemas de envío en el momento en que ocurren
