Klaviyo oder Mailchimp einrichten

Wavize synchronisiert Kontakte mit einer bestimmten Zielgruppe

Klaviyo und Mailchimp verfügen über separate Einrichtungseiten. Jede Integration benötigt einen API-Schlüssel, eine Listen- bzw. Zielgruppen-ID, einen Synchronisationsmodus und einen aktiven Status. Wird bei einer Änderung das Schlüsselfeld leer gelassen, bleibt das bereits gespeicherte Geheimnis erhalten.

Nur Profil erstellt oder aktualisiert das Profil, ohne eine Marketingeinwilligung zu erlangen. Double Opt-in startet den Bestätigungsprozess beim Anbieter: Der Kontakt wird erst nach der erwarteten Aktion zum Abonnenten.

Gemeinsame Sicherheit
Erstellen Sie einen dedizierten Wavize-Schlüssel, kopieren Sie ihn einmalig in das verschlüsselte Formular, senden Sie ihn nicht per E-Mail oder Screenshot und widerrufen Sie ihn, sobald er kompromittiert ist.

Klaviyo mit privatem Schlüssel konfigurieren

Wavize nutzt Serverendpunkte: Der sechsstellige öffentliche Schlüssel, genannt Site ID, ist ungeeignet.

1. Schlüssel erstellen

   In Klaviyo: Einstellungen > API-Schlüssel > Private API-Schlüssel > Privaten API-Schlüssel erstellen. Rolle Owner, Admin oder Manager erforderlich. Benennen Sie ihn Wavize und kopieren Sie den bei Erstellung beginnenden Wert pk_.

2. Scopes wählen

   Lesen von Konten und Liste für die Verifizierung; Profile und Abonnements für die Synchronisierung und Double Opt-in. Mindestens Lesezugriff auf accounts/lists und Schreibzugriff auf profiles/subscriptions für die Endpunkte gewähren.

3. Listen-ID finden

   Öffnen Sie Zielgruppe > Listen & Segmente und wählen Sie die Ziel-Liste aus. Kopieren Sie die Listen-ID aus den Einstellungen oder der URL, nicht den angezeigten Namen. Wavize validiert sie gegen /lists/{id}.

Mailchimp mit Schlüssel und Audience ID einrichten

Der Mailchimp Marketing API-Schlüssel enthält meist den Rechenzentrumssuffix nach einem Bindestrich, z.B. -us21.

1. Schlüssel erstellen

   In Mailchimp: Profil-Icon > Profil > Extras > API-Schlüssel > Schlüssel erstellen. Benennen Sie ihn Wavize, generieren und kopieren Sie ihn sofort, da Mailchimp danach nur Name und Anfang angezeigt.

2. Datacenter-Suffix bewahren

   Wavize extrahiert den Suffix hinter dem letzten Bindestrich, um den korrekten API-Host aufzurufen. Ein gekürzter Schlüssel ohne -usXX kann nicht korrekt geroutet werden.

3. Audience ID finden

   In Zielgruppe > Alle Kontakte > Einstellungen > Zielgruppenname und Standardwerte kopieren Sie die Audience ID. Dies ist weder der öffentliche Name noch eine Kampagnen-ID.

Nur Profil oder Double Opt-in wählen

Der Modus muss Ihrer Rechtsgrundlage und dem Widget-Text entsprechen.

• Nur Profil

  Klaviyo erhält ein Profil; Mailchimp nutzt den Transaktionsstatus. Der Kontakt wird nicht als Marketing-Abonnent dargestellt und dient für erlaubte nicht-promotionale Zwecke.

• Double Opt-in

  Klaviyo startet eine Profil-Abonnementaufgabe; Mailchimp setzt den Kontakt auf ausstehend. Die Adresse muss entsprechend dem Anbieter bestätigen, bevor sie für Marketing aktiv wird.

• Synchronisierte Felder

  Gültige E-Mail erforderlich, Telefon E.164 falls vorhanden, Vorname, Nachname, Organisation, Standort und nützliche Wavize-Eigenschaften. Mailchimp-Felder FNAME/LNAME müssen in der Zielgruppe vorhanden oder kompatibel sein.

Test mit echtem Testkontakt

Wavize prüft erst Konto und Zielgruppe vor Aktivierung der Synchronisierung.

1. Klaviyo Verifizierung

   Der Server ruft /accounts und /lists/{id} auf. Ein 403 weist oft auf fehlenden Scope hin; ein 404 auf eine Listen-ID falschen Kontos.

2. Mailchimp Verifizierung

   Der Server ruft /ping und /lists/{id} auf. Ein Fehler beim Datacenter-Suffix kommt meist durch Schlüssel-Suffix; eine nicht gefundene Audience durch falsche ID.

3. Testkontakt

   Senden Sie vom Widget eine teamzugehörige Adresse, prüfen Sie deren Erstellung bei Wavize und das Eintreffen beim Anbieter. Bei Double Opt-in öffnen und bestätigen Sie die Nachricht, bevor Sie abschließen.

Rotation und Vorfall

Ein neuer Schlüssel ersetzt nicht automatisch den alten in Wavize.

• Erstellen — Neuer dedizierter Schlüssel mit minimal notwendigen Berechtigungen.
• Aktualisieren und testen — Neue Werte eintragen, Audience und Modus beibehalten, dann prüfen.
• Widerrufen — Alten Schlüssel nur nach erfolgreichem Test beim Anbieter löschen.