Verwenden von Klaviyo-Aktionen in Aktionsflüssen

Suite, alle Versionen

Team, Growth, Professional, Enterprise oder Enterprise Plus

Support

Team, Professional oder Enterprise

Zusammenfassung: ◀▼

Sie können Aktionsflüsse per API-Schlüssel mit Klaviyo verbinden, um das Verwalten von Kundenprofilen, Verfolgen von Ereignissen, Auflisten von Abonnements und Erstellen von Kampagnen zu automatisieren. Diese Integration unterstützt das Erstellen, Aktualisieren und Nachschlagen von Profilen, das Verwalten von Listen und Metriken sowie das Managen von Kampagnen. Verwenden Sie ein dediziertes Dienstkonto für sichere Verbindungen und überprüfen Sie Berechtigungen sorgfältig, um die Kontrolle über die Daten und die durch die Integration durchgeführten Aktionen zu gewährleisten.

Durch Verbinden des Aktionsgenerators mit externen Systemen wie Klaviyo können Administratoren Zendesk in automatisierten Workflows mit externen Systemen integrieren, um die Zusammenarbeit zu verbessern und für ein plattformübergreifend einheitliches Erlebnis zu sorgen.

Hinweis: Die mit externen Systemen verknüpften Schritte in Aktionsflüssen werden als externe Aktionen bezeichnet.

In diesem Beitrag werden folgende Themen behandelt:

Verbinden von Klaviyo mit dem Aktionsgenerator
Verwenden von Klaviyo-Aktionen in Aktionsflüssen

Verbinden von Klaviyo mit dem Aktionsgenerator

Bevor Sie externe Aktionen in Aktionsflüsse einbinden können, müssen Sie den Aktionsgenerator mit dem externen System verbinden.

Beachten Sie beim Verbinden mit externen Systemen für die Verwendung in Aktionsflüssen die folgenden Best Practices:

Alle von einem Aktionsfluss ausgeführten externen Aktionen werden dem Benutzer zugeordnet, der das externe System verbunden hat. Deshalb wird empfohlen, für die Verbindung mit einem externen System ein dediziertes Dienstkonto und keine persönlichen Anmeldedaten zu verwenden.
Alle Integrationen fordern den Zugang zu erforderlichen Zugriffsarten an. Sie sollten die Zugriffsarten jedoch unbedingt überprüfen und validieren, bevor Sie die Verbindung zum externen System autorisieren.
Bei der Verwaltung von Anmeldedaten für Tools wie OpenAI, die auf API-Schlüsseln basieren, sollten die Schlüssel nach Möglichkeit in einem sicheren Tresor oder Credential Manager gespeichert werden.

So erstellen Sie einen API-Schlüssel

Für die Authentifizierung der Klaviyo-Verbindung wird ein API-Schlüssel benötigt. Detaillierte Anweisungen finden Sie in der Dokumentation zur Klaviyo-API.

Wichtig: Bewahren Sie Ihren API-Schlüssel sicher auf und geben Sie ihn nicht weiter. Der Schlüssel gewährt Zugriff auf Ihr Klaviyo-Konto und ermöglicht Aktionsflüssen, in Ihrem Namen Operationen auszuführen.

Melden Sie sich bei Ihrem Klaviyo-Konto an.
Gehen Sie zu Einstellungen > API-Schlüssel.
Kopieren Sie den Schlüssel im Format Klaviyo-API-Key {your_key}.
Speichern Sie den API-Schlüssel, oder lassen Sie das Fenster geöffnet, damit Sie den Schlüssel kopieren und in Zendesk einfügen können.
Sie benötigen ihn für die Verbindung von Klaviyo mit dem Aktionsgenerator.

So verbinden Sie den Aktionsgenerator mit Klaviyo

