> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitorização AML contínua: retriagem diária

> Retriagem AML diária da Didit para utilizadores verificados com alertas webhook de sanções e conformidade contínua desde $0.07/ano.

A monitorização contínua é um componente essencial de um programa de AML completo. Garante que a sua diligência devida sobre a clientela se mantém atualizada e ajuda-o a identificar potenciais riscos que possam surgir após o processo inicial de onboarding. Esta funcionalidade é incluída automaticamente em todas as sessões em que foi realizada uma verificação AML, não exigindo quaisquer passos adicionais de integração.

![Didit continuous AML monitoring dashboard with daily rescreening and webhook alerts](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/aml-continuous-monitoring.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=8cf8c4ecef0f78953423a598defd2b2b)

### Como funciona

O nosso sistema de monitorização contínua verifica continuamente os seus utilizadores verificados contra várias listas de vigilância, listas de sanções e fontes de notícias adversas. Apresentamos uma visão geral detalhada do processo:

1. **Verificações diárias automatizadas**:
   * O nosso sistema executa verificações diárias automatizadas para todas as sessões que foram previamente aprovadas
   * Cada verificação volta a fazer a triagem do utilizador contra a nossa base de dados abrangente de listas de vigilância e listas de sanções
   * O sistema compara quaisquer novos resultados com os seus limiares de AML configurados

