# 调查员警报、Webhook、Copilot 与 API

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

把调查员警报发到 Slack 或 Teams，在 Webhook 上接收事件，经你批准后用 Copilot 或 MCP 操作，通过 API 审核 Didit 之外的项目。

在**调查员 → 设置 → Slack 和 Teams 警报**中，粘贴 Slack 或 Microsoft Teams 频道的传入 Webhook URL，然后点击**发送测试**。在 **Webhook** 中为你的 Webhook 端点订阅 `investigator` 事件。你可以让 Didit Copilot 打开或接受一份报告：它在作出任何决定之前都会先征求你的批准。

> **Note:** 这些功能正在逐项上线，可能尚未对你的应用开启。你可以在警报开启之前添加 Slack 或 Teams 频道：在警报开启之前不会发布任何内容。

## 批量就绪通知

当有 5 条或以上高置信度建议等待接受时，调查员会通过电子邮件和控制台通知你的团队，每 4 小时最多一次，并附上一个链接，打开后队列会定位到这批项目。通知会发给设置的**检查并开启**步骤中**通知对象**下显示的人。该列表在控制台中为只读：默认情况下会通知你组织的每一位成员，并且只会通知成员。每个人的通知偏好和免打扰时段照常适用。

## Slack 和 Teams 警报

每个应用可以添加一个频道：粘贴该频道的传入 Webhook URL，点击**添加频道**，然后点击**发送测试**，检查消息是否送达。该 URL 必须是 Slack 或 Microsoft Teams 频道的 https 链接。它会被加密存储，并且不会再次显示；点击**移除**即可停止发布。

在以下情况下，频道会收到消息：

| 警报 | 何时 |
|---|---|
| **批量可接受** | 有 5 条或以上高置信度建议正在等待，每 4 小时最多一次 |
| **一致性下降** | 某个队列在不到 90% 的重跑中重复了它的建议 |
| **漂移** | 某个队列发生漂移，其级别被降低 |

警报只包含数量和链接，绝不包含任何人的数据。

## Webhook 事件

你的 Webhook 端点可以接收调查员的事件，这些事件与 Didit 的其他所有 Webhook 一样经过签名并会重试。在 **Webhook** 中订阅它们：

| 事件 | 何时发送 |
|---|---|
| `investigator.report.ready` | 一份报告已撰写完成 |
| `investigator.decision.automated` | 调查员自行对某个项目作出了决定 |
| `investigator.decision.overridden` | 某人采取了与报告不同的操作，或改判了一项自动决定 |
| `investigator.question.raised` | 调查员就其政策向你的团队提出了问题 |
| `investigator.automation.paused` | 自动处理已暂停，由某人暂停或因达到每月支出上限而暂停 |
| `investigator.rfi.answered` | 当事人回答了一项信息请求 |
| `investigator.rfi.overdue` | 一项信息请求超过截止期限仍未得到回答 |
| `investigator.decision.contested` | 当事人对一项决定提出了异议 |
| `investigator.drift.detected` | 某个队列发生漂移并降低了一个级别 |
| `investigator.sla.breached` | 一份报告的等待时间超过了其队列的服务水平 |
| `investigator.qa.failed` | 某人作出的一项决定未通过质检审核 |
| `investigator.external.report.ready` | 针对来自 Didit 之外的某个项目的报告已就绪 |

事件只包含 ID、队列、建议、操作和来源信息，绝不包含任何人的姓名、审核员的理由或叙述。核验和企业验证的状态事件还会在 `decided_by` 中说明由谁作出决定：调查员自行决定时为 `investigator`，由人决定时为 `human`。有效负载详见[开发者文档](https://docs.didit.me)。另请参见 [Webhook 基础知识](https://help.didit.me/zh/integration/webhooks-basics)。

## Didit Copilot

Didit Copilot 可以替你操作调查员：列出队列、打开并解释一份报告、回答一个问题、启动一次回测或查看性能。当你让它接受、改判或批量接受时，它会显示一张列出确切操作的批准卡片，在你批准之前不会作出任何决定。以这种方式作出的决定会在**活动**中标记为**通过 Copilot**。它还可以为项目添加备注，并在你通过同样的卡片批准后，请调查员重新审查该项目。它还能操作其他标签页：暂停自动处理、自主程度、设置、政策和 SOP，以及它启动的检查，每一项都通过同样的卡片确认。参见[在调查员中使用 Didit Copilot](https://help.didit.me/zh/didit-copilot/copilot-in-the-investigator)。

## MCP

Didit MCP 服务器为你自己的 AI 助手提供同样的调查员工具：队列、报告、问题、回测、仪表板、性能和活动，以及为项目添加备注和请求重新审查。接受、改判和批量接受被标记为破坏性操作，在你的助手确认你已批准该确切操作之前会拒绝执行。以这种方式作出的决定会在**活动**中标记为**通过 MCP**。这些工具以你的身份、按你角色的权限运行：对某个项目作出决定需要对该项目的写入权限。

## 发送来自 Didit 之外的项目

如果你的部分审核在 Didit 之外进行，例如来自其他提供商的核验，或来自你自己的交易监控的警报，你可以通过 API 将这些项目发送给调查员。它会依据你的核验或交易规则审核每个项目，并撰写一份报告，你可以通过 API 读取，或以 `investigator.external.report.ready` Webhook 的形式接收。这些项目永远不会由 Didit 作出决定，也永远不会计费。开发者文档中说明了格式。

在控制台中，将队列的**来源**筛选设为**外部（API）**，即可在**外部项目**下看到它们。每个项目会显示它是**身份**项目还是**交易**项目、它的状态（**排队中**、**审查中**、**已审查**或**失败**），或者在审核完成后显示其建议、另一个系统标记的内容，以及你的政策给出的结论及其所应用的规则。它的报告只是建议，绝不是决定。**如何通过 API 发送项目**会打开开发者文档。

## API

调查员页面上的所有功能也都可以通过调查员 API 使用，所需的 API 密钥需具有决定权限（用于读取和决定项目）或应用权限（用于更改设置）。参见[开发者文档](https://docs.didit.me)。