> ## Documentation Index > Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # Usuarios más susceptibles > Recree el resumen de los usuarios más susceptibles de los últimos 12 meses de un proveedor anterior a partir de los resultados de simulación y las entidades de /v1. Este informe es un resumen de susceptibilidad por usuario de los últimos 12 meses: una fila por persona que recibió al menos una simulación en el último año, con recuentos y porcentajes de clics, credenciales y reportes, una racha actual de clics y una lista concatenada de los últimos 5 resultados. La ventana es de **12 meses naturales** (medianoche UTC del mismo día del mes de hace doce meses), no una duración de 365 días. Las interacciones de escáneres automáticos y bots se excluyen de los recuentos de clics y credenciales. Esta es una divergencia deliberada respecto a la exportación heredada. Consulte [Divergencias respecto a la exportación heredada](#divergencias-respecto-a-la-exportaci%C3%B3n-heredada). La configuración, las credenciales, la paginación y el reintento por límite de solicitudes son los mismos que en la [guía de conectividad de Power BI y Excel](/es/developers/v1/powerbi). Agregue primero la consulta compartida `Fn_FetchAll`; este informe la invoca por su nombre. ## Ámbitos de clave necesarios | Ámbito | Uso | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (unión de correo electrónico y nombre para mostrar) | Este informe utiliza la lista de resultados **operativa** por persona, no la familia de vista previa de informes. Una clave a la que solo se concedió `reporting:read` no puede llamar a `GET /v1/simulation_results` (la API devuelve `403`). Consulte [elegir la granularidad adecuada](/es/developers/v1/powerbi#elija-la-granularidad-adecuada). ## Endpoints de origen | Endpoint | Función | | - | - | | `GET /v1/simulation_results` | Resultado por destinatario. Esta es la granularidad de hechos. | | `GET /v1/entities` | Resuelve `entity` → correo electrónico / nombre para mostrar. La fila de resultado no tiene correo electrónico ni nombre para mostrar del destinatario propios (solo `entity`). | Filtros permitidos en la lista de resultados: `limit`, `page_token`, `simulation`, `entity`. En esta lista no existe `delivered_after` / `start_date`, por lo que los últimos 12 meses se aplican en Power Query después de recorrer la lista completa. Campos utilizados en cada resultado: `id`, `simulation`, `entity`, `status`, `targeted_at`, `delivered_at`, `bounced_at`, `opened_at`, `clicked_at`, `attachment_opened_at`, `credential_submitted_at`, `reported_at`, `reported_before_interaction`, `bot_activity_detected`, `email_subject`, `sender_email`, `difficulty_level`, `created_at`, `updated_at`. ### Granularidad Una fila por entidad que tenga al menos un resultado con `delivered_at` en los últimos 12 meses naturales. Una persona a la que se dirigió una simulación pero que nunca la recibió no aparece. Varias simulaciones de la misma persona se consolidan aquí. Presupuesto de solicitudes: un recorrido paginado de todos los resultados de simulación de la organización, más un recorrido de las entidades. Establezca siempre `limit = "500"`. ## Precedencia de resultados (`last_5_assessments`) Cada uno de los cinco resultados entregados más recientes (`delivered_at` en orden descendente) se resume como `YYYY-MM-DD: `. Prevalece la primera marca de tiempo que coincida, de mayor a menor prioridad: | Prioridad | Marca de tiempo | Etiqueta de resultado | | - | - | - | | 1 | `credential_submitted_at` | `credential submitted` | | 2 | `clicked_at` | `clicked` | | 3 | `attachment_opened_at` | `attachment opened` | | 4 | `reported_at` | `reported` | | 5 | `opened_at` | `opened` | | 6 | `delivered_at` | `no action` | | 7 | `bounced_at` | `bounced` | Solo entregado es `no action` (el mensaje llegó; la persona no hizo nada). Una persona que hizo clic y después reportó es `clicked`: el reporte no tiene precedencia sobre una interacción de riesgo en esta lista. Las filas marcadas como bot siguen recibiendo una etiqueta de resultado a partir de las marcas de tiempo presentes; simplemente no incrementan los recuentos de clics ni de credenciales. **Racha actual de clics:** recorra esos mismos resultados entregados del más reciente al más antiguo y cuente las filas consecutivas en las que `clicked_at` no sea nulo **y** `bot_activity_detected` no sea `true`. Deténgase en la primera que no cumpla. ## Asignación de columnas Los nombres de columna heredados proceden de la exportación de su proveedor anterior. Los campos de `/v1` son los nombres de la API pública; la consulta deriva los recuentos y porcentajes. | Columna heredada | Campo o derivación de `/v1` | Columna del informe | | - | - | - | | Email | `Entity.email` (unión por `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Recuento de resultados en los que `delivered_at` no es nulo (incluye filas marcadas como bot) | `total_received` | | Clicks # | Recuento donde `clicked_at` no es nulo **y** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Recuento donde `credential_submitted_at` no es nulo **y** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Recuento donde `reported_at` no es nulo (incluye bots; no es un clic ni una credencial) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Resultados entregados más recientes consecutivos en los que la persona hizo clic (los bots la interrumpen) | `current_click_streak` | | Last 5 assessments | Los cinco resultados entregados más recientes, separados por `"; "` (consulte [precedencia](#precedencia-de-resultados-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | No está en `/v1` | Se omite, no se rellena con nulos | Clave de unión conservada para un modelo de esquema en estrella: `entity_id`. ## Divergencias respecto a la exportación heredada * **La actividad de bots se excluye de los recuentos de clics y credenciales.** La exportación de un proveedor anterior contaba las interacciones de escáneres automáticos y bots como clics y envíos de credenciales. Esta consulta no lo hace. Un resultado con `bot_activity_detected = true` sigue siendo una simulación entregada: se cuenta en `total_received` y en los agregados de reportes, pero se trata como un no clic y un no envío: se omite de `clicks` / `credential_submissions` e interrumpe una racha actual de clics. No "corrija" esto contando los bots para que coincida con la exportación heredada. * **El reporte no tiene precedencia sobre un clic** en `last_5_assessments`. Una persona que hizo clic y después reportó se etiqueta como `clicked`. * **Los datos adicionales del directorio se omiten, no se rellenan con nulos.** El departamento y campos similares no están en `/v1`. * **Sin filtro de tiempo en el servidor.** `GET /v1/simulation_results` no tiene `delivered_after`. La consulta recorre todos los resultados y luego conserva `delivered_at` de los últimos 12 meses naturales. Una organización con un gran historial puede consumir más del presupuesto de límite de solicitudes por clave que una lista filtrada. ## Próximos pasos Credenciales, paginación y carga de estas consultas en Power BI o Excel. Interacciones de phishing a nivel de evento de los últimos 12 meses. Inscripciones a Capacitación con granularidad de persona × asignación. Conceda `simulation:read` y `entity:read` a la clave que actualiza este informe. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.