> ## 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. # Usuários mais suscetíveis > Recrie o resumo de 12 meses dos usuários mais suscetíveis de um provedor anterior a partir dos resultados de simulação e das entidades da /v1. Este relatório é um resumo consolidado de suscetibilidade por usuário ao longo de 12 meses: uma linha por pessoa que recebeu ao menos uma simulação no último ano, com contagens e taxas de cliques, credenciais e relatos, uma sequência atual de cliques e uma lista concatenada dos últimos 5 resultados. A janela é de **12 meses do calendário** (meia-noite UTC no mesmo dia do mês doze meses atrás), e não uma duração de 365 dias. As interações de scanners automatizados e bots são excluídas das contagens de cliques e credenciais. Trata-se de uma divergência deliberada em relação à exportação legada. Consulte [Divergências em relação à exportação legada](#diverg%C3%AAncias-em-rela%C3%A7%C3%A3o-%C3%A0-exporta%C3%A7%C3%A3o-legada). A configuração, as credenciais, a paginação e a repetição em caso de limite de taxa são as mesmas do [guia de conectividade com Power BI / Excel](/pt/developers/v1/powerbi). Adicione primeiro a consulta compartilhada `Fn_FetchAll`; este relatório a chama pelo nome. ## Escopos de chave necessários | Escopo | Utilizado para | | - | - | | `simulation:read` | `GET /v1/simulation_results` | | `entity:read` | `GET /v1/entities` (junção de e-mail e nome de exibição) | Este relatório usa a lista **operacional** de resultados por pessoa, e não a família de visualização prévia de relatórios. Uma chave que recebeu somente `reporting:read` não pode chamar `GET /v1/simulation_results` (a API retorna `403`). Consulte [escolha a granularidade correta](/pt/developers/v1/powerbi#escolha-a-granularidade-correta). ## Endpoints de origem | Endpoint | Função | | - | - | | `GET /v1/simulation_results` | Resultado por destinatário. Esta é a granularidade dos fatos. | | `GET /v1/entities` | Resolve `entity` → e-mail / nome de exibição. A linha de resultado não tem e-mail nem nome de exibição do destinatário (apenas `entity`). | Filtros permitidos na lista de resultados: `limit`, `page_token`, `simulation`, `entity`. Não há `delivered_after` / `start_date` nesta lista; por isso, os últimos 12 meses são aplicados no Power Query após a leitura completa. Campos usados em 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`. ### Granularidade Uma linha por entidade que tenha ao menos um resultado com `delivered_at` nos últimos 12 meses do calendário. Uma pessoa que foi selecionada, mas nunca recebeu a entrega, não aparece. Várias simulações para a mesma pessoa são consolidadas aqui. Orçamento de requisições: uma leitura paginada de todos os resultados de simulação da organização, mais uma leitura das entidades. Defina sempre `limit = "500"`. ## Precedência de resultados (`last_5_assessments`) Cada um dos cinco resultados entregues mais recentes (`delivered_at` decrescente) é resumido como `YYYY-MM-DD: `. Vence o primeiro carimbo de data/hora correspondente, da prioridade mais alta para a mais baixa: | Prioridade | Carimbo de data/hora | Rótulo do 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` | Somente entregue é `no action` (a mensagem chegou; a pessoa não fez nada). Uma pessoa que clicou e depois reportou é `clicked` — o relato não prevalece sobre uma interação de risco nesta lista. As linhas sinalizadas como bot ainda recebem um rótulo de resultado a partir dos carimbos de data/hora presentes; elas apenas não incrementam as contagens de cliques e credenciais. **Sequência atual de cliques:** percorra esses mesmos resultados entregues do mais recente para o mais antigo e conte as linhas consecutivas em que `clicked_at` não é nulo **e** `bot_activity_detected` não é `true`. Pare na primeira que não atender. ## Mapeamento de colunas Os nomes das colunas legadas são da exportação do seu provedor anterior. Os campos `/v1` são os nomes da API pública; a consulta deriva as contagens e as taxas. | Coluna legada | Campo ou derivação de `/v1` | Coluna do relatório | | - | - | - | | Email | `Entity.email` (junção por `Result.entity`) | `email` | | Full name | `Entity.display_name` | `full_name` | | Total simulations received | Contagem de resultados em que `delivered_at` não é nulo (inclui linhas sinalizadas como bot) | `total_received` | | Clicks # | Contagem em que `clicked_at` não é nulo **e** `bot_activity_detected` ≠ `true` | `clicks` | | Clicks % | `clicks / total_received` | `click_pct` | | Credential submissions # | Contagem em que `credential_submitted_at` não é nulo **e** `bot_activity_detected` ≠ `true` | `credential_submissions` | | Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` | | Reported # | Contagem em que `reported_at` não é nulo (bots incluídos — não é clique/credencial) | `reported` | | Reported % | `reported / total_received` | `reported_pct` | | Current click streak | Resultados entregues consecutivos mais recentes em que a pessoa clicou (bots interrompem a sequência) | `current_click_streak` | | Last 5 assessments | Os cinco resultados entregues mais recentes, separados por `"; "` (consulte [precedência](#precedência-de-resultados-last_5_assessments)) | `last_5_assessments` | | Directory extras (department, …) | Não está em `/v1` | Omitido, não preenchido com nulo | Chave de junção mantida para um modelo em estrela: `entity_id`. ## Divergências em relação à exportação legada * **A atividade de bots é excluída das contagens de cliques e credenciais.** A exportação de um provedor anterior contava interações de scanners automatizados e bots como cliques e envios de credenciais. Esta consulta não faz isso. Um resultado com `bot_activity_detected = true` continua sendo uma simulação entregue — ele é contado em `total_received` e nos agregados de relatos — mas é tratado como não clique e não envio: é omitido de `clicks` / `credential_submissions` e interrompe uma sequência atual de cliques. Não "corrija" isso contando os bots para coincidir com a exportação legada. * **O relato não prevalece sobre um clique** em `last_5_assessments`. Uma pessoa que clicou e depois reportou recebe o rótulo `clicked`. * **Os extras do diretório são omitidos, não preenchidos com nulo.** Departamento e campos semelhantes não estão em `/v1`. * **Sem filtro de tempo no servidor.** `GET /v1/simulation_results` não tem `delivered_after`. A consulta percorre todos os resultados e, em seguida, mantém `delivered_at` nos últimos 12 meses do calendário. Uma organização grande com muito histórico pode consumir mais do orçamento de taxa por chave do que uma lista filtrada. ## Próximas etapas Credenciais, paginação e carregamento dessas consultas no Power BI ou no Excel. Interações de phishing em nível de evento dos últimos 12 meses. Inscrições em Treinamento na granularidade pessoa × atribuição. Conceda `simulation:read` e `entity:read` à chave que atualiza este relatório. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.