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

1. Integration hinzufuegen

   Gehen Sie zu Integrationen → Integration hinzufuegen → waehlen Sie Benutzerdefinierter Webhook aus der Kategorie CRM.

2. 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 ...)

3. Testen

   Klicken Sie auf Verbindung testen. Revol sendet eine Test-Nutzlast und ueberpreuft, ob die URL mit einem 2xx-Status antwortet.

​

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:

{
  "event": "lead_captured",
  "timestamp": "2026-03-07T14:30:00Z",
  "company_id": 5,
  "agent_id": 12,
  "conversation_id": "conv_abc123",
  "data": {
    "name": "John Doe",
    "email": "[e-mail]",
    "phone": "[phone]",
    "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