Klicken Sie in der Seitenleiste des Admin Centers auf Apps und Integrationen und dann auf Aktionen > Aktionsflüsse.
Erstellen oder bearbeiten Sie einen Aktionsfluss.
Öffnen Sie die Schritt-Seitenleiste.
Klicken Sie unter Externe Aktionen auf Klaviyo.
Klicken Sie auf Verbinden.
Befolgen Sie die Anweisungen, um Ihren Klaviyo API-Schlüssel einzugeben und den Verbindungsaufbau abzuschließen. Fügen Sie den vollständigen Schlüssel einschließlich Präfix ein.
Beim Autorisieren der Verbindung werden Sie zu Klaviyo weitergeleitet und müssen Ihrem Zendesk-Konto die erforderlichen Berechtigungen erteilen.

Die Klaviyo-Verbindung verwendet OAuth 2.0 mit der Gewährungsart „Autorisierungscode“. Überprüfen Sie die Berechtigungen sorgfältig, bevor Sie die Verbindung autorisieren. Mit diesen Berechtigungen können Aktionsflüsse in Ihrem Namen Seiten erstellen und bearbeiten, Kommentare hinzufügen, Datenbankelemente verwalten und Inhalte in Ihrem Klaviyo-Arbeitsbereich aktualisieren.

Hinweis: Alle von einem Aktionsfluss ausgeführten externen Aktionen werden dem Benutzer zugeordnet, der das externe System verbunden hat. Deshalb wird empfohlen, für die Verbindung mit einem externen System ein dediziertes Dienstkonto und keine persönlichen Anmeldedaten zu verwenden.

Nach dem Verbindungsaufbau sehen Sie eine entsprechende Anzeige sowie Details zur verbundenen Instanz und zu den verfügbaren Klaviyo-Aktionen.

Verwenden von Klaviyo-Aktionen in Aktionsflüssen

Folgende Klaviyo-Aktionen sind verfügbar:

Profil erstellen
Profil aktualisieren
Profil nachschlagen
Ereignis erstellen
Profil für Liste abonnieren
Profil aus Liste entfernen
Liste nachschlagen
Listen auflisten
Liste erstellen
Metrik nachschlagen
Metriken auflisten
Kampagne erstellen
Kampagne nachschlagen
Kampagnen auflisten

Erstellen eines Profils

Mit der Aktion Profil erstellen können Sie in Klaviyo ein neues Kundenprofil mit Kontaktinformationen und Attributen erstellen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Optional: `Email`, `Phone number`, `First name`, `Last name`, `Organization`, `Title`, `Image URL`, `Address line 1`, `Address line 2`, `City`, `Region/State`, `Country`, `Zip/Postal code` Telefonnummern müssen im E.164-Format mit vorangestelltem Pluszeichen (+), der Ländervorwahl und der Teilnehmernummer ohne Leerzeichen oder Sonderzeichen angegeben werden (z. B. +15551234567).
Ausgabe	Gibt ein Objekt mit Profil-ID, E-Mail-Adresse, Telefonnummer, Vorname, Nachname, Organisation, Titel, Bild sowie dem Zeitstempel der Erstellung und der letzten Aktualisierung und ein Standortobjekt (mit Adresse1, Adresse2, Ort, Region, Land und Postleitzahl) zurück.

Aktualisieren eines Profils

Mit der Aktion Profil aktualisieren können Sie in Klaviyo ein vorhandenes Kundenprofil mit neuen Informationen aktualisieren.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `Profile ID` Optional: `Email`, `Phone number`, `First name`, `Last name`, `Organization`, `Title`, `Image URL`, `Address line 1`, `Address line 2`, `City`, `Region/State`, `Country`, `Zip/Postal code` Telefonnummern müssen im E.164-Format mit vorangestelltem Pluszeichen (+), der Ländervorwahl und der Teilnehmernummer ohne Leerzeichen oder Sonderzeichen angegeben werden (z. B. +15551234567).
Ausgabe	Gibt ein Objekt mit Profil-ID, E-Mail-Adresse, Telefonnummer, Vorname, Nachname, Organisation, Titel, Bild sowie dem Zeitstempel der Erstellung und der letzten Aktualisierung und ein Standortobjekt (mit Adresse1, Adresse2, Ort, Region, Land und Postleitzahl) zurück.

