> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deal-pipe.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks empfangen

> Ereignisbenachrichtigungen prüfen und wiederholbar verarbeiten.

## Webhook einrichten

Öffnen Sie **Einstellungen → Webhooks**. Hinterlegen Sie eine öffentliche HTTPS-Zieladresse, wählen Sie Ereignisse und speichern Sie das Geheimnis für die Signaturprüfung. Prüfen Sie die Zustellungen in der angebotenen Historie.

Die derzeit angebundenen Abläufe senden `client.created`, `client.stage_changed`, `pipeline.deal_stage_changed`, `pipeline.deal_won` und `pipeline.deal_lost`. Die Ereignisauswahl in den Einstellungen enthält weitere Namen; daraus folgt keine Garantie, dass jeder Produktablauf bereits ein entsprechendes Ereignis auslöst. Insbesondere ist dies kein vollständiger Immobilien-Änderungsfeed.

## Anfrage prüfen

Die Zustellung enthält `x-dealpipe-event`, `x-dealpipe-delivery` und `x-dealpipe-signature`. Die Signatur ist ein hexadezimaler HMAC-SHA256 über den unveränderten Request-Body mit Ihrem Webhook-Geheimnis.

```json theme={null}
{
  "event": "pipeline.deal_won",
  "data": {
    "dealId": "example-deal-id",
    "clientId": "example-client-id"
  }
}
```

Berechnen und vergleichen Sie die Signatur vor der Verarbeitung. Speichern Sie erfolgreich verarbeitete Zustellungs-IDs und behandeln Sie wiederholte Zustellungen ohne doppelte Auswirkungen. Die Signatur enthält keinen signierten Zeitstempel; die Zustellungs-ID hilft beim Erkennen bereits verarbeiteter Nachrichten.

## Antwort und Wiederholungen

Antworten Sie nach sicherer Annahme mit einem `2xx`-Status. Nicht erfolgreiche Zustellungen werden bis zu insgesamt sechs Versuchen wiederholt. Die vorgesehenen Warteabstände sind 1, 5, 30, 240 und 1440 Minuten; die tatsächliche Ausführung hängt vom Zustellungsjob ab. Weiterleitungen werden nicht verfolgt. Deaktivierte Ziele werden nicht weiter beliefert.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.