> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence des modèles WhatsApp : catégories, en-têtes, boutons

> Référence pour les catégories de modèles WhatsApp, les formats d'en-tête, les types de boutons, la syntaxe des variables, les modèles de coupon et de localisation et le cycle de vie de soumission.

Cette page est une référence pour les blocs de construction d'un modèle WhatsApp — catégories, en-têtes, corps, boutons, variables, types de modèles avancés et cycle de vie de soumission. Pour le pas-à-pas de création et de test d'un modèle, voir [Modèles](/fr/app/templates). Pour les limites de format des médias, voir [En-têtes médias](/fr/app/media-in-template-headers).

## Catégories

Chaque modèle a exactement une catégorie, définie lorsque vous le soumettez à Meta. La catégorie détermine la **tarification** et **le contenu autorisé**.

| Catégorie | Utilisez-la pour | Notes |
| - | - | - |
| **Marketing** | Promotions, offres, invitations à des événements, réengagement | Palier le plus cher ; soumis aux règles d'opt-in |
| **Utility** | Mises à jour de commande, alertes de compte, rappels, suivis d'un flux initié par l'utilisateur | Moins cher que Marketing ; le contenu doit être lié à une transaction ou une demande spécifique |
| **Authentication** | Mots de passe à usage unique et codes de vérification de compte | Format strict ; aucun contenu marketing autorisé ; palier le moins cher |

Si Meta estime que votre modèle ne correspond pas à la catégorie que vous avez choisie, il sera **rejeté** ou **re-catégorisé** — courant pour le contenu marketing soumis en Utility. La catégorie peut également changer automatiquement à mesure que Meta observe les modes d'usage, ce qui change alors le tarif qui vous est facturé.

## Formats d'en-tête

L'en-tête d'un modèle est optionnel. Lorsqu'il est présent, il peut être l'un des suivants :

* **TEXT** — chaîne courte, peut inclure une variable.
* **IMAGE** — JPEG ou PNG, max 5 Mo. Voir [En-têtes médias](/fr/app/media-in-template-headers).
* **VIDEO** — MP4 ou 3GPP avec H.264/AAC, max 16 Mo.
* **DOCUMENT** — PDF (le plus fiable), formats Office ou texte brut. Max 100 Mo. L'éditeur dispose d'un champ **Nom de fichier du document** qui prend par défaut celui du fichier uploadé ; la valeur que vous y définissez est ce que le destinataire voit sur la bulle document WhatsApp, alors choisissez quelque chose de descriptif comme `Acme-Commande-12345-Recu.pdf`.
* **LOCATION** — latitude, longitude, nom et adresse. Utile pour les visites en magasin ou les confirmations de livraison.

Les en-têtes médias peuvent être attachés soit sous forme de **media handle** (uploadé une fois vers Meta), soit sous forme d'**URL HTTPS publique** récupérée par envoi. Voir [En-têtes médias](/fr/app/media-in-template-headers) pour les compromis.

## Corps et variables

Le corps est le texte principal du message. Les variables utilisent des **doubles accolades avec un index basé sur 1** :

```text theme={null}
Hi {{1}}, your order {{2}} has shipped. Track it here: {{3}}
```

Règles :

* Les numéros doivent être séquentiels à partir de `{{1}}` — vous ne pouvez pas sauter d'index.
* Fournissez un exemple de valeur pour chaque variable lors de la soumission. Meta utilise les exemples pour évaluer le modèle.
* Gardez les variables sur des valeurs courtes et prévisibles. Les longs blocs collés sont une raison de rejet courante.

La même syntaxe `{{n}}` est utilisée dans les **en-têtes TEXT** et les **boutons URL** (voir ci-dessous).

### Mise en forme dans le corps

WhatsApp prend en charge un ensemble limité de mise en forme en ligne dans les corps de modèles :

* **Gras** avec `*astérisques*`
* **Italique** avec `_soulignés_`
* **Barré** avec `~tildes~`
* **Monospace** avec triple backticks

Utilisez la mise en forme avec parcimonie. Les modèles avec beaucoup de mise en forme sont souvent rejetés comme paraissant spammy.

