Webhook mit KeyVue einrichten
Nutzt du KeyVue als CRM? Dann kannst du deinen Heyloha AI-Agenten direkt über einen Webhook mit KeyVue verbinden. Leads, die dein AI-Agent sammelt, werden dann automatisch als neue Leads in KeyVue erstellt, mit dem richtigen Status, der richtigen Quelle und Priorität.
In diesem Artikel erfährst du, wie du zuerst einen Webhook in KeyVue erstellst und ihn dann in Heyloha verbindest.
Lies zuerst den Artikel 'Eine Webhook-Verbindung einrichten', wenn du noch nicht mit Webhooks in Heyloha vertraut bist.
Schritt 1: Webhook in KeyVue erstellen
Erstelle in KeyVue einen Webhook unter Einstellungen > Smart Marketing > Webhooks. Klick auf 'Neuen Webhook erstellen' und konfiguriere Folgendes:
- Name: ein erkennbarer Name für den internen Gebrauch (zum Beispiel 'Heyloha Chat Leads').
- Lead-Typ: welcher Lead-Typ soll bei Eingang erstellt werden.
- Status: soll der Lead als 'Neu' oder als 'Chance' eingehen.
- Quelle: woher kommt der Lead (zum Beispiel 'Website-Chat' oder 'AI-Agent').
- Kommentar: ein Standardkommentar, der jedem Lead hinzugefügt wird.
- Priorität: die Priorität des eingehenden Leads.
- Erfolgswahrscheinlichkeit: eine Einschätzung der Erfolgsrate für diesen Lead-Typ.
Klick auf Speichern. Du kehrst zur Webhook-Übersicht zurück.
Schritt 2: Webhook-URL kopieren
In der Webhook-Übersicht siehst du den soeben erstellten Webhook. Klick auf 'Webhook-URL kopieren'. Die URL wird in deine Zwischenablage kopiert. Diese URL enthält eine eindeutige Referenz zum konfigurierten Webhook, einschließlich aller Anweisungen für KeyVue.
Die Webhook-URL sieht etwa so aus: https://app.keyvue.nl/webhook?company=deinunternehmen&webhook=abc123. Halte diese URL bereit, du brauchst sie gleich in Heyloha.
Schritt 3: Verbindung in Heyloha erstellen
Geh zu Agent, dann Integrationen
Klick im linken Menü auf Agent und öffne den Tab Integrationen. Klick im Bereich Webhooks auf Webhook hinzufügen.
Wähle KeyVue als Plattform
Wähle KeyVue im Formular aus. Du kannst den Webhook auch auf bestimmte Kanäle beschränken; lässt du das leer, gilt er für alle Kanäle.
Füge die KeyVue Webhook-URL ein
Füge die URL ein, die du in Schritt 2 kopiert hast. Heyloha erkennt automatisch die Parameter 'company' und 'webhook' und zeigt 'Link erkannt' an.
Benenne die Integration
Wähle einen klaren Namen, zum Beispiel 'KeyVue Lead' oder 'CRM Besichtigung'. Dieser Name wird auch zum Funktionsnamen, den dein AI-Agent verwendet.
Wähle Kontaktfelder aus
Wähle, welche Daten dein AI-Agent sammeln soll: Vorname, Nachname, E-Mail, Telefon, Adresse, Postleitzahl, Stadt oder Land.
Beschreibe den Einsatzzeitpunkt
Erkläre, wann dein AI-Agent diese Verbindung auslösen soll. Zum Beispiel: 'Sende die Kontaktdaten an KeyVue, wenn ein Besucher Interesse an einer Immobilie zeigt und seine Daten hinterlässt.'
Aktivieren und speichern
Setz die Verbindung auf 'Aktiv' und klick auf Speichern. Die Verbindung ist sofort aktiv.
Was passiert, wenn ein Lead eingeht?
- Ein Besucher startet ein Gespräch mit deinem AI-Agenten auf deiner Website.
- Der AI-Agent sammelt die Kontaktdaten während des Gesprächs.
- Heyloha sendet die Daten über den Webhook an KeyVue.
- KeyVue erstellt automatisch einen neuen Lead mit dem konfigurierten Status, der Quelle und Priorität.
- Dein Team sieht den Lead in KeyVue und kann nachfassen.
Praktische Tipps
- Erstelle separate Webhooks in KeyVue für verschiedene Lead-Typen, zum Beispiel einen für Besichtigungsanfragen und einen für Bewertungen.
- Setz die Quelle in KeyVue auf etwas Erkennbares, wie 'Heyloha Chat' oder 'AI Website-Agent', damit du in Berichten sehen kannst, woher Leads kommen.
- Teste die Verbindung, indem du ein Gespräch mit deinem AI-Agenten führst und prüfst, ob der Lead korrekt in KeyVue erscheint.
Hinweis: Die Webhook-URL muss HTTPS verwenden. Heyloha akzeptiert aus Sicherheitsgründen keine HTTP-Verbindungen.
Häufig gestellte Fragen
Kann ich mehrere KeyVue Webhooks mit demselben AI-Agenten verbinden?
Ja. Du kannst mehrere Webhooks pro Marke einrichten, jeweils mit einer eigenen KeyVue Webhook-URL. So sendest du verschiedene Lead-Typen an verschiedene Webhooks in KeyVue.
Erscheinen die Leads sofort in KeyVue?
Ja. Sobald dein AI-Agent die Daten gesammelt hat und der Webhook ausgelöst wird, erscheint der Lead nahezu sofort in KeyVue.
Was passiert, wenn ich die Webhook-Einstellungen in KeyVue ändere?
Die Webhook-URL bleibt gleich. Wenn du in KeyVue die Einstellungen änderst (zum Beispiel Status oder Quelle), werden zukünftige Leads mit den neuen Einstellungen erstellt. In Heyloha musst du nichts ändern.
Eine Webhook-Verbindung einrichten