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
- En Configuración, abre Auditoría de registros en el menú lateral.
- Visualiza la lista cronológica de eventos: actor (quién), acción (qué), objetivo y fecha/hora.
- Usa los filtros disponibles para reducir el alcance (por período, por tipo de acción, etc.).
- 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.
- Elige un tipo de evento en la lista agrupada (Acceso, Agentes y equipos, Configuración, Conversaciones) o mantén Todos los eventos.
- Define el período en el selector de fechas y la ordenación (más recientes o más antiguos primero).
- Usa Limpiar filtros para volver a la lista completa.
- 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.
- 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,sortypage).
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.