Klaviyo

Einführung
PAQATO bietet eine Integration mit Klaviyo an. Dies ermöglicht den Versand von After-Sales Benachrichtigungen inklusive Retourenupdates über die Klaviyo-Plattform. Dadurch können Kommunikationsflows in Klaviyo erstellt, mit Bestell- und Kundeninformationen angereichert und an die Endkunden rausgesendet werden. Um die Integration zu Klaviyo zu buchen, gehe auf den Integrationsbereich der PAQATO WebApp auf den Reiter "verfügbare Integrationen".
Voraussetzungen
- Du hast ein aktives Konto bei PAQATO und Klaviyo
Einrichtung
Sobald du das Klaviyo Add-On gebucht hast, kannst du die Verbindung via OAuth herstellen. Die Einrichtung dauert nur wenige Minuten. Voraussetzung dafür ist, dass die Berechtigung für die "Konfiguration Klaviyo Integration" im Benutzer- & Rollenmanagement gegeben ist.
- Integration starten:
- Klicke im Integrationsbereich auf den Button "Integration starten", um den Prozess zu starten.
- Bei Klaviyo einloggen und Zugriff gewähren:
- Du wirst zu Klaviyo weitergeleitet. Falls du noch nicht eingeloggt bist, melde dich bitte bei deinem Klaviyo-Konto an.
- Anschließend erscheinen zwei Bildschirme, auf denen du die Verbindung autorisieren musst. Klicke zuerst auf "Continue" und danach auf "Allow", um PAQATO den Zugriff auf dein Klaviyo-Konto zu geben.
- Shops zuordnen:
- Nachdem du den Zugriff gewährt hast, findest du die Klaviyo-Integration im Bereich "Aktive Integrationen".
- Als letzten Schritt musst du nur noch die entsprechenden PAQATO-Shops der Integration zuordnen.
Hinweis: Ab jetzt werden PAQATO-Ereignisse an Klaviyo gesendet, sobald sie in PAQATO ausgelöst werden. Beachte, dass die Ereignisse (Metrics) erst in deiner Liste in Klaviyo sichtbar werden, nachdem das erste Ereignis dorthin gesendet wurde.
Einen weiteren Shop verbinden Möchtest du einen weiteren Shop mit einem anderen Klaviyo-Konto verbinden, wiederhole die Schritte einfach. Achte dabei darauf, dich zuerst im gewünschten Klaviyo-Konto anzumelden und im letzten Schritt einen anderen PAQATO-Shop auszuwählen.

