Notifications de commande WhatsApp pour Shopify via webhooks
Shopify envoie déjà un webhook pour chaque événement de commande qui compte — créée, payée, traitée, expédiée. La plupart des boutiques les branchent sur l'email ou le SMS et s'arrêtent là. WhatsApp affiche des taux d'ouverture bien supérieurs aux deux, et si vous acceptez d'écrire un petit récepteur de webhook plutôt que d'installer une application « boîte noire », vous gardez la maîtrise totale du moment, du contenu et du coût de vos messages. Voici comment connecter Shopify directement à TextMeFlow.
Pourquoi éviter l'app store
Une application générique « WhatsApp pour Shopify » facture généralement au message, en plus de votre facture d'API WhatsApp, et vous enferme dans ses propres modèles. Brancher les webhooks natifs de Shopify directement sur l'API TextMeFlow ne coûte rien de plus que le quota de messages de votre forfait, et vous restez propriétaire du texte des messages, de la logique de déclenchement et des données. Si vous envoyez déjà des messages WhatsApp transactionnels ailleurs dans votre stack, cela garde tout sur un seul compte et un seul forfait au lieu de payer deux fois.
Étape 1 : enregistrer le webhook Shopify
Dans l'administration Shopify, allez dans Settings → Notifications → Webhooks (ou utilisez l'Admin API) et abonnez-vous aux événements sur lesquels vous voulez agir :
orders/paid→ confirmation de commandefulfillments/create→ notification d'expédition avec lien de suivi
Pointez chaque webhook vers un point d'entrée que vous contrôlez, par exemple https://yourapp.com/webhooks/shopify. Shopify signe chaque payload avec un en-tête HMAC (X-Shopify-Hmac-Sha256) — vérifiez-le avant de faire confiance au corps de la requête, comme vous devez aussi vérifier les signatures des webhooks de TextMeFlow dans l'autre sens.
Étape 2 : recevoir le webhook et extraire le numéro de téléphone
Un récepteur Node minimal :
app.post('/webhooks/shopify', express.raw({ type: 'application/json' }), (req, res) => {
const digest = crypto
.createHmac('sha256', process.env.SHOPIFY_WEBHOOK_SECRET)
.update(req.body)
.digest('base64');
if (digest !== req.headers['x-shopify-hmac-sha256']) {
return res.status(401).send('invalid signature');
}
const order = JSON.parse(req.body);
const phone = order.customer?.default_address?.phone || order.phone;
if (!phone) return res.status(200).send('no phone, skipped');
sendOrderConfirmation(phone, order);
res.status(200).send('ok');
});
Toutes les commandes Shopify ne contiennent pas un numéro de téléphone exploitable — la collecte du téléphone à la commande doit être activée dans les paramètres de votre boutique, et vous recevrez malgré tout des commandes sans numéro. Ignorez-les proprement plutôt que de laisser un champ manquant casser la réponse du webhook ; Shopify réessaie les webhooks en échec, et une accumulation d'erreurs 5xx de votre côté finit par faire désactiver l'abonnement.
Étape 3 : envoyer via l'API TextMeFlow
curl -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer $TEXTMEFLOW_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "+32470123456",
"text": "Bonjour Sarah, votre commande #1042 est confirmée — 2 articles, total 68,50 €. Nous vous écrirons à nouveau dès son expédition."
}'
Pour l'étape d'expédition, utilisez le champ tracking_url du payload fulfillments/create pour construire un second message dès que le statut de la commande change. Deux messages clairs et distincts se lisent mieux sur WhatsApp qu'une confirmation surchargée qui tente de couvrir les deux événements.
Étape 4 : rester dans les règles anti-spam
Les notifications de commande et d'expédition sont transactionnelles, pas du marketing ; elles ne déclenchent donc pas les déclencheurs de type diffusion du score de risque de TextMeFlow — vous envoyez un message personnalisé par client, pas un contenu identique à toute une liste. Deux points restent toutefois importants pour une intégration Shopify :
- Respectez STOP. Si un client s'est désinscrit via WhatsApp, ne le réintégrez pas via les données de commande du checkout — TextMeFlow rejette les envois vers des destinataires désinscrits, et tenter l'envoi vous coûte des points de score de risque.
- Validez le format du numéro. Shopify stocke les numéros de téléphone dans le format saisi par le client ; normalisez-les en E.164 (
+<indicatif><numéro>) avant d'appeler l'API, sinon l'envoi échoue à la validation.
Ce que cela vous apporte par rapport à l'email
Les accusés de livraison et de lecture de WhatsApp reviennent sur le webhook propre à TextMeFlow, ce qui vous permet de consigner précisément le moment où un client a vu sa notification d'expédition — ce que les ouvertures d'email ne permettent pas de savoir de façon fiable. Si votre boutique envoie des médias par commande (une facture en PDF, une photo de l'article emballé), le même point d'entrée messages accepte des pièces jointes jusqu'à 100 Mo, de sorte qu'un seul appel peut transporter à la fois le texte et la facture.
Ce schéma webhook-vers-API fonctionne pour toute plateforme capable de déclencher un webhook sortant sur des événements de commande — WooCommerce, Lightspeed, un panier sur mesure — Shopify n'est que le point de départ le plus courant. Si vous migrez un flux de notifications de commande existant basé sur TextMeBot, la liste de contrôle de migration couvre les différences d'URL et de payload.
Commencez gratuitement avec TextMeFlow — 50 messages par mois, sans limite de durée, de quoi tester un flux complet de notifications de commande avant de choisir un forfait.
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