Les modèles WhatsApp sont des formats de message pré-approuvés qui vous permettent d’initier des conversations avec vos clients. Ils sont essentiels pour envoyer des messages promotionnels, des mises à jour de commandes et des notifications d’assistance via la Plateforme WhatsApp Business.
Remarque : Les modèles WhatsApp sont actuellement pris en charge uniquement pour les boîtes de réception WhatsApp Cloud.
Que sont les modèles WhatsApp ?
Les modèles WhatsApp sont des messages structurés qui doivent être approuvés par WhatsApp avant de pouvoir être envoyés à vos clients. Ils garantissent la conformité avec les règles de messagerie WhatsApp tout en vous permettant d’envoyer des communications professionnelles et cohérentes.
Les modèles peuvent inclure :
-
Messages texte avec des variables personnalisées
-
Images, vidéos ou documents en tant qu’en-têtes
-
Boutons d’action pour des réponses rapides des clients
-
Boutons d’appel à l’action qui redirigent vers des sites web ou des numéros de téléphone
Catégories de modèles
WhatsApp organise les modèles en différentes catégories selon leur objectif :
-
Utilité - Messages transactionnels comme les confirmations de commande et les reçus
-
Marketing - Contenu promotionnel et offres spéciales
-
Mise à jour d’expédition - Mises à jour sur la livraison et l’état des colis
-
Mise à jour du ticket - Notifications de dossiers d’assistance
-
Résolution de problème - Suivi du service client
Ce qui n’est pas pris en charge
Modèles d’authentification
-
Modèles AUTHENTICATION avec des codes OTP et messages de vérification
-
Remplissage automatique des paramètres de boutons avec des valeurs OTP
-
Validation d’OTP et gestion de la durée d’expiration
Composants interactifs
-
Modèles LIST avec options sélectionnables
-
Modèles PRODUCT avec intégration du catalogue
-
Modèles CATALOG pour la navigation produits
-
Composants multi-sélection
Composants d’autorisation d’appel
-
Modèles CALL_PERMISSION_REQUEST nécessitant l’API d’appel WhatsApp activée
-
Boutons d’autorisation d’appel et composants d’appel interactifs
Composants de localisation
-
En-têtes LOCATION avec coordonnées cartographiques
-
Paramètres Adresse avec latitude/longitude
-
Modèles basés sur la localisation
Fonctionnalités avancées
-
Mise en forme de texte enrichi lors de la création de modèles (préservée à l’envoi)
-
Modèles carrousel avec plusieurs cartes
-
Composants formulaire pour la collecte de données
-
Modèles d’intégration paiement
-
Modèles Flow avec logique conditionnelle
Modèles "Legacy" vs. modèles améliorés
Chatwoot prend en charge deux formats de modèles pour assurer la compatibilité avec tous vos modèles existants :
Modèles Legacy
Il s’agit des modèles traditionnels qui utilisent des variables de texte simples. Ils fonctionnent avec :
-
Messages texte de base
-
Substitution simple de variable (ex : insertion d’un nom de client)
-
Interactions de bouton simples
Exemple de format Legacy :
{
"parameters": ["John Doe", "12345", "2025-01-15"]
}
⚠️ Important : La prise en charge des modèles Legacy sera supprimée à partir de la v4.7. Nous recommandons de migrer vers les modèles améliorés pour garantir la continuité du service.
Modèles améliorés
Le nouveau format amélioré offre des fonctionnalités plus sophistiquées :
-
Support média - Envoi d’images, vidéos et documents
-
Variables avancées - Personnalisation du texte plus flexible
-
Boutons interactifs - Boutons URL avec liens dynamiques, codes à copier, et réponses rapides
-
Meilleure validation - Vérification en temps réel des paramètres de votre modèle
Exemple de format amélioré :
{
"body": {
"1": "John Doe",
"2": "12345",
"3": "2025-01-15"
},
"header": {
"media_url": "https://example.com/image.jpg",
"media_type": "image"
},
"buttons": [
{
"type": "url",
"parameter": "track123"
}
]
}
Remarque : Tous vos modèles Legacy existants continuent de fonctionner pour le moment, mais vous devriez planifier leur transition vers les modèles améliorés. Les fonctionnalités améliorées sont automatiquement accessibles lorsque vous utilisez les types de modèles pris en charge.
Veuillez consulter cette API pour connaître les formats de requête.
Comment créer des modèles WhatsApp
Actuellement, les modèles WhatsApp doivent être créés via le WhatsApp Business Manager :
-
Accédez au Business Manager WhatsApp - Rendez-vous sur business.facebook.com
-
Naviguez jusqu’aux modèles - Trouvez la section "Outils du compte" et sélectionnez "Modèles de message"
-
Créez un nouveau modèle - Cliquez sur "Créer un modèle" et choisissez le type de modèle
-
Concevez votre modèle - Ajoutez en-tête, corps, pied de page et boutons selon le besoin
-
Soumettez pour approbation - WhatsApp examinera votre modèle (cela peut prendre jusqu’à 24h)
-
Synchronisez avec Chatwoot - Une fois approuvé, les modèles apparaîtront automatiquement ou vous pourrez synchroniser manuellement les modèles via la boîte de réception dans Chatwoot
🚀 Bientôt disponible : Nous prévoyons d’ajouter la création de modèles directement dans l’interface Chatwoot dans une future version afin de faciliter la conception et la gestion des modèles sans quitter Chatwoot.
Comment envoyer des modèles WhatsApp
Les modèles WhatsApp peuvent être envoyés de deux façons :
-
Conversations individuelles - Envoyer des modèles à des clients spécifiques pendant les échanges
-
Campagnes - Envoyer des modèles à plusieurs clients à la fois via la fonctionnalité campagne de Chatwoot
Envoi de modèles en conversation
Étape 1 : Accéder aux options de modèles
Ouvrez une conversation avec un contact WhatsApp. Cliquez sur l’icône de modèle dans le compositeur de message. Sélectionnez "Modèles WhatsApp" dans le menu déroulant

