Skip to Content

Webhook-Automatisierungen

Lead-Eingänge prüfen

Das Diagramm gruppiert Eingänge in Tagesintervalle, in der Tagesansicht in Stundenintervalle. Bewegen Sie den Zeiger auf einen Linienpunkt oder fokussieren Sie ihn mit der Tastatur, um die Markierung anzuzeigen. Wählen Sie ihn für die Eingänge der Gruppe aus; jeder behält seine genaue Eingangszeit.

Unter Marketing → Kontakt-Automatisierung → Übersicht zeigt Lead-Eingänge im Zeitverlauf, welche Formulare und Webhooks Leads liefern. Jede Linie zeigt die fortlaufende Summe im gewählten Zeitraum: letzte 1, 7, 30 oder 90 Tage. Wählen Sie einen Auslöser unter dem Diagramm, um seine Linie ein- oder auszublenden.

Wählen Sie einen Punkt für den Namen und die Eingangszeit in Ihrer Zeitzone. Namen erfordern Zugriff auf Kontakte und sind ohne Namensangabe möglicherweise nicht verfügbar. Überlappende Punkte zeigen alle zeitgleichen Eingänge. Test-Leads sind enthalten; ein Eingang bedeutet nicht, dass die Folgeaufgabe erfolgreich war. Die Eingangszeit kann vom Zeitpunkt der Formularübermittlung abweichen.

Das Diagramm wird automatisch aktualisiert; Lead-Eingänge aktualisieren lädt sofort neu. Bei mehr als 5.000 Eingängen werden nur die ersten 5.000 angezeigt, und die Linien enden beim letzten enthaltenen Eingang. Wählen Sie einen kürzeren Zeitraum für spätere Eingänge.

Öffnen Sie bei Anruf- und WhatsApp-Aufgaben Erweiterte Einstellungen → Land für Nummern ohne Ländervorwahl, um lokale Lead-Nummern richtig zu interpretieren. Wählen Sie das Land für Webhooks manuell; internationale Vorwahlen bleiben erhalten.

Ein Webhook startet das Follow-up von Leads aus Ihrer Website oder Anwendung. Eine Angebotsanfrage kann beispielsweise eine WhatsApp-Nachricht mit einer E-Mail als Ersatzaktion auslösen und eine CRM-Verkaufschance erstellen. Eine Meta Ads-Verbindung ist nicht erforderlich.

Marketing-Navigation

Unter Marketing → Kampagnen finden Sie Telefon- und WhatsApp-Kampagnen. Marketing → Kontakt-Automatisierung → Übersicht zeigt Ergebnisse von Instant Forms und Webhooks sowie die CRM-Konfiguration. Bearbeiten Sie Abläufe im Automatisierungseditor. Verbindungen bleiben unter Allgemein → Integrationen → Ads Platforms. Meta Ads verbinden öffnet dort die Einrichtung. Unter Marketing → WhatsApp-Vorlagen wählen Sie einen WhatsApp-Kanal. Vor dem Verlassen ungespeicherter Änderungen ist eine Bestätigung erforderlich.

Bevor Sie beginnen

Sie benötigen Zugriff auf Integrationen und einen auswählbaren API-Schlüssel. Verwalten Sie Ihre Schlüssel auf der API-Schlüsselseite , oder erstellen Sie einen Schlüssel beim Einrichten des Webhooks. Für Follow-up-Aufgaben bereiten Sie den Agenten sowie dessen WhatsApp-Kanal, E-Mail-Postfach oder Rufnummer für ausgehende Anrufe vor. Verbinden Sie Ihr CRM, wenn Sie Verkaufschancen erstellen möchten.

Webhook und Automation hinzufügen

  1. Öffnen Sie Marketing → Kontakt-Automatisierung → Automatisierungseditor.
  2. Wählen Sie in der Knotenpalette Webhook oder ziehen Sie den Eintrag auf die Arbeitsfläche.
  3. Geben Sie einen Namen ein und wählen Sie den API-Schlüssel. Mit Neuen API-Schlüssel erstellen… erstellen und wählen Sie einen Schlüssel direkt im Dialog. Auf der API-Schlüsselseite  können Sie Ihre Schlüssel verwalten.
  4. Ergänzen Sie die Test-Lead-Daten um Kontaktfelder und eigene Werte wie your_field_1. Diese stehen dann für Aufgaben- und CRM-Zuordnungen bereit.
  5. Unter CRM konfigurieren können Sie Pipeline und Phase festlegen. Gemeinsame Vorgaben für Instant-Formulare gelten nicht für Webhooks.
  6. Wählen Sie Übernehmen, verbinden Sie den Webhook mit einer WhatsApp-, E-Mail- oder Anrufaufgabe und konfigurieren Sie diese. Verbinden Sie weitere Aufgaben über Bei Erfolg oder Bei Fehler. Ein Webhook kann mehrere unabhängige Pfade starten.
  7. Wählen Sie im Editor Speichern, bevor Sie Anfragen senden.

