· 3 min · TextMeFlow Team

Klaviyo-WhatsApp-Integration: Nachrichten aus Flows senden

Klaviyo-Flows wissen genau, wann ein Kunde seinen Warenkorb abgebrochen, eine Bestellung aufgegeben oder 60 Tage lang nichts getan hat. Dafür sind Flow-Trigger da. Die Nachrichten selbst gehen aber nur per E-Mail oder, in höheren Tarifen, per Klaviyo-SMS raus. Beide werden nicht so schnell geöffnet wie WhatsApp. Wenn die Kunden deines Shops in einem Markt sitzen, in dem WhatsApp der Standardkanal ist, ist ein Flow-Schritt über WhatsApp (statt oder neben E-Mail) eine kleine Ergänzung: eine Webhook-Aktion und ein Empfänger, der die Messages-API von TextMeFlow aufruft.

Das unterscheidet sich vom direkten Anbinden von Shopify- oder WooCommerce-Bestell-Webhooks: Hier erledigt Klaviyo bereits Segmentierung und Timing (Wartezeiten, Flow-Filter, A/B-Splits), und du gibst ihm nur einen WhatsApp-Ausgang zusätzlich zu E-Mail/SMS.

Klaviyos eigener WhatsApp-Kanal oder ein Webhook an deine eigene Nummer?

Klaviyo ergänzt WhatsApp als nativen Kanal auf Basis von Metas WhatsApp Business Platform. Ob er für dein Konto verfügbar ist, hängt von Tarif und Region ab; sieh dazu in Klaviyos eigener Dokumentation nach. Ist er verfügbar, lohnt es sich zu wissen, was jeder Weg bedeutet, bevor du etwas baust:

Klaviyos natives WhatsApp Klaviyo-Webhook → TextMeFlow
Absendernummer Eine auf der WhatsApp Business Platform registrierte Nummer Deine bestehende WhatsApp-Nummer, verknüpft per QR-Code-Scan
Inhalt Von dir gestartete Nachrichten nutzen von Meta genehmigte Templates Der Text, den dein Empfänger baut; keine Template-Freigabe
Kosten Klaviyo-Preis plus Metas Gebühren pro Nachricht Dein TextMeFlow-Tarif; kostenlos für 50 Nachrichten pro Monat
Einrichtung Unternehmensverifizierung bei Meta und Template-Prüfung Eine Webhook-Aktion und ein kleiner Empfänger
Ideal für Große Marketingkampagnen mit Metas offiziellen Tools Transaktions- und Flow-Nachrichten in Shop-Größe, von der Nummer, die Kunden schon kennen

Der Webhook-Weg ist kein Trick, um WhatsApps Regeln zu umgehen: Du brauchst weiterhin ein Opt-in, und TextMeFlow wendet auf jeden Versand Rate Limits und eine Risikoprüfung an, damit sich eine verknüpfte Nummer wie eine Person verhält und nicht wie ein Massenversender. Für einen Shop, der Warenkorb- und Bestellnachrichten an Kunden schickt, die darum gebeten haben, ist das selten eine Einschränkung.

Schritt 1: Webhook-Aktion zum Flow hinzufügen

Öffne in Klaviyo den Flow (Abandoned Cart, Order Confirmation, Win-back, was auch immer ihn auslöst) und füge dort, wo die WhatsApp-Nachricht rausgehen soll, eine Webhook-Aktion hinzu, meist statt oder parallel zu einem E-Mail-Schritt. Mit der Webhook-Aktion von Klaviyo kannst du:

  • Die Endpunkt-URL (deinen Empfänger) festlegen
  • POST und einen JSON-Body wählen
  • Profil- und Event-Eigenschaften mit der Templating-Syntax von Klaviyo in die Payload einfügen

Baue die Payload nur mit dem, was du brauchst:

{
  "phone": "{{ person|lookup:'phone_number' }}",
  "first_name": "{{ person|lookup:'first_name' }}",
  "cart_url": "{{ event|lookup:'$ecommerce.abandoned_checkout_url' }}",
  "cart_total": "{{ event|lookup:'$value' }}"
}

Die genauen Eigenschaftsnamen hängen vom Event ab, das den Flow auslöst. Schau dir vor dem Livegang das „Preview“-Panel im Webhook-Schritt von Klaviyo an, um die echten Werte zu sehen.

Schritt 2: Den Webhook absichern

In Klaviyo kannst du der Webhook-Aktion eigene Header hinzufügen. Füge ein statisches Bearer-Token hinzu:

Authorization: Bearer <a long random secret you generate yourself>

Dein Empfänger prüft diesen Header bei jeder Anfrage und weist alles ab, was nicht passt. Nur das hindert andere daran, gefälschte Bestellungen an deinen Endpunkt zu POSTen, denn Klaviyo signiert diese Payloads nicht selbst.

Schritt 3: Empfänger, der TextMeFlow aufruft

<?php
$auth = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
if ($auth !== 'Bearer ' . getenv('KLAVIYO_WEBHOOK_SECRET')) {
    http_response_code(401);
    exit;
}