2. **Atualizações com base em limiares**:
   * Se forem encontrados novos resultados que excedam o seu limiar de revisão configurado, o estado da sessão muda para "Em análise"
   * Se os novos resultados excederem o seu limiar de recusa, o estado da sessão muda automaticamente para "Recusada"
   * Estes limiares são os mesmos que configurou nos seus [Fluxos](https://docs.didit.me/pt/console/workflows.md)

3. **Notificações em tempo real**:
   * Quando ocorre uma alteração de estado, a sua aplicação recebe uma notificação de webhook
   * O payload do webhook inclui o estado atualizado e informações detalhadas sobre os novos resultados de AML
   * Estas notificações seguem o mesmo formato do nosso [sistema de webhooks](https://docs.didit.me/pt/integration/webhooks.md) padrão

4. **Atualizações na Business Console**:
   * Todas as alterações são imediatamente refletidas na sua Business Console
   * A sua equipa de conformidade pode inspecionar novos resultados de AML, rever conclusões detalhadas e tomar as ações adequadas
   * A consola mantém um registo de auditoria completo de todas as atividades de monitorização e alterações de estado

### Ativar a monitorização para utilizadores e empresas

Pode ativar ou desativar a monitorização contínua para utilizadores e empresas como um todo diretamente a partir da consola — incluindo utilizadores que nunca passaram por uma verificação AML, como utilizadores importados.

1. Abra **Utilizadores** (ou **Empresas**) na sua Business Console, selecione os perfis que pretende monitorizar e clique em **Monitorização AML contínua**.
2. A caixa de diálogo apresenta uma estimativa de custos antes de qualquer execução: quantos perfis estão selecionados, quantos precisam de uma nova triagem AML, o custo único da triagem e o custo anual de monitorização.
3. Clique em **Ativar monitorização**. As seleções pequenas são concluídas de imediato; as maiores são executadas em segundo plano enquanto a caixa de diálogo apresenta o progresso em direto.
4. Quando a execução terminar, a caixa de diálogo discrimina o resultado por perfil: ativado, triado e ativado, já ativado ou ignorado com o respetivo motivo (por exemplo, um perfil sem o nome completo, data de nascimento e país necessários para a triagem).

Alguns detalhes que convém conhecer:

* **Os perfis sem uma triagem AML são triados primeiro.** A Didit cria uma nova verificação AML para estes (visível no separador **Verificações** do perfil), faturada como uma triagem AML normal. A monitorização é então ativada nessa triagem.
* **Uma triagem monitorizada por perfil.** A ativação mantém exatamente uma triagem AML monitorizada por utilizador ou empresa, pelo que uma pessoa que se tenha verificado múltiplas vezes só é monitorizada — e faturada — uma vez. A desativação desliga a monitorização em todas as triagens do perfil.
* **As listas permitem ver a monitorização rapidamente.** Tanto a lista de **Utilizadores** como a de **Empresas** incluem uma coluna de **Monitorização contínua**; passe o cursor por cima para ver a próxima data de faturação anual.
* **A seleção total funciona com os seus filtros.** Com todas as linhas selecionadas, a ação aplica-se à sua vista filtrada atual, não apenas à página carregada.

### Ativar a monitorização através da API

A mesma operação está disponível para o seu backend através da sua chave de API, para que nunca tenha de voltar a fazer a triagem de um perfil ou abrir a consola para alterar a sua monitorização:

* [`POST /v3/users/aml-monitoring/`](https://docs.didit.me/pt/management-api/aml-monitoring/toggle-users) para utilizadores
* [`POST /v3/businesses/aml-monitoring/`](https://docs.didit.me/pt/management-api/aml-monitoring/toggle-businesses) para empresas
* [`GET /v3/aml-monitoring/jobs/{job_id}/`](https://docs.didit.me/pt/management-api/aml-monitoring/get-job) para consultar periodicamente o estado de um trabalho

Ambos os endpoints de ativação/desativação aceitam uma lista dos seus próprios identificadores (`vendor_data_list`) e/ou IDs da Didit (`didit_internal_id_list`), até 1000 por chamada, e seguem exatamente as regras da consola: uma triagem monitorizada por perfil, perfis sem triagem são triados primeiro e a desativação desliga a monitorização em todas as triagens do perfil.

```bash theme={null}
# 1. Preview the cost. Nothing is written.
curl -X POST https://verification.didit.me/v3/users/aml-monitoring/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_enabled": true, "estimate_only": true, "vendor_data_list": ["user-123", "user-456"]}'

# 2. Enable monitoring. 20 profiles or fewer complete inline (200);
#    larger selections return 202 and a job_id to poll.
curl -X POST https://verification.didit.me/v3/users/aml-monitoring/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_enabled": true, "vendor_data_list": ["user-123", "user-456"]}'
```

A resposta inclui a mesma discriminação apresentada na caixa de diálogo da consola, além de uma entrada em `results` por perfil com o respetivo resultado: `enabled`, `screened_and_enabled`, `already_enabled`, `disabled` ou um motivo para ignorar o perfil, como `skipped_no_identity_data`. Os identificadores que não correspondam a nada são devolvidos em `unmatched`. Alternar a monitorização não emite nenhum webhook próprio; uma vez ativada a monitorização, as novas triagens disparam os eventos habituais de `status.updated` e `data.updated`.

### Comprovar a execução da monitorização

Os alertas, entradas de atividade e webhooks acima disparam todos após uma **alteração**. Um sujeito triado diariamente durante um ano sem novos resultados não produz nenhum deles, pelo que "sem novidades" e "nada foi executado" parecem idênticos — o que não é uma resposta que resista a uma auditoria. Três áreas registam as próprias execuções.

**1. A data da última triagem, no relatório de AML.** O campo `last_ongoing_screening_at` é atualizado em cada execução concluída, quer tenha havido alterações ou não, nas decisões de sessão de `/v2/` e `/v3/` e no relatório de AML autónomo. O campo `last_ongoing_screening_datasets_updated_at`, ao lado deste, é a atualização mais recente do conjunto de dados de AML que o fornecedor reportou para essa execução. Nenhum dos dois é estimado: `null` significa "nunca foi triado novamente" e "nenhuma data do conjunto de dados foi comunicada", respetivamente, e não "desconhecido, pelo que aqui está uma data plausível". Não interprete `next_ongoing_monitoring_bill_date` como uma data de triagem — trata-se de uma data de faturação.

**2. O histórico de triagens, por sujeito.** `GET /v1/session/{session_id}/aml-screening-history/` devolve todas as execuções concluídas para a verificação AML dessa sessão, da mais recente para a mais antiga, incluindo as execuções cujo resultado foi `NO_CHANGE`. Adicione `?node_id=` quando um fluxo de grafo tiver mais do que um nó de AML.

```bash theme={null}
curl https://verification.didit.me/v1/session/SESSION_ID/aml-screening-history/ \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{
  "count": 2,
  "results": [
    {
      "uuid": "0d1c...",
      "completed_at": "2026-09-12T04:03:11Z",
      "started_at": "2026-09-12T04:00:02Z",
      "outcome": "NO_CHANGE",
      "trigger": "ONGOING_MONITORING",
      "status": "Approved",
      "score": 0,
      "total_hits": 0,
      "dataset_freshness": null
    }
  ]
}
```

| Campo | Significado |
| - | - |
| `outcome` | `NO_CHANGE` — a execução foi concluída e o resultado não se alterou. `CHANGED` — a execução foi concluída e a pontuação, o estado ou as ocorrências alteraram-se. `FAILED` — o fornecedor não devolveu qualquer resposta utilizável para este sujeito, pelo que nada foi sujeito a triagem e nada foi alterado. Uma falha de cobertura é registada em vez de ser ocultada. |
| `completed_at` / `started_at` | Quando a triagem deste sujeito terminou e quando o lote a que pertencia foi iniciado. |
| `status` / `score` / `total_hits` | O estado em que a verificação ficou após a execução. |
| `dataset_freshness` | O nível de atualização das listas do fornecedor para essa execução, ou `null` quando não havia datas disponíveis para os conjuntos de dados. |

**3. A evidência exportável.** `GET /v1/session/{session_id}/aml-screening-history/export/` transmite o mesmo histórico num ficheiro CSV — uma linha por triagem concluída, com a data de atualização do conjunto de dados por família de fontes onde o fornecedor reportou uma e uma célula vazia onde não o fez. Esse ficheiro é o que uma equipa de conformidade entrega a um auditor. A Business Console apresenta a mesma lista e a mesma exportação junto ao resultado de AML, para que os revisores não precisem de acesso à API para o produzir.

> [!NOTE]
>
> **Limites de disponibilidade, explicados de forma clara.** O histórico é registado a partir do momento em que esta funcionalidade foi lançada; as triagens anteriores não são reconstruídas e estão simplesmente ausentes. As execuções são mantidas durante a janela de conservação configurada (dois anos por predefinição). O grau de atualização dos conjuntos de dados depende de o fornecedor publicar as respetivas datas para o ambiente em que se encontra — caso não o faça, todos os campos de conjuntos de dados indicam `null` e `GET /v1/aml/dataset-freshness/` reporta `availability: "not_configured"`. Uma data ausente nunca é substituída por um valor substituto.

### Benefícios da monitorização contínua

1. **Conformidade contínua**: Garanta o cumprimento contínuo dos regulamentos de AML/KYC sem qualquer configuração adicional.
2. **Mitigação de riscos**: Identifique e resolva rapidamente os riscos emergentes através de monitorização automática.
3. **Eficiência operacional**: Automatize processos morosos de nova triagem manual sem trabalho de integração adicional.
4. **Diligência devida reforçada**: Mantenha os perfis de clientes atualizados automaticamente.
5. **Apoio regulamentar**: Demonstre facilmente os esforços de conformidade contínua aos reguladores.
6. **Integração sem intervenção**: Beneficie de monitorização contínua sem qualquer trabalho de desenvolvimento adicional.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.