# Alertas, webhooks, Copilot e API do Investigador

Source: https://help.didit.me/pt-BR/investigations/investigator-alerts-and-integrations
Updated: 2026-10-23

Seja avisado quando um lote estiver pronto para aceitar, publique alertas no Slack ou Teams, escute os eventos investigator nos webhooks e opere pelo Copilot.

Em **Investigador → Configurações → Alertas no Slack e no Teams**, cole a URL do
webhook de entrada de um canal do Slack ou do Microsoft Teams e pressione **Enviar
teste**. Inscreva os seus endpoints de webhook nos eventos `investigator` em
**Webhooks**. Peça ao Didit Copilot para abrir ou aceitar um relatório: ele sempre
pede a sua aprovação antes de decidir qualquer coisa.

> **Note:** Estes recursos estão sendo liberados um a um e podem ainda não estar ativados para a
> sua aplicação. Você pode adicionar um canal do Slack ou do Teams antes de os alertas
> serem ativados: nada é publicado até que sejam.

## Notificações de lote pronto

Quando 5 ou mais recomendações de alta confiança estão esperando para ser aceitas, o Investigador avisa a sua equipe por e-mail e no console, no máximo uma vez a cada 4 horas, com um link que abre a fila no lote. O aviso vai para as pessoas mostradas em **Quem é avisado** na etapa **Revisar e ativar** da configuração. Essa lista é somente leitura no console: por padrão, todos os membros da sua organização são avisados, e somente membros são avisados. As preferências de notificação e os horários de silêncio de cada pessoa se aplicam normalmente.

## Alertas no Slack e no Teams

Adicione um canal por aplicação: cole a URL do webhook de entrada do canal, pressione **Adicionar canal** e depois **Enviar teste** para conferir se a mensagem chega. A URL precisa ser um link https de um canal do Slack ou do Microsoft Teams. Ela é armazenada criptografada e nunca mais é exibida; pressione **Remover** para parar de publicar.

O canal recebe uma mensagem quando:

| Alerta | Quando |
|---|---|
| **Lote pronto para aceitar** | 5 ou mais recomendações de alta confiança estão esperando, no máximo a cada 4 horas |
| **Queda de consistência** | Uma fila repetiu a recomendação em menos de 90% das reexecuções |
| **Desvio** | Uma fila entrou em desvio e o nível dela foi reduzido |

Os alertas trazem apenas contagens e links, nunca os dados de uma pessoa.

## Eventos de webhook

Os seus endpoints de webhook podem receber os eventos do Investigador, assinados e com novas tentativas como qualquer outro webhook da Didit. Inscreva-se neles em **Webhooks**:

| Evento | Enviado quando |
|---|---|
| `investigator.report.ready` | Um relatório foi escrito |
| `investigator.decision.automated` | O Investigador decidiu um item sozinho |
| `investigator.decision.overridden` | Uma pessoa tomou uma ação diferente da do relatório, ou alterou uma decisão automática |
| `investigator.question.raised` | O Investigador fez uma pergunta à sua equipe sobre a política |
| `investigator.automation.paused` | A automação foi pausada, por uma pessoa ou ao atingir o limite de gasto mensal |
| `investigator.rfi.answered` | A pessoa respondeu a um pedido de informação |
| `investigator.rfi.overdue` | Um pedido de informação passou do prazo sem resposta |
| `investigator.decision.contested` | A pessoa contestou uma decisão |
| `investigator.drift.detected` | Uma fila entrou em desvio e desceu um nível |
| `investigator.sla.breached` | Um relatório esperou além do nível de serviço da fila |
| `investigator.qa.failed` | Uma decisão tomada por uma pessoa foi reprovada na revisão de qualidade |
| `investigator.external.report.ready` | O relatório sobre um item enviado de fora da Didit está pronto |

Os eventos trazem apenas ids, a fila, a recomendação, a ação e a procedência, nunca o nome de uma pessoa, o motivo de um revisor ou uma narrativa. Os eventos de status de verificação e de verificação de empresa também dizem quem decidiu, em `decided_by`: `investigator` quando ele decidiu sozinho, `human` quando uma pessoa decidiu. Os payloads estão na [documentação para desenvolvedores](https://docs.didit.me). Veja também [noções básicas de webhooks](https://help.didit.me/pt-BR/integration/webhooks-basics).

## Didit Copilot

O Didit Copilot pode operar o Investigador por você: listar a fila, abrir um relatório e explicá-lo, responder a uma pergunta, iniciar um teste retroativo ou ler o desempenho. Quando você pede para aceitar, alterar a decisão ou aceitar em lote, ele mostra um cartão de aprovação com a ação exata, e nada é decidido até você aprovar. As decisões tomadas assim são marcadas como **via Copilot** em **Atividade**. Ele também pode adicionar uma nota a um item e, depois que você aprovar em um cartão igual, pedir ao Investigador que revise o item de novo. Ele também chega às outras abas: pausar a automação, autonomia, configurações, a política e o SOP, e as verificações que inicia, cada uma em um cartão igual. Veja [use o Didit Copilot no Investigador](https://help.didit.me/pt-BR/didit-copilot/copilot-in-the-investigator).

## MCP

O servidor MCP da Didit dá ao seu próprio assistente de IA as mesmas ferramentas do Investigador: a fila, os relatórios, as perguntas, os testes retroativos, o painel, o desempenho e a Atividade, além de adicionar uma nota a um item e pedir uma nova revisão. Aceitar, alterar a decisão e aceitar em lote são marcados como destrutivos e se recusam a rodar até que o seu assistente confirme que você aprovou exatamente aquela ação. As decisões tomadas assim são marcadas como **via MCP** em **Atividade**. As ferramentas agem em seu nome, com as permissões do seu papel: decidir um item exige acesso de escrita a ele.

## Enviar itens de fora da Didit

Se parte da sua revisão acontece fora da Didit, por exemplo verificações de outro provedor ou alertas do seu próprio monitoramento de transações, você pode enviar esses itens ao Investigador por API. Ele revisa cada um com base nas suas regras de verificação ou de transação e escreve um relatório que você lê por API ou recebe como o webhook `investigator.external.report.ready`. Esses itens nunca são decididos pela Didit e nunca são cobrados. A documentação para desenvolvedores explica o formato.

No console, defina o filtro **Origem** da fila como **Externo (API)** para vê-los em **Itens externos**. Cada item mostra se é um item de **Identidade** ou de **Transação**, o status (**Na fila**, **Em revisão**, **Revisado** ou **Falhou**) ou, depois de revisado, a recomendação, o que o outro sistema sinalizou e o que a sua política diz, com as regras que aplicou. O relatório é apenas uma recomendação, nunca uma decisão. **Como enviar itens por API** abre a documentação para desenvolvedores.

## API

Tudo o que está nas páginas do Investigador também está disponível pela API do Investigador, com uma chave de API que tenha acesso a decisões (para ler e decidir itens) ou a aplicações (para alterar a configuração). Veja a [documentação para desenvolvedores](https://docs.didit.me).