Ein Webhook kann dieselbe Aufgabe und Ersatzaufgabe wie ein Instant-Formular verwenden. Änderungen an der gemeinsamen Aufgabe gelten für beide Auslöser; Feldzuordnungen bleiben getrennt. Ohne Aufgaben und CRM-Aktionen wird nur der Kontakt gespeichert. Lassen Sie beide Meta-Filter auf Alle, damit Webhooks sichtbar bleiben.

E-Mail- und WhatsApp-Aufgaben in einer Webhook-Automatisierung können bei Leads, die nicht antworten, auf dieselbe Weise nachfassen wie bei Instant-Formularen. Siehe Follow-ups für eine Aufgabe wählen.

Webhook aufrufen

Sie können Aufgaben- oder CRM-Felder full_name zuordnen, auch wenn Sie nur first_name und last_name senden: Versafy kombiniert diese automatisch. Wenn Sie einen nicht leeren Wert für full_name übergeben, wird dieser verwendet.

Der Name einer Verkaufschance kann Lead-Feldwerte sowie die Standardvariablen für Kontakt und Kampagne enthalten. Wählen Sie eine Variable unter dem Namensfeld, um sie an der Cursorposition einzufügen. Instant Forms bieten ihre Antwortfelder an, Webhooks die Felder aus den Testdaten. Fehlende Werte bleiben leer; mehrere Antworten werden durch Kommas getrennt. Bestehende Verkaufschancen behalten ihre Namen.

Öffnen Sie Marketing → Kontakt-Automatisierung → Automatisierungseditor und dann die Einstellungen Ihres gespeicherten Webhook-Knotens. Kopieren Sie Endpunkt-URL; die Beispielanfrage enthält Ihre trigger_id. Sind die Einstellungen bereits geöffnet, können Sie die vollständige Beispielanfrage direkt kopieren. Verwalten Sie den ausgewählten Schlüssel auf der API-Schlüsselseite . Senden Sie die Anfrage vom Server Ihrer Anwendung; veröffentlichen Sie den API-Schlüssel nicht im Website-Code. Verwenden Sie den gewählten Schlüssel im Header Authorization: Bearer. Ersetzen Sie die Platzhalter im Beispiel durch Ihre URL, Ihren Schlüssel und Ihre Trigger-ID:

curl -X POST 'YOUR_WEBHOOK_URL' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ --data '{ "trigger_id": "YOUR_TRIGGER_ID", "event_id": "quote-request-123", "first_name": "Alex", "last_name": "Smith", "company_name": "Example Company", "email": "alex@example.com", "phone_number": "+351916000000", "your_field_1": "Example value 1", "your_field_2": "Example value 2" }'

Erforderlich sind trigger_id, event_id, first_name und mindestens eines der Felder email oder phone_number. Nachname und Firmenname sind optional. Eigene Felder stehen auf derselben JSON-Ebene; verschachtelte Objekte sind nicht erlaubt. Die Webhook-API-Referenz  erklärt die vollständigen Grenzen und Antworten. Der Link API-Dokumentation in den Webhook-Einstellungen öffnet dieselbe Referenz.

Verwenden Sie für jede neue Anfrage eine neue event_id. Wiederholen Sie dieselbe Übermittlung mit unveränderter ID und unveränderten Daten, erhalten Sie den ursprünglichen Beleg. Geänderte Daten mit derselben ID führen zu 409 Conflict.

Testen und Ergebnisse prüfen

Testleads benötigen gültige E-Mail-Adressen und Telefonnummern, auch in benutzerdefinierten Empfängerfeldern für Haupt- und Ersatzaufgaben. Korrigieren Sie markierte Felder vor dem Senden; Platzhaltertext wird abgelehnt. Für Nummern ohne Landesvorwahl gilt das in der Aufgabe eingestellte Land. Die Formatprüfung bestätigt keine Erreichbarkeit.

Um eine E-Mail ohne Ausführung der Automation zu testen, öffnen Sie die Aufgabe E-Mail senden, wählen einen verbundenen Absender, geben Betreff und Anweisungen ein und wählen Test-E-Mail senden. Tragen Sie Beispielwerte ein und senden Sie den Test an die E-Mail-Adresse Ihres angemeldeten Kontos. Der Test verwendet die ungespeicherten Aufgaben- und Stileinstellungen; er speichert keine Aufgabe, erstellt keinen Kontakt und löst keine weiteren Aktionen aus.

Öffnen Sie Marketing → Kontakt-Automatisierung → Übersicht und wählen Sie eine WhatsApp-, E-Mail- oder Anrufaufgabenzahl größer als null, um die Gespräche dieses Webhooks zu prüfen. Chats wird nach Webhook und Aufgabentyp gefiltert. Entfernen Sie den Filter-Chip oder wählen Sie Alle entfernen, um die Liste zu erweitern. Dieser Filter ist nur über diese Links verfügbar, nicht in der Filterauswahl von Chats. Wartende oder vor der Kontaktaufnahme fehlgeschlagene Aufgaben haben möglicherweise kein Gespräch; mehrere Aufgaben können zum selben Gespräch gehören.

