Aller au contenu principal
Technique WhatsApp API 7 min de lecture

API WhatsApp et les templates : guide pour les agences push notifications

Templates WhatsApp pour les agences push notifications : créer, catégoriser et optimiser vos modèles de messages pour des campagnes approuvées rapidement et sans blocage Meta.

Les templates WhatsApp (ou message templates) sont les modèles de messages pré-approuvés par Meta que vous devez utiliser pour initier une conversation avec un contact. Pour une agence push notifications, ils sont le cœur de toute campagne sortante : pas de template approuvé, pas d'envoi possible. Comprendre leur structure, leurs catégories et leur cycle de validation est la condition de base pour opérer une plateforme WhatsApp fiable à l'échelle.

Ce qu'est un template WhatsApp et pourquoi il est obligatoire

WhatsApp distingue deux types de messages :

  • Les messages libres (free-form) : envoyables uniquement dans une fenêtre de 24 heures ouverte par le client. Aucune validation Meta requise.
  • Les templates (message templates) : seul moyen d'initier une conversation ou d'envoyer un message en dehors de la fenêtre de 24 heures. Doivent être approuvés par Meta avant usage.

Pour une agence push notifications, la quasi-totalité des envois sortants (campagnes, relances, notifications proactives) passe par des templates. Vous ne pouvez pas improviser le contenu au moment de l'envoi : le texte, les variables, les boutons et le format médias sont figés dans le template approuvé.

Un template est défini par :

  • Un nom unique (minuscules, tirets, chiffres)
  • Une catégorie Meta : Marketing, Utility ou Authentication
  • Un langage (fr, en, es, etc. — un template distinct par langue)
  • Un corps de message avec variables au format {{1}}, {{2}}...
  • Des composants optionnels : header (texte, image, vidéo, document), footer, boutons (CTA, réponse rapide)

Les trois catégories de templates et leurs implications

La catégorie d'un template détermine son coût de facturation et les règles d'approbation auxquelles il est soumis. Pour une plateforme push notifications, bien catégoriser ses templates n'est pas anodin.

Catégorie Usage typique Tarif conversation FR (Meta) Approbation
Marketing Promotions, relances, actualités ~0,0712 €/conv Plus stricte
Utility Confirmations, rappels, mises à jour ~0,0248 €/conv Standard
Authentication OTP, codes de vérification ~0,0248 €/conv Standard

Marketing : tout message qui promeut un produit, un service, une offre ou qui incite à une action commerciale. Si votre template mentionne un prix, une promotion ou un lien vers une page de vente, Meta le classifie automatiquement en marketing, même si vous l'aviez soumis en utility. Meta peut recatégoriser unilatéralement un template lors de l'approbation.

Utility : messages attendus par le destinataire dans le cadre d'une relation commerciale existante. Confirmation de commande, rappel de rendez-vous, mise à jour de statut de livraison. Le critère clé : le destinataire a déclenché une action qui justifie le message.

Authentication : exclusivement les codes OTP et les liens de vérification. Format standardisé, peu de personnalisation possible.

Pour une analyse complète des règles de catégorisation, consultez notre guide sur les catégories de templates WhatsApp.

Créer et soumettre des templates efficacement

Sur une plateforme push notifications multi-clients, votre SaaS doit permettre à vos agences et à leurs clients de créer et gérer leurs templates sans accéder au Meta Business Manager.

Les bonnes pratiques de rédaction pour l'approbation :

  • Éviter le langage promotionnel excessif dans les templates utility (Meta les reclassifie en marketing)
  • Ne pas utiliser de majuscules excessives ni de points d'exclamation multiples
  • Inclure le nom de l'expéditeur dans le corps du message pour plus de clarté
  • Limiter les variables à ce qui est strictement nécessaire : trop de variables rendent le template opaque pour le validateur Meta
  • Tester le message rendu avec des valeurs de variables réalistes avant soumission

Le cycle de validation : Meta traite les soumissions de templates en quelques minutes pour la plupart des comptes bien établis. Le délai peut monter à 24 heures pour les nouveaux comptes ou les templates à contenu sensible. Le statut retourné est PENDING, APPROVED, REJECTED ou PAUSED.

