> 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/de/user-manual/configure/notification-channels/webhook-format.md).

# Webhook-Format

## Webhook-Nachricht

<table><thead><tr><th width="192.21875">Feld</th><th width="125.03125">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>type</td><td>Integer</td><td><p>Typ der vom Webhook empfangenen Nachricht:</p><ol><li>notification (Risk Engine-Warnung)</li><li>monitorEvent (Überwachungsereignis)</li></ol></td></tr><tr><td>typeDescription</td><td>String</td><td><p>Gültige Werte für diese Variable:</p><p>["notification", "monitorEvent"]</p></td></tr><tr><td>data</td><td>Object</td><td>Die konkreten Details der Nachricht hängen vom Wert von type ab.</td></tr></tbody></table>

### Benachrichtigungsdaten

<table><thead><tr><th width="198.01953125">Feld</th><th width="133.109375">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>triggeringId</td><td>String</td><td>Die Warnungs-ID, die die Benachrichtigung ausgelöst hat.</td></tr><tr><td>riskEngineId</td><td>String</td><td>Die ID der Risk Engine, die die Benachrichtigung ausgelöst hat.</td></tr><tr><td>riskEngineName</td><td>String</td><td>Der Name der Risk Engine, die die Benachrichtigung ausgelöst hat.</td></tr><tr><td>targetType</td><td>Integer</td><td><p>1: Adresse</p><p>2: Transaktion</p></td></tr><tr><td>targetTypeDescription</td><td>String</td><td><p>Gültige Werte für diese Variable:</p><p>["address", "transaction"]</p></td></tr><tr><td>chainId</td><td>Integer</td><td>Die Chain-ID des Blockchain-Netzwerks.</td></tr><tr><td>targetIdentifier</td><td>String</td><td><p>Wenn targetType 1 ist, handelt es sich um die Adresse.</p><p>Wenn targetType 2 ist, handelt es sich um den Transaktions-Hash.</p></td></tr><tr><td>riskType</td><td>Integer</td><td><p>Der Risikotyp, der der Risk Engine zugeordnet ist, die die Benachrichtigung ausgelöst hat.</p><p>1: exposure</p><p>2: behavior</p></td></tr><tr><td>riskTypeDescription</td><td>String</td><td><p>Gültige Werte für diese Variable:</p><p>["exposure", "behavior"]</p></td></tr><tr><td>riskLevel</td><td>Integer</td><td><p>Die benutzerdefinierte Risikostufe, die der Risk Engine zugeordnet ist, die die Benachrichtigung ausgelöst hat.</p><ol><li>kritisch</li><li>hoch</li><li>mittel</li><li>niedrig</li><li>informativ</li></ol></td></tr><tr><td>riskLevelDescription</td><td>String</td><td><p>Gültige Werte für diese Variable:</p><p>["critical", "high", "medium", "low", "informational"]</p></td></tr><tr><td>timestamp</td><td>String</td><td>Zeitstempel der Warnung im ISO-8601-Format.</td></tr><tr><td>type</td><td>Integer</td><td><p>Typ der detaillierten Benachrichtigungsdaten</p><p>Adresstypen:</p><p>1: Entity-Risikodaten</p><p>2: Interaktionsrisikodaten</p><p>3: Daten zu großen Transfers</p><p>4: Daten zu hoher Frequenz</p><p>5: Daten zu Transitadressen</p><p>6: Daten zu Blacklist-Interaktionen</p><p>Transaktionstypen:</p><p>7: Teilnehmer-Risikodaten</p><p>8: Interaktionsrisikodaten</p><p>9: Daten zu großen Transfers</p><p>10: Daten zu schnellem Transit</p><p>11: Daten zu Blacklist-Interaktionen</p></td></tr><tr><td>data</td><td>Array[Object]</td><td><p>Die Liste der Benachrichtigungsdetails hängt vom Typ der Risk Engine ab.</p><p>Weitere Informationen finden Sie in den folgenden Abschnitten.</p></td></tr></tbody></table>

#### 1. Adresse – Entity-Risikodaten

