## Visión general

Los **registros de auditoría** documentan las acciones relevantes realizadas en la cuenta: cambios
de configuración, gestión de agentes y equipos, cambios de permisos y otras acciones
administrativas. Responden a la pregunta **“quién hizo qué y cuándo”**, fundamental para la
seguridad, el cumplimiento y la investigación de incidentes.

La lista ofrece **búsqueda por persona, filtros por tipo de evento y por período, y ordenación**. Así
reduces miles de eventos al puñado que importa antes de investigar.

## Requisitos previos

- Rol de **Administrador** para acceder a los registros.
- **Registros de auditoría** es una función **premium/opcional** y puede no estar habilitada en tu
  cuenta. Si el área no aparece, habla con el responsable de la cuenta o con el soporte.

## Paso a paso

1. En Configuración, abre **Auditoría de registros** en el menú lateral.
2. Visualiza la lista cronológica de eventos: actor (quién), acción (qué), objetivo y fecha/hora.
3. Usa los **filtros** disponibles para reducir el alcance (por período, por tipo de acción, etc.).
4. Usa la **búsqueda** del encabezado para encontrar las acciones de una persona por **nombre o correo
   electrónico**. Se activa a partir de **3 caracteres**.
5. Elige un **tipo de evento** en la lista agrupada (Acceso, Agentes y equipos, Configuración,
   Conversaciones) o mantén **Todos los eventos**.
6. Define el **período** en el selector de fechas y la **ordenación** (más recientes o más antiguos
   primero).
7. Usa **Limpiar filtros** para volver a la lista completa.
8. Lee la fila del evento: ya trae la descripción completa de la acción, la hora y la dirección IP
   de origen. La fila **es** el registro entero — no hay una pantalla de detalle detrás de ella.
9. Para análisis externos, consulta el mismo historial por la API en
   `GET /api/v1/accounts/{account_id}/audit_logs`, que acepta exactamente los filtros de la pantalla
   (`q`, `types`, `since`, `until`, `sort` y `page`).

## Configuración y opciones

- **Vista cronológica**: eventos del más reciente al más antiguo.
- **Filtros**: ayudan a localizar una acción específica entre muchos registros.
- **Búsqueda por persona**: el campo de búsqueda busca por **nombre de agente o correo electrónico**.
  Empieza a partir de **3 caracteres** y espera una breve pausa en la escritura antes de consultar,
  para no dispararse en cada tecla.
- **Filtro por tipo de evento**, organizado en cuatro grupos:

  | Grupo | Tipos disponibles |
  |---|---|
  | Acceso | Inicio / cierre de sesión |
  | Agentes y equipos | Agentes · Equipos · Miembros del equipo · Colaboradores de la bandeja de entrada |
  | Configuración | Configuración de la cuenta · Bandejas de entrada · Webhooks · Reglas de automatización · Macros |
  | Conversaciones | Eliminaciones de conversaciones |

- **Filtro por período**: el selector de fechas estándar de la plataforma. El intervalo elegido se
  aplica desde el **inicio del primer día hasta el fin del último**.
- **Ordenación**: **Más recientes primero** (predeterminado) o **Más antiguos primero**.
- **Contador**: el encabezado muestra el total de eventos que cumplen los filtros actuales.
- **Limpiar filtros**: el botón aparece en cuanto hay una búsqueda, un tipo de evento, un período o
  una ordenación activos.
- **Estado en la URL**: búsqueda, tipo, período, ordenación y página viven en la dirección de la
  página. Puedes recargar, usar atrás/adelante del navegador y **compartir el enlace ya filtrado** con
  otro administrador.
- **Paginación**: **25 eventos por página**.
- **Columnas**: la actividad descrita en texto (quién hizo qué), la hora y la **dirección IP** de
  origen.
- **Exportación**: la pantalla **no** exporta CSV. Para llevar los eventos fuera, usa la API citada
  en el paso 9.
- **Retención**: el historial está disponible según la política de tu plan. La plataforma no depura
  estos registros por su cuenta y la pantalla no tiene un campo de retención — el registro con plazo
  configurable es el nativo que se describe a continuación.
- **Registro nativo (Gobernanza y LGPD)**: además de los logs premium, la cuenta puede habilitar el
  **registro de auditoría nativo**, consultado en la pestaña **Auditoría** de
  **Configuración → Gobernanza y LGPD** — inicios de sesión, cambios de configuración, aplicación
  de plantillas de rol/enrutamiento, cambios de agentes y bandejas, eliminaciones de contactos y
  solicitudes de titulares, con **retención configurable** por el administrador. Ese registro tiene
  filtros propios (**Acción**, **Desde** y **Hasta**) y **no** ofrece búsqueda por texto.

## Casos de uso

- Investigar cuándo y por quién se cambió una configuración.
- Confirmar los cambios de permiso de un agente tras una queja.
- Cumplir con los requisitos de cumplimiento y seguridad de la empresa.
- Reconstruir el día de un agente: buscar por su correo electrónico y ordenar del más antiguo al más
  reciente.
- Aislar cambios de configuración en un intervalo sospechoso: filtrar por **Configuración** y por el
  período del incidente.
- Verificar eliminaciones: filtrar por **Conversaciones → Eliminaciones de conversaciones**.

## Consejos, límites y buenas prácticas

- Combina la auditoría con **roles bien definidos**: menos acceso amplio significa menos sorpresas en
  el registro.
- Revisa los registros periódicamente, no solo después de incidentes.
- Los registros son de **solo lectura** — documentan la historia y no deben editarse.
- La búsqueda cubre **quién** ejecutó la acción (nombre o correo electrónico), no el texto de la
  descripción del evento. Para responder “qué cambió”, combina **tipo de evento + período**.
- Filtra antes de compartir: un enlace ya filtrado le ahorra a la otra persona repetir toda la
  investigación.
- Un tipo de evento o una ordenación desconocidos en la dirección se ignoran sin más, y el período
  solo se aplica cuando **inicio y fin** están completos.

## Solución de problemas

- **No veo el área de auditoría**: la función premium no está habilitada para la cuenta.
- **No encuentro una acción específica**: ajusta los filtros (período/tipo) y confirma que la acción
  sea de las que se registran en auditoría.
- **La búsqueda no devuelve nada**: necesita al menos **3 caracteres** y busca por nombre o correo
  electrónico del usuario — un fragmento de la descripción de la acción no encuentra el registro.
- **La lista dice “No hay elementos que coincidan con esta consulta”**: hay filtros activos que no
  coincidieron con ningún evento. Usa **Limpiar filtros** para empezar de nuevo.
- **Pegué un enlace y llegaron menos filtros de los esperados**: los valores fuera de los admitidos se
  descartan al leer la dirección.
- **Quiero exportar a una hoja de cálculo**: la pantalla no tiene botón de exportación. Usa la API
  del paso 9 y convierte el resultado.
- **Necesito más historial**: la retención depende del plan — habla con el responsable de la cuenta.

## Ver también

- [Gobernanza y LGPD](/hc/ajuda/articles/administration-governanca-lgpd-es)
- [Roles personalizados y gobernanza (RBAC)](/hc/ajuda/articles/administration-custom-roles-governanca-rbac-es)
- [Cuenta, agentes y equipos](/hc/ajuda/articles/administration-conta-agentes-equipes-es)
- [Integraciones](/hc/ajuda/articles/administration-integracoes-es)
- [Visión general de Administración](/hc/ajuda/articles/administration-overview-es)