> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels/webhook-format.md).

# Webhook 형식

## Webhook 메시지

<table><thead><tr><th width="192.21875">필드</th><th width="125.03125">유형</th><th>설명</th></tr></thead><tbody><tr><td>type</td><td>Integer</td><td><p>Webhook으로 수신되는 메시지 유형:</p><ol><li>notification (Risk Engine 알림)</li><li>monitorEvent (모니터링 이벤트)</li></ol></td></tr><tr><td>typeDescription</td><td>String</td><td><p>이 변수의 유효한 값:</p><p>["notification", "monitorEvent"]</p></td></tr><tr><td>data</td><td>Object</td><td>메시지의 세부 내용은 type 값에 따라 다릅니다.</td></tr></tbody></table>

### Notification 데이터

<table><thead><tr><th width="198.01953125">필드</th><th width="133.109375">유형</th><th>설명</th></tr></thead><tbody><tr><td>triggeringId</td><td>String</td><td>알림을 트리거한 알림 ID입니다.</td></tr><tr><td>riskEngineId</td><td>String</td><td>알림을 트리거한 risk engine ID입니다.</td></tr><tr><td>riskEngineName</td><td>String</td><td>알림을 트리거한 risk engine의 이름입니다.</td></tr><tr><td>targetType</td><td>Integer</td><td><p>1: 주소</p><p>2: 트랜잭션</p></td></tr><tr><td>targetTypeDescription</td><td>String</td><td><p>이 변수의 유효한 값:</p><p>["address", "transaction"]</p></td></tr><tr><td>chainId</td><td>Integer</td><td>블록체인 네트워크의 chain ID입니다.</td></tr><tr><td>targetIdentifier</td><td>String</td><td><p>targetType이 1이면 주소입니다.</p><p>targetType이 2이면 트랜잭션 해시입니다.</p></td></tr><tr><td>riskType</td><td>Integer</td><td><p>알림을 트리거한 risk engine과 관련된 위험 유형입니다.</p><p>1: exposure</p><p>2: behavior</p></td></tr><tr><td>riskTypeDescription</td><td>String</td><td><p>이 변수의 유효한 값:</p><p>["exposure", "behavior"]</p></td></tr><tr><td>riskLevel</td><td>Integer</td><td><p>알림을 트리거한 risk engine과 관련된 사용자 정의 위험 수준입니다.</p><ol><li>critical</li><li>high</li><li>medium</li><li>low</li><li>informational</li></ol></td></tr><tr><td>riskLevelDescription</td><td>String</td><td><p>이 변수의 유효한 값:</p><p>["critical", "high", "medium", "low", "informational"]</p></td></tr><tr><td>timestamp</td><td>String</td><td>ISO 8601 형식의 알림 타임스탬프입니다.</td></tr><tr><td>type</td><td>Integer</td><td><p>세부 알림 데이터의 유형</p><p>주소 유형:</p><p>1: Entity risk 데이터</p><p>2: Interaction risk 데이터</p><p>3: 대규모 이체 데이터</p><p>4: 고빈도 데이터</p><p>5: 경유 주소 데이터</p><p>6: 블랙리스트 상호작용 데이터</p><p>트랜잭션 유형:</p><p>7: 참여자 위험 데이터</p><p>8: Interaction risk 데이터</p><p>9: 대규모 이체 데이터</p><p>10: 빠른 경유 데이터</p><p>11: 블랙리스트 상호작용 데이터</p></td></tr><tr><td>data</td><td>Array[Object]</td><td><p>알림 세부 정보 목록은 risk engine 유형에 따라 다릅니다.</p><p>자세한 내용은 다음 섹션을 참조하세요.</p></td></tr></tbody></table>

#### 1. 주소 - Entity Risk 데이터

