Skip to main content
Durch die Verbindung mit Ihrer Emarsys-Integration synchronisiert Chatarmin automatisch Kontakte und Aktivitäten mit Ihrem Emarsys-Konto. Folgende Daten werden synchronisiert: E-Mail-Adresse, Telefonnummer, benutzerdefinierte Eigenschaften und Flow-Anmeldung. Auf diese Weise erhalten Sie messbare KPIs, anhand derer Sie einschätzen können, wie Chatarmin Ihnen hilft, Ihren Gewinn zu steigern, und wissen, welcher WhatsApp-Nutzer zu welchem Emarsys-Konto gehört.

So stellen Sie eine Verbindung zu Emarsys her


Gehen Sie zu Management → Sicherheitseinstellungen → API Credentials und erstellen Sie neue API-Zugangsdaten. Kopieren Sie die Client-ID und das API Secret sofort; Emarsys zeigt das Secret nur einmal an. Wählen Sie auf der Emarsys-Seite in Chatarmin API Credentials (OIDC) und fügen Sie Client-ID und API Secret ein. Chatarmin tauscht diese automatisch gegen kurzlebige Zugriffstoken aus; Sie müssen selbst kein Token erzeugen.
Emarsys stellt die alte WSSE-Authentifizierung ein; die endgültige Abschaltung ist für Ende 2026 geplant. Bestehende Integrationen mit der alten Methode sollten so bald wie möglich erneut über OIDC verbunden werden, um Unterbrechungen zu vermeiden.
Weisen Sie den neuen Emarsys API Credentials anschließend die folgenden Berechtigungen zu. Der folgende Screenshot zeigt, wo Sie die Berechtigungen der API Credentials konfigurieren: Chatarmin help center image Aktivieren Sie anschließend die folgenden Endpunkt-Berechtigungen. Emarsys kann diese unter Kontakte / Kontaktlisten, Felder und Segmente gruppieren. Falls die Bezeichnungen in Ihrem Konto abweichen, verwenden Sie die unten aufgeführten technischen Berechtigungsnamen.

Erforderliche API-Berechtigungen

Kontakte und Kontaktlisten

  • contact.list — Kontakte suchen (GET /contact/query)
  • contact.getdata — Kontaktdaten lesen (POST /contact/getdata)
  • contact.create — Kontakte erstellen (POST /contact)
  • contact.update — Kontakte einschließlich E-Mail, Telefonnummer, Opt-in und benutzerdefinierter Eigenschaften aktualisieren (PUT /contact)
  • contact.delete — doppelte, nur aus einer Telefonnummer bestehende Kontakte entfernen, wenn ein bestehender E-Mail-Kontakt zugeordnet wird (POST /contact/delete)
  • contactlist.list — Kontaktlisten auflisten und prüfen (GET /contactlist)
  • contactlist.create — bei Bedarf die Chatarmin-WhatsApp-Kontaktliste erstellen (POST /contactlist)
  • contactlist.contact.ids — Kontakte einer Liste lesen (GET /contactlist/{contactListId}/contactIds)
  • contactlist.contact.add — einen Kontakt zu einer Liste hinzufügen (POST /contactlist/{listId}/add)
  • contactlist.contact.delete — einen Kontakt aus einer Liste entfernen (POST /contactlist/{listId}/delete)

Felder

  • field.get — Kontaktfelder auflisten und ihre IDs ermitteln (GET /field)
  • field.create — eine fehlende benutzerdefinierte Eigenschaft für die Synchronisierung erstellen (POST /field)

Segmente

  • segment.get — Segmente auflisten (GET /filter)
  • segment.contacts.run — eine Segmentberechnung starten (POST /filter/{segmentId}/runs)
  • segment.contacts.run.status — das Ergebnis der Segmentberechnung abrufen (GET /filter/runs/{runId})
Client-ID und API Secret müssen aktuell sein. Fehlende Endpunkt-Berechtigungen führen normalerweise zu HTTP 403; ungültige oder veraltete Zugangsdaten zu HTTP 401 mit Credentials are invalid.
Nutzen Sie die folgenden Screenshots zusammen mit der obigen Berechtigungsliste, um alle erforderlichen Berechtigungen zu aktivieren. Chatarmin help center image Chatarmin help center image Chatarmin help center image Chatarmin help center image Chatarmin help center image Speichern Sie nun diese Berechtigungen. Herzlichen Glückwunsch! Du hast erfolgreich eine Verbindung zu Emarsys hergestellt 🥳

Aktualisieren von Emarsys-Eigenschaften über einen Chatarmin-Flow


So können Sie Ihrem Emarsys-Konto Eigenschaften hinzufügen. Wir können einem Emarsys-Konto je nach Nutzerverhalten automatisch Eigenschaften hinzufügen. Je nachdem, welchen Zweig des Ablaufs der Nutzer durchläuft, können wir das Emarsys-Profil mit einer von uns festgelegten Eigenschaft aktualisieren. Chatarmin help center image Außerdem können Sie einen Nutzer direkt auf Grundlage seiner Aktivitäten in eine Emarsys-Liste aufnehmen. Chatarmin help center image

IF/Else-Verzweigung basierend auf Emarsys-Eigenschaften


Innerhalb von Flows haben Sie außerdem die Möglichkeit, bestimmte Emarsys-Eigenschaften mit if/else-Anweisungen zu verzweigen: Chatarmin help center image

Segmentierung mit Emarsys


Sie können Emarsys information, die Sie über Ihre Kunden haben, um bestimmte Segmente zu erstellen. Diese Segmente können später verwendet werden, um in Flows Verzweigungen über Wenn/Sonst Teilung oder zu Kampagnen an bestimmte Nutzergruppen senden. Auf diese Weise können Sie in Klaviyo eine Liste oder ein Segment erstellen oder ein vorhandenes mit Ihren bestehenden Daten verwenden und dasAbschnitt in Chatarmin. Chatarmin help center image

