Über Webhooks

Im Marketing hilft es, deine Marketingkampagnen mit anderen Aktionen auf deiner Website und anderen Kanälen wie Textnachrichten und Direktwerbung zu koordinieren. Webhooks sind eine Möglichkeit für dich, Mailchimp-Aktivitäten mit Apps von Drittanbietern zu synchronisieren.

In diesem Artikel erfährst du, wie du einen Webhook in der Mailchimp-App erstellen kannst.

Vor dem Start

• Zur Verwendung von Webhooks musst du den Standard- oder Premium-Tarif haben. Im Essentials- oder Free-Tarif können Benutzer den Webhook einrichten und die Funktion sehen. Dabei werden sie jedoch aufgefordert, ein Upgrade durchzuführen, bevor sie den Journey-Punkt aktivieren. Du kannst deinen Tarif auf der Tarifseite deines Accounts ändern.
• Wir empfehlen Webhooks für Benutzer, die sich mit benutzerdefinierter Codierung auskennen. Wende dich an deinen Entwickler oder beauftrage einen Mailchimp-Experten, falls du Hilfe benötigst.
• In diesem Artikel erfährst du, wie du Webhooks in Mailchimp hinzufügst. Weitere Informationen zur Arbeit mit Webhooks findest du in unserer Kurzanleitung zu Webhooks.

So funktioniert es

Wenn ein Kontakt eine bestimmte Aktion in Mailchimp ausführt – wie das Erreichen eines bestimmten Punkts in einer Customer Journey oder das Aktualisieren eines Profils – löst ein Webhook ein Ereignis in einer Drittanbieter-App aus. Der Webhook sendet eine HTTP-Anfrage an eine URL mit Anweisungen und Details zum Ereignis. Die App oder Integration, die diese URL überwacht, sendet dann eine Textnachricht an den Kontakt oder führt eine andere Aktion in einer Drittanbieter-App aus.

Definitionen

Dies sind ein paar Begriffe, die du bei deiner Arbeit mit Webhooks in Mailchimp kennen solltest.

• Webhooks
  Ein Webhook ist eine HTTP-Anfrage, die es einer App ermöglicht, Informationen an eine andere zu senden.

• Header
  Header beschreiben etwas über die Anfrage. Header umfassen alle Informationen, die die empfangende App benötigt, um die Anfrage zu bearbeiten. In vielen Apps müssen Header einen Schlüsseltyp („Schlüssel“) und einen Schlüsselwert („Wert“) enthalten.

• Inhaltstyp
  Mit der Inhaltstyp-Option kannst du die Programmiersprache für den Textkörper der Anfrage auswählen. Derzeit akzeptiert der Editor nur JSON und FormData.

• Nutzlast
  Die Nutzlast ist der Hauptteil der Anfrage. Das richtige Format des Hauptteils wird von der App bestimmt, mit der sich der Webhook verbindet.

Webhooks als Customer Journey-Punkt

Eine Customer Journey besteht aus bestimmten Startpunkten, Aktionen und Regeln, die du auf deinen Marketing-Zielen basierend festgelegt hast. Um deine Customer Journey zu erstellen, wählst du diese Elemente in einer Journey Map aus.

So fügst du einen Webhook als Customer Journey-Punkt hinzu.

1. Klicke auf Automatisierungen und dann auf Alle Journeys.
   
2. Klicke auf die Schaltfläche Create Journey (Journey erstellen) oder klicke neben einer vorhandenen Journey auf Finish Setup (Setup beenden) .
3. Um einen Journeypunkt an der Stelle, an der der Webhook platziert werden soll, hinzuzufügen, bewege den Cursor über das Plus-Symbol (+) .
4. Klicke dann auf Add a journey point (Journeypunkt hinzufügen).
   

5. Klicke auf Webhook.
   

6. Fülle im Webhook-Builder-Modul die Felder aus, um deinen Webhook zu konfigurieren. Die Felder Webhook name(Webhook-Name), URL destination(URL-Ziel), Username(Benutzername) und Password (Passwort) sind Pflichtfelder.