<table><thead><tr><th width="203.15234375">필드</th><th width="133.04296875">유형</th><th>설명</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td><p>사전 구성된 규칙에 따라 일치한 위험 지표입니다.</p><p>1: 제재 대상</p><p>2: 공격</p><p>3: 스캠</p><p>4: 랜섬웨어</p><p>5: 아동 학대 자료</p><p>6: 자금세탁</p><p>7: 믹싱</p><p>8: 다크마켓</p><p>9: 다크웹 비즈니스</p><p>10: 차단됨</p><p>11: 도박</p><p>12: KYC 미적용 거래소<br>13. 테러자금 조달<br>14. FATF 그레이리스트 관할권<br>15. FATF 고위험 관할권<br>16. 인신매매<br>17. 마약 밀매</p></td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td><p>이 변수의 유효한 값:</p><p>["제재 대상", "공격", "스캠", "랜섬웨어", "아동 학대 자료", "자금세탁", "믹싱", "다크마켓", "다크웹 비즈니스", "차단됨", "도박", "KYC 미적용 거래소", "테러자금 조달", "FATF 그레이리스트 관할권", "FATF 고위험 관할권", "인신매매", "마약 밀매"]</p></td></tr><tr><td>detail</td><td>Array[String]</td><td>추가 정보</td></tr></tbody></table>

#### 2. 주소 - Interaction Risk 데이터

<table><thead><tr><th width="213.07421875">필드</th><th width="133.50390625">유형</th><th>설명</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>direction</td><td>Integer</td><td>이체 방향:<br>• 1 : 인바운드(자금 수신)<br>• 2 : 아웃바운드(자금 송신)</td></tr><tr><td>hop</td><td>Integer</td><td>위험 엔터티와의 분리 단계:<br>• 1 : 직접 상호작용<br>• 2+ : 간접 상호작용(단계 수)</td></tr><tr><td>exposureValue</td><td>String</td><td>노출된 자금의 절대값(USD 기준)</td></tr><tr><td>exposurePercent</td><td>String</td><td>위험으로 "오염된" 전체 트랜잭션 규모의 비율</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>이 상호작용의 세부 정보로, 참여 주소 각각의 목록과 해당 상호작용에서의 구체적인 위험 노출 정보를 포함합니다.</td></tr><tr><td>>address</td><td>String</td><td>위험 지표가 있는 주소입니다.</td></tr><tr><td>>label</td><td>String</td><td>주소 라벨입니다.</td></tr><tr><td>>detail</td><td>String</td><td>상세 위험 정보입니다.</td></tr><tr><td>>hop</td><td>Integer</td><td>검사 대상 주소까지의 최소 단계 수입니다.</td></tr><tr><td>>exposureValue</td><td>String</td><td>기여한 위험 노출 값(USD 기준)입니다.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>기여한 위험 노출 비율입니다.</td></tr></tbody></table>

#### 3. 주소 - 대규모 이체 데이터

<table><thead><tr><th width="205.31640625">필드</th><th width="97.8984375">유형</th><th>설명</th></tr></thead><tbody><tr><td>transaction</td><td>String</td><td>트랜잭션 해시</td></tr><tr><td>usdValue</td><td>String</td><td>USD 기준 이체 금액</td></tr><tr><td>direction</td><td>Integer</td><td>이체 방향:<br>• 1 : 인바운드(자금 수신)<br>• 2 : 아웃바운드(자금 송신)</td></tr><tr><td>timestamp</td><td>String</td><td>ISO 8601 형식의 트랜잭션 타임스탬프</td></tr><tr><td>token</td><td>String</td><td>토큰 컨트랙트 주소</td></tr><tr><td>tokenSymbol</td><td>String</td><td>토큰 심볼</td></tr><tr><td>tokenAmount</td><td>String</td><td>토큰 수량</td></tr></tbody></table>

#### 4. 주소 - 고빈도 데이터

<table><thead><tr><th width="201.19140625">필드</th><th width="142.28515625">유형</th><th>설명</th></tr></thead><tbody><tr><td>transactionCount</td><td>Integer</td><td>관찰 기간 동안의 총 트랜잭션 수</td></tr><tr><td>duration</td><td>Integer</td><td>가장 가까운 분 단위로 반올림</td></tr><tr><td>transactionList</td><td>Array[Object]</td><td>개별 트랜잭션 세부 정보의 배열</td></tr><tr><td>>transactionItem</td><td>Object</td><td>트랜잭션 항목 형식: **대규모 이체 데이터 스키마**와 동일</td></tr></tbody></table>

