API WhatsApp et les templates : guide pour les plateformes de fidélité

Les templates WhatsApp (aussi appelés HSM — Highly Structured Messages) sont les seuls messages qu'une plateforme de fidélité peut envoyer en dehors d'une conversation ouverte par le client. Pour toute communication business-initiated — notification de points, offre personnalisée, rappel d'expiration de récompense — il faut un template approuvé par Meta. Comprendre comment les concevoir, les faire approuver et les utiliser efficacement est une compétence centrale pour tout éditeur de plateforme de fidélité.

Ce que sont les templates et pourquoi ils sont obligatoires

Un template est un modèle de message pré-approuvé par Meta, avec des variables personnalisables mais une structure fixe. Meta impose ce système pour éviter le spam : vous ne pouvez pas envoyer de message libre à un client qui ne vous a pas écrit dans les dernières 24 heures.

Les templates se composent de :

• Un header optionnel (texte, image, vidéo ou document).
• Un body obligatoire (texte avec variables {{1}}, {{2}}…).
• Un footer optionnel (texte statique, souvent utilisé pour le nom de la marque).
• Des boutons optionnels (jusqu'à 3 : CTA URL, appel téléphonique, réponse rapide).

Chaque template est soumis à Meta pour approbation. Le délai d'approbation est généralement de quelques minutes à quelques heures pour les templates simples. Un template refusé peut être resoumis après correction.

Les catégories de templates pour les plateformes de fidélité

Meta classe les templates en trois catégories qui déterminent le coût de la conversation :

Catégorie	Usage fidélité	Coût total FR (Whakup)
Marketing	Offre promotionnelle, campagne de points bonus, soldes membres	~0,08 €/conversation
Utility	Confirmation de transaction, solde de points, rappel d'expiration	~0,0336 €/conversation
Authentication	Code OTP pour connexion au portail fidélité	~0,0336 €/conversation

Règle clé : la catégorie est déclarée lors de la soumission du template. Meta peut reclassifier un template qui ne correspond pas à la catégorie déclarée — avec impact direct sur la facturation. Un template "Profitez de 200 points bonus ce week-end" est marketing, même si vous le soumettez en utility.

Pour une plateforme de fidélité, les templates utility sont les plus fréquents : notifications de transactions, confirmations d'échanges de récompenses, rappels d'expiration de points. Les templates marketing concernent les campagnes de stimulation ponctuelles.

Pour aller plus loin sur la classification, consultez notre article sur les catégories de templates WhatsApp.

Templates de fidélité : exemples concrets et bonnes pratiques

Template utility — Confirmation de points gagnés :

Header (texte) : Vos points {{1}}
Body : Bonjour {{2}}, vous venez de gagner {{3}} points suite à votre achat du {{4}}. 
Votre solde actuel est de {{5}} points. 
Footer : [Nom de l'enseigne]
Bouton CTA : "Voir mes récompenses" → https://moncompte.enseigne.fr/points

Template marketing — Offre membres exclusifs :

Header (image) : [visuel de l'offre]
Body : {{1}}, votre statut {{2}} vous donne accès à -{{3}}% ce week-end. 
Offre valable jusqu'au {{4}} en magasin et sur notre site.
Footer : [Nom de l'enseigne] — Se désabonner : répondre STOP
Boutons : "J'en profite" (URL) | "Non merci" (réponse rapide)

Bonnes pratiques pour l'approbation :

• Éviter les majuscules excessives, les points d'exclamation en rafale et le vocabulaire typiquement promotionnel dans les templates utility.
• Inclure systématiquement un bouton de désabonnement dans les templates marketing.
• Les variables ne peuvent pas être en position de header seul — le texte doit avoir du contenu statique autour.
• Ne pas soumettre de templates avec des URLs raccourcies (bit.ly, tinyurl) — Meta les refuse.

Gestion des templates dans votre plateforme de fidélité

En tant qu'éditeur, vous devez exposer la gestion des templates à vos clients (enseignes, programmes de fidélité). Voici les fonctionnalités essentielles :

Création et soumission :

• Éditeur de template dans votre interface avec prévisualisation en temps réel.
• Soumission via l'API WhatsApp : POST /v19.0/{waba_id}/message_templates.
• Affichage du statut d'approbation (PENDING, APPROVED, REJECTED) et des motifs de rejet.

Bibliothèque de templates :

• Permettre au client de gérer ses templates approuvés par catégorie.
• Afficher les métriques de performance par template (taux de livraison, taux de lecture, taux de clic sur les boutons).
• Alerter quand un template est désactivé par Meta (souvent après des signalements).

Variables dynamiques : Votre système doit être capable de mapper les variables du template ({{1}}, {{2}}…) avec les données du membre au moment de l'envoi :

{
  "messaging_product": "whatsapp",
  "to": "33612345678",
  "type": "template",
  "template": {
    "name": "points_gagnes_confirmation",
    "language": {"code": "fr"},
    "components": [{
      "type": "body",
      "parameters": [
        {"type": "text", "text": "Marie"},
        {"type": "text", "text": "150"},
        {"type": "text", "text": "12/07/2026"},
        {"type": "text", "text": "2 340"}
      ]
    }]
  }
}

Pour les questions d'architecture complète et de choix entre construire ou acheter l'API, consultez notre article Build vs Buy WhatsApp API et notre comparatif des meilleurs BSP WhatsApp en France.

L'API WhatsApp Whakup permet de soumettre et gérer des templates pour chaque compte client dans une architecture multi-tenant, avec un accès en marque blanche depuis votre interface.

FAQ

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

Par défaut, Meta autorise 250 templates par WABA. Ce quota peut être augmenté sur demande si vos cas d'usage le justifient. Pour une plateforme multi-enseignes, chaque enseigne a son propre WABA avec son propre quota.

Un template approuvé peut-il être modifié ?

Non. Un template approuvé ne peut pas être modifié — il doit être supprimé et resoumis. Meta impose cette règle pour garantir que le contenu approuvé correspond à ce qui est réellement envoyé. Anticipez ce délai dans votre gestion des campagnes.

Peut-on envoyer des images ou des documents dans les templates de fidélité ?

Oui. Les templates avec header de type image, vidéo ou document sont supportés. L'image peut être une URL externe ou un media_id obtenu via l'API Media Upload. Pour les campagnes de fidélité avec visuels produits, utilisez les headers image — ils augmentent significativement les taux de clic sur les boutons.

Les boutons interactifs (réponses rapides) sont-ils traités comme des messages entrants ?

Oui. Quand un client clique sur un bouton de réponse rapide, votre webhook reçoit un événement de type interactive avec le button_reply.id que vous avez défini. Vous pouvez ainsi tracker précisément quel bouton a été cliqué et déclencher le flux correspondant dans votre plateforme.

---

Les templates WhatsApp sont l'interface créative de votre plateforme de fidélité sur ce canal. Bien conçus, ils génèrent des taux d'engagement bien supérieurs aux emails ou SMS. Mal catégorisés ou mal structurés, ils coûtent plus cher et risquent d'être désactivés. Intégrez l'API WhatsApp Whakup dans votre plateforme de fidélité et accédez à une gestion de templates multi-tenant prête à l'emploi.