Un template refusé inclut une raison lisible machine (rejection_reason). Les motifs les plus fréquents pour une agence push notifications :

  • INVALID_FORMAT : structure du template incorrecte
  • TAG_CONTENT_MISMATCH : le contenu ne correspond pas à la catégorie sélectionnée
  • PROMOTIONAL_CONTENT : contenu promotionnel détecté dans un template utility
  • ABUSIVE_CONTENT : contenu non conforme aux politiques Meta

La gestion via API : Votre plateforme doit implémenter l'API de gestion des templates pour permettre la création, la modification et la suppression programmatiques. Les endpoints clés sont POST /whatsapp_business_account_id/message_templates (création) et GET /whatsapp_business_account_id/message_templates (liste et statuts). Le webhook message_template_status_update notifie les changements de statut en temps réel.

Pour comprendre comment se structure l'accès à ces endpoints selon votre architecture BSP, lisez notre article sur le Meta Tech Provider WhatsApp.

Optimiser les templates pour les campagnes push notifications

Au-delà de la simple approbation, la performance de vos templates en production dépend de plusieurs facteurs que votre agence doit piloter.

La personnalisation par variables. Un template avec Bonjour {{1}}, votre commande {{2}} est confirmée est plus performant qu'un générique. Meta l'évalue aussi positivement lors de l'approbation. Assurez-vous que votre plateforme valide les valeurs de variables avant envoi (longueur max, caractères autorisés).

Les boutons d'action. Trois types disponibles : URL dynamique, appel téléphonique, et réponse rapide. Les boutons URL dynamiques (avec une variable dans l'URL) permettent des liens trackés par destinataire. Les réponses rapides déclenchent vos webhooks et alimentent vos automations.

Le header média. Ajouter une image ou une vidéo dans le header augmente le taux d'engagement mais ralentit légèrement la livraison (chargement du média). Pour une campagne push notifications urgente (flash sale, alerte), préférez un header texte. Pour du nurturing, le visuel aide.

La rotation des templates. Envoyer le même template à une liste entière augmente le risque de signalement. Créer plusieurs versions d'un même message (A/B test) avec des formulations légèrement différentes réduit ce risque et améliore les données de performance.

Accédez à la gestion programmatique des templates depuis l'API WhatsApp de Whakup pour automatiser vos workflows d'approbation et vos campagnes push multi-clients.

FAQ

Un template approuvé peut-il être modifié après coup ?

Oui, mais une modification soumet le template à une nouvelle validation. Pendant la période de révision, le template reste actif dans sa version précédente si elle était approuvée. Si vous modifiez un template approuvé en version rejetée, vous revenez à l'ancienne version sans interruption de service.

Peut-on utiliser le même template dans plusieurs langues ?

Oui. Un template est identifié par son nom et son langage. Vous pouvez créer confirmation_commande en français, en anglais, en espagnol, etc. Chaque version est soumise et approuvée indépendamment. L'API d'envoi sélectionne la version correspondant à la langue du destinataire.

Y a-t-il une limite au nombre de templates par compte WhatsApp Business ?

Oui. La limite par défaut est de 250 templates par compte WhatsApp Business. Pour les plateformes multi-clients où chaque client a son propre WABA, cette limite est par WABA et s'avère rarement contraignante. En cas de besoin, Meta peut relever ce plafond sur demande.

Meta peut-il désactiver un template approuvé en production ?

Oui. Si un template approuvé génère un volume anormal de signalements ou de blocages, Meta peut le passer en statut PAUSED ou DISABLED sans préavis. Le webhook message_template_status_update notifie votre système. Les messages en cours d'envoi avec ce template échouent. Votre plateforme doit détecter ce statut et alerter le client concerné immédiatement.


Les templates WhatsApp sont à la fois votre outil de travail quotidien et votre contrainte réglementaire permanente. Les gérer correctement à l'échelle d'une agence push notifications nécessite une intégration API solide, un suivi des statuts en temps réel et des processus de création clairs pour vos clients. Whakup fournit l'infrastructure BSP certifiée Meta et les outils de gestion des templates pour que vos agences déploient des campagnes sans friction. Contactez notre équipe pour une démonstration.

#technique api whatsapp#template whatsapp#push notifications
Arthur Lyonnet
Arthur LyonnetCo-fondateur & CEO

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 gratuit