Implémenter la confirmation de commande WhatsApp dans une plateforme e-commerce ou un OMS, c'est connecter un événement métier (commande validée) à un canal de communication haute délivrabilité. Ce cas pratique décrit les choix d'architecture réels, les écueils à éviter et les métriques à suivre, du point de vue d'un éditeur qui embarque WhatsApp pour ses clients marchands.
Contexte : une plateforme SaaS e-commerce multi-marchands
Imaginons une plateforme SaaS hébergeant 50 marchands. Chaque marchand dispose de son propre catalogue, de ses propres clients, et souhaite envoyer ses confirmations de commande par WhatsApp. Les contraintes sont :
- Isolation stricte des données entre marchands (multi-tenant)
- Chaque marchand a son numéro WhatsApp dédié (branding propre)
- Le volume total est de 10 000 commandes/jour
- Certains clients n'ont pas WhatsApp — fallback email obligatoire
C'est exactement le cas d'usage pour lequel l'architecture multi-tenant de l'API WhatsApp Business Whakup a été conçue : un seul accès API côté éditeur, un WABA et un numéro par marchand.
Architecture retenue et décisions techniques
Un WABA par marchand, géré via l'embedded signup
Chaque nouveau marchand crée son compte WhatsApp Business via le flux embedded signup intégré à votre dashboard. Le processus prend moins de 10 minutes et ne nécessite aucune démarche côté marchand auprès de Meta. Votre plateforme stocke le phone_number_id et le token d'accès associés à chaque marchand dans votre table de configuration.
Un template partagé ou un template par marchand ?
Deux options sont possibles :
| Option | Avantages | Inconvénients |
|---|---|---|
| Template partagé (namespace plateforme) | 1 seule approbation Meta | Moins de personnalisation possible |
| Template par marchand | Branding complet | Approbation à répéter par marchand |
La plupart des éditeurs optent pour un template partagé avec variables de personnalisation (nom du marchand en variable), au moins au départ. Les marchands premium peuvent ensuite avoir leurs propres templates.
File d'attente asynchrone
À 10 000 commandes/jour, l'envoi synchrone (appel API dans le même thread que la validation de commande) est risqué. Si l'API WhatsApp est lente ou indisponible, la validation de commande échoue côté client. La solution : publier un événement dans une queue (Kafka, RabbitMQ, SQS) et traiter les envois WhatsApp de manière asynchrone.
Order validated → publish to queue → consumer picks up → call Whakup API → store wamid → await webhook
Gestion des cas limites
Le client n'a pas WhatsApp
Le webhook de statut Meta renvoie une erreur 131047 (numéro non joignable) ou 130429 (rate limit) dans les secondes qui suivent l'envoi. Votre consumer doit détecter ces codes et déclencher l'envoi email immédiatement. Planifiez un délai de fallback de 90 secondes : si vous ne recevez pas de delivered dans ce délai, envoyez l'email.
Le numéro est malformé ou incomplet
Validez le format E.164 avant d'appeler l'API. Un numéro 0612345678 (format local FR) doit être converti en 33612345678. Cette normalisation doit être faite au niveau de la collecte (formulaire checkout) et vérifiée à l'envoi.
La commande est passée en dehors des heures ouvrées
WhatsApp API fonctionne 24h/24. Il n'y a pas de contrainte horaire pour les templates Utility — contrairement aux appels téléphoniques ou à certaines réglementations SMS. Envoyez la confirmation dès la validation, quelle que soit l'heure.
Le template est suspendu par Meta
Si votre template reçoit trop de signalements "spam" (qualité dégradée), Meta peut le suspendre temporairement. Votre monitoring doit détecter les erreurs 132000 (template paused) et router automatiquement vers le fallback email le temps que le template soit restauré. Pour comprendre le système de score de qualité Meta, lisez notre article sur la politique qualité Meta WhatsApp.
Métriques à suivre en production
Un éditeur qui embarque WhatsApp pour la confirmation de commande doit exposer ces indicateurs à ses marchands :
- Taux de délivrance WhatsApp : messages
delivered/ messagessent— objectif > 95 % - Taux de lecture : messages
read/ messagesdelivered— indicateur de l'engagement réel - Taux de fallback email : proportion de commandes routées vers l'email — révèle la couverture WhatsApp de la base clients
- Délai moyen de délivrance : temps entre l'envoi et le
delivered— doit rester sous 30 secondes - Coût par confirmation : total facturé Whakup / nombre de confirmations envoyées
Pour des numéros FR, une confirmation de commande (catégorie Utility) coûte ~0,0336 € en tout (0,0088 € Whakup + 0,0248 € Meta). Un marchand qui valide 500 commandes/mois dépense environ 16,80 € pour ses confirmations WhatsApp. Plus de détails sur la grille tarifaire dans notre article prix API WhatsApp Business 2026.
FAQ
Peut-on inclure le détail des articles commandés dans le template ?
Oui, mais avec précaution. Les templates ont une limite de longueur. Pour une commande avec de nombreux articles, vous avez deux options : inclure un résumé (ex. "3 articles") plutôt que la liste complète, ou envoyer un lien vers une page de commande détaillée. L'ajout d'un bouton URL vers le récapitulatif de commande est la pratique la plus courante.
Comment gérer les commandes annulées après la confirmation ?
Préparez un second template Utility order_cancelled_v1 avec les mêmes variables. Si la commande est annulée dans les 24h suivant la confirmation (même fenêtre de conversation Meta), le message d'annulation est inclus dans la même conversation et ne génère pas de coût supplémentaire.
L'éditeur peut-il voir les messages échangés entre le marchand et ses clients ?
Non. L'architecture multi-tenant de Whakup garantit l'isolation des données. Chaque WABA est associé à un marchand — votre plateforme peut voir les métadonnées (statuts, volumes) mais pas le contenu des messages.
Peut-on envoyer la confirmation dans d'autres langues que le français ?
Oui. Chaque template est associé à une langue. Vous pouvez créer la même template en plusieurs langues (fr, en, es, etc.) et sélectionner la langue au moment de l'envoi en fonction des préférences du client.
Pour déployer ce flux en production pour vos marchands, l'API WhatsApp Whakup fournit tout ce dont vous avez besoin : REST API documentée, embedded signup pour l'onboarding marchand, multi-WABA, hébergement EU et conformité RGPD.
Co-fondateur de Whakup, Arthur accompagne les entreprises africaines dans leur transformation digitale via WhatsApp depuis 2022. Passionné par le growth marketing et l'entrepreneuriat en Afrique francophone.
Prêt à passer à l'action ?
Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.
Démarrer l'essai gratuitArticles similaires
WhatsApp pour la confirmation de commande via l'API : FAQ pour les éditeurs
FAQ complète sur l'intégration de la confirmation de commande WhatsApp API : templates, opt-in, fallback, tarifs et conformité Meta pour les éditeurs de plateformes.
WhatsApp pour la confirmation de commande via l'API : guide complet pour les éditeurs
Guide complet pour envoyer des confirmations de commande via WhatsApp Business API : templates Utility, webhooks, personnalisation et tarifs pour les éditeurs.
WhatsApp pour la confirmation de commande via l'API : tutoriel pour les éditeurs
Tutoriel pas à pas pour envoyer une confirmation de commande WhatsApp via l'API Business : appel REST, template Utility, variables et gestion des statuts.