Étape 2 : Choisissez votre modèle
Parcourez vos modèles approuvés. Utilisez la barre de recherche pour retrouver rapidement un modèle précis.

Étape 3 : Personnalisez votre message
Selon le type de modèle, vous devrez peut-être renseigner :

Pour les modèles texte :
-
Nom du client, numéro de commande ou autre information personnalisée
-
Tout champ variable marqué {{1}}, {{2}}, etc.
Pour les modèles média :
-
URL d’image/vidéo - Fournissez un lien direct vers votre fichier média
-
URL de document - Lien vers des PDF, documents Word ou autres fichiers
-
Les médias doivent être accessibles publiquement (aucune connexion requise)
Pour les modèles avec bouton :
-
Paramètres d’URL - Liens dynamiques pour les boutons d’appel à l’action
-
Codes à copier - Codes de réduction ou de parrainage
-
Numéros de téléphone - Pour les boutons click-to-call
Étape 4 : Prévisualisez et envoyez
-
Vérifiez votre message dans l’aperçu
-
Vérifiez que toutes les variables sont correctement renseignées
-
Vérifiez que les URLs des médias fonctionnent (le cas échéant)
-
Cliquez sur "Envoyer le modèle" pour envoyer votre message
Envoyer des modèles via Campagnes
Pour envoyer des modèles à plusieurs clients à la fois :
Accédez aux Campagnes Whatsapp sur votre tableau de bord Chatwoot, créez une nouvelle campagne et sélectionnez WhatsApp comme canal.