Kommunikations-Flows in Klaviyo einrichten
Events and MetricsDie Trigger-Ereignisse von PAQATO werden in der Klaviyo-Plattform als Metriken bezeichnet.
Du kannst Flows für deine After Sales-Kommunikation in Klaviyo erstellen, indem du die Trigger-Ereignisse von PAQATO verwendest.
- Um einen Kommunikations Flow in Klaviyo mit Hilfe von Metriken zu erstellen, rufe den Flow Builder in Klaviyo auf.
- Klicke auf die Komponente „ Metric“ im Bereich „ All triggers“.
- Wähle die Metrik aus (d.h.: PAQATO Trigger-Ereignis), um den Kommunikationsfluss auszulösen, und klicke dann auf „ Fertig“.
- Ziehe die Aktion (z. B. E-Mail), die nach Auslösung des Ereignisses erfolgen soll, per Drag & Drop.
- Wenn du die gewünschten Aktionen hinzugefügt hast, klicke auf Beenden.
Variablen für die Kommunikations-Flows
Mit jedem Event werden alle relevanten Variablen von PAQATO an Klaviyo übergeben. Diese Variablen können genutzt werden, um Segemente zu erstellen oder Variabeln in die E-Mails einzubauen.
Und so müssen unsere Variabeln in die Klaviyo Mails eingebaut werden
Beispiel “orderNumber”
event.extra.orderNumber (es muss immer “event.extra.” davor gesetzt werden)
Beispiel für Trackinglink in Klaviyo:
https://shopname.de/sendungsverfolgung?tracking-code={{ event.extra.language }}~{{ event.extra.trackingCode }}~{{ event.extra.recipient.zipCode }}~{{ event.extra.orderNumber }}
Retourendokumente (returnDocuments)
returnDocuments ist eine Liste von Dokumenten zur Bestellung (z.B. Retourenlabel). Diese ist auf den Objekten order, shipment und shipmentState verfügbar. Da es sich um eine Liste handelt, muss über die Einträge iteriert werden.
Felder eines Listeneintrags
| Feld | Typ | Beschreibung |
|---|---|---|
| uuid | string | Eindeutige ID des Dokuments |
| fileName | string | Dateiname |
| mimeType | string | MIME-Type, z. B. application/pdf |
| type | string | Dokumenttyp (z.B. returnLabel, qrCode) |
| temporaryUrl | string | Temporärer Download-Link (Standard-Gültigkeit: 24 Stunden) |
Beispiel Twig
Um die Dokumente in einem Klaviyo-Template (via Twig) anzuzeigen, kann folgender Code verwendet werden:
{% if returnDocuments|length > 0 %}
<ul>
{% for document in returnDocuments %}
<li>
<a href="{{ document.temporaryUrl }}"
data-uuid="{{ document.uuid }}"
data-type="{{ document.type }}"
{% if document.mimeType %}type="{{ document.mimeType }}"{% endif %}>
{{ document.fileName }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
Liste an Events
| Klaviyo | PAQATO Event |
|---|---|
| Zustellung erfolgreich | |
| PAQATO:SHIPMENT:DELIVERED_TO_RECEIVER | Zugestellt an Empfänger |
| PAQATO:SHIPMENT:DELIVERED_TO_SPOUSE | An Ehepartner übergeben |
| PAQATO:SHIPMENT:DELIVERED_TO_FAMILY_MEMBER | An Familienmitglied übergeben |
| PAQATO:SHIPMENT:DELIVERED_TO_NEIGHBOUR | An Nachbarn übergeben |
| PAQATO:SHIPMENT:DELIVERED_TO_THIRD_PARTY | An Dritte übergeben |
| PAQATO:SHIPMENT:DELIVERED_TO_SECURE_LOCATION | An gesichertem Ort abgelegt |
| Zustellung fehlgeschlagen | |
| PAQATO:SHIPMENT:INCORRECT_ADDRESS | Adresse fehlerhaft |
| PAQATO:SHIPMENT:UNKNOWN_RECEIVER | Empfänger nicht bekannt |
| PAQATO:SHIPMENT:RECEIVER_MOVED_ADDRESS_UNKNOWN | Empfänger unbekannt verzogen |
| PAQATO:SHIPMENT:DELIVERY_ATTEMPT_NOT_SUCCESSFUL | Zustellversuch 1 nicht erfolgreich |
| PAQATO:SHIPMENT:SECOND_DELIVERY_ATTEMPT_NOT_SUCCESSFUL | Zustellversuch 2 nicht erfolgreich |
| PAQATO:SHIPMENT:THIRD_DELIVERY_ATTEMPT_NOT_SUCCESSFUL | Zustellversuch 3 nicht erfolgreich |
| PAQATO:SHIPMENT:FOURTH_DELIVERY_ATTEMPT_NOT_SUCCESSFUL | Zustellversuch 4 nicht erfolgreich |
| PAQATO:SHIPMENT:NOT_PICKED_UP | Nicht abgeholt |
| Ablehnung der Annahme | |
| PAQATO:SHIPMENT:NO_ACCPETANCE_OF_GOODS | Keine Warenannahme |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_WITHOUT_JUSTIFICATION | Annahme verweigert, ohne Begründung |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_NOT_ORDERED | Annahme verweigert, nicht bestellt |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_DAMAGED | Annahme verweigert, Ware beschädigt |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_TRANSPORT_UNIT | Annahme verweigert, Transporteinheit |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_SWAP_BODY | Annahme verweigert, Wechselbehälter |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_INCOMPLETE | Annahme verweigert, Unvollständig |
| PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_DELIVERY_DATE | Annahme verweigert, Liefertermin |
| Paket- & Abwicklungsprobleme | |
| PAQATO:SHIPMENT:PACKAGE_DAMAGED | Sendung beschädigt |
| PAQATO:SHIPMENT:PACKAGE_MISROUTED | Sendung fehlgeleitet |
| PAQATO:SHIPMENT:IDENTITY_CHECK_FAILED | Identitätsprüfung fehlgeschlagen |
| PAQATO:SHIPMENT:CUSTOM_DUTIES | Zollgebühren |
| PAQATO:SHIPMENT:INEXPLICABLE_OBSTACLE_TO_TRANSPORT | Unklärbares Beförderungshindernis |
| PAQATO:SHIPMENT:DELIVERY_VEHICLE_FULL | Zustellfahrzeug voll |
| PAQATO:SHIPMENT:FORCE_MAEJURE_DELAY | Verzögerung durch höhere Gewalt |
| Abhol- & Lagerstatus | |
| PAQATO:SHIPMENT:STORED_IN_PARCEL_STATION | In Packstation abgelegt |
| PAQATO:SHIPMENT:STORED_IN_POST_OFFICE | In Filiale abgegeben |
| PAQATO:SHIPMENT:PARCEL_STATION_FULL_MAIN_POST_OFFICE | Zustellung in Hauspoststelle, Paketstation voll |
| PAQATO:SHIPMENT:PARCEL_STATION_FULL_POST_OFFICE | Zustellung in der Filiale, Paketstation voll |
| PAQATO:SHIPMENT:PARCEL_STATION_FULL_NO_DELIVERY | Packstation voll, keine Zustellung |
| PAQATO:SHIPMENT:FIRST_DELIVERY_ATTEMPT_NOT_SUCCESSFUL_BROUGHT_TO_POST_OFFICE | Zustellversuch 1 nicht erfolgreich, Ablieferung in Filiale |
| PAQATO:SHIPMENT:FIRST_DELIVERY_ATTEMPT_NOT_SUCCESSFUL_BROUGHT_TO_PARCEL_STATION | Zustellversuch 1 nicht erfolgreich, Ablieferung in Paketstation |
| PAQATO:SHIPMENT:REMINDER_TO_PICK_UP | Erinnerung an Abholung |
| Rücksendungen & Retouren | |
| PAQATO:SHIPMENT:RETURN_SHIPPED | Retoure aufgegeben |
| PAQATO.SHIPMENT:RETURN_ARRIVED | Retoure angekommen |
| PAQATO:SHIPMENT:RESHIPMENT_INITIATED | Retoure ausgelöst (von Versanddienstleister, bevor die Ware beim Kunden zugestellt wurde) |
| Sonstige Statusmeldungen | |
| PAQATO:SHIPMENT:CONFIRMATION_OF_SHIPPING | Versandbestätigung |
| PAQATO:SHIPMENT:PACKAGE_ANNOUNCEMENT | Sendungsankündigung |
| PAQATO:SHIPMENT:FIRST_SCAN_SUCCESSFUL | Eingangs-Scan erfolgt |
| PAQATO:SHIPMENT:FIRST_SCAN_MISSING | Eingangs-Scan fehlt |
| PAQATO:SHIPMENT:IN_DELIVERY_VEHICLE | Im Zustellfahrzeug |
| PAQATO:SHIPMENT:IN_DELIVERY_VEHICLE_NEXT_WORKDAY_DELIVERY | Im Zustellfahrzeug - Zustellung am nächsten Werktag |
| PAQATO:SHIPMENT:FIRST_RATING_REQUEST_AFTER_DELIVERY | Bewertungsanfrage nach Zustellung |
| PAQATO:SHIPMENT:SECOND_RATING_REQUEST_AFTER_DELIVERY | Zweite Bewertungsanfrage nach Zustellung |
| PAQATO:SHIPMENT:FIRST_RATING_REQUEST_AFTER_RETURN_DELIVERY | Bewertungsanfrage nach abgeschlossener Retoure |
| Pre-shipement (order) Events | |
| PAQATO:ORDER:PQTORC | Retourenlabel erstellt |
| PAQATO:ORDER: TOKEN | Alle anderen Bestellereignisse sind mit dem entsprechenden Token versehen |
Updated 4 months ago
