Um Ihre automatisierten Prozesse mit anderen Systemen zu integrieren, ermöglicht Papo (https://papo.global/) die Verwendung der Aktion "Webhook senden" innerhalb der Automatisierungs-Flows. Mit dieser Funktion können Sie Kontaktdaten in Echtzeit an externe Plattformen wie Ihr CRM, Tabellen oder Automatisierungstools (wie n8n und Zapier) senden, sobald ein Kontakt eine bestimmte Phase Ihres Flows erreicht.
Die Webhook-Aktion fungiert als Kommunikationsbrücke, die eine automatische Benachrichtigung von einem System (Papo) an ein anderes sendet. Dies eröffnet eine Vielzahl von Möglichkeiten, vernetzte Arbeitsökosysteme zu schaffen, in denen Informationen ohne manuelle Datenexporte und -importe fließen. Zum Beispiel können Sie einen neuen Lead in Ihrem Haupt-CRM registrieren, genau in dem Moment, in dem er von Ihrem Chatbot auf WhatsApp qualifiziert wird.
| Konfigurationsparameter | Beschreibung | Anwendungsbeispiel |
|---|---|---|
| Webhook-URL | Die Adresse (Endpunkt) des externen Systems, das die Daten empfangen soll. | URL, die von einem System wie n8n, Zapier oder Ihrem eigenen Backend bereitgestellt wird. |
| HTTP-Methode | Die Art und Weise, wie die Daten gesendet werden. POST ist am gebräuchlichsten, um Daten zu senden. |
Wählen Sie POST, um Informationen im Anfragetext zu senden. |
| Body (Payload) | Die Daten, die Sie senden möchten, normalerweise im JSON-Format, unter Verwendung von Papo-Variablen. | {"nome": "{{contact.name}}", "email": "{{contact.email}}", "telefone": "{{contact.phone}}"} |
| Header | Zusätzliche Informationen für die Anfrage, wie z.B. Inhaltstyp oder Authentifizierungsschlüssel. | Content-Type: application/json |
Webhook-Aktion Schritt für Schritt konfigurieren
Die Integration eines externen Systems über einen Webhook in einem Papo Flow ist ein technischer, aber unkomplizierter Prozess. Befolgen Sie die folgenden Schritte, um den Datenversand zu konfigurieren.
1. Fügen Sie den Knoten "Webhook senden" zu Ihrem Flow hinzu
Im visuellen Flow-Editor von Papo fügen Sie an der Stelle der Journey, an der die Daten gesendet werden sollen, einen neuen Aktionsknoten hinzu. Suchen und wählen Sie die Aktion "Webhook senden". Dieser Knoten ist dafür verantwortlich, die Kommunikation an das externe System auszulösen.
Zum Beispiel können Sie diesen Knoten direkt hinzufügen, nachdem ein Kontakt eine Qualifizierungsfrage beantwortet hat oder am Ende einer Willkommenssequenz.
2. Konfigurieren Sie die Ziel-URL
Im Konfigurationsbereich des Webhook-Knotens ist das erste auszufüllende Feld die Webhook-URL. Dies ist die eindeutige URL, die vom System bereitgestellt wird, das die Daten empfangen soll.
- Wo finden Sie diese URL? Sie sollten sie in der Dokumentation oder im Dashboard Ihres externen Systems (z.B. Ihres CRM, ERP oder eines Automatisierungstools wie n8n) erhalten. Tools wie Webhook.site eignen sich auch hervorragend, um temporäre URLs für Tests zu generieren.
3. Wählen Sie die HTTP-Methode
Sie müssen die Methode für die Anfrage auswählen. Die gebräuchlichsten sind:
- POST: Für die meisten Fälle empfohlen. Ermöglicht das Senden einer größeren Datenmenge strukturiert im Anfragetext (Payload). Ideal zum Erstellen oder Aktualisieren von Datensätzen in anderen Systemen.
- GET: Wird verwendet, um Daten von einem Server anzufordern. Die Daten werden als Parameter in der URL selbst gesendet. Für diese Art der Integration ist es weniger üblich, da es weniger sicher und in der Größe begrenzt ist.
Wählen Sie POST, um die Daten Ihres Kontakts zu senden.
4. Erstellen Sie den Anfragetext (Payload)
Der Body (oder "Payload") ist der Ort, an dem Sie definieren, welche Kontaktinformationen gesendet werden sollen. Papo ermöglicht es Ihnen, dynamische Variablen zu verwenden, um die Daten des Kontakts einzufügen, der den Flow durchläuft.
Das am häufigsten verwendete Format ist JSON (JavaScript Object Notation). Im Konfigurationsfeld für den Body können Sie eine Struktur wie diese erstellen:
{
"nome_completo": "{{contact.name}}",
"email_contato": "{{contact.email}}",
"telefone": "{{contact.phone}}",
"etiqueta": "Novo Lead Qualificado",
"origem": "Flow de Boas-Vindas"
}
In diesem Beispiel:
{{contact.name}},{{contact.email}}und{{contact.phone}}sind Variablen, die Papo automatisch durch die tatsächlichen Kontaktdaten ersetzt.- "etiqueta" (Label) und "origem" (Quelle) sind Felder mit festen Werten, die Sie hinzufügen können, um die Informationen im Zielsystem zu kontextualisieren.
5. Testen und aktivieren Sie den Flow
Bevor Sie Ihren Flow für alle Kontakte aktivieren, ist es unerlässlich, die Integration zu testen.
- Verwenden Sie eine Test-URL (wie von Webhook.site), um zu überprüfen, ob die Daten korrekt und im erwarteten Format gesendet werden.
- Registrieren Sie einen Testkontakt in Ihrem Flow und beobachten Sie, ob der Webhook ausgelöst wird und ob das externe System die Informationen empfängt.
- Nachdem Sie bestätigt haben, dass alles funktioniert, ersetzen Sie die Test-URL durch die Produktions-URL Ihres Systems und aktivieren Sie den Flow.
Häufig gestellte Fragen (FAQ)
Was ist der Unterschied zwischen einem Webhook und einer API?
Vereinfacht ausgedrückt ist ein Webhook ein "Push"-Mechanismus. Papo sendet die Daten automatisch an Ihr System, wenn ein Ereignis eintritt. Eine API-Abfrage hingegen ist ein "Pull"-Mechanismus, bei dem Ihr System aktiv Daten von Papo anfordern muss. Webhooks sind ideal für Echtzeit-Benachrichtigungen.
Wie erhalte ich die URL für meinen Webhook?
Sie müssen diese URL in dem System generieren, das die Daten empfangen soll. Konsultieren Sie die Dokumentation Ihrer CRM-, ERP-Plattform oder Ihres Automatisierungstools (wie n8n, Zapier, Make), um den Abschnitt "Webhooks" oder "API" zu finden und einen neuen Empfangsendpunkt zu erstellen.
Welche Kontaktdaten kann ich über Webhook senden?
Sie können alle Standard-Kontaktdaten, die in Papo gespeichert sind, wie Name, Telefon, E-Mail, sowie benutzerdefinierte Felder und Tags, die Sie konfiguriert haben, senden. Verwenden Sie die Variablensyntax (z.B. {{contact.feldname}}), um diese Informationen dynamisch in den Anfragetext einzufügen.
Was passiert, wenn das externe System offline ist, wenn der Webhook gesendet wird?
Wenn das Zielsystem nicht antwortet oder einen Fehler zurückgibt, schlägt die Webhook-Zustellung fehl. Papo wird versuchen, die Benachrichtigung zu senden, aber die Empfangsgarantie hängt von der Verfügbarkeit und der korrekten Konfiguration des Empfangssystems ab. Es ist wichtig sicherzustellen, dass Ihr Webhook-Endpunkt stabil ist.
Kann ich Daten sicher senden?
Ja. Webhooks arbeiten über das HTTPS-Protokoll, das die Daten während der Übertragung verschlüsselt. Für eine zusätzliche Sicherheitsebene ermöglichen viele Systeme die Verwendung von Authentifizierungsschlüsseln (Tokens) in den Headern der Anfrage, die Sie auch in der Aktion "Webhook senden" von Papo konfigurieren können.
Kann ich neben Kontakten auch andere Informationen senden?
Ja. Obwohl der häufigste Anwendungsfall das Senden von Kontaktdaten ist, können Sie den Payload Ihres Webhooks so strukturieren, dass er alle statischen oder dynamischen Informationen enthält, die im Kontext des Flows verfügbar sind, wie z.B. den Namen des Flows, die Antwort auf eine bestimmte Frage oder das Datum des Ereignisses.
Kostenlos mit der Automatisierung beginnen →
Erstellen Sie Ihr Konto und erkunden Sie die Automatisierungs-Flows, um Ihre Prozesse zu verbinden.