Verbinde dein Klaviyo-Konto mit Goodweek, um Profile, Listen, Segmente, Kampagnen, Flows und Events direkt aus deinem KI-Arbeitsbereich zu verwalten.
ℹ️ Hinweis zur Governance
Goodweek überschreitet niemals die dem Benutzer innerhalb von Klaviyo gewährten Zugriffsebenen und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Benutzers variieren.
📋 Voraussetzungen
Bevor ein Benutzer die Klaviyo-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek-Adminbereich unter dem Tab Integrationen aktivieren.
Admin-Einrichtung
Die Klaviyo-Integration verwendet einen API-Schlüssel. Es ist kein OAuth-Flow oder eine Genehmigung auf Administratorebene innerhalb von Klaviyo erforderlich. Der verbindende Benutzer muss einen privaten API-Schlüssel aus seinem Klaviyo-Konto generieren.
⚠️ Nur Benutzer mit API-Schlüssel-Zugriff können sich verbinden
In Klaviyo können nur Benutzer mit der Rolle Owner, Admin oder Manager private API-Schlüssel erstellen. Standardbenutzer (Analyst, Viewer oder benutzerdefinierte Rollen ohne API-Zugriff) können keinen Schlüssel generieren und sich nicht verbinden.
Wenn ein Standardbenutzer eine Verbindung herstellen muss, bitte einen Owner oder Admin in deinem Klaviyo-Konto, in seinem Namen einen privaten API-Schlüssel zu generieren und ihn sicher zu teilen.
Einen privaten Klaviyo-API-Schlüssel generieren
Bevor du dich in Goodweek verbindest, musst du einen privaten API-Schlüssel aus deinem Klaviyo-Konto generieren:
Melde dich bei Klaviyo an.
Gehe zu Einstellungen → Konto → API-Schlüssel.
Scrolle zu Private API-Schlüssel und klicke auf Privaten API-Schlüssel erstellen.
Gib dem Schlüssel einen aussagekräftigen Namen (z. B. Goodweek).
Wähle Benutzerdefinierter Schlüssel und gewähre mindestens Vollzugriff auf die für deinen Anwendungsfall relevanten Bereiche (Profile, Listen, Segmente, Kampagnen, Events, Flows).
Klicke auf Erstellen und kopiere den Schlüssel sofort — Klaviyo zeigt ihn nur einmal an.
Benutzerverbindung
Gehe in Goodweek zu Integrationen.
Suche Klaviyo und klicke auf Verbinden.
Füge deinen privaten Klaviyo-API-Schlüssel in das dafür vorgesehene Feld ein.
Klicke auf Verbinden, um die Einrichtung abzuschließen.
Wichtige Hinweise
Jeder Benutzer muss sich mit seinem eigenen API-Schlüssel verbinden.
Der API-Schlüssel erbt die Berechtigungen des Benutzers, der ihn erstellt hat.
Wenn der API-Schlüssel in Klaviyo widerrufen oder gelöscht wird, funktioniert die Integration nicht mehr. Generiere einen neuen Schlüssel und verbinde dich erneut.
Du kannst den Zugriff von Goodweek jederzeit widerrufen, indem du den API-Schlüssel unter Klaviyo → Einstellungen → Konto → API-Schlüssel → Private API-Schlüssel löschst.
Verfügbare Tools
Tool | Beschreibung | Typ |
Profile abrufen | Ruft eine paginierte Liste von Profilen im Klaviyo-Konto ab. | Lesen |
Profil abrufen | Ruft ein bestimmtes Klaviyo-Profil anhand seiner ID ab. | Lesen |
Profil erstellen | Erstellt ein neues Profil im Klaviyo-Konto. | Schreiben |
Profil aktualisieren | Aktualisiert die Attribute eines bestehenden Klaviyo-Profils. | Schreiben |
Listen abrufen | Ruft alle Listen im Klaviyo-Konto ab. | Lesen |
Liste abrufen | Ruft Details für eine bestimmte Klaviyo-Liste ab. | Lesen |
Liste erstellen | Erstellt eine neue Liste im Klaviyo-Konto. | Schreiben |
Profile zur Liste hinzufügen | Fügt einer Klaviyo-Liste Profile anhand von Profil-IDs oder E-Mail-Adressen hinzu. | Schreiben |
Listenprofile abrufen | Ruft alle Profile ab, die Mitglieder einer bestimmten Klaviyo-Liste sind. | Lesen |
Segmente abrufen | Ruft alle Segmente im Klaviyo-Konto ab. | Lesen |
Segment abrufen | Ruft Details für ein bestimmtes Klaviyo-Segment ab. | Lesen |
Segmentprofile abrufen | Ruft Profile ab, die zu einem bestimmten Klaviyo-Segment gehören. | Lesen |
Kampagnen abrufen | Ruft eine Liste der Kampagnen im Klaviyo-Konto ab. | Lesen |
Kampagne abrufen | Ruft Details für eine bestimmte Klaviyo-Kampagne ab. | Lesen |
Kampagne erstellen | Erstellt eine neue Kampagne in Klaviyo für E-Mail oder SMS. | Schreiben |
Kampagnennachrichtenvorlage zuweisen | Erstellt eine nicht wiederverwendbare Version einer Vorlage und weist sie einer Kampagnennachricht zu. | Schreiben |
Flows abrufen | Ruft alle im Klaviyo-Konto konfigurierten Flows ab. | Lesen |
Flow abrufen | Ruft Details für einen bestimmten Klaviyo-Flow ab. | Lesen |
Flow-Aktionen abrufen | Ruft die Aktionen innerhalb eines bestimmten Klaviyo-Flows ab. | Lesen |
Metriken abrufen | Ruft alle im Klaviyo-Konto verfügbaren Metriken ab. | Lesen |
Metrik abrufen | Ruft Details für eine bestimmte Klaviyo-Metrik ab. | Lesen |
Kundenereignisse als Batch erstellen | Verfolgt Profilaktivitäten durch Erstellen mehrerer Events. | Schreiben |
Vorlagen abrufen | Ruft alle E-Mail-Vorlagen im Klaviyo-Konto ab. | Lesen |
Vorlage abrufen | Ruft eine bestimmte E-Mail-Vorlage ab. | Lesen |
Vorlage erstellen | Erstellt eine neue E-Mail-Vorlage im Klaviyo-Konto. | Schreiben |
Liste löschen | Löscht eine Klaviyo-Liste dauerhaft. | ⚠️ Destruktiv |
Kampagne löschen | Löscht eine Klaviyo-Kampagne dauerhaft. | ⚠️ Destruktiv |
Vorlage löschen | Löscht eine Klaviyo-E-Mail-Vorlage dauerhaft. | ⚠️ Destruktiv |
Anwendungsfälle
Profile bei Bedarf überprüfen und aktualisieren. Rufe bestimmte Profile per E-Mail oder ID ab, überprüfe ihre Attribute und Listenmitgliedschaften und aktualisiere ihre Daten aus Goodweek.
Listen- und Segmentmitgliedschaft prüfen. Rufe die Profile einer bestimmten Liste oder eines Segments aus Goodweek ab, um die Zielgruppenzusammensetzung vor dem Start einer Kampagne zu überprüfen.
Kampagnen- und Flow-Status überprüfen. Rufe Kampagnendetails ab oder überprüfe, welche Flows in deinem Konto aktiv sind, direkt aus einer Goodweek-Unterhaltung.
Events verfolgen und Metriken überwachen. Greife auf Klaviyo-Metriken zu, um zu überprüfen, welche Events verfolgt werden, und nutze diese Daten für Segmentierungs- oder Kampagnenentscheidungen.
Fehlerbehebung
Ich kann keinen API-Schlüssel in Klaviyo generieren
Nur Klaviyo-Benutzer mit den Rollen Owner, Admin oder Manager können private API-Schlüssel erstellen. Wenn du keine dieser Rollen hast, bitte einen Owner oder Admin, einen Schlüssel in deinem Namen zu generieren.
Die Integration funktioniert nach der Verbindung nicht mehr
Der API-Schlüssel wurde möglicherweise in Klaviyo gelöscht oder widerrufen. Gehe zu Klaviyo → Einstellungen → Konto → API-Schlüssel und überprüfe, ob der Schlüssel noch aktiv ist. Falls nicht, generiere einen neuen und verbinde dich erneut in Goodweek.
Integration in Goodweek nicht sichtbar
Stelle sicher, dass der Administrator deiner Organisation die Klaviyo-Integration im Goodweek-Adminbereich unter dem Tab Integrationen aktiviert hat.