So testen Sie die Verbindung eines Papo-Webhooks, bevor Sie die Automatisierung aktivieren

Um die Verbindung eines Papo-Webhooks (https://papo.global/) vor der Aktivierung der Automatisierung zu testen, können Sie ein externes Tool wie Webhook.site verwenden, um die Ziel-URL zu validieren, das JSON-Payload-Format zu prüfen und Sendefehler zu beheben, ohne echte Kontakte zu beeinträchtigen. Dieser Prozess funktioniert sowohl für native Webhooks des Kontos als auch für die Aktion „Webhook senden“ in Automatisierungs-Flows.

Die frühzeitige Validierung verhindert, dass eine fehlerhafte Integration Daten verliert oder Kundenjourneys unterbricht. Mit einer temporären Test-URL können Sie genau prüfen, was Papo sendet – Header, Body und Antwortcodes – und Anpassungen vornehmen, bevor Sie auf das endgültige System zeigen.

Zusammenfassung des Testprozesses

So testen Sie Konto-Webhooks (Integrationen)

Die nativen Webhooks von Papo werden bei jeder neuen eingehenden Nachricht in einem Posteingang ausgelöst. So validieren Sie sie ohne Risiko:

1. Rufen Sie im Papo-Dashboard Einstellungen > Integrationen > Webhooks auf und erstellen Sie einen neuen Webhook.
2. Legen Sie den Trigger fest – zum Beispiel Alle Nachrichten – und fügen Sie im Feld URL die temporäre Adresse von Webhook.site ein.
3. Speichern Sie den Webhook.
4. Senden Sie eine Testnachricht (über WhatsApp oder einen anderen verbundenen Kanal) an den überwachten Posteingang.
5. Aktualisieren Sie im Webhook.site das Dashboard und suchen Sie die neu eingegangene Anfrage. Prüfen Sie den JSON-Body: Er sollte Daten wie die Nummer des Absenders, den Nachrichteninhalt und die Konversations-ID enthalten.
6. Wenn das JSON leer oder fehlerhaft ist, überprüfen Sie den gewählten Trigger und bestätigen Sie, dass die Nachricht tatsächlich im Posteingang empfangen wurde.
7. Nach der Validierung bearbeiten Sie den Webhook und tauschen die URL gegen die Ihres Zielsystems aus.

So testen Sie die Aktion „Webhook senden“ in Automatisierungs-Flows

Im Flow-Editor ermöglicht die Aktion Webhook senden, Daten an einem bestimmten Schritt der Journey auszulösen. Der Test erfolgt mit einem vorübergehend aktiven Flow und einem Kontrollkontakt:

1. Erstellen Sie den Flow und fügen Sie den Knoten Webhook senden an der gewünschten Stelle hinzu.
2. Füllen Sie im Konfigurationsbereich des Knotens das Feld URL mit der Adresse von Webhook.site, wählen Sie die Methode POST und stellen Sie den JSON-Body mit Papo-Variablen wie {{contact.name}} und {{contact.phone}} zusammen.
3. Aktivieren Sie den Flow.
4. Melden Sie im CRM manuell einen Testkontakt für diesen Flow an (folgen Sie dem gleichen Verfahren wie beim Testen von Automatisierungs-Flows).
5. Verfolgen Sie den Ausführungsverlauf des Flows und beobachten Sie gleichzeitig Webhook.site.
6. Die empfangene Anfrage sollte das JSON mit den echten Werten des Testkontakts anzeigen, wobei die Variablen ersetzt wurden. Andernfalls prüfen Sie den Body (verwenden Sie "nome": "{{contact.name}}" und stellen Sie sicher, dass der Kontakt die Felder ausgefüllt hat).
7. Wenn die Anfrage einen 4xx- oder 5xx-Fehler zurückgibt, prüfen Sie, ob die Methode korrekt ist (normalerweise POST) und ob der Header Content-Type: application/json enthalten ist.
8. Deaktivieren Sie nach der Validierung den Flow, tauschen Sie die Ziel-URL gegen die Produktions-URL aus und aktivieren Sie ihn erneut.

Für wen dieser Prozess geeignet ist

• Administratoren und Systemanalysten, die die Integrität von Integrationen vor der Freigabe sicherstellen müssen.
• Teams, die Flows mit Webhooks für CRMs, Tabellenkalkulationen oder Automatisierungstools erstellen und das Payload debuggen möchten, ohne echte Leads zu beeinträchtigen.
• Alle Nutzer, die Konto-Webhooks individualisieren und bestätigen möchten, dass Ereignisse korrekt gesendet werden.

Häufig gestellte Fragen

Kann ich den Webhook testen, ohne eine echte Nachricht zu senden?

Für Konto-Webhooks ist das nicht möglich, da sie durch eingehende Nachrichten ausgelöst werden. Verwenden Sie eine Test-WhatsApp-Nummer (Ihre eigene oder die eines Kollegen), um das Ereignis zu erzeugen. Bei Flows ermöglicht die manuelle Anmeldung eines Kontrollkontakts den Test, ohne dass der Lead ein echter Kunde ist.

Ist Webhook.site kostenlos? Sollte ich es in der Produktion verwenden?

Ja, Webhook.site generiert temporäre öffentliche URLs und zeigt den Datenverkehr in Echtzeit an – ideal für die Fehlersuche. Verwenden Sie diese URLs niemals in der Produktion – ersetzen Sie sie nach dem Test durch die URL des Zielsystems.

Der Webhook wurde ausgelöst, aber das Payload ist leer. Was ist zu prüfen?

Prüfen Sie bei Konto-Webhooks den Trigger (ob er den richtigen Nachrichtentyp erfasst) und die Berechtigungen des Posteingangs. Überprüfen Sie bei der Flow-Aktion die Variablen im Body – Felder wie {{contact.name}} werden nur ausgefüllt, wenn der Kontakt das Feld „Name“ ausgefüllt hat. Testen Sie mit einem Kontakt, der vollständige Daten besitzt.

Wie behebe ich Fehler 401 (nicht autorisiert) oder 403 (verboten)?

Diese Fehler zeigen an, dass das Zielsystem die Anfrage abgelehnt hat. Fügen Sie im Feld Headers der Webhook-Konfiguration einen Authentifizierungs-Header hinzu (zum Beispiel Authorization: Bearer ihr-token), wie in der Dokumentation des externen Tools beschrieben.

Kann ich Kanban-Webhooks auf die gleiche Weise testen?

Ja. Webhooks, die im Kanban-Modul konfiguriert sind, können mit einer temporären Webhook.site-URL getestet werden – verschieben Sie einfach eine Karte von einer Spalte in eine andere (Aktion, die das Ereignis auslöst) und prüfen Sie das Payload im Test-Dashboard.

Muss ich den Flow aktiv lassen, um den Webhook zu testen?

Ja. Nur Flows mit dem Status Aktiv verarbeiten den Webhook-Knoten. Aktivieren Sie den Flow, führen Sie den Test durch und deaktivieren Sie ihn anschließend bei Bedarf.

Lesen Sie auch

• So testen Sie einen Automatisierungs-Flow vor der Aktivierung
• So senden Sie Daten neuer Kontakte per Webhook an Google Sheets

Kostenlos starten →

Mit dem ersten kostenlosen Nutzer können Sie bereits Webhooks erstellen und Integrationen unverbindlich testen.