Webhooks ermöglichen es Ihnen, die Automatisierungsfunktionen von Omnisend zu erweitern, indem Sie externe Systeme und Dienste verbinden. Sie ermöglichen es Ihnen, Ereignisse in anderen Plattformen auszulösen oder Echtzeitdaten zu senden, wodurch die Funktionalität Ihrer Automatisierungs-Workflows verbessert wird.
In diesem Leitfaden erfahren Sie, wie Sie Webhooks in Omnisend-Automatisierungen einrichten und verwenden, mit Beispielen und Anwendungsfällen.
⚠️ Tarif-Verfügbarkeit: Webhooks in Automatisierungen sind nur in kostenpflichtigen Tarifen verfügbar. Um diese Funktion zu nutzen, aktualisieren Sie Ihren Tarif unter Webshop-Einstellungen → Die Abrechnung.
⚠️ Wichtig: Die Implementierung von Webhooks erfordert erheblichen Aufwand Ihrerseits und oft die Einbindung eines Entwicklers. Möglicherweise müssen Sie spezielle API-Endpunkte vorbereiten, Payloads verarbeiten und eine ordnungsgemäße Integration zwischen Omnisend und externen Systemen sicherstellen.
Was sind Webhooks?
Webhooks sind HTTP-Callbacks, die Echtzeitdaten von Omnisend an andere Dienste senden, wenn bestimmte Automatisierungsereignisse auftreten. Dies ermöglicht Ihnen:
Benachrichtigen Sie Drittsysteme über Automatisierungsereignisse.
Personalisierte Nachrichten über Plattformen wie WhatsApp senden.
Lösen Sie benutzerdefinierte Workflows in CRMs, Projektmanagement-Tools oder Kommunikationsplattformen wie Slack aus.
💡 Analogie: Ein Restaurant-Pager-System
Stellen Sie sich vor, Sie sind in einem Restaurant und bekommen einen Pager, der Sie benachrichtigt, wenn Ihr Tisch bereit ist. Dieser Pager ist wie ein Webhook, der Sie über spezifische Ereignisse benachrichtigt, ohne dass Sie manuell nachsehen müssen.
Verständnis der Webhook-Struktur und -Komponenten
Beim Einrichten von Webhooks in Omnisend ist es entscheidend, die Schlüsselkomponenten zu verstehen, die bei der Konfiguration einer Webhook-Anfrage beteiligt sind.
Dieser Abschnitt erläutert die Struktur und die Komponenten, denen Sie beim Bearbeiten eines Webhooks in Omnisend begegnen werden:
Komponente 1. Webhook URL
Die URL ist der Zielendpunkt, an den Ihre Webhook-Daten gesendet werden. Dies ist typischerweise ein externes System oder ein Dienst, das die von Omnisend gesendeten Daten verarbeitet und handhabt.
⚠️ Wichtig: Stellen Sie sicher, dass diese URL korrekt und zugänglich ist. Wenn der empfangende Dienst eine sichere Kommunikation erfordert, stellen Sie sicher, dass die URL mit https:// for encrypted transmission.
Komponente 2. Überschriften
Webhooks ermöglichen es Ihnen, zusätzliche Header mit Ihrer Anfrage zu senden. Header sind Schlüssel-Wert-Paare, die Metadaten über die Webhook-Anfrage enthalten oder zur Authentifizierung für das empfangende System dienen.
Schlüssel. Der Name des Headers (z.B.,
Autorisierung,Content-Type).Wert. Der Wert, der mit dem Header-Schlüssel verknüpft ist (z. B.,
Bearer your_access_token,application/json).Beispiel-Überschriften:
Authorization: Bearer your_access_tokenContent-Type: application/json
Häufiger Anwendungsfall. Wenn Ihr Empfangsdienst eine Authentifizierung, wie z. B. einen API-Schlüssel oder ein Token, erfordert, würden Sie diese in den Headern übergeben.
4a1 0Hinweis:a0Stellen Sie immer sicher, dass die erforderlichen Header korrekt eingerichtet sind, um unbefugte oder fehlgeschlagene Anfragen zu vermeiden.
Komponente 3. Body
Der Body ist der Ort, an dem die eigentlichen Daten (Payload) gesendet werden. Es enthält die relevanten Informationen, die Sie an das externe System übergeben möchten, wie z.B. Kundendetails, Bestellinformationen oder spezifische Ereignisauslöser.
Format. Der Body ist normalerweise im JSON-Format strukturiert, was es den meisten Diensten ermöglicht, ihn einfach zu verarbeiten und zu lesen.
Beispieltext (JSON-Nutzlast):
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Anpassen des Body. Sie können die Payload so anpassen, dass sie nur die spezifischen Daten enthält, die der empfangende Dienst benötigt. Omnisend bietet Variablen (z.B.,
[[contact.email]]) das dynamisch Daten aus Ihrer Automatisierung in die Payload einfügt.Finden Sie weitere Details zu den verfügbaren Daten
⚠️ Wichtig: Stellen Sie sicher, dass die Struktur des Körpers dem entspricht, was der empfangende Endpunkt erwartet. Dies umfasst das richtige Format (JSON, XML usw.) und die Feldnamen.
Webhook testen
Nachdem Sie die URL, die Header und den Body festgelegt haben, ist es unerlässlich, den Webhook zu testen, um zu überprüfen, ob die Daten korrekt gesendet werden. Stellen Sie immer sicher, dass die Antwort des empfangenden Systems wie erwartet ist und dass keine Übertragungsfehler auftreten.
So richten Sie Webhooks in Omnisend-Automatisierungen ein
Schritt 1. Erstellen Sie einen Automatisierungs-Workflow
Beginnen Sie mit der Erstellung einer neuen Automatisierung oder der Bearbeitung einer bestehenden innerhalb von Omnisend.
Schritt 2. Fügen Sie eine Webhook-Aktion hinzu
Ziehen Sie in Ihrem Automatisierungsfluss einen 'Webhook'-Block an die Stelle, an der das externe Ereignis ausgelöst werden soll.
Schritt 3. Konfigurieren Sie die Webhook-URL und Header
Geben Sie die Webhook-URL des externen Systems ein, das Daten empfangen wird. Dies könnte ein CRM, ein Kommunikations-Tool oder ein API-Dienst wie die WhatsApp Business API sein. Header sind Schlüssel-Wert-Paare, die Metadaten über die Webhook-Anfrage enthalten oder als Authentifizierung für das empfangende System dienen.
Schritt 4. Ordnen Sie die Nutzlast zu
Passen Sie die Daten-Payload an, die Sie mit dem Webhook senden möchten. Omnisend ermöglicht es Ihnen, Kundendetails, Bestellinformationen oder andere relevante Daten zu übermitteln.
Schritt 5. Testen Sie den Webhook
Nachdem Sie es eingerichtet haben, testen Sie den Webhook, um sicherzustellen, dass das externe System Daten korrekt sendet und empfängt.
Überprüfen:
Das externe System empfängt die Daten.
Der Antwortcode ist
200 OK.Es treten keine Fehler in Omnisend oder den externen Protokollen auf.
Webhook statische IPs whitelisten
Um die Sicherheit Ihrer Webhook-Integrationen zu verbessern, nutzt Omnisend einen dedizierten Satz statischer IP-Adressen für alle ausgehenden Webhook-Anfragen. Sie können diese IPs in Ihrer Firewall, API-Gateway oder Endpunktkonfiguration auf die Whitelist setzen, um sicherzustellen, dass nur Anfragen von Omnisend akzeptiert werden.
Warum Webhook-IPs auf die Whitelist setzen?
Das Whitelisting der statischen IPs von Omnisend bietet eine zusätzliche Sicherheitsebene durch:
Verhinderung unautorisierter Anfragen – Nur Verkehr von Omnisend-IPs kann Ihren Webhook-Endpunkt erreichen.
Reduzierung von Spoofing-Risiken – Blockiert böswillige Akteure, die versuchen, Omnisend-Webhook-Anrufe zu imitieren.
Einhaltung von Compliance-Anforderungen – Unterstützt Unternehmenssicherheitsrichtlinien, die IP-basierten Zugriffskontrollen erfordern.
Omnisend Webhook Statische IP Liste
Fügen Sie die folgenden IPs zu Ihrer Whitelist-Konfiguration hinzu:
34.170.162.11
34.56.62.59
34.56.108.215
34.133.59.36
34.58.66.146
35.184.130.5
35.232.14.89
6a8 Wichtig: Diese IPs werden ausschließlich von Omnisend für Webhook-Anfragen verwendet, die aus Automatisierungs-Workflows gesendet werden. Stellen Sie sicher, dass Ihre Firewall- oder API-Konfiguration den eingehenden Verkehr von diesen Adressen zulässt.
Hinweis: Wenn Sie sich nicht sicher sind, wie Sie die IP-Whitelist konfigurieren, wenden Sie sich an Ihr Entwicklungsteam oder Ihren Systemadministrator.
Eine Nachricht über Slack mit Webhooks senden
Slack kann mit Omnisend integriert werden, um Benachrichtigungen an bestimmte Kanäle zu senden, wenn ein Automatisierungsereignis auftritt.
Schritt 1. Erstellen Sie einen eingehenden Webhook in Slack.
Gehen Sie zur Slack API und richten Sie ein eingehendes Webhook ein.
Wählen Sie einen Kanal aus, in dem die Nachrichten gesendet werden.
Kopieren Sie die von Slack bereitgestellte Webhook-URL.
Schritt 2. Fügen Sie den Webhook zur Omnisend-Automatisierung hinzu.
Fügen Sie in Ihrem Omnisend-Workflow den Webhook-Block an der gewünschten Stelle in Ihrer Automatisierung ein.
Geben Sie die Slack-Webhook-URL ein.
Passen Sie die Nutzlast an. Definieren Sie das Nachrichtenformat, das Sie senden möchten. Für Slack könnte die Nutzlast so aussehen:
{ "text": "A new subscriber has joined! 🎉", "attachments": [ { "title": "Subscriber Details", "text": "Name: [[contact.first_name]] \n Email: [[contact.email]]" } ] }Testen Sie die Integration. Aktivieren Sie die Automatisierung und überprüfen Sie den Slack-Kanal, um zu bestätigen, dass die Nachricht erfolgreich gesendet wurde.
Kontakte von Omnisend über Automatisierungs-Webhooks an Postscript senden
Schritt 1. Ihren Postscript API-Schlüssel erhalten
Navigieren Sie zu Ihrem Postscript Konto.
Klicken Sie auf Ihren Namen in der oberen rechten Ecke und wählen Sie API.
Wenn Sie noch kein API-Schlüssel-Paar erstellt haben, klicken Sie auf Erstellen Sie ein Sicherheits-Schlüssel-Paar, um eines zu generieren.
Kopieren Sie den Privaten Schlüssel und speichern Sie ihn an einem sicheren Ort, da Sie ihn später benötigen.
Schritt 2. Erstellen eines Keywords in Postscript
Klicken Sie in Postscript auf Keywords auf der linken Seite.
Klicken Sie auf Keyword erstellen in der oberen rechten Ecke.
Benennen Sie Ihr Keyword und entscheiden Sie, ob Sie einen Gutschein in der Antwort einfügen möchten.
Um die Antwort zu bearbeiten:
Klicken Sie auf das lila Antwort-Feld oder erstellen Sie eine automatische Antwort, indem Sie auf Aktion hinzufügen klicken, und passen Sie dann die Antwortnachricht an.
Diese Keyword-Antwort wird sofort gesendet, wenn ein Benutzer sich über Ihr Keyword anmeldet.
Schritt 3. Abrufen der Keyword-ID
Besuchen Sie die Postscript API-Dokumentation: Postscript Get Keywords.
Geben Sie Ihren Privaten Schlüssel im Header ein und klicken Sie auf Ausprobieren, um die Keyword-ID zu finden, die Sie für Kontakte von Omnisend verwenden möchten.
Schritt 4. Einrichtung der Automatisierung in Omnisend
Automatisierungs-Trigger. Verwenden Sie den "Contact Enters Segment" Trigger, um Kontakte an Postscript zu übergeben.
Webhook-Block.
Fügen Sie einen Webhook-Block zu Ihrem Automatisierungsfluss hinzu.
Für URL verwenden Sie:
https://api.postscript.io/api/v2/subscribers.Für Header fügen Sie hinzu:
Authorization: Beareraccept: application/json
Body. Übermitteln Sie die folgenden Informationen im Anfrage-Body:
{ "origin": "other", "properties": { "VIP": true }, "phone_number": "[[contact.phone_number]]", "email": "[[contact.email]]", "keyword_id": "<keywordID obtained previously>", "tags": [ "source:omnisend" ] }Ersetzen Sie durch Ihre tatsächliche Keyword-ID.
Sie können
"origin": "website","social"oder"other"verwenden.
Schritt 5. Die Automatisierung aktivieren
Aktivieren Sie die Automatisierung und testen Sie sie, indem Sie einen Testkontakt mit einer Telefonnummer zu Ihrem Segment hinzufügen.
Überprüfen Sie, ob die Kontakte im Flow erfolgreich an Postscript übergeben werden.
Indem Sie diese Schritte befolgen, können Sie Kontakte von Omnisend über Automatisierungs-Webhooks an Postscript senden.
WhatsApp-Nachrichten mit Webhooks senden
Die WhatsApp-Integration erfordert die Nutzung der WhatsApp Business API oder eines Drittanbieterdienstes. Nachfolgend sind die Schritte zur Integration von WhatsApp-Nachrichten über Webhooks aufgeführt.
Schritt 1. Richten Sie die WhatsApp Business API ein.
Registrieren Sie sich für die WhatsApp Business API über Facebook.
Befolgen Sie den Einrichtungsprozess, der das Hosten der API auf Ihrem Server oder die Nutzung eines Drittanbieterdienstes umfasst.
Erhalten Sie die erforderlichen API-Anmeldeinformationen.
Schritt 2. Konfigurieren Sie Webhooks in Omnisend.
Fügen Sie einen Webhook-Block in Ihren Omnisend-Automatisierungs-Workflow ein.
Geben Sie die URL des WhatsApp Business API-Endpunkts als Webhook ein.
Stellen Sie die HTTP-Anfrage zusammen.Um Nachrichten über WhatsApp zu senden, stellen Sie eine HTTP-POST-Anfrage mit der erforderlichen Nutzlast zusammen. Beispiel mit cURL:
curl -X POST https://graph.facebook.com/v14.0/YOUR_PHONE_NUMBER_ID/messages \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "messaging_product": "whatsapp", "to": "RECIPIENT_PHONE_NUMBER", "type": "text", "text": { "body": "Hello, this is a test message from the WhatsApp Business API." } }'Schritt 3. Testen Sie die Integration. Führen Sie Ihre Automatisierung aus, um sicherzustellen, dass die WhatsApp-Nachricht erfolgreich gesendet wird.
Daten an einen benutzerdefinierten API-Endpunkt senden
In einigen Fällen möchten Sie möglicherweise Ereignisdaten an einen benutzerdefinierten API-Endpunkt senden, z. B. an Ihr eigenes CRM-System oder Ihre Bestellverwaltungsplattform.
Schritt 1. Erstellen Sie einen benutzerdefinierten API-Endpunkt. Arbeiten Sie mit Ihrem Entwicklungsteam zusammen, um einen API-Endpunkt zu erstellen, der Omnisend-Webhook-Daten empfangen kann.
Schritt 2. Fügen Sie den Webhook in Omnisend hinzu. Fügen Sie den Webhook-Block in die gewünschte Automatisierung ein und geben Sie die benutzerdefinierte API-Endpunkt-URL ein.
Passen Sie die Nutzlast an. Die Nutzlast kann beliebige Daten aus der Automatisierung enthalten, wie z. B. Kundendetails, Bestellinformationen oder Kampagnendaten. Beispiel:
{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }Schritt 3. Testen & Aktivieren. Testen Sie das Webhook, um sicherzustellen, dass die Daten korrekt an Ihren benutzerdefinierten API-Endpunkt gesendet werden.
Verwendung von Webhooks für Aktionsbenachrichtigungen
Diese Anweisungen helfen Ihnen, Webhooks einzurichten, um Benachrichtigungen für verschiedene Aktionen zu erhalten, wie zum Beispiel, wenn ein Kunde ein bestimmtes Produkt kauft, eine Rückerstattung anfordert oder auf einen bestimmten Link in einer E-Mail klickt. Webhooks ermöglichen es Ihnen, benutzerdefinierte Ereignisse basierend auf Aktionen Ihrer Kontakte zu erstellen. So funktioniert es normalerweise:
Der Kontakt führt eine Aktion aus: Ein Kontakt löst ein Ereignis aus, indem er beispielsweise auf einen Link in einer E-Mail klickt.
Die Automatisierung betreten: Der Kontakt betritt einen Automatisierungsworkflow. Dies kann beginnen, wenn er einen bestimmten Segment betritt.
Webhook sendet benutzerdefiniertes Ereignis: Ein Webhook sendet ein benutzerdefiniertes Ereignis bezüglich der von dem ersten Kontakt durchgeführten Aktion an eine angegebene interne E-Mail-Adresse.
Zweite Automatisierung ausgelöst: Der angegebene Kontakt tritt in eine zweite Automatisierung ein, in der Sie Benachrichtigungen über die von dem ersten Kontakt durchgeführte Aktion erhalten.
Beispiel
In unserem Beispiel senden wir uns eine E-Mail-Benachrichtigung, wann immer jemand auf einen bestimmten Link innerhalb einer E-Mail klickt.
Schritt 1. Einrichten der ersten Automatisierung
Definieren Sie die Aktion:
Richten Sie Ihren Trigger für die Automatisierung ein. Dies kann jede Aktion umfassen, wie das Betreten eines Segments oder das Klicken auf einen Werbe-Button.
In unserem Beispiel möchten wir wissen, wann jemand auf einen bestimmten Button in einer Marketingaktivität klickt.
Fügen Sie einen Webhook-Block hinzu:
Fügen Sie in Ihrem Automatisierungsfluss einen Webhook-Block hinzu, um ein benutzerdefiniertes Ereignis an den angegebenen Kontakt zu senden.
Webhook-Konfiguration
Header:
Schlüssel:
x-api-keyWert: (ersetzen Sie dies durch Ihren tatsächlichen API-Schlüssel)
Körper:
{
"eventName": "Click notification",
"origin": "api",
"contact": {
"email": "[email protected]"
},
"properties": {
"clicker_email":"[[contact.email]]",
"clicker_fname":"[[contact.first_name]]",
"clicker_lname":"[[contact.last_name]]"
}}Wichtiger Hinweis zur Körperkonfiguration:
eventName: Sie können dieses Ereignis beliebig benennen. Es wird verwendet, um die zweite Automatisierung auszulösen.
origin: Muss eingestellt werden auf
"api".Der Kontakt → E-Mail: Dies gibt den Kontakt an, der das benutzerdefinierte Ereignis und die Benachrichtigung über die von dem ersten Kontakt durchgeführte Aktion erhalten wird.
Eigenschaften: Dies ist eine optionale Liste von Details, die Sie über den ersten Kontakt angeben können. In diesem Fall sammeln wir ihre E-Mail-Adresse, ihren Vornamen und ihren Nachnamen.
Schritt 2. Einrichten der zweiten Automatisierung
Wählen Sie den Trigger:
Wählen Sie den
eventNameaus dem vorherigen Schritt als den Trigger für die Automatisierung.
Benachrichtigungsdetails hinzufügen:
In dieser Automatisierung können Sie eine E-Mail- oder SMS-Benachrichtigung einrichten, indem Sie Details aus der ersten Automatisierung verwenden, wie die E-Mail-Adresse und den Namen des Kontakts.
Diese Webhook-Einrichtung ermöglicht es Ihnen, einen einzelnen Kontakt über bestimmte Aktionen zu benachrichtigen, die von jedem anderen Kontakt innerhalb von Omnisend durchgeführt werden. Wenn Sie weitere Fragen haben oder Hilfe benötigen, wenden Sie sich bitte an unser Support-Team.
Webhooks bieten die Flexibilität, Ihre Omnisend-Automatisierungen zu erweitern und die Kommunikation mit externen Plattformen in Echtzeit zu ermöglichen. Egal, ob Sie Nachrichten über Slack, WhatsApp oder SMS-Plattformen wie Postscript senden, der Prozess ist ähnlich – das Einrichten einer Webhook-URL, das Definieren einer Payload und das Testen der Integration. Beachten Sie jedoch, dass die Integration von Webhooks häufig Entwicklungsressourcen erfordert, insbesondere für benutzerdefinierte API-Setups.
4a1 Beachten Sie: Die Integration von Webhooks erfordert häufig Entwicklungsressourcen, insbesondere für benutzerdefinierte API-Setups, stellen Sie also sicher, dass Sie die notwendige Unterstützung haben.
Häufig gestellte Fragen
Wann sollte ich Webhooks im Vergleich zu nativen Integrationen verwenden?
Verwenden Sie Webhooks für Plattformen ohne eine direkte Omnisend-Integration oder wenn Sie eine benutzerdefinierte Datenzuordnung benötigen.
Kann ich Webhooks testen, bevor ich die Automatisierung aktiviere?
Yes – oder Tools wie Postman, um Testanfragen zu senden.
Gibt es Ratenlimits?
Die Limits hängen vom externen Dienst ab – überprüfen Sie deren API-Dokumentation.
Kann ich die IPs von Omnisend für Webhooks zur Sicherheit auf die Whitelist setzen?
Yes. Omnisend uses a dedicated set of static IP addresses for all webhook requests sent from Automation workflows. Whitelisting these IPs adds an extra security layer by ensuring only Omnisend can reach your endpoint.
Welche Daten kann ich in Webhook-Nutzlasten verwenden?
You can use any contact attributes or data from an event that triggers the automation. For more information, see
Welcher Tarif muss ich verwenden, um Webhooks in Automatisierungen zu nutzen?
Webhooks sind in allen kostenpflichtigen Plänen verfügbar. Wenn Sie den kostenlosen Tarif nutzen und Webhooks verwenden möchten, müssen Sie zuerst ein Upgrade durchführen. Gehe zu Webshop-Einstellungen Die Abrechnung, um deinen Tarif zu verwalten.
Wenn Sie Unterstützung bei der Einrichtung Ihrer Webhooks benötigen, wenden Sie sich gerne an unser preisgekröntes Kundensupport-Team. Sie können uns über den In-App-Chat oder unter [email protected] erreichen.