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-Pagersystem
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.
Tipp 💡 Überprüfen Sie immer, ob die erforderlichen Header korrekt eingerichtet sind, um unautorisierte 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. Weitere Details dazu, welche Daten verfügbar sindhier
⚠️ WICHTIG! Stellen Sie sicher, dass die Struktur des Anfragetexts 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 vom empfangenden System den Erwartungen entspricht und dass bei der Übertragung keine Fehler auftreten.
Wie man Webhooks in Omnisend Automatisierungen einrichtet
Schritt 1. Erstellen Sie einen Automatisierungs-Workflow
Beginnen Sie, indem Sie eine neue Automatisierung erstellen oder eine bestehende innerhalb von Omnisend bearbeiten.
Schritt 2. Fügen Sie eine Webhook Action hinzu
In Ihrem Automatisierungs-Workflow ziehen Sie 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 zur Authentifizierung für das empfangende System dienen.
Schritt 4. Payload zuordnen
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 übergeben.
Schritt 5. Testen Sie den Webhook
Nach der Einrichtung testen Sie den Webhook, um sicherzustellen, dass das externe System Daten korrekt sendet und empfängt.
Bestätigen:
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, Ihrem API-Gateway oder Ihrer Endpunktkonfiguration auf die Whitelist setzen, um sicherzustellen, dass nur Anfragen von Omnisend akzeptiert werden.
Warum Webhook-IPs whitelisten?
Das Whitelisting der statischen IPs von Omnisend bietet eine zusätzliche Sicherheitsebene, indem:
Verhindern unbefugter Anfragen – Nur Traffic von Omnisend-IPs kann Ihren Webhook-Endpunkt erreichen.
Reduzierung von Spoofing-Risiken – Blockiert bösartige Akteure, die versuchen, Omnisend-Webhook-Aufrufe zu imitieren.
Erfüllung von Compliance-Anforderungen – Unterstützt Unternehmenssicherheitsrichtlinien, die eine IP-basierte Zugriffssteuerung erfordern.
Omnisend Webhook Static 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
Wichtig Diese IPs werden ausschließlich von Omnisend für Webhook-Anfragen verwendet, die von Automatisierungs-Workflows gesendet werden. Stellen Sie sicher, dass Ihre Firewall- oder API-Konfiguration eingehenden Datenverkehr von diesen Adressen zulässt.
Hinweis: Wenn Sie unsicher sind, wie Sie die IP-Whitelisting konfigurieren, wenden Sie sich an Ihr Entwicklungsteam oder Ihren Systemadministrator.
Nachricht über Slack mithilfe von 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 einen eingehenden Webhook ein.
Wählen Sie einen Kanal aus, über den 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.
Payload anpassen. Definieren Sie das Nachrichtenformat, das Sie senden möchten. Für Slack könnte die Payload 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 oben rechts auf Ihren Namen und wählen Sie API.
Wenn Sie noch kein API-Schlüsselpaar erstellt haben, klicken Sie auf Create Security Key Pair, um eines zu generieren.
Kopieren Sie den Private Key und speichern Sie ihn an einem sicheren Ort, da Sie ihn später benötigen werden.
Schritt 2. Ein Keyword in Postscript erstellen
Klicken Sie in Postscript auf der linken Seite auf Keywords.
Klicken Sie oben rechts auf Create Keyword.
Benennen Sie Ihr Keyword und entscheiden Sie, ob Sie einen Coupon in die Antwort aufnehmen möchten.
So bearbeiten Sie die Antwort:
Klicken Sie auf das lila Feld Reply oder erstellen Sie eine automatische Antwort, indem Sie auf Add Action klicken und dann die Antwortnachricht anpassen.
Diese Keyword-Antwort wird sofort gesendet, wenn ein Benutzer über Ihr Keyword abonniert.
Schritt 3. Keyword-ID abrufen
Besuchen Sie die Postscript API-Dokumentation: Postscript Get Keywords.
Geben Sie Ihren Private Key im Header ein und klicken Sie auf Try it, um die Keyword ID zu finden, die Sie für Kontakte verwenden möchten, die von Omnisend kommen.
Schritt 4. Automatisierung in Omnisend einrichten
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 Automatisierungs-Flow hinzu.
Für URL verwenden Sie:
https://api.postscript.io/api/v2/subscribers.Fügen Sie für Header hinzu:
Authorization: Beareraccept: application/json
Body. Übergeben Sie die folgenden Informationen im Anfragetext:
{ "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.
Prü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 mithilfe von Webhooks senden
Die WhatsApp-Integration erfordert die Nutzung der WhatsApp Business API oder eines Drittanbieterdienstes. Im Folgenden sind die Schritte zur Integration von WhatsApp-Nachrichten mithilfe von Webhooks aufgeführt.
Schritt 1. WhatsApp Business API einrichten.
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.
Beschaffen Sie die erforderlichen API-Anmeldeinformationen.
Schritt 2. Webhooks in Omnisend konfigurieren.
Fügen Sie einen Webhook-Block in Ihrem Omnisend-Automatisierungs-Workflow hinzu.
Geben Sie die WhatsApp Business API-Endpunkt-URL als Webhook ein.
HTTP-Anfrage erstellen. Um Nachrichten über WhatsApp zu senden, erstellen Sie eine HTTP-POST-Anfrage mit der erforderlichen Nutzlast. 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.
Senden von Daten an einen benutzerdefinierten API-Endpunkt
In einigen Fällen möchten Sie möglicherweise Ereignisdaten an einen benutzerdefinierten API-Endpunkt senden, wie zum Beispiel Ihr eigenes CRM-System oder eine Auftragsverwaltungsplattform.
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. Webhook in Omnisend hinzufügen. Fügen Sie den Webhook-Block in die gewünschte Automatisierung ein und geben Sie die benutzerdefinierte API-Endpunkt-URL ein.
Passen Sie die Payload an. Die Payload kann alle Daten enthalten, die aus der Automatisierung verfügbar sind, wie zum Beispiel 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 den Webhook, um sicherzustellen, dass Daten korrekt an Ihren benutzerdefinierten API-Endpunkt gesendet werden.
Webhooks für Aktionsbenachrichtigungen verwenden
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 typischerweise:
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.
Eintritt in die Automatisierung: Der Kontakt tritt in einen Automatisierungs-Workflow ein. Dies kann beginnen, wenn er ein bestimmtes Segment betritt.
Webhook sendet benutzerdefinierten Event: Ein Webhook sendet einen benutzerdefinierten Event bezüglich der vom ersten Kontakt ausgefü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 Aktion erhalten, die vom ersten Kontakt durchgeführt wurde.
Beispiel
In unserem Beispiel senden wir uns eine E-Mail-Benachrichtigung, sobald jemand auf einen bestimmten Link in einer E-Mail klickt.
Schritt 1. Einrichten der ersten Automatisierung
Aktion definieren:
Richten Sie Ihren Trigger für die Automatisierung ein. Dies kann jede Aktion umfassen, wie zum Beispiel das Eintreten in ein Segment oder das Klicken auf eine Werbeschaltfläche.
Für unser Beispiel möchten wir wissen, wann jemand auf eine bestimmte Schaltfläche in einer Marketingaktivität klickt.
Webhook-Block hinzufügen:
Fügen Sie in Ihrem Automatisierungs-Flow einen Webhook-Block hinzu, um ein benutzerdefiniertes Ereignis an den angegebenen Kontakt zu senden.
Webhook-Konfiguration
Headers:
Schlüssel:
x-api-keyWert: (ersetzen Sie dies durch Ihren tatsächlichen API-Schlüssel)
Body:
{
"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 Body-Konfiguration:
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 →Die E-Mail: Dies legt den Kontakt fest, der den benutzerdefinierten Event und die Benachrichtigung über die vom ersten Kontakt ausgeführte Aktion erhält.
properties: Dies ist eine optionale Liste von Details, die Sie über den ersten Kontakt angeben können. In diesem Fall erfassen wir ihre E-Mail-Adresse, ihren Vornamen und Nachnamen.
Schritt 2. Einrichten der zweiten Automatisierung
Wählen Sie den Trigger aus:
Wählen Sie den
eventNameaus dem vorherigen Schritt als Der Trigger für die Automatisierung.
Benachrichtigungsdetails hinzufügen:
In dieser Automatisierung können Sie eine E-Mail- oder SMS-Benachrichtigung einrichten, indem Sie die aus der ersten Automatisierung erfassten Details wie die E-Mail-Adresse und den Namen des Kontakts nutzen.
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 oft Entwicklungsressourcen erfordert, insbesondere für benutzerdefinierte API-Einrichtungen.
Beachten Sie 💡 Die Integration von Webhooks erfordert oft Entwicklungsressourcen, insbesondere für benutzerdefinierte API-Einrichtungen. Stellen Sie daher sicher, dass Sie die notwendige Unterstützung haben.
FAQ
Wann sollte ich Webhooks anstelle nativer Integrationen verwenden?
Verwenden Sie Webhooks für Plattformen ohne eine direkte Omnisend-Integration oder wenn Sie ein benutzerdefiniertes Daten-Mapping benötigen.
Kann ich Webhooks testen, bevor ich die Automatisierung aktiviere?
Ja – Webhook testenoder Tools wie Postman verwenden, um Testanfragen zu senden.
Gibt es Ratenbegrenzungen?
Grenzwerte hängen vom externen Dienst ab – überprüfen Sie deren API-Dokumentation.
Kann ich die Webhook-IPs von Omnisend aus Sicherheitsgründen auf die Whitelist setzen?
Ja. Omnisend verwendet einen dedizierten Satz statischer IP-Adressen für alle Webhook-Anfragen, die von Automatisierungs-Workflows gesendet werden. Das Whitelisting dieser IPs fügt eine zusätzliche Sicherheitsebene hinzu, indem sichergestellt wird, dass nur Omnisend Ihren Endpunkt erreichen kann. Die vollständige IP-Liste anzeigen
Welche Daten kann ich in Webhook-Payloads verwenden?
Sie können beliebige Kontaktattribute oder Daten aus einem Ereignis verwenden, das die Automatisierung auslöst. Weitere Informationen finden Sie hier
Welchen Tarif benötige ich, 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. Gehen Sie zu Webshop-Einstellungen → Die Abrechnung, um Ihren 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 erreichen uns über den In-App-Chat oder unter [email protected].