<table><thead><tr><th width="203.15234375">Feld</th><th width="133.04296875">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td><p>Der Risikoindikator, der anhand vorkonfigurierter Regeln erkannt wurde.</p><p>1: Sanktioniert</p><p>2: Angriff</p><p>3: Betrug</p><p>4: Ransomware</p><p>5: Material über Kindesmissbrauch</p><p>6: Geldwäsche</p><p>7: Mixing</p><p>8: Darknet-Markt</p><p>9: Darkweb-Geschäft</p><p>10: Gesperrt</p><p>11: Glücksspiel</p><p>12: Börse ohne KYC<br>13. Terrorismusfinanzierung<br>14. FATF-Grauzonengebiet<br>15. FATF-Hochrisikogebiet<br>16. Menschenhandel<br>17. Drogenhandel</p></td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td><p>Gültige Werte für diese Variable:</p><p>["Sanktioniert", "Angriff", "Betrug", "Ransomware", "Material über Kindesmissbrauch", "Geldwäsche", "Mixing", "Darknet-Markt", "Darkweb-Geschäft", "Gesperrt", "Glücksspiel", "Börse ohne KYC", "Terrorismusfinanzierung", "FATF-Grauzonengebiet", "FATF-Hochrisikogebiet", "Menschenhandel", "Drogenhandel"]</p></td></tr><tr><td>detail</td><td>Array[String]</td><td>Zusätzliche Informationen</td></tr></tbody></table>

#### 2. Adresse – Interaktionsrisikodaten

<table><thead><tr><th width="213.07421875">Feld</th><th width="133.50390625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>direction</td><td>Integer</td><td>Transferrichtung:<br>• 1 : Eingehend (Gelder empfangen)<br>• 2 : Ausgehend (Gelder gesendet)</td></tr><tr><td>hop</td><td>Integer</td><td>Grad der Trennung von der Risikoentität:<br>• 1 : Direkte Interaktion<br>• 2+ : Indirekte Interaktion (Anzahl der Hops)</td></tr><tr><td>exposureValue</td><td>String</td><td>Absoluter Wert der exponierten Gelder (in USD)</td></tr><tr><td>exposurePercent</td><td>String</td><td>Prozentsatz des gesamten Transaktionsvolumens, das durch das Risiko „verunreinigt“ ist</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>Details zu dieser Interaktion, einschließlich einer Liste aller beteiligten Adressen und ihrer spezifischen Risikoexpositionsinformationen in dieser Interaktion.</td></tr><tr><td>>address</td><td>String</td><td>Die Adresse mit dem Risikoindikator.</td></tr><tr><td>>label</td><td>String</td><td>Die Adressbezeichnung.</td></tr><tr><td>>detail</td><td>String</td><td>Detaillierte Risikoinformationen.</td></tr><tr><td>>hop</td><td>Integer</td><td>Die Mindestanzahl der Hops zur überprüften Adresse.</td></tr><tr><td>>exposureValue</td><td>String</td><td>Der beigetragene Risikoexpositionswert in USD.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>Der prozentuale Anteil der beigetragenen Risikoexposition.</td></tr></tbody></table>

#### 3. Adresse – Daten zu großen Transfers

<table><thead><tr><th width="205.31640625">Feld</th><th width="97.8984375">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>transaction</td><td>String</td><td>Transaktions-Hash</td></tr><tr><td>usdValue</td><td>String</td><td>Transferwert in USD</td></tr><tr><td>direction</td><td>Integer</td><td>Transferrichtung:<br>• 1 : Eingehend (Gelder empfangen)<br>• 2 : Ausgehend (Gelder gesendet)</td></tr><tr><td>timestamp</td><td>String</td><td>Transaktionszeitstempel im ISO-8601-Format</td></tr><tr><td>token</td><td>String</td><td>Token-Vertragsadresse</td></tr><tr><td>tokenSymbol</td><td>String</td><td>Token-Symbol</td></tr><tr><td>tokenAmount</td><td>String</td><td>Token-Betrag</td></tr></tbody></table>

#### 4. Adresse – Daten zu hoher Frequenz

<table><thead><tr><th width="201.19140625">Feld</th><th width="142.28515625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>transactionCount</td><td>Integer</td><td>Gesamtzahl der Transaktionen während des Beobachtungszeitraums</td></tr><tr><td>duration</td><td>Integer</td><td>Auf die nächste Minute gerundet</td></tr><tr><td>transactionList</td><td>Array[Object]</td><td>Array mit Details zu einzelnen Transaktionen</td></tr><tr><td>>transactionItem</td><td>Object</td><td>Format des Transaktionselements: identisch mit dem **Schema für Daten zu großen Transfers**</td></tr></tbody></table>

