> ## Documentation Index
> Fetch the complete documentation index at: https://revolai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Benutzerdefinierter Webhook

> Lead-Daten per HTTP an jedes CRM oder externes System senden

## Ueberblick

Benutzerdefinierter Webhook ist die einfachste Integration — er sendet HTTP-Anfragen an eine beliebige von Ihnen angegebene URL. Verwenden Sie ihn, um Lead-Daten an ein CRM zu uebermitteln, Automatisierungen in Zapier/Make auszuloesen oder sich mit jedem System mit einer API zu verbinden.

Kein OAuth, kein SDK — nur eine Ziel-URL und optionale Header.

## Einrichtung

<Steps>
  <Step title="Integration hinzufuegen">
    Gehen Sie zu **Integrationen** → **Integration hinzufuegen** → waehlen Sie **Benutzerdefinierter Webhook** aus der Kategorie CRM.
  </Step>

  <Step title="Konfigurieren">
    | Feld                  | Erforderlich | Beschreibung                                                                   |
    | --------------------- | ------------ | ------------------------------------------------------------------------------ |
    | **Webhook-URL**       | Ja           | Der Endpunkt, an den Daten gesendet werden                                     |
    | **Webhook-Geheimnis** | Nein         | Geheimnis fuer die HMAC-SHA256-Anfragensignierung                              |
    | **Header**            | Nein         | Benutzerdefinierte HTTP-Header (JSON-Format, z.B. `Authorization: Bearer ...`) |
  </Step>

  <Step title="Testen">
    Klicken Sie auf **Verbindung testen**. Revol sendet eine Test-Nutzlast und ueberpreuft, ob die URL mit einem 2xx-Status antwortet.
  </Step>
</Steps>

## Agenten-Tools

| Tool              | Beschreibung                                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `send_payload`    | Strukturierte JSON-Daten (Lead-Informationen, Formulardaten) an die Webhook-URL senden. Mit HMAC-SHA256 signiert, wenn ein Geheimnis konfiguriert ist. |
| `test_connection` | Ueberpruefen, ob die Webhook-URL erreichbar ist und korrekt antwortet                                                                                  |

## Nutzlastformat

Wenn ein Agent `send_payload` aufruft, sendet Revol eine POST-Anfrage mit einem JSON-Body. Der Inhalt wird vom KI-Agenten basierend auf den waehrend der Konversation gesammelten Informationen bestimmt:

```json theme={null}
{
  "event": "lead_captured",
  "timestamp": "2026-03-07T14:30:00Z",
  "company_id": 5,
  "agent_id": 12,
  "conversation_id": "conv_abc123",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+380501234567",
    "message": "Interested in Enterprise plan",
    "source": "website_widget",
    "utm_campaign": "spring_promo"
  }
}
```

## Anfragensignierung

Wenn Sie ein **Webhook-Geheimnis** angeben, wird jede Anfrage mit HMAC-SHA256 signiert:

* Die Signatur ist im `X-Webhook-Signature`-Header enthalten
* Verifizieren Sie sie auf Ihrem Server, indem Sie `HMAC-SHA256(request_body, your_secret)` berechnen und vergleichen

## Verwendung in Workflow-Knoten

Webhook-Tools funktionieren wie jedes andere Agenten-Tool:

1. Verbinden Sie die Webhook-Integration und testen Sie die URL
2. Die Tools erscheinen im **Tools**-Tab des Agenten
3. Fuegen Sie `send_payload` zu einem **benutzerdefinierten Knoten** im Workflow-Editor hinzu
4. Das LLM entscheidet basierend auf dem Konversationskontext, wann Daten gesendet werden

**Beispiel-Workflow:** Agent sammelt Lead-Informationen (Name, E-Mail, Telefon, Interesse) → am Ende der Konversation verwendet er `send_payload`, um die Daten an Ihr CRM zu uebermitteln.

## Anwendungsfaelle

* **CRM-Integration** — Qualifizierte Leads an Pipedrive, HubSpot, Salesforce oder jedes CRM mit einem Webhook-/API-Endpunkt uebermitteln
* **Zapier / Make** — Mehrstufige Automatisierungen aus Konversationsereignissen ausloesen
* **Slack / Discord** — Benachrichtigungen senden, wenn hochwertige Leads erfasst werden
* **Eigenes Backend** — Ihre eigene API aufrufen, um Bestellungen zu erstellen, Datensaetze zu aktualisieren oder interne Workflows auszuloesen
* **Analyse** — Konversationsergebnisse an Ihr Data Warehouse senden