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

# Log de Actividad

> Registro cronológico de todas tus acciones en la plataforma.

# Log de Actividad

El Log de Actividad es un registro cronológico de todas las acciones que realizas en la plataforma, ideal para auditoría y troubleshooting.

## Qué se Registra

### Contenido Creado

* **Posts generados**: cada vez que creas contenido con IA
* **Plantillas usadas**: qué template usaste
* **Brand Voice seleccionado**: qué perfil de marca aplicaste
* **Fecha y hora**: timestamp exacto de creación

### Publicaciones

* **Posts publicados**: contenido publicado en redes sociales
* **Plataforma**: Facebook, Instagram, TikTok, LinkedIn, Twitter, YouTube
* **Estado**: exitoso, fallido, programado
* **ID del post**: identificador único en la plataforma

### Integraciones

* **Conexiones**: cuando conectas una red social
* **Desconexiones**: cuando revocas acceso a una plataforma
* **Errores de conexión**: fallas en la conexión OAuth
* **Reconexiones**: cuando restableces una conexión expirada

### Configuraciones

* **Brand Voice creado**: nuevo perfil de marca
* **Brand Voice modificado**: cambios en tono/estilo
* **Configuraciones de cuenta**: cambios en preferencias
* **Cambios en suscripción**: upgrades, downgrades, cancelaciones

### Créditos

* **Créditos otorgados**: por suscripción o compra
* **Créditos consumidos**: por generación de contenido
* **Transacciones**: movimientos en tu saldo
* **Saldo actualizado**: tu nuevo balance después de cada acción

## Cómo Acceder al Log

### Paso 1: Navegar a Insights

1. Haz clic en **"Insights"** en el menú lateral
2. Selecciona **"Actividad"** en el submenú

### Paso 2: Filtrar Actividad

Puedes filtrar por:

| Filtro             | Opciones                                                         |
| ------------------ | ---------------------------------------------------------------- |
| **Tipo de acción** | Contenido, Publicaciones, Integraciones, Configuración, Créditos |
| **Plataforma**     | Todas, Facebook, Instagram, TikTok, LinkedIn, Twitter, YouTube   |
| **Estado**         | Todas, Exitoso, Fallido                                          |
| **Fecha**          | Hoy, Ayer, Últimos 7 días, Últimos 30 días, Custom               |

### Paso 3: Buscar

Usa la barra de búsqueda para encontrar:

* **Por texto**: busca palabras clave en descripciones
* **Por ID**: busca por ID de post o transacción
* **Por plataforma**: filtra por red social específica

## Tipos de Eventos

### Contenido

| Evento                  | Descripción                   |
| ----------------------- | ----------------------------- |
| `content.generated`     | Contenido generado con IA     |
| `content.template.used` | Plantilla usada               |
| `content.modified`      | Contenido editado manualmente |
| `content.deleted`       | Contenido eliminado           |

### Publicaciones

| Evento           | Descripción                     |
| ---------------- | ------------------------------- |
| `post.published` | Post publicado exitosamente     |
| `post.scheduled` | Post programado para futuro     |
| `post.failed`    | Falló la publicación            |
| `post.deleted`   | Post eliminado de la plataforma |

### Integraciones

| Evento                     | Descripción             |
| -------------------------- | ----------------------- |
| `integration.connected`    | Plataforma conectada    |
| `integration.disconnected` | Plataforma desconectada |
| `integration.error`        | Error en la conexión    |
| `integration.expired`      | Conexión expirada       |

### Configuraciones

| Evento                 | Descripción                  |
| ---------------------- | ---------------------------- |
| `brand_voice.created`  | Perfil de marca creado       |
| `brand_voice.updated`  | Perfil de marca modificado   |
| `settings.updated`     | Configuraciones actualizadas |
| `subscription.changed` | Cambio en suscripción        |

### Créditos

| Evento              | Descripción                      |
| ------------------- | -------------------------------- |
| `credits.granted`   | Créditos otorgados (suscripción) |
| `credits.consumed`  | Créditos consumidos (IA)         |
| `credits.purchased` | Créditos comprados (pack)        |
| `credits.adjusted`  | Ajuste manual por admin          |

## Detalles de un Evento

Al hacer clic en cualquier evento del log, verás:

### Información Básica

* **Timestamp**: fecha y hora exacta
* **Tipo de evento**: categoría del evento
* **Estado**: exitoso, fallido, pendiente
* **Usuario**: quién realizó la acción

### Detalles Específicos

**Para contenido generado:**

* Prompt utilizado
* Brand Voice aplicado
* Tokens consumidos
* Costo en créditos

**Para publicaciones:**

* Plataforma objetivo
* Contenido publicado
* ID del post en la plataforma
* Métricas iniciales (likes, comentarios)

**Para errores:**

* Mensaje de error
* Stack trace (técnico)
* Pasos para resolver
* Timestamp de reintentos

## Exportar Log

Puedes exportar tu log de actividad para:

### Auditoría

* **Cumplimiento**: demostrar actividad a stakeholders
* **Reporting**: presentaciones a clientes o management
* **Troubleshooting**: análisis de errores recurrentes

### Formatos de Exportación

* **CSV**: para análisis en Excel/Google Sheets
* **PDF**: reportes ejecutivos
* **JSON**: para integraciones técnicas

### Filtros de Exportación

* **Rango de fechas**: custom date range
* **Tipos de evento**: selecciona categorías
* **Plataformas**: filtra por red social
* **Estado**: solo errores, solo exitosos, todos

## Retención de Datos

### Políticas de Retención

* **Log de actividad**: 90 días
* **Analytics detallados**: 90 días
* **Analytics agregados**: 12 meses
* **Contenido creado**: hasta que lo elimines

### Exportar Antes de la Eliminación

Si necesitas datos más antiguos:

1. Exporta el log antes de la fecha de retención
2. Guarda el archivo en tu sistema local
3. Los datos eliminados no se pueden recuperar

## Consejos para el Log de Actividad

### Usos Prácticos

1. **Troubleshooting**: cuando algo falla, revisa el log para identificar el patrón
2. **Reporting**: usa el log para reportar actividad a clientes
3. **Optimización**: analiza qué acciones consumen más créditos
4. **Seguridad**: monitorea actividad sospechosa

### Búsqueda Eficiente

* **Filtra por plataforma primero**: luego busca dentro de esa plataforma
* **Usa rangos de fechas cortos**: últimos 7 días es más rápido que últimos 30 días
* **Busca por palabras clave**: "error", "fallido", "Instagram"

### Exportación Regular

* **Semanal**: exporta para reportes a clientes
* **Mensual**: archiva para auditoría anual
* **Antes de cancelar**: exporta todo tu historial

***

¿Quieres ver tus métricas de rendimiento? Consulta [Analytics](./analytics).