Choisissez votre modèle WhatsApp parmi les options disponibles et configurez votre audience et les paramètres du modèle.
.png)
Remarque : La fonction campagne vous permet de toucher efficacement plusieurs clients avec le même modèle de message.
Foire Aux Questions (FAQ)
Questions générales
Pourquoi tous mes modèles WhatsApp n’apparaissent-ils pas dans Chatwoot ?
Seuls les modèles approuvés par WhatsApp et pris en charge par Chatwoot apparaîtront. Les modèles non pris en charge (comme les modèles d’authentification avec OTP) sont automatiquement filtrés.
Combien de temps faut-il pour que les nouveaux modèles s’affichent dans Chatwoot ?
Les modèles sont généralement synchronisés automatiquement après un certain temps et vous pouvez aussi les mettre à jour manuellement depuis les paramètres de la boîte de réception.
Puis-je modifier des modèles directement dans Chatwoot ?
Non, les modèles doivent être créés et modifiés dans WhatsApp Business Manager. Chatwoot sert uniquement à envoyer des modèles approuvés.
Pourquoi dois-je fournir des URL pour les images et vidéos ?
WhatsApp requiert que les fichiers médias soient hébergés en ligne et accessibles publiquement. Il n’est pas possible de télécharger directement des fichiers – vous devez fournir des URLs valides vers votre contenu média.
Puis-je utiliser le même modèle pour différents clients ?
Oui ! Les modèles sont conçus pour être réutilisés. Il suffit de renseigner des informations clients différentes à chaque envoi.
Dépannage
Mon modèle n'est pas envoyé. Que dois-je vérifier ?
Problèmes courants :
-
Variables manquantes – Vérifiez que tous les champs obligatoires sont remplis
-
URLs de médias cassées – Assurez-vous que vos liens d’image/vidéo/document fonctionnent bien
-
Fichier trop volumineux – Vérifiez que vos fichiers respectent la taille limite imposée par WhatsApp
-
Modèle non approuvé – Confirmez le statut du modèle dans WhatsApp Business Manager
Pourquoi mes clients ne voient-ils pas mes images/vidéos ?
Cela signifie généralement :
-
L’URL n’est pas accessible publiquement
-
Le format du fichier n’est pas pris en charge
-
Le fichier est trop volumineux
-
Le serveur d’hébergement est en panne ou nécessite une authentification
Mes boutons URL ne fonctionnent pas correctement. Que faire ?
Pour les modèles contenant des boutons URL dynamiques, il existe des problèmes connus avec certaines configurations de modèles. Essayez d’utiliser des URLs statiques à la place pour une meilleure fiabilité.
Puis-je envoyer des modèles à des clients qui ne m’ont pas contacté en premier ?
Oui, mais uniquement pour certaines catégories de modèles :
-
Les modèles utilitaires peuvent être envoyés à tout moment à des fins transactionnelles
-
Les modèles marketing nécessitent l’opt-in du client et ont des fenêtres d’envoi spécifiques
-
Toujours respecter les règles de conformité WhatsApp pour votre région
Médias et fichiers
Quels types de fichiers puis-je utiliser dans mes modèles ?
Formats pris en charge :
-
Images : JPEG, PNG (moins de 5 Mo)
-
Vidéos : MP4, 3GPP (moins de 16 Mo)
-
Documents : PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT (moins de 100 Mo)
Conformité et limites
Combien de modèles puis-je envoyer par jour ?
Cela dépend des limites de votre compte WhatsApp Business et des quotas de messages. Contactez l’assistance WhatsApp pour connaitre les restrictions spécifiques à votre compte.
Y a-t-il des restrictions sur l’envoi de modèles marketing ?
Oui, les modèles marketing ont des fenêtres d’envoi spécifiques et nécessitent que le client ait donné son consentement. Consultez la politique WhatsApp à jour pour votre type d’activité et votre région.
Que se passe-t-il si j’envoie trop de messages ?
WhatsApp surveille la qualité et le taux de distribution des messages. L’envoi massif de messages non livrés ou non désirés peut impacter les limites de messages et la validation des modèles pour votre compte.
Besoin d’aide supplémentaire ?
Si vous rencontrez des problèmes qui ne sont pas couverts dans ce guide :
-
Vérifiez le statut du modèle dans WhatsApp Business Manager
-
Vérifiez que vos URLs de médias fonctionnent et sont accessibles publiquement
-
Testez avec des données fictives avant d’envoyer à vos clients
-
Contactez votre administrateur Chatwoot pour des problèmes spécifiques à votre compte
-
Consultez la politique WhatsApp sur les modèles pour toutes questions de conformité
Rappelez-vous que les modèles WhatsApp sont un outil puissant pour la communication client quand ils sont utilisés correctement. L’objectif est d’apporter de la valeur à vos clients par des messages pertinents et opportuns qui respectent leurs préférences.