API WhatsApp et les templates : guide pour les SaaS e-commerce

Les templates WhatsApp — appelés officiellement Message Templates ou HSM (Highly Structured Messages) — sont des formats de messages pré-approuvés par Meta que les entreprises doivent utiliser pour initier des conversations avec leurs contacts. Pour un SaaS e-commerce, les templates sont le vecteur de toutes les notifications critiques : confirmation de commande, alerte de livraison, demande d'avis, relance de panier abandonné. Bien construits, ils affichent des taux d'ouverture supérieurs à 90%. Mal construits, ils sont refusés par Meta ou génèrent des signalements de spam.

Structure d'un template WhatsApp

Un template se compose de sections optionnelles, chacune avec ses propres règles :

Section	Obligatoire ?	Description
Header	Non	Texte (60 car. max), image, vidéo ou document
Body	Oui	Corps du message (1024 car. max), avec variables `{{1}}`, `{{2}}`
Footer	Non	Texte fixe court (60 car. max), souvent utilisé pour le désabonnement
Buttons	Non	Jusqu'à 3 boutons : CTA (URL, numéro de téléphone) ou Quick Reply

Les variables sont des espaces réservés numérotés ({{1}}, {{2}}…) remplacés par des valeurs dynamiques à l'envoi. Elles doivent être entourées d'un exemple de valeur lors de la soumission du template à Meta.

Les catégories de templates et leurs implications e-commerce

Meta classe chaque template dans une catégorie qui détermine son tarif et ses règles d'utilisation :

Marketing

Utilisé pour les messages promotionnels, les campagnes, les offres. Exemple pour l'e-commerce :

Bonjour {{1}}, votre panier vous attend ! 
Les articles que vous avez sélectionnés sont toujours disponibles. 
Profitez de -10% avec le code RETOUR10 jusqu'à ce soir minuit.
[Bouton : Voir mon panier → https://boutique.com/panier/{{2}}]

Tarif : ~0,08 €/conversation pour un destinataire FR (frais Meta + Whakup).

Utility

Notifications transactionnelles liées à une action que le client a initiée. Exemples types :

Votre commande #{{1}} a bien été confirmée.
Montant : {{2}} € | Livraison estimée : {{3}}
[Bouton : Suivre ma commande]

Tarif : ~0,0336 €/conversation pour un destinataire FR. La qualification utility est plus stricte : le message doit concerner une transaction spécifique déjà initiée par l'utilisateur.

Authentication

Réservé aux OTP et codes de vérification. Format imposé par Meta, peu de personnalisation possible. Utilisé pour la connexion, la validation de compte, la double authentification.

Processus d'approbation Meta : ce qu'il faut savoir

Tout nouveau template doit être soumis à Meta avant utilisation. Le délai d'approbation est généralement de 10 minutes à 24 heures pour les comptes avec un historique de qualité satisfaisant.

Causes fréquentes de refus :

Contenu promotionnel dans un template soumis en catégorie Utility
Variables sans exemple de valeur dans la soumission
URL dynamique dans un bouton CTA sans domaine déclaré dans le WABA
Contenu ambigu ou potentiellement trompeur (offres "gratuites", urgence artificielle)
Mise en majuscules excessives dans le body

Bonnes pratiques pour maximiser le taux d'approbation :

Soyez précis dans le choix de catégorie : un template refusé en Marketing peut parfois être approuvé comme Utility si le contexte le justifie
Fournissez des exemples réalistes pour chaque variable (pas "XXXXXXX" mais une vraie valeur)
Évitez les tournures commerciales agressives dans les templates Utility
Pré-testez dans l'environnement sandbox Meta avant soumission en production

Intégration des templates dans un SaaS e-commerce

Créer et gérer les templates via l'API

Votre SaaS peut créer, soumettre et supprimer des templates programmatiquement :

POST /{WABA-ID}/message_templates
{
  "name": "confirmation_commande_v2",
  "language": "fr",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Votre commande #{{1}} est confirmée. Livraison prévue le {{2}}.",
      "example": { "body_text": [["12345", "15 juillet 2026"]] }
    },
    {
      "type": "BUTTONS",
      "buttons": [{ "type": "URL", "text": "Suivre", "url": "https://shop.com/track/{{1}}" }]
    }
  ]
}

L'API retourne un template_id et un statut PENDING jusqu'à l'approbation Meta. Souscrivez au webhook message_template_status_update pour être notifié du résultat.

Construire une bibliothèque de templates dans votre SaaS

Proposez à vos clients e-commerce une bibliothèque de templates pré-configurés pour les cas d'usage courants :

Confirmation de commande (Utility)
Confirmation d'expédition avec tracking (Utility)
Livraison réussie + demande d'avis (Utility ou Marketing selon le contenu)
Relance panier abandonné (Marketing)
Code promo personnalisé (Marketing)
Alerte de retour en stock (Marketing)
OTP de connexion (Authentication)

Chaque template de la bibliothèque doit être soumis une seule fois par WABA client. Si vous mutualisez des templates entre clients, sachez que les templates sont liés au WABA — en architecture multi-tenant avec WABA par client, chaque client doit avoir ses propres templates approuvés.

Personnalisation des variables à l'envoi

Lors de l'envoi via l'API, vous substituez les variables avec les valeurs issues de votre base de données e-commerce :

{
  "type": "template",
  "template": {
    "name": "confirmation_commande_v2",
    "language": { "code": "fr" },
    "components": [{
      "type": "body",
      "parameters": [
        { "type": "text", "text": "87654" },
        { "type": "text", "text": "18 juillet 2026" }
      ]
    }]
  }
}

FAQ

Un même template peut-il être utilisé dans plusieurs langues ?

Oui. Meta gère les templates par paire nom + langue. Vous pouvez créer confirmation_commande_v2 en français (fr), en anglais (en_US) et en espagnol (es). Chaque variante est soumise et approuvée séparément. Pour un SaaS e-commerce multi-marché, c'est essentiel.

Peut-on modifier un template approuvé ?

Non directement. Vous devez créer une nouvelle version du template (ex. : confirmation_commande_v3), la soumettre à l'approbation et, une fois approuvée, migrer vos envois vers la nouvelle version. L'ancienne version peut coexister pendant la transition.

Combien de templates peut-on créer par WABA ?

La limite par défaut est de 250 templates actifs par WABA. Cette limite peut être augmentée sur demande pour les comptes à fort usage. Les templates rejetés ou supprimés ne comptent pas dans le quota.

Meta peut-il désactiver un template après approbation ?

Oui. Meta surveille en continu les templates actifs. Si un template génère un fort taux de signalement après déploiement, Meta peut le désactiver (statut PAUSED ou DISABLED) même s'il avait été approuvé. Un webhook message_template_status_update notifie ce changement. Votre SaaS doit traiter cet événement pour désactiver automatiquement les campagnes utilisant ce template.

Les templates WhatsApp sont l'interface entre votre SaaS e-commerce et les clients de vos utilisateurs. Une bibliothèque de templates bien structurée, versionnée et monitorée est un actif produit à part entière.

Whakup accompagne les éditeurs de SaaS e-commerce dans la création, la soumission et la gestion des templates via une API WhatsApp Business en marque blanche. Pour aller plus loin, consultez notre guide détaillé sur les templates WhatsApp et leurs catégories et notre article sur les prix de l'API WhatsApp Business en 2026.