## Pied

Texte brut optionnel affiché après le corps. Pas de variables, pas de mise en forme.

## Boutons

Un modèle peut inclure jusqu'à **10 boutons au total**, groupés en réponses rapides ou call-to-action. Les combinaisons autorisées par Meta ont évolué au fil des versions de l'API Cloud ; les motifs les plus fiables :

| Type de bouton | Ce qu'il fait | Exemple | Variable ? |
| - | - | - | - |
| **QUICK\_REPLY** | Envoie une réponse texte pré-définie à votre entreprise | `Oui, c'est moi` | Non |
| **URL** | Ouvre une page web | `https://acme.com/orders/{{1}}` | Une dans l'URL |
| **PHONE** | Appelle un numéro de téléphone | `+44 20 7946 0000` | Non |
| **COPY\_CODE** | Copie un code dans le presse-papiers | `SAVE20` | Une pour le code |
| **FLOW** | Ouvre un WhatsApp Flow | (ID de Flow lié) | Variables via le Flow lui-même |
| **CATALOG** | Ouvre votre catalogue WhatsApp | (ID de catalogue lié) | Non |
| **MPM** | Lanceur Multi-Product Message | (produits du catalogue) | Non |
| **VOICE\_CALL** | Initie un appel vocal WhatsApp (où pris en charge) | (votre numéro d'entreprise) | Non |

Les boutons de réponse rapide sont utiles lorsque vous voulez une réponse structurée (bon pour l'analytique). Les boutons URL et téléphone sont utiles pour router les destinataires hors de WhatsApp vers votre stack. Les boutons FLOW sont la porte d'entrée vers les Flows pilotés par les formulaires HubSpot dans lesquels Flowella est spécialisé.

## Types de modèles spécialisés

Meta dispose de plusieurs types de modèles marketing spécialisés qui bundlent des fonctionnalités supplémentaires en plus de la structure de base.

### Modèles Carrousel

Un modèle carrousel (que Meta appelle carrousel de cartes multimédias) envoie une bulle de message suivie de jusqu'à 10 cartes dans un défilement horizontal. Chaque carte a son propre média, un texte de corps optionnel et des boutons. Utilisez les carrousels pour les vitrines de catalogue, les offres multi-produits ou les comparaisons de fonctionnalités.

* **Marketing uniquement.** Les modèles carrousel ne peuvent utiliser que la catégorie **Marketing**.
* **De 2 à 10 cartes** par modèle.
* **Pas d'en-tête ni de pied sur le message.** Le message ne comporte qu'un corps. Chaque carte porte son propre en-tête média, et le message lui-même ne peut pas avoir de boutons.
* **Un seul type de média par modèle.** Toutes les cartes utilisent un en-tête image, ou toutes utilisent un en-tête vidéo. Vous ne pouvez pas les mélanger.
* **Le corps de carte est optionnel, jusqu'à 160 caractères.** Si une carte a un texte de corps, toutes les cartes doivent en avoir un.
* **Jusqu'à 2 boutons par carte** (Quick reply, URL ou Phone number).
* **Même structure de boutons sur chaque carte.** Chaque carte a le même nombre de boutons, avec les mêmes types dans le même ordre. Les libellés des boutons, les URL et les numéros de téléphone peuvent varier d'une carte à l'autre.

L'approbation est par modèle (pas par carte), donc toutes les cartes doivent être conformes à la catégorie Marketing. Consultez la documentation de Meta sur les [modèles de carrousel de cartes multimédias](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates/media-card-carousel-templates) pour la spécification complète. Pour en créer un dans Flowella, voir [Construire un modèle carrousel](/fr/app/templates#construire-un-modèle-carrousel).

### Modèles Offre à durée limitée (LTO)

Les modèles LTO affichent un compte à rebours sous le corps. Une fois le minuteur expiré, l'offre s'affiche comme expirée et taper le CTA ne fait rien.

* Un paramètre de **code d'offre** est requis et affiché à l'utilisateur.
* Une **époque d'expiration (en secondes)** est requise.
* Le bouton CTA est généralement un Copy Code ou URL.

Idéal pour de vraies offres limitées dans le temps — utiliser LTO pour des offres qui n'expirent pas réellement provoque des plaintes d'utilisateurs et une re-catégorisation loin du Marketing.

### Modèles Code de coupon

Comme LTO mais sans compte à rebours — juste un code que l'utilisateur peut copier en un tap.

* Le code peut faire **jusqu'à 20 caractères** (récemment augmenté de 15).
* Le bouton Copy Code copie la valeur fournie **au moment de l'envoi** — le champ `example` du modèle est un placeholder uniquement et n'est jamais envoyé.
* Dans **Modèles → onglet Envoyer** et dans la **boîte de dialogue de modèle de la boîte de réception**, les modèles de code coupon font apparaître une entrée dédiée **Boutons de code coupon** où vous tapez les codes que vous voulez réellement envoyer (un par ligne de destinataire pour les envois en masse). Les anciens libellés « Copy code » / « Copy coupon code buttons » ont été remplacés par ce terme unique et cohérent.

### Modèles d'authentification

Modèles spécialisés pour la livraison d'OTP. Trois sous-types :

* **Autofill en un tap** — utilise l'API d'autofill d'Android pour renseigner automatiquement l'OTP lorsque l'utilisateur tape le bouton. Meilleure UX là où c'est pris en charge.
* **Copy code** — affiche un bouton Copy ; l'utilisateur colle le code dans votre app. Fonctionne partout.
* **Zero-tap** — pour les expéditeurs de confiance, l'OTP peut être livré sans aucun tap (un callback API automatique du client WhatsApp vers votre app). Éligibilité stricte.

Les modèles d'authentification ont le prix par message le moins cher mais les règles de contenu les plus strictes : pas de contenu marketing, pas de texte de corps supplémentaire au-delà du code lui-même.

### Modèles de localisation

Portent une localisation ponctuelle dans l'en-tête, utile pour les visites en magasin, les confirmations de livraison ou les lieux d'événement. L'utilisateur peut ouvrir la localisation dans son application de cartes en un tap.

**En-tête de localisation en tant que variables**

L'en-tête LOCATION porte jusqu'à quatre champs — **latitude**, **longitude**, **nom** et **adresse** — et Flowella traite les quatre comme des variables de modèle normales.

* Les valeurs que vous avez saisies dans l'éditeur (sous `_flowellaEditor.headerLocationPreview`) deviennent la valeur **par défaut** envoyée si aucun override n'est fourni.
* Les boîtes de dialogue **Test Template** et d'envoi depuis la boîte de réception exposent les quatre champs comme entrées de variables classiques.
* L'action [Envoyer un modèle WhatsApp](/fr/hubspot/workflow-actions#send-whatsapp-template) de HubSpot passe les quatre valeurs via `headerLocation` pour qu'un workflow puisse personnaliser le point par destinataire.

Si vous omettez l'un des quatre au moment de l'envoi, Flowella retombe sur la valeur d'aperçu de l'éditeur pour ce champ.

## Cycle de vie de soumission

Lorsque vous soumettez un modèle depuis Flowella, il passe par ces états :

<Steps>
  <Step title="DRAFT">
    Enregistré dans Flowella mais pas encore envoyé à Meta.
  </Step>

  <Step title="PENDING">
    Soumis à Meta et en cours de revue. La plupart des modèles passent la revue automatisée de Meta en quelques minutes, mais certains sont acheminés pour une revue humaine. L'éditeur de Flowella vous indique que l'approbation **peut prendre jusqu'à 12 heures** et **vous envoie un e-mail** dès que le statut change — vous n'avez pas besoin de continuer à rafraîchir.
  </Step>

  <Step title="APPROVED">
    Actif et utilisable. Vous pouvez l'envoyer depuis la boîte de réception, l'API et les workflows HubSpot.
  </Step>

  <Step title="REJECTED">
    Meta a refusé le modèle. La raison du rejet apparaît sur la page du modèle. Modifiez et resoumettez.
  </Step>

  <Step title="FLAGGED">
    Meta a examiné les retours qualité et a signalé le modèle. Habituellement un précurseur de PAUSED.
  </Step>

  <Step title="PAUSED">
    Meta a temporairement restreint l'envoi du modèle, généralement à cause des retours des destinataires ou d'une qualité basse. Revient automatiquement si la qualité se rétablit.
  </Step>

  <Step title="DISABLED">
    Meta a restreint le modèle de manière permanente. Doit être resoumis comme un nouveau modèle (souvent re-catégorisé) si vous voulez réutiliser le contenu.
  </Step>
</Steps>

## Note de qualité

Une fois approuvé, chaque modèle accumule sa propre note de qualité — distincte de la [note de qualité du numéro de téléphone](/fr/meta/quality-score). La note au niveau du modèle utilise la même échelle Vert/Jaune/Rouge et est principalement pilotée par :

* Le taux de blocage parmi les destinataires
* La fréquence des actions « Signaler » dans WhatsApp
* Un engagement bas soutenu (pas de réponses, pas de clics sur les liens)

Les notes de modèle Jaune et Rouge peuvent amener Meta à mettre le modèle en pause même si la propre note du numéro de téléphone est Verte. Surveillez la qualité des modèles dans **Flowella → Modèles** aux côtés de la note au niveau du numéro.

## Durée de vie (TTL)

Les modèles peuvent avoir une **durée de vie** qui contrôle pendant combien de temps Meta tentera la livraison avant d'abandonner. Utile pour les envois sensibles au temps comme les invitations à une vente flash.

* **Par défaut :** 30 jours pour la plupart des modèles.
* **Modèles OTP / authentification :** beaucoup plus court (quelques minutes par défaut), puisque les codes n'ont plus de valeur une fois périmés.
* **TTL personnalisé :** peut être défini par envoi pour certains types de modèles.

Si un modèle expire avant la livraison (téléphone du destinataire hors ligne, compte en pause, etc.), il compte comme un envoi pour la facturation mais n'atteint jamais le client.

## Raisons de rejet courantes

* **Contenu promotionnel soumis en Utility.** Resoumettez en Marketing.
* **Exemples de variables qui ne correspondent pas au corps** — par exemple, des exemples qui contiennent des liens que le corps ne justifie pas.
* **Texte de corps ou d'en-tête qui ressemble à du spam** — capitalisation excessive, « Cliquez ici », « Gratuit !!! », points d'exclamation multiples.
* **URL d'en-tête média cassées ou inaccessibles.**
* **Texte de pied qui contredit le corps.**
* **Modèles génériques** qui pourraient être envoyés par n'importe qui — `Hi {{1}}, offre spéciale pour vous` sans précisions est trop générique pour une approbation marketing.
* **Variables dans le mauvais contexte** — utiliser une variable à un endroit que Meta n'autorise pas (par exemple certains types de boutons).
* **Le nom d'affichage ne correspond pas à la marque** du contenu du modèle. Si le nom d'affichage du WABA est « Acme » et que le modèle promeut « Beta Co », il sera rejeté.

<Tip>
  Modifiez une copie d'un modèle APPROVED plutôt que l'original, pour garder une version fonctionnelle pendant que Meta examine les modifications. **Modèles → Dupliquer** de Flowella fait cela pour vous, et copie le média d'en-tête (IMAGE, VIDEO ou DOCUMENT) et le **Nom de fichier du document** dans le nouveau brouillon pour que vous n'ayez pas à re-uploader avant de publier. Si Flowella ne peut pas copier le média (par exemple lorsque l'URL de l'exemple d'origine est inaccessible), l'éditeur affiche un avertissement et bloque la publication jusqu'à ce que vous re-uploadiez le fichier.
</Tip>

## Guides associés

* [Modèles](/fr/app/templates) — le pas-à-pas de la construction d'un modèle
* [En-têtes médias](/fr/app/media-in-template-headers) — référence des formats médias
* [Modèle rejeté](/fr/troubleshooting/template-rejected) — diagnostiquer les rejets
* [Score de qualité](/fr/meta/quality-score) — comment la qualité du numéro interagit avec la qualité du modèle
* [Limites d'envoi](/fr/meta/messaging-limits) — le système de paliers qui contraint combien de modèles vous pouvez envoyer


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.