Automatisierungsprogramme für den Chatarmin-Fluss


Sie können auch einen Chatarmin Durchfluss Das Automatisierungsprogramm von Emarsys: Chatarmin help center image

Automatische Synchronisierung von Eigenschaften mit Emarsys


Wenn Sie Emarsys auf der Chatarmin-Integrationsseite verbinden, können Sie auch bestimmte Eigenschaften festlegen, die automatisch mit Emarsys synchronisiert werden sollen. Beispiel: So synchronisieren Sie den WhatsApp-/Chatarmin-Opt-in-Status mit einer Emarsys-Property: Chatarmin help center image

Emarsys-Geburtstagskampagne

Wie richte ich die Automatisierung in Emarsys ein?

  1. Erstellen Sie die Zielgruppe für Ihre Kampagne. Wenn Sie eine wiederkehrende Kampagne einrichten möchten, die genau am Geburtstag Ihres Vertragspartners ausgelöst wird, würde das Segment wie folgt lauten:„Heute ist Geburtstag“.
  2. Stellen Sie ein zielgruppenorientiertes Programm zusammen:
  • Beginnen Sie mit dem Filter für wiederkehrende Ereignisse und stellen Sie ihn auf einen täglichen Versand ein
  • Für eine Geburtstagskampagne empfehlen wir, die Nachricht früh am Tag zu versenden 😉
  1. Ändern Sie das Segment auf dasjenige, das Sie für diese bestimmte Veranstaltung vorbereitet haben:
Chatarmin help center image
  1. Verbinden Sie Ihre Automatisierung mit einem Webhook und wählen Sie die richtige Webhook-Voreinstellung aus.

Wie erstelle ich die richtige Webhook-Voreinstellung?

Emarsys-Dokumentation: So erstellen Sie eine Webhook-Voreinstellung 🚨Die Felder „External_reference_id“, „Telefon“ und „E-Mail“ sind Pflichtfelder, damit der Kontakt in Chatarmin zugeordnet werden kann. Wählen Sie bei „Telefon“ das Feld aus, in dem Sie die Handynummer in Emarsys speichern. Bitte beachten Sie, dass Telefonnummern im Format +{Ländervorwahl}… oder {Ländervorwahl}… angegeben werden müssen; bei einer deutschen Nummer wäre dies beispielsweise +4915… oder 4911111.
  1. Geben Sie im Abschnitt „Zusätzliche Daten“ bitte den Namen des Ereignisses ein (diese Angabe ist für den Ablauf relevant, der von der Charles-Seite aus ausgelöst werden soll):
Chatarmin help center image
  1. Richten Sie einen neuen Flow mit einem Emarsys-Trigger ein:
  • Ereignistyp: Benutzerdefiniertes Ereignis
  • Name des Ereignisses: „Geburtstag“ (muss mit der Webhook-Voreinstellung übereinstimmen)
Kopieren Sie den JSON-Payload aus der Testumgebung in Emarsys und fügen Sie ihn in den Journey-Trigger ein. Beispiel: { “id”: “646b8faba72d83cfac9724c2”, “email”:“max@mustermann.com”, “phone”:“+49182381238”, “firstname”:“Max”, “lastname”:“Mustermann”, “consent”:“double”, “tags”:[{“label”:“Agentur”,“id”:“643e6d91815051a97f293738”}], }
  • eine if/else-Verzweigung für „emarsys property“ festlegen
  1. Reichen Sie die Geburtstagsvorlage ein und veröffentlichen Sie den Ablauf, sobald sie akzeptiert wurde.
  2. Testen Sie den Ablauf, indem Sie die Automatisierung über Emarsys auslösen.

Emarsys-Webhook als Auslöser für einen WhatsApp-Flow


So richten Sie einen neuen Flow mit einem Emarsys-Webhook als Auslöser ein:
  • Ereignistyp: Benutzerdefiniertes Ereignis
  • Name des Ereignisses: „Geburtstag“ (muss mit der Webhook-Voreinstellung übereinstimmen)
Kopieren Sie den JSON-Payload aus der Testumgebung in Emarsys und fügen Sie ihn in den Journey-Trigger ein. Beispiel: { “id”: “646b8faba72d83cfac9724c2”, “email”:“max@mustermann.com”, “phone”:“+49182381238”, “firstname”:“Max”, “lastname”:“Mustermann”, “consent”:“double”, “tags”:[{“label”:“Agentur”,“id”:“643e6d91815051a97f293738”}], }
  • eine if/else-Verzweigung für „emarsys property“ festlegen
🚨***Stellen Sie sicher, dass Sie den Ablauf testen, indem Sie die Automatisierung über Emarsys auslösen.***🚨 Bitte Die Dokumentation zur Einrichtung eines Emarsys-Webhooks als Auslöser für Chatarmin-Flows finden Sie hier. Stellen Sie als Nächstes sicher, dass Sie genau diesen Webhook als Auslöser auswählen im Chatarmin Flowbuilder, wie unten dargestellt: Chatarmin help center image Befolgen Sie als Nächstes unsere Strömungsführung,genauer gesagt diese Anleitung zum Auslösen von WA-Abläufen in Chatarmin über benutzerdefinierte API-Endpunkte von Drittanbieter-Integrationen, um den gewünschten Ablauf einzurichten. PROFI-TIPP: Achten Sie darauf, Verzögerungen und if/else-Verzweigungen mit emarsys-Syncs zu kombinieren („Logik –> emarsys als Integration“), um nur die richtige Zielgruppe zum richtigen Zeitpunkt der User Journey anzusprechen.