#### 5. 주소 - 경유 주소 데이터

<table><thead><tr><th width="179.84765625">필드</th><th width="118.41796875">유형</th><th>설명</th></tr></thead><tbody><tr><td>inTransaction</td><td>String</td><td>인바운드 트랜잭션 해시</td></tr><tr><td>inTimestamp</td><td>String</td><td>ISO 8601 형식의 인바운드 트랜잭션 타임스탬프</td></tr><tr><td>inUsdValue</td><td>String</td><td>인바운드 이체 금액(USD)</td></tr><tr><td>outTransaction</td><td>String</td><td>아웃바운드 트랜잭션 해시</td></tr><tr><td>outTimestamp</td><td>String</td><td>ISO 8601 형식의 아웃바운드 트랜잭션 타임스탬프</td></tr><tr><td>outUsdValue</td><td>String</td><td>아웃바운드 이체 금액(USD)</td></tr><tr><td>transitPercent</td><td>String</td><td>경유한 자금의 비율</td></tr></tbody></table>

#### 6. 주소 - 블랙리스트 상호작용 데이터

<table><thead><tr><th width="213.07421875">필드</th><th width="133.50390625">유형</th><th>설명</th></tr></thead><tbody><tr><td>direction</td><td>Integer</td><td>이체 방향:<br>• 1 : 인바운드(자금 수신)<br>• 2 : 아웃바운드(자금 송신)</td></tr><tr><td>hop</td><td>Integer</td><td>위험 엔터티와의 분리 단계:<br>• 1 : 직접 상호작용<br>• 2+ : 간접 상호작용(단계 수)</td></tr><tr><td>exposureValue</td><td>String</td><td>노출된 자금의 절대값(USD 기준)</td></tr><tr><td>exposurePercent</td><td>String</td><td>위험으로 "오염된" 전체 트랜잭션 규모의 비율</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>이 상호작용의 세부 정보로, 참여 주소 각각의 목록과 해당 상호작용에서의 구체적인 위험 노출 정보를 포함합니다.</td></tr><tr><td>>address</td><td>String</td><td>위험 지표가 있는 주소입니다.</td></tr><tr><td>>label</td><td>String</td><td>주소 라벨입니다.</td></tr><tr><td>>hop</td><td>Integer</td><td>검사 대상 주소까지의 최소 단계 수입니다.</td></tr><tr><td>>exposureValue</td><td>String</td><td>기여한 위험 노출 값(USD 기준)입니다.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>기여한 위험 노출 비율입니다.</td></tr></tbody></table>

#### 7. 트랜잭션 - 참여자 위험 데이터

<table><thead><tr><th width="158.515625">필드</th><th width="143.9140625">유형</th><th>설명</th></tr></thead><tbody><tr><td>address</td><td>String</td><td>위험 지표가 탐지된 참여자 주소입니다.</td></tr><tr><td>riskIndicator</td><td>Integer</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>detail</td><td>Array[String]</td><td>추가 정보</td></tr></tbody></table>

#### 8. 트랜잭션 - Interaction Risk 데이터

<table><thead><tr><th width="213.07421875">필드</th><th width="133.50390625">유형</th><th>설명</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>***Entity Risk 데이터***와 동일한 값 및 정의를 사용합니다.</td></tr><tr><td>direction</td><td>Integer</td><td>이체 방향:<br>• 1 : 인바운드(자금 수신)<br>• 2 : 아웃바운드(자금 송신)</td></tr><tr><td>hop</td><td>Integer</td><td>위험 엔터티와의 분리 단계:<br>• 1 : 직접 상호작용<br>• 2+ : 간접 상호작용(단계 수)</td></tr><tr><td>exposureValue</td><td>String</td><td>노출된 자금의 절대값(USD 기준)</td></tr><tr><td>exposurePercent</td><td>String</td><td>위험으로 "오염된" 전체 트랜잭션 규모의 비율</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>이 상호작용의 세부 정보로, 참여 주소 각각의 목록과 해당 상호작용에서의 구체적인 위험 노출 정보를 포함합니다.</td></tr><tr><td>>address</td><td>String</td><td>위험 지표가 있는 주소입니다.</td></tr><tr><td>>label</td><td>String</td><td>주소 라벨입니다.</td></tr><tr><td>>detail</td><td>String</td><td>상세 위험 정보입니다.</td></tr><tr><td>>hop</td><td>Integer</td><td>검사 대상 주소까지의 최소 단계 수입니다.</td></tr><tr><td>>exposureValue</td><td>String</td><td>기여한 위험 노출 값(USD 기준)입니다.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>기여한 위험 노출 비율입니다.</td></tr></tbody></table>