Erforderlich: Profile ID

Optional: Email, Phone number, First name, Last name, Organization, Title, Image URL, Address line 1, Address line 2, City, Region/State, Country, Zip/Postal code

Telefonnummern müssen im E.164-Format mit vorangestelltem Pluszeichen (+), der Ländervorwahl und der Teilnehmernummer ohne Leerzeichen oder Sonderzeichen angegeben werden (z. B. +15551234567).

Ausgabe Gibt ein Objekt mit Profil-ID, E-Mail-Adresse, Telefonnummer, Vorname, Nachname, Organisation, Titel, Bild sowie dem Zeitstempel der Erstellung und der letzten Aktualisierung und ein Standortobjekt (mit Adresse1, Adresse2, Ort, Region, Land und Postleitzahl) zurück.

Nachschlagen eines Profils

Mit der Aktion Profil nachschlagen können Sie ein Kundenprofil anhand der ID, der E-Mail-Adresse oder der Telefonnummer abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: `Identity profile by`, `Profile identifier` Sie können Profile über die ID, die E-Mail-Adresse oder die Telefonnummer identifizieren. Das Feld „Profilkennung“ wird nach dem Auswählen der Identifizierungsmethode angezeigt.
Ausgabe	Gibt ein Objekt mit Profil-ID, E-Mail-Adresse, Telefonnummer, Vorname, Nachname, Organisation, Titel, Bild sowie dem Zeitstempel der Erstellung und der letzten Aktualisierung und ein Standortobjekt (mit Adresse1, Adresse2, Ort, Region, Land und Postleitzahl) zurück.

Erstellen eines Ereignisses

Mit der Aktion Ereignis erstellen können Sie in Klaviyo Aktionsflüsse auslösen und Interaktionen messen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `Metric name`, `Profile ID` Optional: `Properties`, `Timestamp` Eigenschaften sollten als Schlüssel-Wert-Paare im JSON-Format angegeben werden. Zeitstempel sollten das ISO-8601-Format aufweisen (z. B. 2025-01-15T14:30:00Z). Ohne Angabe der Uhrzeit wird die aktuelle Uhrzeit verwendet.
Ausgabe	Gibt ein Objekt mit dem Metriknamen, der Profil-ID und dem Eigenschaftenobjekt zurück.

Erforderlich: Metric name,

Profile
                                            ID

Optional: Properties, Timestamp

Eigenschaften sollten als Schlüssel-Wert-Paare im JSON-Format angegeben werden. Zeitstempel sollten das ISO-8601-Format aufweisen (z. B. 2025-01-15T14:30:00Z). Ohne Angabe der Uhrzeit wird die aktuelle Uhrzeit verwendet.

Ausgabe Gibt ein Objekt mit dem Metriknamen, der Profil-ID und dem Eigenschaftenobjekt zurück.

Abonnieren eines Profils für eine Liste

Mit der Aktion Profil für Liste abonnieren können Sie ein Profil mit optionalen Einstellungen für das E-Mail- und SMS-Einverständnis zu einer Liste hinzufügen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `List` Optional: `Email`, `Phone number`, `Profile ID`, `Email consent`, `SMS consent` Telefonnummern müssen im E.164-Format eingegeben werden. Die möglichen Optionen für das E-Mail- und das SMS-Einverständnis lauten „Ja – E-Mail/SMS abonnieren“ (SUBSCRIBED) oder „Nein, E-Mail/SMS nicht abonnieren“ (NONE).
Ausgabe	Gibt ein Objekt mit dem Erfolgsstatus (Boolescher Wert) und einer Nachricht zurück.

Erforderlich: List

Optional: Email, Phone number, Profile ID, Email consent, SMS consent

