Limites de caractères des modèles WhatsApp
La documentation de Meta sur les composants de modèle fixe des limites strictes pour chaque partie. Un modèle qui les dépasse est refusé par l'API avant même qu'un réviseur ne le voie : mieux vaut les vérifier pendant la rédaction.
Les caractères sont comptés tels qu'on les voit : un emoji ou une lettre arabe compte pour un. Les retours à la ligne comptent aussi, tout comme les caractères de mise en forme, par exemple les astérisques de *gras*.
Source : Meta, Template components, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components (vérifié en octobre 2026).
- Nom du modèle : 512 caractères maximum, minuscules, chiffres et tirets bas uniquement.
- En-tête texte : 60 caractères et une variable au maximum. Un en-tête média peut être une image, une vidéo ou un document ; l'en-tête localisation est réservé aux modèles utilitaires et marketing.
- Corps : 1 024 caractères maximum, obligatoire, avec autant de variables que nécessaire.
- Pied de page : 60 caractères maximum, sans variable.
- Boutons : 10 au total, dont 10 réponses rapides, 2 boutons URL, 1 bouton téléphone et 1 bouton de code au maximum. Texte des boutons : 25 caractères ; URL : 2 000 ; numéro : 20 ; code à copier : 20.
Les règles de variables qui entraînent un refus
La plupart des modèles refusés échouent sur leurs variables, pas sur leur texte. Le guide de révision de Meta liste les problèmes refusés : variables non séquentielles, contenant des caractères spéciaux comme #, $ ou %, accolades mal appariées, ou placées tout au début ou tout à la fin du message.
Meta refuse aussi les modèles qui ont trop de variables pour leur longueur. Aucun ratio officiel n'est publié ; l'outil avertit donc en dessous de trois mots fixes par variable. Les réviseurs refusent aussi souvent deux variables collées, comme {{1}} {{2}} : fusionnez-les ou séparez-les par des mots.
Chaque variable exige un exemple réaliste lors de la soumission. Les réviseurs le lisent pour comprendre le message : « test » ou « xxx » appelle un refus.
Source : Meta, Template review, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review.
Modèle rejeté ? Décodez le motif de Meta
Passez à l'onglet « Rejeté ? Collez le motif de Meta » et collez le motif affiché dans WhatsApp Manager, Business Support Home, l'e-mail de rejet ou le webhook message_template_status_update. L'outil reconnaît les codes de Meta, comme INVALID_FORMAT, INCORRECT_CATEGORY, TAG_CONTENT_MISMATCH, PROMOTIONAL, SCAM et ABUSIVE_CONTENT, ainsi que la formulation des causes fréquentes du guide de revue des modèles, puis affiche la cause probable et la correction.
Un modèle rejeté peut être modifié et soumis à nouveau, ou vous pouvez faire appel dans WhatsApp Manager après avoir ajouté des exemples de valeurs ; Meta indique que les appels sont tranchés sous 24 heures. Un motif NONE signifie que le modèle a été mis en pause, pas rejeté.
Utilitaire, marketing ou authentification
La catégorie détermine l'approbation et le prix. Un modèle utilitaire fait suite à une action ou une demande du client (commande, réservation, modification de compte, alerte) et ne doit rien promouvoir. Un modèle d'authentification transporte un code à usage unique avec le texte fixe de Meta. Tout le reste, y compris les relances de panier, les offres et la réactivation, relève du marketing.
Selon les règles de catégorisation de Meta, un modèle qui mêle contenu utilitaire et promotionnel est un modèle marketing. Codes de réduction, offres, ventes additionnelles, relances de panier et invitations à télécharger une application font basculer en marketing. Meta revérifie régulièrement les modèles approuvés et reclasse en marketing les modèles utilitaires promotionnels, généralement avec un jour de préavis.
L'outil analyse votre texte en français, anglais, arabe, espagnol, allemand et portugais à la recherche de termes promotionnels et vous prévient avant que Meta ne reclasse le modèle. Seuls les modèles d'authentification peuvent envoyer des codes à usage unique : les formulations d'OTP dans les autres catégories sont aussi signalées.
Source : Meta, Template categorization, https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization.
Boutons : regroupement, liens dynamiques et affichage
Les réponses rapides et les boutons d'action doivent être regroupés : toutes les réponses rapides avant les autres boutons, ou toutes après. Une réponse rapide coincée entre deux liens est refusée par l'API.
Un bouton URL accepte une variable, placée à la fin de l'URL, par exemple https://shop.example.com/orders/{{1}}. Encodez la valeur envoyée (une espace devient %20) et évitez les raccourcisseurs de liens, qui masquent la destination et ressemblent à du spam.
Au-delà de trois boutons, WhatsApp en affiche deux et regroupe les autres sous « Voir toutes les options ». Avec quatre boutons ou plus, ou des réponses rapides mêlées à d'autres boutons, le modèle ne s'affiche pas sur WhatsApp pour ordinateur : placez l'action principale en premier.
De l'aperçu à l'envoi à grande échelle
Le JSON exporté suit le corps de requête POST /<WABA_ID>/message_templates de l'API WhatsApp Business Management, exemples compris. Pour un en-tête média, importez un fichier d'exemple via la Resumable Upload API et remplacez l'identifiant fictif.
Une fois approuvé, le modèle s'envoie par son nom et sa langue avec les vraies valeurs. OmniChannels.ai gère les modèles de plusieurs comptes WhatsApp Business, suit leur révision et leur qualité, et les envoie via une seule API REST, des campagnes ou la boîte de réception partagée, avec bascule SMS si WhatsApp n'est pas disponible.
