Conversa Labs

Última actualización el 7 de sep de 2026

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