Wählen Sie auf der Statistikkarte des Webhooks CRM einrichten oder CRM konfigurieren, um die Erstellung von Verkaufschancen zu bearbeiten. Mit Speichern übernehmen Sie die CRM-Einstellungen, ohne den Automationseditor zu öffnen.

Unter Marketing → Kontakt-Automatisierung → Übersicht zeigt jeder gespeicherte Webhook die Anzahl der Leads und der erstellten WhatsApp-, E-Mail- und Anrufaufgaben. Testanfragen werden mitgezählt. Erstellte Aufgaben können noch ausstehen oder später fehlschlagen; diese Zahlen bestätigen keine Zustellung. Ein neuer Webhook zeigt null an, bis Leads eingehen.

Tests führen echte Aktionen aus: Nachrichten, Anrufe und CRM-Einträge sind möglich. Verwenden Sie eigene Kontaktdaten.

Öffnen Sie den gespeicherten Editor erneut, wählen Sie am Webhook Test-Lead, bearbeiten Sie die Daten und wählen Sie Test-Lead senden. Lassen Sie den Dialog offen, um Beleg und Verarbeitungsstatus zu sehen.

Nach erfolgreichem Senden bereitet der Dialog eine neue Ereignis-ID vor. Behalten oder bearbeiten Sie die Kontaktdaten und wählen Sie Weiteren Testlead senden, um erneut zu testen. Letzte Übermittlung kennzeichnet den vorherigen Beleg. Bei einem Verbindungsfehler wiederholen Sie die Anfrage mit unveränderten Daten, um Duplikate zu vermeiden.

  • 202 Accepted bestätigt die Annahme zur Hintergrundverarbeitung, nicht die Zustellung. Bewahren Sie die receipt_id für Supportanfragen auf.
  • Unter Allgemein → Kontakte finden Sie den Kontakt per E-Mail oder Telefonnummer. Ein passender vorhandener Kontakt kann aktualisiert werden.
  • Unter Allgemein → Aufgaben sehen Sie Status und Ergebnisse. Webhook-Aufgaben haben die Quelle API. Berücksichtigen Sie Verzögerungen und Arbeitszeiten.
  • Prüfen Sie im CRM die gewählte Pipeline und Phase sowie die Lead-Daten und Follow-up-Notizen der Verkaufschance.

Fehlt ein nutzbarer Kontaktkanal, kann die Aufgabe fehlschlagen. Eine geeignete Ersatzaufgabe läuft nur, wenn sie verbunden ist und die nötigen Kontaktdaten vorliegen.

Fehler beheben

Wenn der E-Mail-Agent im Modus Dry Run oder Entwurfsprüfung arbeitet, sendet die Automation keine E-Mail und führt die konfigurierte Ersatzaktion aus. Ohne Ersatzaktion schlägt dieser Zweig fehl. Wechseln Sie zum Sendemodus, um automatische E-Mails zu erlauben.

Bei abgelehnten Anfragen prüfen Sie gespeicherte Einstellungen, URL, Trigger-ID, gewählten Schlüssel und Pflichtfelder. Fehlt nach Annahme eine Nachricht, prüfen Sie Aufgabenverbindungen und Status. suppressed bedeutet, dass das Follow-up wegen Duplikatschutz übersprungen wurde; prüfen Sie vorhandene Aufgaben vor einem erneuten Versuch. Fehlt eine Verkaufschance, prüfen Sie die CRM-Einstellungen dieses Webhooks.

Bestehende CRM-Verkaufschancen aktualisieren

Öffnen Sie Diese CRM-Einstellungen auf andere Webhooks anwenden, um andere Webhooks zu suchen und anzukreuzen. Der Bereich ist zunächst eingeklappt; die Auswahl bleibt beim Einklappen für das Speichern erhalten.

Beim Speichern wird die ausgewählte Gruppe gespeichert. Wenn Sie einen Webhook der Gruppe erneut öffnen, sind die anderen automatisch angekreuzt. Entfernen Sie vor dem Speichern das Häkchen eines Webhooks, um ihn aus der Gruppe zu lösen. Bei zuvor kopierten Einstellungen speichern Sie einmal mit den gewünschten Webhooks ausgewählt.

Neue Kontakte aus Webhook-Anfragen erhalten die Quelle Webhook. WhatsApp-Automatisierungen speichern den Kontakt vor dem Versand; die CRM-Synchronisierung verwendet den verknüpften Kontakt erneut. Diese CRM-Einstellungen auf andere Webhooks anwenden kopiert CRM-Einstellungen und lehnt inkompatible Auswahlen vollständig ab. Es gelten die CRM-Regeln für Formulare.

Zuletzt aktualisiert am