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.

  1. Integration starten:
  • Klicke im Integrationsbereich auf den Button "Integration starten", um den Prozess zu starten.
  1. 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.
  1. 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 Metrics

Die 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.

  1. Um einen Kommunikations Flow in Klaviyo mit Hilfe von Metriken zu erstellen, rufe den Flow Builder in Klaviyo auf.
  2. Klicke auf die Komponente „ Metric“ im Bereich „ All triggers“.
  3. Wähle die Metrik aus (d.h.: PAQATO Trigger-Ereignis), um den Kommunikationsfluss auszulösen, und klicke dann auf „ Fertig“.
  4. Ziehe die Aktion (z. B. E-Mail), die nach Auslösung des Ereignisses erfolgen soll, per Drag & Drop.
  5. 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

FeldTypBeschreibung
uuidstringEindeutige ID des Dokuments
fileNamestringDateiname
mimeTypestringMIME-Type, z. B. application/pdf
typestringDokumenttyp (z.B. returnLabel, qrCode)
temporaryUrlstringTemporä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

KlaviyoPAQATO Event
Zustellung erfolgreich
PAQATO:SHIPMENT:DELIVERED_TO_RECEIVERZugestellt an Empfänger
PAQATO:SHIPMENT:DELIVERED_TO_SPOUSEAn Ehepartner übergeben
PAQATO:SHIPMENT:DELIVERED_TO_FAMILY_MEMBERAn Familienmitglied übergeben
PAQATO:SHIPMENT:DELIVERED_TO_NEIGHBOURAn Nachbarn übergeben
PAQATO:SHIPMENT:DELIVERED_TO_THIRD_PARTYAn Dritte übergeben
PAQATO:SHIPMENT:DELIVERED_TO_SECURE_LOCATIONAn gesichertem Ort abgelegt
Zustellung fehlgeschlagen
PAQATO:SHIPMENT:INCORRECT_ADDRESSAdresse fehlerhaft
PAQATO:SHIPMENT:UNKNOWN_RECEIVEREmpfänger nicht bekannt
PAQATO:SHIPMENT:RECEIVER_MOVED_ADDRESS_UNKNOWNEmpfänger unbekannt verzogen
PAQATO:SHIPMENT:DELIVERY_ATTEMPT_NOT_SUCCESSFULZustellversuch 1 nicht erfolgreich
PAQATO:SHIPMENT:SECOND_DELIVERY_ATTEMPT_NOT_SUCCESSFULZustellversuch 2 nicht erfolgreich
PAQATO:SHIPMENT:THIRD_DELIVERY_ATTEMPT_NOT_SUCCESSFULZustellversuch 3 nicht erfolgreich
PAQATO:SHIPMENT:FOURTH_DELIVERY_ATTEMPT_NOT_SUCCESSFULZustellversuch 4 nicht erfolgreich
PAQATO:SHIPMENT:NOT_PICKED_UPNicht abgeholt
Ablehnung der Annahme
PAQATO:SHIPMENT:NO_ACCPETANCE_OF_GOODSKeine Warenannahme
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_WITHOUT_JUSTIFICATIONAnnahme verweigert, ohne Begründung
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_NOT_ORDEREDAnnahme verweigert, nicht bestellt
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_DAMAGEDAnnahme verweigert, Ware beschädigt
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_TRANSPORT_UNITAnnahme verweigert, Transporteinheit
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_SWAP_BODYAnnahme verweigert, Wechselbehälter
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_INCOMPLETEAnnahme verweigert, Unvollständig
PAQATO:SHIPMENT:ACCEPTANCE_REFUSED_DELIVERY_DATEAnnahme verweigert, Liefertermin
Paket- & Abwicklungsprobleme
PAQATO:SHIPMENT:PACKAGE_DAMAGEDSendung beschädigt
PAQATO:SHIPMENT:PACKAGE_MISROUTEDSendung fehlgeleitet
PAQATO:SHIPMENT:IDENTITY_CHECK_FAILEDIdentitätsprüfung fehlgeschlagen
PAQATO:SHIPMENT:CUSTOM_DUTIESZollgebühren
PAQATO:SHIPMENT:INEXPLICABLE_OBSTACLE_TO_TRANSPORTUnklärbares Beförderungshindernis
PAQATO:SHIPMENT:DELIVERY_VEHICLE_FULLZustellfahrzeug voll
PAQATO:SHIPMENT:FORCE_MAEJURE_DELAYVerzögerung durch höhere Gewalt
Abhol- & Lagerstatus
PAQATO:SHIPMENT:STORED_IN_PARCEL_STATIONIn Packstation abgelegt
PAQATO:SHIPMENT:STORED_IN_POST_OFFICEIn Filiale abgegeben
PAQATO:SHIPMENT:PARCEL_STATION_FULL_MAIN_POST_OFFICEZustellung in Hauspoststelle, Paketstation voll
PAQATO:SHIPMENT:PARCEL_STATION_FULL_POST_OFFICEZustellung in der Filiale, Paketstation voll
PAQATO:SHIPMENT:PARCEL_STATION_FULL_NO_DELIVERYPackstation voll, keine Zustellung
PAQATO:SHIPMENT:FIRST_DELIVERY_ATTEMPT_NOT_SUCCESSFUL_BROUGHT_TO_POST_OFFICEZustellversuch 1 nicht erfolgreich, Ablieferung in Filiale
PAQATO:SHIPMENT:FIRST_DELIVERY_ATTEMPT_NOT_SUCCESSFUL_BROUGHT_TO_PARCEL_STATIONZustellversuch 1 nicht erfolgreich, Ablieferung in Paketstation
PAQATO:SHIPMENT:REMINDER_TO_PICK_UPErinnerung an Abholung
Rücksendungen & Retouren
PAQATO:SHIPMENT:RETURN_SHIPPEDRetoure aufgegeben
PAQATO.SHIPMENT:RETURN_ARRIVEDRetoure angekommen
PAQATO:SHIPMENT:RESHIPMENT_INITIATEDRetoure ausgelöst (von Versanddienstleister, bevor die Ware beim Kunden zugestellt wurde)
Sonstige Statusmeldungen
PAQATO:SHIPMENT:CONFIRMATION_OF_SHIPPINGVersandbestätigung
PAQATO:SHIPMENT:PACKAGE_ANNOUNCEMENTSendungsankündigung
PAQATO:SHIPMENT:FIRST_SCAN_SUCCESSFULEingangs-Scan erfolgt
PAQATO:SHIPMENT:FIRST_SCAN_MISSINGEingangs-Scan fehlt
PAQATO:SHIPMENT:IN_DELIVERY_VEHICLEIm Zustellfahrzeug
PAQATO:SHIPMENT:IN_DELIVERY_VEHICLE_NEXT_WORKDAY_DELIVERYIm Zustellfahrzeug - Zustellung am nächsten Werktag
PAQATO:SHIPMENT:FIRST_RATING_REQUEST_AFTER_DELIVERYBewertungsanfrage nach Zustellung
PAQATO:SHIPMENT:SECOND_RATING_REQUEST_AFTER_DELIVERYZweite Bewertungsanfrage nach Zustellung
PAQATO:SHIPMENT:FIRST_RATING_REQUEST_AFTER_RETURN_DELIVERYBewertungsanfrage nach abgeschlossener Retoure
Pre-shipement (order) Events
PAQATO:ORDER:PQTORCRetourenlabel erstellt
PAQATO:ORDER: TOKENAlle anderen Bestellereignisse sind mit dem entsprechenden Token versehen


Did this page help you?