Telefonnummern müssen im E.164-Format eingegeben werden. Die möglichen Optionen für das E-Mail- und das SMS-Einverständnis lauten „Ja – E-Mail/SMS abonnieren“ (SUBSCRIBED) oder „Nein, E-Mail/SMS nicht abonnieren“ (NONE).

Ausgabe Gibt ein Objekt mit dem Erfolgsstatus (Boolescher Wert) und einer Nachricht zurück.

Entfernen eines Profils aus einer Liste

Mit der Aktion Profil aus Liste entfernen können Sie in Klaviyo ein Profil aus einer Liste entfernen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: `List`, `Profile ID`
Ausgabe	Gibt ein Objekt mit dem Erfolgsstatus (Boolescher Wert) und einer Nachricht zurück.

Nachschlagen einer Liste

Mit der Aktion Liste nachschlagen können Sie Details zu einer bestimmten Liste anhand ihrer ID oder ihres Namens abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: `Identify list by`, `List identifier` Sie können Listen über ID oder den Namen identifizieren. Das Feld „Listenkennung“ wird nach dem Auswählen der Identifizierungsmethode angezeigt.
Ausgabe	Gibt ein Objekt mit der Listen-ID, dem Namen der Liste, dem Zeitstempel der Erstellung und der letzten Aktualisierung sowie dem Opt-in-Prozess zurück.

Auflisten von Listen

Mit der Aktion Listen auflisten können Sie in Klaviyo alle Listen abrufen und die Liste bei Bedarf nach Namen filtern und paginieren.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Optional: `Name`, `Page cursor`
Ausgabe	Gibt ein Objekt mit einem Array von Listen (jeweils mit ID, Name, Zeitstempel der Erstellung und der letzten Aktualisierung sowie Opt-in-Prozess) und den Nächste-Seite-Cursor für die Paginierung zurück.

Erstellen von Listen

Mit der Aktion Liste erstellen können Sie in Klaviyo eine neue Liste zum Organisieren von Profilen erstellen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: `Name`
Ausgabe	Gibt ein Objekt mit der Listen-ID, dem Namen der Liste, dem Zeitstempel der Erstellung und der letzten Aktualisierung sowie dem Opt-in-Prozess zurück.

Nachschlagen einer Metrik

Mit der Aktion Metrik nachschlagen können Sie Details zu einer bestimmten Metrik anhand ihrer ID abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Erforderlich: `Metric ID`
Ausgabe	Gibt ein Objekt mit der Metrik-ID, dem Namen und dem Zeitstempel der Erstellung und der Aktualisierung sowie das Integrationsobjekt (mit ID, Name und Kategorie) zurück.

Auflisten von Metriken

Mit der Aktion Metriken auflisten können Sie in Klaviyo alle Metriken abrufen und die Liste bei Bedarf filtern und paginieren. Verwenden Sie diese Aktion, um verfügbare Ereignismetriken zur Verfolgung des Kundenverhaltens zu untersuchen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

	Variablen
Eingaben	Optional: `Integration name`, `Integration category`, `Page cursor`
Ausgabe	Gibt ein Objekt mit einem Array von Metriken (jeweils mit ID, Name, Zeitstempel der Erstellung und der letzten Aktualisierung sowie Integrationsobjekt mit ID, Name und Kategorie) und den Nächste-Seite-Cursor für die Paginierung zurück.

Erstellen von Kampagnen

Mit der Aktion Kampagne erstellen können Sie in Klaviyo eine neue Marketingkampagne für den E-Mail- oder den SMS-Kanal erstellen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `Name`, `List`, `Channel`, `Send strategy` Optional: `Subject`, `Preview text`, `From email`, `From name`, `Reply-to email` Mögliche Kanäle: E-Mail oder SMS. Optionen für die Versandstrategie sind „Sofort“, „Geplant (statisch)“, „Gedrosselt“ oder „Intelligenter Versandzeitpunkt“. Bei E-Mail-Kampagnen muss die Betreffzeile angegeben werden.
Ausgabe	Gibt ein Objekt mit der Kampagnen-ID, dem Namen, dem Status, dem Kanal, dem Zeitstempel der Erstellung und der letzten Aktualisierung sowie dem Versandzeitpunkt zurück.

