# インベスティゲーターのアラート、Webhook、Copilot、API

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

バッチが揃うと通知し、アラートをSlackやMicrosoft Teamsに投稿、イベントをWebhookで受信、CopilotやMCPから操作できます。

**インベスティゲーター → 設定 → SlackとTeamsのアラート**で、SlackまたはMicrosoft Teamsのチャンネルの受信WebhookのURLを貼り付け、**テストを送信**を押します。**Webhook**で、Webhookエンドポイントを`investigator`イベントに登録します。Didit Copilotにレポートを開く、または採用するよう依頼できます。Copilotは何かを判断する前に、必ずあなたの承認を求めます。

> **Note:** これらの機能は1つずつ提供中のため、あなたのアプリケーションではまだ有効になっていない場合があります。SlackまたはTeamsのチャンネルはアラートが有効になる前に追加できますが、有効になるまで何も投稿されません。

## バッチ準備完了の通知

確信度の高い推奨が5件以上採用待ちになると、インベスティゲーターはメールとコンソールでチームに通知します。通知は最大で4時間に1回で、キューをそのバッチで開くリンクが付きます。通知は、セットアップの**確認して有効化**ステップの**通知先**に表示されているメンバーに送られます。このリストはコンソールでは読み取り専用です。デフォルトでは組織のすべてのメンバーに通知され、メンバー以外に通知されることはありません。各メンバーの通知設定と通知停止時間は通常どおり適用されます。

## SlackとTeamsのアラート

アプリケーションごとに1つのチャンネルを追加します。チャンネルの受信WebhookのURLを貼り付けて**チャンネルを追加**を押し、**テストを送信**でメッセージが届くことを確認します。URLは、SlackまたはMicrosoft Teamsのチャンネルのhttpsリンクである必要があります。URLは暗号化して保存され、再表示されることはありません。投稿を止めるには**削除**を押します。

チャンネルには次の場合にメッセージが届きます。

| アラート | タイミング |
|---|---|
| **採用可能なバッチ** | 確信度の高い推奨が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` | キューでドリフトが発生し、レベルが1段階下がった |
| `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/ja/integration/webhooks-basics)もご覧ください。

## Didit Copilot

Didit Copilotは、あなたの代わりにインベスティゲーターを操作できます。キューの一覧表示、レポートを開いての説明、質問への回答、バックテストの開始、パフォーマンスの確認などです。採用、決定の変更、一括採用を依頼すると、正確な操作内容を示した承認カードが表示され、あなたが承認するまで何も判断されません。この方法で行われた判断は、**アクティビティ**で**Copilot経由**と表示されます。項目へのメモの追加もでき、同じような承認カードで承認すると、インベスティゲーターに項目の再レビューを依頼することもできます。ほかのタブにも対応しており、自動化の一時停止、自律性、設定、ポリシーとSOP、Copilotが開始するチェックも、それぞれ同じような承認カードで行います。詳しくは[インベスティゲーターでDidit Copilotを使う](https://help.didit.me/ja/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)をご覧ください。