Zum Hauptinhalt springen

​
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

FeldErforderlichBeschreibung
Webhook-URLJaDer Endpunkt, an den Daten gesendet werden
Webhook-GeheimnisNeinGeheimnis fuer die HMAC-SHA256-Anfragensignierung
HeaderNeinBenutzerdefinierte 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

ToolBeschreibung
send_payloadStrukturierte JSON-Daten (Lead-Informationen, Formulardaten) an die Webhook-URL senden. Mit HMAC-SHA256 signiert, wenn ein Geheimnis konfiguriert ist.
test_connectionUeberpruefen, 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": "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