#### 9. 트랜잭션 - 대규모 이체 데이터

<table><thead><tr><th width="224.0390625">필드</th><th width="202.22265625">유형</th><th>설명</th></tr></thead><tbody><tr><td>transaction</td><td>String</td><td>트랜잭션 해시</td></tr><tr><td>usdValue</td><td>String</td><td>USD 기준 이체 금액</td></tr><tr><td>fromAddress</td><td>String</td><td>송신자 주소</td></tr><tr><td>toAddress</td><td>String</td><td>수신자 주소</td></tr><tr><td>timestamp</td><td>String</td><td>ISO 8601 형식의 트랜잭션 타임스탬프</td></tr><tr><td>token</td><td>String</td><td>토큰 컨트랙트 주소</td></tr><tr><td>tokenSymbol</td><td>String</td><td>토큰 심볼</td></tr><tr><td>tokenAmount</td><td>String</td><td>이체에 포함된 토큰 수량</td></tr></tbody></table>

#### 10. 트랜잭션 - 빠른 경유 데이터

<table><thead><tr><th width="223.77734375">필드</th><th width="201">유형</th><th>설명</th></tr></thead><tbody><tr><td>proceedTransaction</td><td>Object</td><td>Object 형식: 대규모 이체 데이터 스키마와 동일</td></tr><tr><td>ScreenedTransaction</td><td>Object</td><td>Object 형식: 대규모 이체 데이터 스키마와 동일</td></tr></tbody></table>

#### 11. 트랜잭션 - 블랙리스트 상호작용 데이터

<table><thead><tr><th width="213.07421875">필드</th><th width="133.50390625">유형</th><th>설명</th></tr></thead><tbody><tr><td>direction</td><td>Integer</td><td>이체 방향:<br>• 1 : 인바운드(자금 수신)<br>• 2 : 아웃바운드(자금 송신)</td></tr><tr><td>hop</td><td>Integer</td><td>위험 엔터티와의 분리 단계:<br>• 1 : 직접 상호작용<br>• 2+ : 간접 상호작용(단계 수)</td></tr><tr><td>exposureValue</td><td>String</td><td>노출된 자금의 절대값(USD 기준)</td></tr><tr><td>exposurePercent</td><td>String</td><td>위험으로 "오염된" 전체 트랜잭션 규모의 비율</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>이 상호작용의 세부 정보로, 참여 주소 각각의 목록과 해당 상호작용에서의 구체적인 위험 노출 정보를 포함합니다.</td></tr><tr><td>>address</td><td>String</td><td>위험 지표가 있는 주소입니다.</td></tr><tr><td>>label</td><td>String</td><td>주소 라벨입니다.</td></tr><tr><td>>hop</td><td>Integer</td><td>검사 대상 주소까지의 최소 단계 수입니다.</td></tr><tr><td>>exposureValue</td><td>String</td><td>기여한 위험 노출 값(USD 기준)입니다.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>기여한 위험 노출 비율입니다.</td></tr></tbody></table>

***

## 모니터링 이벤트 데이터