$data = json_decode(file_get_contents('php://input'), true);
$phone = trim((string) ($data['phone'] ?? ''));

// TextMeFlow akzeptiert +32 470 12 34 56, 0032470123456 und 32470123456.
// Eine nationale Nummer (0470 12 34 56) hat keine Vorwahl: überspringen.
if ($phone === '' || preg_match('/^0(?!0)/', $phone)) {
    http_response_code(200); // nothing to retry, just skip
    exit;
}

$text = sprintf(
    "Hallo %s, du hast etwas in deinem Warenkorb vergessen (%s). Schließe deine Bestellung ab: %s",
    $data['first_name'] ?? 'du',
    $data['cart_total'] ?? '',
    $data['cart_url'] ?? ''
);

$ch = curl_init('https://api.textmeflow.eu/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TEXTMEFLOW_TOKEN'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['to' => $phone, 'text' => $text]),
    CURLOPT_RETURNTRANSFER => true,
]);
curl_exec($ch);
http_response_code(200);

Der Aufbau ist in Node oder Python derselbe. Die PHP-, Python- und Node-Beispiele findest du direkt dort.

Schritt 4: Das Telefonnummernformat ist die häufigste Fehlerquelle

Klaviyo-Profile speichern Telefonnummern so, wie das Checkout- oder Anmeldeformular sie erfasst hat: mit Leerzeichen, Bindestrichen, einem 00-Präfix oder manchmal einer führenden 0 statt Ländervorwahl. Das meiste räumt TextMeFlow selbst auf: Leerzeichen, Bindestriche, Punkte und Klammern werden entfernt, aus 0049151… wird +49151…, und eine Nummer, die mit der Ländervorwahl, aber ohne + beginnt (49151…), bekommt das + ergänzt. Nicht lösbar ist eine nationale Nummer wie 0151 2345678: Ohne Ländervorwahl weiß niemand, zu welchem Land sie gehört, also antwortet die API mit 422 und "error": "invalid_recipient". Versuche nicht, in deinem Empfänger eine Ländervorwahl zu erraten. Überspringe diese Profile (der Empfänger oben tut das) und behebe das Problem im Erfassungsformular, zum Beispiel mit einer Länderauswahl am Telefonfeld, statt es später zu kaschieren.

Schritt 5: Nicht doppelt senden, was der Flow ohnehin schickt

Wenn der Flow weiterhin auch E-Mails verschickt, entscheide pro Flow einmal, welcher Kanal der primäre ist, statt jedes Mal beide zu senden. Ein gängiges Muster: zuerst WhatsApp (schnellste Öffnung), mit dem ursprünglichen E-Mail-Schritt weiter hinten im Flow als Fallback, nur für Profile ohne gültige Telefonnummer. Verzweige dafür mit einem Flow-Filter auf die Telefoneigenschaft.

Einwilligung und Ruhezeiten beachten

Ein Klaviyo-Profil, das E-Mail- oder SMS-Marketing zugestimmt hat, hat damit nicht automatisch WhatsApp zugestimmt. Prüfe, was dein Opt-in-Formular tatsächlich abgefragt hat, bevor du Flow-Nachrichten in größerem Umfang anbindest (Nachweis der Einwilligung erklärt, was du aufbewahren solltest). TextMeFlow liefert standardmäßig auch nicht außerhalb der in deinem Konto eingestellten Ruhezeiten aus: Ein Win-back-Flow, der um 2 Uhr nachts auslöst, wird in die Warteschlange gestellt und zu einer vernünftigen Uhrzeit gesendet, ein Punkt weniger, den du selbst in die Flow-Logik bauen musst.

Häufige Fragen

Hat Klaviyo eine Webhook-Aktion in Flows? Ja, darauf baut dieses ganze Setup auf (Schritt 1). Du fügst sie wie jede andere Flow-Aktion hinzu und legst URL, Header und einen JSON-Body aus Profil- und Event-Eigenschaften fest.

Brauche ich dafür von Meta genehmigte Templates? Nicht mit TextMeFlow: Die Nachrichten gehen von deiner eigenen verknüpften WhatsApp-Nummer raus, und der Text ist das, was dein Empfänger baut. Die Einwilligung des Kunden für WhatsApp brauchst du trotzdem.

Können Kunden auf die WhatsApp-Nachricht antworten? Ja. Antworten erscheinen auf deinem Handy wie jeder andere Chat, und du kannst sie mit einem eingehenden Webhook auch an deinem eigenen Endpoint empfangen, etwa um sie im Klaviyo-Profil zu protokollieren.

Was kostet ein Test? Nichts: Der kostenlose Tarif enthält 50 Nachrichten pro Monat ohne Zeitlimit. Bezahlte Tarife findest du auf der Preisseite.

Kostenlos mit TextMeFlow starten: 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um einen Klaviyo-Flow komplett anzubinden und echte Sendungen zu sehen, bevor du dich für einen kostenpflichtigen Tarif entscheidest.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis