Intégration Klaviyo WhatsApp : envoyer depuis vos flows
Les flows Klaviyo savent exactement quand un client a abandonné son panier, passé une commande ou disparu pendant 60 jours : c'est tout l'intérêt des déclencheurs de flow. Les messages eux-mêmes partent toutefois uniquement par e-mail ou, sur les offres supérieures, par SMS Klaviyo. Ni l'un ni l'autre n'est ouvert aussi vite que WhatsApp. Si les clients de votre boutique se trouvent sur un marché où WhatsApp est le canal par défaut, rediriger une étape de flow vers WhatsApp (à la place de l'e-mail ou en plus) est un petit ajout : une action webhook et un récepteur qui appelle l'API messages de TextMeFlow.
C'est différent d'un branchement direct des webhooks de commande Shopify ou WooCommerce : ici, Klaviyo gère déjà la segmentation et le timing (étapes d'attente, filtres de flow, tests A/B), et vous lui donnez simplement une sortie WhatsApp en plus de l'e-mail/SMS.
Le canal WhatsApp natif de Klaviyo ou un webhook vers votre propre numéro ?
Klaviyo ajoute WhatsApp comme canal natif, basé sur la WhatsApp Business Platform de Meta. Sa disponibilité pour votre compte dépend de votre offre et de votre région : consultez la documentation de Klaviyo. S'il est disponible, mieux vaut savoir ce qu'implique chaque option avant de construire quoi que ce soit :
| WhatsApp natif de Klaviyo | Webhook Klaviyo → TextMeFlow | |
|---|---|---|
| Numéro d'envoi | Un numéro enregistré sur la WhatsApp Business Platform | Votre numéro WhatsApp existant, lié en scannant un QR code |
| Contenu | Les messages à votre initiative utilisent des modèles approuvés par Meta | Le texte construit par votre récepteur ; pas d'approbation de modèle |
| Coûts | Tarif Klaviyo plus les frais Meta par message | Votre forfait TextMeFlow ; gratuit jusqu'à 50 messages par mois |
| Mise en place | Vérification d'entreprise Meta et validation des modèles | Une action webhook et un petit récepteur |
| Idéal pour | Les grosses campagnes marketing avec l'outillage officiel de Meta | Les messages transactionnels et de flow à l'échelle d'une boutique, depuis le numéro que vos clients connaissent déjà |
Le webhook n'est pas un moyen de contourner les règles de WhatsApp : l'opt-in reste nécessaire, et TextMeFlow applique des limites de débit et un contrôle de risque à chaque envoi, pour qu'un numéro lié se comporte comme une personne et non comme un expéditeur de masse. Pour une boutique qui envoie des relances de panier et des messages de commande à des clients qui les ont demandés, c'est rarement une contrainte.
Étape 1 : ajouter une action webhook au flow
Dans Klaviyo, ouvrez le flow (Abandoned Cart, Order Confirmation, Win-back, peu importe son déclencheur) et ajoutez une action Webhook à l'endroit où vous voulez envoyer le message WhatsApp, généralement à la place d'une étape e-mail ou en parallèle. L'action webhook de Klaviyo permet de :
- Définir l'URL de l'endpoint (votre récepteur)
- Choisir
POSTet un corpsJSON - Insérer les propriétés du profil et de l'événement dans la charge utile avec la syntaxe de templating de Klaviyo
Construisez la charge utile avec le strict nécessaire :
{
"phone": "{{ person|lookup:'phone_number' }}",
"first_name": "{{ person|lookup:'first_name' }}",
"cart_url": "{{ event|lookup:'$ecommerce.abandoned_checkout_url' }}",
"cart_total": "{{ event|lookup:'$value' }}"
}
Les noms exacts des propriétés dépendent de l'événement qui déclenche le flow : consultez le panneau « Preview » de l'étape webhook de Klaviyo pour voir les vraies valeurs avant la mise en production.
Étape 2 : sécuriser le webhook
Klaviyo permet d'ajouter des en-têtes personnalisés à l'action webhook. Ajoutez un jeton bearer statique :
Authorization: Bearer <a long random secret you generate yourself>
Votre récepteur vérifie cet en-tête à chaque requête et rejette tout ce qui ne correspond pas. C'est la seule chose qui empêche quelqu'un d'autre d'envoyer de fausses commandes à votre endpoint, car Klaviyo ne signe pas ces charges utiles.
Étape 3 : le récepteur qui appelle TextMeFlow
<?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 accepte +32 470 12 34 56, 0032470123456 et 32470123456.
// Un numéro national (0470 12 34 56) n'a pas d'indicatif : on l'ignore.
if ($phone === '' || preg_match('/^0(?!0)/', $phone)) {
http_response_code(200); // nothing to retry, just skip
exit;
}
$text = sprintf(
"Bonjour %s, vous avez laissé des articles dans votre panier (%s). Finalisez votre commande : %s",
$data['first_name'] ?? '',
$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);
La structure est la même en Node ou en Python : consultez les exemples PHP, Python et Node si vous les voulez directement.
Étape 4 : le format du numéro de téléphone est la principale source d'échecs
Les profils Klaviyo stockent les numéros tels que le formulaire de commande ou d'inscription les a collectés : avec des espaces, des tirets, un préfixe 00 ou parfois un 0 initial au lieu d'un indicatif pays. TextMeFlow nettoie lui-même l'essentiel : espaces, tirets, points et parenthèses sont supprimés, 0032470… devient +32470…, et un numéro qui commence par l'indicatif sans + (32470…) reçoit le +. Ce qui ne peut pas être corrigé, c'est un numéro national comme 0470 12 34 56 : sans indicatif, impossible de savoir à quel pays il appartient, donc l'API répond 422 avec "error": "invalid_recipient". N'essayez pas de deviner l'indicatif dans votre récepteur : ignorez ces profils (le récepteur ci-dessus le fait) et corrigez le formulaire de collecte, par exemple avec un sélecteur de pays sur le champ téléphone, plutôt que de masquer le problème en aval.
Étape 5 : ne pas faire doublon avec ce que le flow envoie déjà
Si le flow envoie encore un e-mail, décidez une fois par flow quel canal est principal plutôt que d'envoyer les deux à chaque fois. Un schéma courant : WhatsApp d'abord (ouverture la plus rapide), avec l'étape e-mail d'origine déplacée plus loin dans le flow comme solution de repli, uniquement pour les profils sans numéro de téléphone valide. Utilisez pour cela un filtre de flow sur la propriété téléphone afin de créer la branche.
Attention à l'opt-in et aux heures calmes
Un profil Klaviyo qui consent au marketing par e-mail ou SMS n'a pas automatiquement consenti à WhatsApp : vérifiez ce que votre formulaire d'opt-in demandait réellement avant de brancher des messages de flow à volume (la preuve d'opt-in explique ce qu'il faut conserver). TextMeFlow ne livre pas non plus par défaut en dehors des heures calmes configurées sur votre compte : un flow win-back qui se déclenche à 2 h du matin est mis en file d'attente et envoyé à une heure raisonnable, un souci de moins à gérer dans la logique du flow.
Questions fréquentes
Klaviyo propose-t-il une action webhook dans les flows ? Oui, c'est sur elle que repose toute cette configuration (étape 1). Vous l'ajoutez comme n'importe quelle action de flow, avec une URL, des en-têtes et un corps JSON construit à partir des propriétés du profil et de l'événement.
Faut-il des modèles approuvés par Meta ? Pas avec TextMeFlow : les messages partent de votre propre numéro WhatsApp lié, et le texte est celui que construit votre récepteur. Le consentement du client pour WhatsApp reste nécessaire.
Les clients peuvent-ils répondre au message WhatsApp ? Oui. Les réponses arrivent sur votre téléphone comme n'importe quelle conversation, et vous pouvez aussi les recevoir sur votre propre endpoint avec un webhook entrant, par exemple pour les consigner sur le profil Klaviyo.
Combien coûte un test ? Rien : le forfait gratuit inclut 50 messages par mois, sans limite de durée. Les forfaits payants sont sur la page tarifs.
Démarrez gratuitement avec TextMeFlow : 50 messages par mois, sans limite de durée, de quoi brancher un flow Klaviyo de bout en bout et voir de vrais envois avant de choisir un forfait payant.
Envie d'envoyer des messages WhatsApp via API ?
Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.
Gratuit pour toujours