#### 5. Adresse – Daten zu Transitadressen

<table><thead><tr><th width="179.84765625">Feld</th><th width="118.41796875">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>inTransaction</td><td>String</td><td>Eingehender Transaktions-Hash</td></tr><tr><td>inTimestamp</td><td>String</td><td>Zeitstempel der eingehenden Transaktion im ISO-8601-Format</td></tr><tr><td>inUsdValue</td><td>String</td><td>Wert des eingehenden Transfers (USD)</td></tr><tr><td>outTransaction</td><td>String</td><td>Ausgehender Transaktions-Hash</td></tr><tr><td>outTimestamp</td><td>String</td><td>Zeitstempel der ausgehenden Transaktion im ISO-8601-Format</td></tr><tr><td>outUsdValue</td><td>String</td><td>Wert des ausgehenden Transfers (USD)</td></tr><tr><td>transitPercent</td><td>String</td><td>Prozentsatz der durchgeleiteten Gelder</td></tr></tbody></table>

#### 6. Adresse – Daten zu Blacklist-Interaktionen

<table><thead><tr><th width="213.07421875">Feld</th><th width="133.50390625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>direction</td><td>Integer</td><td>Transferrichtung:<br>• 1 : Eingehend (Gelder empfangen)<br>• 2 : Ausgehend (Gelder gesendet)</td></tr><tr><td>hop</td><td>Integer</td><td>Grad der Trennung von der Risikoentität:<br>• 1 : Direkte Interaktion<br>• 2+ : Indirekte Interaktion (Anzahl der Hops)</td></tr><tr><td>exposureValue</td><td>String</td><td>Absoluter Wert der exponierten Gelder (in USD)</td></tr><tr><td>exposurePercent</td><td>String</td><td>Prozentsatz des gesamten Transaktionsvolumens, das durch das Risiko „verunreinigt“ ist</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>Details zu dieser Interaktion, einschließlich einer Liste aller beteiligten Adressen und ihrer spezifischen Risikoexpositionsinformationen in dieser Interaktion.</td></tr><tr><td>>address</td><td>String</td><td>Die Adresse mit dem Risikoindikator.</td></tr><tr><td>>label</td><td>String</td><td>Die Adressbezeichnung.</td></tr><tr><td>>hop</td><td>Integer</td><td>Die Mindestanzahl der Hops zur überprüften Adresse.</td></tr><tr><td>>exposureValue</td><td>String</td><td>Der beigetragene Risikoexpositionswert in USD.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>Der prozentuale Anteil der beigetragenen Risikoexposition.</td></tr></tbody></table>

#### 7. Transaktion – Teilnehmer-Risikodaten

<table><thead><tr><th width="158.515625">Feld</th><th width="143.9140625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>address</td><td>String</td><td>Die Adresse des Teilnehmers, bei der ein Risikoindikator erkannt wurde.</td></tr><tr><td>riskIndicator</td><td>Integer</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>detail</td><td>Array[String]</td><td>Zusätzliche Informationen</td></tr></tbody></table>

#### 8. Transaktion – Interaktionsrisikodaten

<table><thead><tr><th width="213.07421875">Feld</th><th width="133.50390625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>riskIndicator</td><td>Integer</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>riskIndicatorDescription</td><td>String</td><td>Verwendet dieselben Werte und Definitionen wie die ***Entity-Risikodaten***</td></tr><tr><td>direction</td><td>Integer</td><td>Transferrichtung:<br>• 1 : Eingehend (Gelder empfangen)<br>• 2 : Ausgehend (Gelder gesendet)</td></tr><tr><td>hop</td><td>Integer</td><td>Grad der Trennung von der Risikoentität:<br>• 1 : Direkte Interaktion<br>• 2+ : Indirekte Interaktion (Anzahl der Hops)</td></tr><tr><td>exposureValue</td><td>String</td><td>Absoluter Wert der exponierten Gelder (in USD)</td></tr><tr><td>exposurePercent</td><td>String</td><td>Prozentsatz des gesamten Transaktionsvolumens, das durch das Risiko „verunreinigt“ ist</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>Details zu dieser Interaktion, einschließlich einer Liste aller beteiligten Adressen und ihrer spezifischen Risikoexpositionsinformationen in dieser Interaktion.</td></tr><tr><td>>address</td><td>String</td><td>Die Adresse mit dem Risikoindikator.</td></tr><tr><td>>label</td><td>String</td><td>Die Adressbezeichnung.</td></tr><tr><td>>detail</td><td>String</td><td>Detaillierte Risikoinformationen.</td></tr><tr><td>>hop</td><td>Integer</td><td>Die Mindestanzahl der Hops zur überprüften Adresse.</td></tr><tr><td>>exposureValue</td><td>String</td><td>Der beigetragene Risikoexpositionswert in USD.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>Der prozentuale Anteil der beigetragenen Risikoexposition.</td></tr></tbody></table>

#### 9. Transaktion – Daten zu großen Transfers

<table><thead><tr><th width="224.0390625">Feld</th><th width="202.22265625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>transaction</td><td>String</td><td>Transaktions-Hash</td></tr><tr><td>usdValue</td><td>String</td><td>Transferwert in USD</td></tr><tr><td>fromAddress</td><td>String</td><td>Absenderadresse</td></tr><tr><td>toAddress</td><td>String</td><td>Empfängeradresse</td></tr><tr><td>timestamp</td><td>String</td><td>Transaktionszeitstempel im ISO-8601-Format</td></tr><tr><td>token</td><td>String</td><td>Token-Vertragsadresse</td></tr><tr><td>tokenSymbol</td><td>String</td><td>Token-Symbol</td></tr><tr><td>tokenAmount</td><td>String</td><td>Anzahl der Token in diesem Transfer</td></tr></tbody></table>

#### 10. Transaktion – Daten zu schnellem Transit

<table><thead><tr><th width="223.77734375">Feld</th><th width="201">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>proceedTransaction</td><td>Object</td><td>Objektformat: identisch mit dem Schema für Daten zu großen Transfers</td></tr><tr><td>ScreenedTransaction</td><td>Object</td><td>Objektformat: identisch mit dem Schema für Daten zu großen Transfers</td></tr></tbody></table>

#### 11. Transaktion – Daten zu Blacklist-Interaktionen

<table><thead><tr><th width="213.07421875">Feld</th><th width="133.50390625">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>direction</td><td>Integer</td><td>Transferrichtung:<br>• 1 : Eingehend (Gelder empfangen)<br>• 2 : Ausgehend (Gelder gesendet)</td></tr><tr><td>hop</td><td>Integer</td><td>Grad der Trennung von der Risikoentität:<br>• 1 : Direkte Interaktion<br>• 2+ : Indirekte Interaktion (Anzahl der Hops)</td></tr><tr><td>exposureValue</td><td>String</td><td>Absoluter Wert der exponierten Gelder (in USD)</td></tr><tr><td>exposurePercent</td><td>String</td><td>Prozentsatz des gesamten Transaktionsvolumens, das durch das Risiko „verunreinigt“ ist</td></tr><tr><td>contributions</td><td>Array[Object]</td><td>Details zu dieser Interaktion, einschließlich einer Liste aller beteiligten Adressen und ihrer spezifischen Risikoexpositionsinformationen in dieser Interaktion.</td></tr><tr><td>>address</td><td>String</td><td>Die Adresse mit dem Risikoindikator.</td></tr><tr><td>>label</td><td>String</td><td>Die Adressbezeichnung.</td></tr><tr><td>>hop</td><td>Integer</td><td>Die Mindestanzahl der Hops zur überprüften Adresse.</td></tr><tr><td>>exposureValue</td><td>String</td><td>Der beigetragene Risikoexpositionswert in USD.</td></tr><tr><td>>exposurePercent</td><td>Number</td><td>Der prozentuale Anteil der beigetragenen Risikoexposition.</td></tr></tbody></table>

***

## Überwachungsereignisdaten