Erforderlich: Name, List, Channel, Send strategy

Optional: Subject, Preview text, From email, From name, Reply-to email

Mögliche Kanäle: E-Mail oder SMS.

Optionen für die Versandstrategie sind „Sofort“, „Geplant (statisch)“, „Gedrosselt“ oder „Intelligenter Versandzeitpunkt“. Bei E-Mail-Kampagnen muss die Betreffzeile angegeben werden.

Ausgabe Gibt ein Objekt mit der Kampagnen-ID, dem Namen, dem Status, dem Kanal, dem Zeitstempel der Erstellung und der letzten Aktualisierung sowie dem Versandzeitpunkt zurück.

Nachschlagen einer Kampagne

Mit der Aktion Kampagne nachschlagen können Sie Details zu einer bestimmten Kampagne anhand ihrer ID oder ihres Namens abrufen.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `Identify campaign by`, `Campaign identifier` Bei einer Suche mit dem Kriterium „Name (enthält)“ wird der erste Treffer zurückgegeben. Das Feld „Kampagnenkennung“ wird nach dem Auswählen der Identifizierungsmethode angezeigt.
Ausgabe	Gibt ein Objekt mit der Kampagnen-ID, dem Namen, dem Status, dem Kanal, dem Zeitstempel der Erstellung und der letzten Aktualisierung, dem Versandzeitpunkt und dem Archivierungsstatus (Boolescher Wert) zurück.

Erforderlich: Identify campaign by, Campaign identifier

Bei einer Suche mit dem Kriterium „Name (enthält)“ wird der erste Treffer zurückgegeben.

Das Feld „Kampagnenkennung“ wird nach dem Auswählen der Identifizierungsmethode angezeigt.

Ausgabe Gibt ein Objekt mit der Kampagnen-ID, dem Namen, dem Status, dem Kanal, dem Zeitstempel der Erstellung und der letzten Aktualisierung, dem Versandzeitpunkt und dem Archivierungsstatus (Boolescher Wert) zurück.

Auflisten von Kampagnen

Mit der Aktion Kampagnen auflisten können Sie in Klaviyo Kampagnen abrufen und die Liste bei Bedarf filtern und paginieren.

Diese Aktion weist die folgenden Eingaben und Ausgaben auf:

Variablen

Eingaben

	Variablen
Eingaben	Erforderlich: `Channel` Optional: `Name`, `Status`, `Archived`, `Page cursor` Die möglichen Statusoptionen sind „Entwurf“, „Geplant“, „Gesendet“ oder „Abgebrochen“. Der Filter „Archiviert“ akzeptiert die Werte „Ja“ und „Nein“.
Ausgabe	Gibt ein Objekt mit einem Array von Kampagnen (jeweils mit ID, Name, Status, Kanal, Zeitstempel der Erstellung und der letzten Aktualisierung sowie Versandzeitpunkt und Archivierungsstatus) und den Nächste-Seite-Cursor für die Paginierung zurück.

Erforderlich: Channel

Optional: Name, Status, Archived, Page cursor

Die möglichen Statusoptionen sind „Entwurf“, „Geplant“, „Gesendet“ oder „Abgebrochen“.

Der Filter „Archiviert“ akzeptiert die Werte „Ja“ und „Nein“.

Ausgabe Gibt ein Objekt mit einem Array von Kampagnen (jeweils mit ID, Name, Status, Kanal, Zeitstempel der Erstellung und der letzten Aktualisierung sowie Versandzeitpunkt und Archivierungsstatus) und den Nächste-Seite-Cursor für die Paginierung zurück.