> 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/zh-hant/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>

### 通知資料

<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>觸發此通知的風險引擎 ID。</td></tr><tr><td>riskEngineName</td><td>String</td><td>觸發此通知的風險引擎名稱。</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>區塊鏈網路的鏈 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>與觸發此通知的風險引擎相關聯的風險類型。</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>與觸發此通知的風險引擎相關聯，由使用者定義的風險等級。</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：Participant risk 資料</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>通知詳細資訊清單取決於風險引擎類型。</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 Data*** 相同的值和定義</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>使用與 ***Entity Risk Data*** 相同的值和定義</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. 交易 - Participant Risk 資料

<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 Data*** 相同的值和定義</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>使用與 ***Entity Risk Data*** 相同的值和定義</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 Data*** 相同的值和定義</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>使用與 ***Entity Risk Data*** 相同的值和定義</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>物件格式：與大額轉帳資料結構相同</td></tr><tr><td>ScreenedTransaction</td><td>Object</td><td>物件格式：與大額轉帳資料結構相同</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/zh-hant/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>鏈 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>風險引擎 ID</td></tr><tr><td>riskEngineName</td><td>String</td><td>風險引擎名稱</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>風險引擎 ID</td></tr><tr><td>riskEngineName</td><td>String</td><td>風險引擎名稱</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>