Wenn **Überwachungsereignisse** für einen Benachrichtigungskanal aktiviert sind, werden Überwachungsereignisse als Nachrichten vom Typ `type: 2` (`monitorEvent`) zugestellt. Es werden nur risikobezogene Ereignisse übertragen (Lifecycle-Ereignisse wie der Start oder Stopp der Überwachung sind ausgeschlossen). Die Zustellung wird durch Ihre [Einstellungen für Benachrichtigungsauslöser](https://docs.compliance.phalcon.blocksec.com/de/user-manual/monitoring/monitor.md#setting-up-notifications) gesteuert.

### Gemeinsame Felder

Alle Nachrichten zu Überwachungsereignissen enthalten im `data`-Objekt die folgenden Felder:

<table><thead><tr><th width="210">Feld</th><th width="110">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>eventType</td><td>Integer</td><td>Ereignistyp: 4 (risk_level_increased), 5 (risk_level_decreased), 6 (alert_triggered), 7 (alert_expired)</td></tr><tr><td>eventTypeDescription</td><td>String</td><td>Menschenlesbarer Name des Ereignistyps</td></tr><tr><td>targetType</td><td>Integer</td><td>1: Adresse, 2: Transaktion (derzeit werden nur Adressen unterstützt)</td></tr><tr><td>targetTypeDescription</td><td>String</td><td>"address" oder "transaction"</td></tr><tr><td>chainId</td><td>Integer</td><td>Chain-ID</td></tr><tr><td>targetIdentifier</td><td>String</td><td>Die überwachte Adresse</td></tr><tr><td>riskLevel</td><td>Integer</td><td>Die aktuelle Gesamtrisikostufe der Adresse (1: kritisch, 2: hoch, 3: mittel, 4: niedrig)</td></tr><tr><td>riskLevelDescription</td><td>String</td><td>Name der Risikostufe</td></tr><tr><td>timestamp</td><td>String</td><td>Ereigniszeit im ISO-8601-Format</td></tr></tbody></table>

### Risikostufe erhöht / gesenkt (eventType 4, 5)

Wird gesendet, wenn sich die Gesamtrisikostufe einer überwachten Adresse ändert. Enthält die folgenden zusätzlichen Felder:

<table><thead><tr><th width="210">Feld</th><th width="110">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>prevLevel</td><td>Integer</td><td>Risikostufe vor der Änderung</td></tr><tr><td>prevLevelDescription</td><td>String</td><td>Vorheriger Name der Risikostufe</td></tr><tr><td>newLevel</td><td>Integer</td><td>Risikostufe nach der Änderung</td></tr><tr><td>newLevelDescription</td><td>String</td><td>Neuer Name der Risikostufe</td></tr><tr><td>relatedAlerts</td><td>Array</td><td>Warnungen, die die Änderung der Risikostufe verursacht haben</td></tr></tbody></table>

Jedes Objekt in `relatedAlerts`:

<table><thead><tr><th width="210">Feld</th><th width="110">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>alertId</td><td>String</td><td>Warnungs-ID</td></tr><tr><td>riskEngineId</td><td>String</td><td>ID der Risk Engine</td></tr><tr><td>riskEngineName</td><td>String</td><td>Name der Risk Engine</td></tr><tr><td>riskLevel</td><td>Integer</td><td>Risikostufe der Warnung</td></tr><tr><td>riskLevelDescription</td><td>String</td><td>Name der Risikostufe der Warnung</td></tr><tr><td>action</td><td>String</td><td>"triggered" oder "expired"</td></tr></tbody></table>

### Warnung ausgelöst / abgelaufen (eventType 6, 7)

Wird gesendet, wenn eine Warnung ausgelöst wird oder abläuft, ohne eine Änderung der Risikostufe zu verursachen. Verursacht sie eine Änderung der Risikostufe, wird sie stattdessen in `relatedAlerts` der Nachricht zur Erhöhung oder Senkung der Risikostufe aufgeführt.

Diese Ereignisse enthalten ein `alerts`-Array, dessen Objekte jeweils die folgenden Felder enthalten:

<table><thead><tr><th width="230">Feld</th><th width="110">Typ</th><th>Beschreibung</th></tr></thead><tbody><tr><td>alertId</td><td>String</td><td>Warnungs-ID</td></tr><tr><td>riskEngineId</td><td>String</td><td>ID der Risk Engine</td></tr><tr><td>riskEngineName</td><td>String</td><td>Name der Risk Engine</td></tr><tr><td>alertRiskLevel</td><td>Integer</td><td>Die eigene Risikostufe der Warnung (unterscheidet sich von der Gesamtrisikostufe der Adresse)</td></tr><tr><td>alertRiskLevelDescription</td><td>String</td><td>Name der Risikostufe der Warnung</td></tr><tr><td>description</td><td>String</td><td>Beschreibung der Warnung</td></tr></tbody></table>
