# 인베스티게이터 알림, 웹훅, Copilot, API

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

인베스티게이터 알림을 Slack이나 Microsoft Teams로 받고, 이벤트를 웹훅으로 받으며, Copilot이나 MCP로 조작할 수 있습니다.

**인베스티게이터 → 설정 → Slack 및 Teams 알림**에서 Slack 또는 Microsoft Teams 채널의
수신 웹훅 URL을 붙여 넣고 **테스트 보내기**를 누르세요. **웹훅**에서 웹훅 엔드포인트가
`investigator` 이벤트를 구독하도록 설정합니다. Didit Copilot에게 보고서를 열거나 수락해
달라고 요청할 수 있으며, Copilot은 무엇이든 결정하기 전에 항상 승인을 요청합니다.

> **Note:** 이 기능들은 하나씩 순차적으로 제공되고 있어 아직 애플리케이션에서 켜져 있지 않을 수
> 있습니다. 알림이 켜지기 전에도 Slack 또는 Teams 채널을 추가할 수 있지만, 켜지기 전까지는
> 아무것도 게시되지 않습니다.

## 일괄 처리 준비 알림

수락을 기다리는 확신도 높은 권고가 5건 이상이 되면, 인베스티게이터는 최대 4시간에 한 번 이메일과 콘솔로 팀에 알리며, 해당 묶음이 열린 대기열로 이동하는 링크를 함께 보냅니다. 알림은 설정의 **검토 후 켜기** 단계에서 **알림 대상** 아래에 표시된 사람에게 갑니다. 이 목록은 콘솔에서 읽기 전용입니다. 기본적으로 조직의 모든 구성원에게 알림이 가며, 알림은 항상 구성원에게만 갑니다. 각자의 알림 환경설정과 방해 금지 시간은 평소처럼 적용됩니다.

## Slack 및 Teams 알림

애플리케이션마다 채널을 하나 추가합니다. 채널의 수신 웹훅 URL을 붙여 넣고 **채널 추가**를 누른 다음, **테스트 보내기**를 눌러 메시지가 도착하는지 확인하세요. URL은 Slack 또는 Microsoft Teams 채널의 https 링크여야 합니다. URL은 암호화되어 저장되며 다시 표시되지 않습니다. 게시를 중단하려면 **제거**를 누르세요.

채널은 다음 경우에 메시지를 받습니다.

| 알림 | 발생 시점 |
|---|---|
| **일괄 수락 준비 완료** | 확신도 높은 권고가 5건 이상 대기 중일 때, 최대 4시간마다 |
| **일관성 하락** | 대기열이 재실행의 90% 미만에서 권고를 반복했을 때 |
| **드리프트** | 대기열에 드리프트가 발생해 단계가 낮아졌을 때 |

알림에는 건수와 링크만 담기며, 개인의 데이터는 절대 포함되지 않습니다.

## 웹훅 이벤트

웹훅 엔드포인트는 인베스티게이터의 이벤트를 받을 수 있으며, 다른 모든 Didit 웹훅과 마찬가지로 서명되고 재시도됩니다. **웹훅**에서 구독하세요.

| 이벤트 | 전송 시점 |
|---|---|
| `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` | 사람이 내린 결정이 QA 검토에서 불합격했을 때 |
| `investigator.external.report.ready` | Didit 외부에서 보낸 항목에 대한 보고서가 준비되었을 때 |

이벤트에는 ID, 대기열, 권고, 작업, 출처 정보만 담기며, 개인의 이름, 검토자의 사유, 설명 서술은 절대 포함되지 않습니다. 인증 및 비즈니스 인증 상태 이벤트는 `decided_by`로 누가 결정했는지도 알려 줍니다. 스스로 결정했으면 `investigator`, 사람이 결정했으면 `human`입니다. 페이로드는 [개발자 문서](https://docs.didit.me)에 있습니다. [웹훅 기본 사항](https://help.didit.me/ko/integration/webhooks-basics)도 참고하세요.

## Didit Copilot

Didit Copilot은 인베스티게이터 작업을 대신할 수 있습니다. 대기열을 나열하고, 보고서를 열어 설명하고, 질문에 답하고, 백테스트를 시작하거나 성능을 읽어 줍니다. 수락, 결정 변경 또는 일괄 수락을 요청하면 정확한 작업이 담긴 승인 카드를 보여 주며, 승인하기 전까지는 아무것도 결정되지 않습니다. 이렇게 내린 결정은 **활동**에 **Copilot 경유**로 표시됩니다. 항목에 메모를 추가할 수도 있으며, 같은 방식의 카드에서 승인하면 인베스티게이터에게 항목을 다시 검토하도록 요청할 수도 있습니다. 다른 탭에도 접근합니다. 자동화 일시 중지, 자율성, 설정, 정책과 SOP, 그리고 시작하는 점검까지 모두 같은 방식의 카드에서 진행됩니다. [인베스티게이터에서 Didit Copilot 사용하기](https://help.didit.me/ko/didit-copilot/copilot-in-the-investigator)를 참고하세요.

## MCP

Didit MCP 서버는 사용자의 AI 어시스턴트에게 같은 인베스티게이터 도구를 제공합니다. 대기열, 보고서, 질문, 백테스트, 대시보드, 성능, 활동, 그리고 항목에 메모 추가와 재검토 요청이 포함됩니다. 수락, 결정 변경, 일괄 수락은 파괴적 작업으로 표시되며, 어시스턴트가 사용자가 바로 그 작업을 승인했음을 확인하기 전까지 실행되지 않습니다. 이렇게 내린 결정은 **활동**에 **MCP 경유**로 표시됩니다. 도구는 사용자로서, 사용자 역할의 권한으로 작동합니다. 항목을 결정하려면 해당 항목에 대한 쓰기 권한이 필요합니다.

## Didit 외부 항목 보내기

검토의 일부가 Didit 외부에서 이루어진다면(예: 다른 제공업체의 인증이나 자체 거래 모니터링의 알림), 해당 항목을 API로 인베스티게이터에게 보낼 수 있습니다. 인베스티게이터는 각 항목을 인증 또는 거래 규칙과 대조해 검토하고 보고서를 작성하며, 보고서는 API로 읽거나 `investigator.external.report.ready` 웹훅으로 받을 수 있습니다. 이 항목들은 Didit이 절대 결정하지 않으며 절대 청구되지 않습니다. 형식은 개발자 문서에서 설명합니다.

콘솔에서 대기열의 **출처** 필터를 **외부(API)** 옵션으로 설정하면 **외부 항목** 아래에서 이 항목들을 볼 수 있습니다. 각 항목에는 **신원** 항목인지 **거래** 항목인지, 상태(**대기 중**, **검토 중**, **검토됨** 또는 **실패**) 또는 검토가 끝난 경우 그 권고, 다른 시스템이 표시한 내용, 그리고 정책이 말하는 내용과 적용한 규칙이 표시됩니다. 보고서는 권고일 뿐 결정이 아닙니다. **API로 항목을 보내는 방법**을 누르면 개발자 문서가 열립니다.

## API

인베스티게이터 페이지의 모든 기능은 인베스티게이터 API로도 사용할 수 있으며, 결정 접근 권한(항목을 읽고 결정하기 위해) 또는 애플리케이션 접근 권한(설정을 변경하기 위해)이 있는 API 키가 필요합니다. [개발자 문서](https://docs.didit.me)를 참고하세요.