7. Nachdem du deinen Webhook konfiguriert hast, klicke auf Save (Speichern), um ihn als Journey-Punkt hinzuzufügen.

Gut gemacht! Wenn du deine Journey startest oder fortsetzt, wird der Webhook ausgelöst, sobald Benutzer*innen zu diesem Journey-Punkt gelangen. Die Anzahl der gesendeten Anfragen wird am Journey-Punkt selbst angezeigt.

Webhooks als Campaign Manager-Touchpoint

Der Campaign Manager von Mailchimp ist ein End-to-End-Kampagnenplaner. Lege ein Ziel fest und organisiere dann Aufgaben, Events, E-Mails und Webhooks von einem zentralen Planer aus.

So fügst du einen Webhook als Campaign Manager-Touchpoint hinzu:

1. Klicke auf Campaigns(Kampagnen) und dann auf Campaign Manager.
   

2. Klicke auf die Schaltfläche Create campaign (Kampagne erstellen) oder klicke auf die aktive Kampagne, zu der du einen Webhook-Touchpoint hinzufügen möchtest.

3. Klicke auf das Dropdown-Menü Add touchpoint (Touchpoint hinzufügen) und dann auf Webhook.

4. Zum Konfigurieren und für die Terminplanung für deinen Webhook musst du im Webhook-Builder-Modul die Felder ausfüllen.

   Die Zielgruppe, die du für die Kampagnen während deren Einrichtung ausgewählt hast, wird standardmäßig verwendet. Wenn du keine Webhook-Aktion für deine gesamte Zielgruppe auslösen möchtest, wähle ein vorhandenes Segment oder Tag aus deiner Zielgruppe im Abschnitt Segment or Tag (Segment oder Tag) des Moduls aus.

5. Sobald du deinen Webhook konfiguriert und Datum und Uhrzeit festgelegt hast, klicke auf Schedule webhook (Webhook planen), um ihn als Kampagnen-Touchpoint hinzuzufügen.

Ausgezeichnet! Du kannst deinen Webhook-Touchpoint in deinem Kalender anzeigen lassen. Nach dem geplanten Datum und der geplanten Uhrzeit wird er dann als abgeschlossen angezeigt.

Zielgruppen-Webhook-Konfiguration

Um Updates zu deiner Zielgruppe an eine andere App zu senden, kannst du einen Zielgruppen-Webhook konfigurieren. Webhooks können eine Anfrage an die URL deiner Wahl senden, wenn bestimmte Aktualisierungen in der Zielgruppe stattfinden, z. B. wenn jemand abonniert oder ein Profil aktualisiert wird.

So fügst du deiner Zielgruppe einen Webhook hinzu.

1. Klicke auf Audience (Zielgruppe), dann auf Audience dashboard (Zielgruppen-Dashboard).
   
2. Wenn du mehrere Zielgruppen hast, musst du zur Auswahl der gewünschten Zielgruppe die Dropdown-Liste „Current Audience“ (Aktuelle Zielgruppe) anklicken.
3. Klicke auf die Dropdown-Liste Manage Audience (Zielgruppe verwalten) und wähle Settings (Einstellungen) aus.

4. Klicke auf Webhooks.
   

5. Klicke auf Create webhook(Webhook erstellen).

6. Gib eine Callback URL (Rückruf-URL) ein. Dies ist die URL, an die der Webhook Anfragen sendet.

7. Markieren alle Aktionen, die einen Webhook auslösen sollen. Hier sind die verfügbaren Optionen:

   • Subscribes (Abonnenten)
   • Unsubscribes (Abbestellung)
   • Profil-Updates
   • Adresse bereinigt
   • E-Mail geändert
   • Kampagne wird gesendet

8. Du kannst auch wählen, Aktualisierungen nur zu senden, wenn eine Änderung von einem Abonnenten, einem Account-Administrator oder über die API vorgenommen wird.

9. Klicke auf Save (Speichern).

Das war auch schon alles! Wenn eine der ausgewählten Aktionen auftritt, sendet der Webhook eine Anfrage an die von dir eingegebene URL.