알림 채널에서 **모니터링 이벤트**를 활성화하면 모니터링 이벤트는 `type: 2` (`monitorEvent`) 메시지로 전달됩니다. 위험 관련 이벤트만 푸시되며(모니터링 시작/중지와 같은 수명 주기 이벤트는 제외), 전달 여부는 [알림 트리거 설정](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/monitoring/monitor.md#setting-up-notifications)에 따라 제어됩니다.

### 공통 필드

모든 모니터링 이벤트 메시지는 `data` 객체에 다음 필드를 포함합니다.

<table><thead><tr><th width="210">필드</th><th width="110">유형</th><th>설명</th></tr></thead><tbody><tr><td>eventType</td><td>Integer</td><td>이벤트 유형: 4 (risk_level_increased), 5 (risk_level_decreased), 6 (alert_triggered), 7 (alert_expired)</td></tr><tr><td>eventTypeDescription</td><td>String</td><td>사람이 읽을 수 있는 이벤트 유형 이름</td></tr><tr><td>targetType</td><td>Integer</td><td>1: 주소, 2: 트랜잭션(현재는 주소만 지원됨)</td></tr><tr><td>targetTypeDescription</td><td>String</td><td>"address" 또는 "transaction"</td></tr><tr><td>chainId</td><td>Integer</td><td>Chain ID</td></tr><tr><td>targetIdentifier</td><td>String</td><td>모니터링 중인 주소</td></tr><tr><td>riskLevel</td><td>Integer</td><td>주소의 현재 종합 위험 수준(1: critical, 2: high, 3: medium, 4: low)</td></tr><tr><td>riskLevelDescription</td><td>String</td><td>위험 수준 이름</td></tr><tr><td>timestamp</td><td>String</td><td>ISO 8601 형식의 이벤트 시간</td></tr></tbody></table>

### 위험 수준 증가 / 감소 (eventType 4, 5)

모니터링 중인 주소의 종합 위험 수준이 변경되면 전송됩니다. 다음 추가 필드를 포함합니다.

<table><thead><tr><th width="210">필드</th><th width="110">유형</th><th>설명</th></tr></thead><tbody><tr><td>prevLevel</td><td>Integer</td><td>변경 전 위험 수준</td></tr><tr><td>prevLevelDescription</td><td>String</td><td>이전 위험 수준 이름</td></tr><tr><td>newLevel</td><td>Integer</td><td>변경 후 위험 수준</td></tr><tr><td>newLevelDescription</td><td>String</td><td>새 위험 수준 이름</td></tr><tr><td>relatedAlerts</td><td>Array</td><td>위험 수준 변경을 유발한 알림</td></tr></tbody></table>

`relatedAlerts`의 각 객체:

<table><thead><tr><th width="210">필드</th><th width="110">유형</th><th>설명</th></tr></thead><tbody><tr><td>alertId</td><td>String</td><td>알림 ID</td></tr><tr><td>riskEngineId</td><td>String</td><td>Risk engine ID</td></tr><tr><td>riskEngineName</td><td>String</td><td>Risk engine 이름</td></tr><tr><td>riskLevel</td><td>Integer</td><td>알림 위험 수준</td></tr><tr><td>riskLevelDescription</td><td>String</td><td>알림 위험 수준 이름</td></tr><tr><td>action</td><td>String</td><td>"triggered" 또는 "expired"</td></tr></tbody></table>

### 알림 트리거 / 만료 (eventType 6, 7)

위험 수준을 변경하지 않고 알림이 트리거되거나 만료되면 전송됩니다. 위험 수준 변경을 유발하는 경우에는 대신 위험 수준 증가/감소 메시지의 `relatedAlerts`에 포함됩니다.

이 이벤트에는 `alerts` 배열이 포함되며, 각 객체에는 다음 필드가 있습니다.

<table><thead><tr><th width="230">필드</th><th width="110">유형</th><th>설명</th></tr></thead><tbody><tr><td>alertId</td><td>String</td><td>알림 ID</td></tr><tr><td>riskEngineId</td><td>String</td><td>Risk engine ID</td></tr><tr><td>riskEngineName</td><td>String</td><td>Risk engine 이름</td></tr><tr><td>alertRiskLevel</td><td>Integer</td><td>알림 자체의 위험 수준(주소의 종합 위험 수준과 다름)</td></tr><tr><td>alertRiskLevelDescription</td><td>String</td><td>알림 위험 수준 이름</td></tr><tr><td>description</td><td>String</td><td>알림 설명</td></tr></tbody></table>
