Klaviyo

  # Klaviyo Integration

Die Klaviyo-Integration ermöglicht es Ihnen, Ihren Botpress mit Klaviyo zu verbinden, einer führenden Plattform für Kundendaten und Marketing-Automatisierung. Mit dieser Integration kann Ihr Chatbot Leads erstellen, Kundeninformationen aktualisieren und Profile für SMS- und E-Mail-Marketing abonnieren.

## Verfügbare Aktionen

### Profil erstellen

Erstellen Sie ein neues Kundenprofil in Klaviyo. Mit dieser Aktion können Sie Ihrer Klaviyo-Datenbank neue Kontakte mit umfassenden Profilinformationen hinzufügen.

**Erforderliche Felder:**

- Entweder **E-Mail-Adresse** ODER **Telefonnummer** (im E.164 Format wie +15005550006)

**Optionale Felder:**

- **Vorname** und **Nachname**
- **Organisation** und **Stellenbezeichnung**
- **Gebietsschema** (im IETF BCP 47 Format wie en-US, fr-FR)
- **Standort** (Adressangaben einschließlich Adresszeilen, Stadt, Land, Region, Postleitzahl)
- **Benutzerdefinierte Eigenschaften** (Schlüssel-Wert-Paare zur Speicherung zusätzlicher Profildaten)

**Ausgabe:** Gibt das erstellte Profil mit seiner eindeutigen Klaviyo ID zurück.

### Profil aktualisieren

Aktualisiert ein bestehendes Kundenprofil in Klaviyo unter Verwendung der eindeutigen ID des Profils. Diese Aktion ermöglicht es Ihnen, alle Profilinformationen nach der Erstellung zu ändern.

**Erforderliche Felder:**

- **Profil-ID** (die eindeutige Klaviyo-Kennung des zu aktualisierenden Profils)

**Optionale Felder:**

- **E-Mail-Adresse** (aktualisiert die E-Mail des Profils)
- **Telefonnummer** (im E.164 Format)
- **Vorname** und **Nachname**
- **Organisation** und **Stellenbezeichnung**
- **Ortsangabe** (im IETF BCP 47-Format)
- **Standort** (vollständige Adressinformationen)
- **Benutzerdefinierte Eigenschaften** (Schlüssel-Werte-Paare)

**Ausgabe:** Gibt das aktualisierte Profil mit allen aktuellen Informationen zurück.

### Profil abrufen

Ruft ein bestimmtes Kundenprofil von Klaviyo anhand seiner eindeutigen ID ab. Diese Aktion ist nützlich, um individuelle Kundeninformationen abzurufen.

**Erforderliche Felder:**

- **Profil-ID** (die eindeutige Klaviyo-Kennung des abzurufenden Profils)

**Ausgabe:** Gibt die vollständigen Profilinformationen zurück, einschließlich ID, E-Mail, Telefon, Name und alle anderen gespeicherten Daten.

### Profile abrufen

Suche und Abruf mehrerer Kundenprofile von Klaviyo mit Hilfe von Filtern und Sortieroptionen. Diese Aktion ist ideal, um Kundengruppen nach bestimmten Kriterien zu finden.

**Filter Optionen:**

- **Filterfeld:** Wählen Sie aus `id`, `email`, `phone_number`, `external_id`, `created`, oder `updated`
- **Filteroperator:** Verwenden Sie Vergleichsoperatoren wie `gleich`, `enthält`, `größer-als`, `weniger-als`, `beginnt-mit`, `endet-mit`
- **Filterwert:** Der Wert, nach dem gesucht werden soll (unterstützt Zeichenketten und Datumsangaben)

**Paginierung & Sortierung:**

- **Seitengröße:** Anzahl der Profile, die zurückgegeben werden sollen (1-100, Standard: 20)
- **Sortierung:** Sortierung nach einem beliebigen Feld mit optionaler absteigender Reihenfolge (Präfix mit `-`)

**Benutzungsbeispiele:**

- Suche nach allen Profilen, die nach einem bestimmten Datum erstellt wurden
- Suche nach Profilen mit E-Mail-Adressen, die eine Domäne enthalten
- Profile nach Erstellungsdatum sortiert abrufen (neueste zuerst)

**Ausgabe:** Gibt ein Array von Profilen zurück, die Ihren Kriterien entsprechen.

### Profile abonnieren

Abonnieren Sie mehrere Kundenprofile für E-Mail- und/oder SMS-Marketinglisten in Klaviyo. Diese Aktion verarbeitet Abonnements asynchron und kann bis zu 1.000 Profile auf einmal verarbeiten.

**Erforderliche Felder:**

- **Profil-Abonnements:** Array von Profilen mit Zustimmungsinformationen
  - **Profil-ID** (oder E-Mail/Telefon zur Identifizierung)
  - **Email Consent:** Boolesches Kriterium für die Zustimmung zum E-Mail-Marketing
  - SMS-Zustimmung:** Boolesches Zeichen für die Zustimmung zum SMS-Marketing

**Optionale Felder:**

- **Listen-ID:** Spezifische Klaviyo-Liste, zu der abonnierte Profile hinzugefügt werden sollen
- **Historischer Import:** Boolescher Wert für den Import historischer Profile

**Wichtige Hinweise:**

- Maximal 1.000 Profile pro Anfrage
- Mindestens ein Profil ist erforderlich
- Die Zustimmungsflags bestimmen, für welche Marketingkanäle das Profil abonniert werden soll
- Die Operation wird asynchron von Klaviyo verarbeitet

**Ausgabe:** Gibt einen booleschen Erfolgswert zurück, der angibt, ob der Abonnementauftrag erfolgreich geplant wurde.