> ## 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.

# Note de qualité WhatsApp : la comprendre et la rétablir

> Comment Meta note votre numéro et vos modèles en Vert, Jaune ou Rouge, ce qui fait baisser la note et comment la rétablir avant que l'envoi soit limité.

Chaque numéro de téléphone professionnel WhatsApp porte une **note de qualité**, et chaque modèle de message possède sa propre **note de qualité de modèle**. Meta utilise les deux pour décider si vous pouvez continuer à envoyer librement, si les modèles restent actifs et si votre [limite de messagerie](https://knowledge.flowella.io/fr/whatsapp/limits/messaging-limits.md) peut augmenter.

Les notes des numéros de téléphone fonctionnent comme un feu de signalisation :

* **Vert :** haute qualité. L'envoi est normal, et votre limite peut augmenter lorsque les autres critères sont remplis.
* **Jaune :** qualité moyenne. Considérez-la comme un avertissement et resserrez les audiences et la fréquence avant que la note ne baisse davantage.
* **Rouge :** qualité faible. Attendez-vous à des restrictions. Un numéro qui reste Rouge peut être fortement limité.

Cette page couvre ce que Meta documente, ce que vous voyez dans Flowella et dans le Gestionnaire WhatsApp, et le lien entre la qualité et les erreurs de remise comme [131048](https://knowledge.flowella.io/fr/whatsapp/errors/error-131048.md).

> [!NOTE]
>
> **Dans Flowella.** Pris en charge en partie. Flowella affiche la qualité des modèles sous forme de pastilles dans la liste des modèles, affiche une bannière rouge et prévient tout le monde lorsqu'un numéro passe au Jaune ou au Rouge, et enregistre chaque changement signalé par Meta. Il n'affiche pas la note actuelle de chaque numéro : consultez-la dans le Gestionnaire WhatsApp. Voir [Ce qu'affiche Flowella](#what-flowella-shows).

## Ce sur quoi la qualité influe

| Domaine | Effet d'une note basse |
| - | - |
| [Limite de messagerie](https://knowledge.flowella.io/fr/whatsapp/limits/messaging-limits.md) | Une qualité faible ralentit ou empêche l'augmentation de la limite du portefeuille. Depuis le 7 octobre 2025, elle ne **réduit** plus une limite que vous avez déjà. |
| [Débit](https://knowledge.flowella.io/fr/whatsapp/limits/throughput.md) | Un numéro doit avoir une note Medium (Jaune) ou meilleure pour passer à 1 000 messages par seconde. |
| Envoi | Un numéro aux problèmes de qualité persistants peut voir ses envois bloqués avec [131048](https://knowledge.flowella.io/fr/whatsapp/errors/error-131048.md). |
| Modèles | Un modèle noté Rouge est mis en pause, et la troisième pause le désactive. Voir [Rythme et pause des modèles](https://knowledge.flowella.io/fr/whatsapp/limits/template-pacing-and-pausing.md). |

L'état **Flagged** que recevaient les numéros après une baisse de qualité n'existe plus. Avant le 7 octobre 2025, un numéro Flagged pendant 7 jours descendait d'un niveau de limite de messagerie.

## Note de qualité du numéro de téléphone

Meta attribue à chaque numéro de téléphone professionnel un `quality_rating`, renvoyé par l'API Phone Numbers. Le Gestionnaire WhatsApp affiche la même note sous un autre nom, dans **Account tools** → **Phone numbers**.

| Valeur API | Gestionnaire WhatsApp | Flowella |
| - | - | - |
| `GREEN` | High | Aucune alerte |
| `YELLOW` | Medium | Notification **WhatsApp quality rating** |
| `RED` | Low | Notification et bannière rouge sur chaque page |

Meta signale chaque changement avec un webhook `phone_number_quality_update`.

Meta ne publie pas de seuils exacts de taux de blocage. En pratique, les notes évoluent lorsque les destinataires :

* **Bloquent** votre numéro professionnel
* **Signalent** vos messages comme spam
* Montrent un faible engagement (peu de lectures ou de réponses) par rapport à votre volume

Le comportement récent pèse davantage que l'historique ancien, et les volumes d'envoi élevés sont jugés plus sévèrement qu'un numéro à faible volume en phase de montée en charge.

> [!TIP]
>
> Pour la formulation de Meta sur la qualité des numéros dans le Gestionnaire WhatsApp, consultez l'article du centre d'aide de Meta [*About your WhatsApp Business phone number's quality rating*](https://www.facebook.com/business/help/896873687365001), vers lequel renvoie la documentation de Meta sur les numéros de téléphone.

## Note de qualité des modèles

Par ailleurs, **chaque modèle** possède une note de qualité basée sur son utilisation, les retours des clients et l'engagement. Meta la communique via l'API Template et l'affiche dans le panneau **Manage templates** du Gestionnaire WhatsApp :

| Score API | Libellé dans le Gestionnaire WhatsApp | Signification |
| - | - | - |
| `GREEN` | Active - High quality | Peu ou pas de retours négatifs. Le modèle peut être envoyé |
| `YELLOW` | Active - Medium quality | Retours négatifs ou faibles taux de lecture. Il peut encore être envoyé, mais risque bientôt d'être mis en pause ou désactivé |
| `RED` | Active - Low quality | Retours négatifs ou faibles taux de lecture. Il peut encore être envoyé, mais risque fortement d'être mis en pause ou désactivé prochainement |
| `UNKNOWN` | Active - Quality pending | Nouveau modèle sans suffisamment de retours pour l'instant. Le modèle peut être envoyé |

Les nouveaux modèles commencent en `UNKNOWN`. La qualité alimente le **rythme d'envoi des modèles** (template pacing) et la **mise en pause des modèles** : un modèle sans note Vert peut voir son rythme d'envoi ralenti, et un modèle Rouge est mis en pause. Voir [Rythme et pause des modèles](https://knowledge.flowella.io/fr/whatsapp/limits/template-pacing-and-pausing.md). Si le statut d'un modèle passe d'approuvé à un autre statut, vous ne pouvez plus l'envoyer tant que Meta ne l'a pas approuvé à nouveau.

Meta signale les changements de qualité des modèles avec un webhook `message_template_quality_update`, et les pauses et désactivations avec `message_template_status_update`. Flowella met à jour les pastilles à partir des deux.

Référence officielle : la page [template quality rating](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality) de Meta.

Dans Flowella, la liste des modèles signale les modèles en pause, désactivés et de faible qualité à l'aide de pastilles. Voir [Pastilles de santé de remise dans la liste des modèles](https://knowledge.flowella.io/fr/app/templates.md#delivery-health-pills-on-the-templates-list).

## Pourquoi les notes des numéros baissent

La plupart des baisses viennent de problèmes d'audience et de fréquence, et non d'un seul « mauvais » modèle :

> [accordion] Envoyer à des personnes qui n'ont jamais consenti à WhatsApp
>
> Un numéro de téléphone collecté il y a des années pour des SMS ou lors d'un achat n'est pas un consentement WhatsApp. Des modèles marketing inattendus entraînent des blocages. Privilégiez les contacts qui ont récemment consenti à WhatsApp.

> [accordion] Envoyer trop souvent aux mêmes personnes
>
> WhatsApp est plus personnel que l'e-mail. Une fréquence élevée par destinataire augmente les taux de blocage et de signalement. Limitez les modèles sortants dans les workflows HubSpot (par exemple au maximum un modèle marketing par destinataire et par semaine, sauf s'il a répondu).

> [accordion] Un contenu qui ne correspond pas au consentement obtenu
>
> Un contenu marketing envoyé à des personnes qui n'ont accepté que des mises à jour de service (ou l'inverse) provoque des plaintes. Alignez la catégorie et le texte du modèle sur le consentement dont vous disposez. Voir [Modèle rejeté](https://knowledge.flowella.io/fr/troubleshooting/template-rejected.md).

> [accordion] Un nom d'affichage que les clients ne reconnaissent pas
>
> Si le nom d'affichage ne correspond pas à la marque dont le client se souvient, il peut considérer la conversation comme du spam. Utilisez un nom que les clients reconnaissent. Voir [Nom d'affichage et profil](https://knowledge.flowella.io/fr/whatsapp/accounts/profile-setup.md).

## Ce qu'affiche Flowella

Flowella n'affiche pas la note de chaque numéro de téléphone. Consultez-la dans le Gestionnaire WhatsApp → **Account tools** → **Phone numbers**. Flowella vous alerte lorsque la qualité cause des problèmes.

### Bannière rouge

Lorsqu'un numéro connecté est noté Rouge, ou que Meta a restreint ou banni le compte, chaque page de Flowella affiche « WhatsApp quality or account status needs attention. Open Meta Business Suite and resolve restrictions before sending is affected. »

### Notifications

Flowella vous avertit lorsque Meta modifie un élément qui affecte l'envoi. Ces notifications sont toujours actives dans l'application et par e-mail. Voir [Préférences de notification](https://knowledge.flowella.io/fr/settings/notification-preferences.md).

| Notification | Quand elle est envoyée | Nom de la préférence |
| - | - | - |
| WhatsApp number quality changed | La note d'un numéro descend à Jaune ou Rouge | **WhatsApp quality rating** |
| WhatsApp Business account update | Meta restreint, suspend, bannit ou désactive le compte, ou signale une violation des règles | **WhatsApp account status** |
| Message template paused | WhatsApp met un modèle en pause | **Template paused** |
| Message template disabled | WhatsApp désactive un modèle | **Template disabled** |
| Message template quality dropped | La note d'un modèle descend à Rouge | **Template quality drop** |

### Pastilles des modèles

La liste des modèles affiche **Quality: Yellow**, **Quality: Red**, **Paused by WhatsApp**, **Quality pause 1/3** (le compteur augmente à chaque pause) et **Disabled by WhatsApp**. Les pauses liées au rythme d'envoi disposent aussi d'un bouton **Unpause**. Voir [Pastilles de santé de remise dans la liste des modèles](https://knowledge.flowella.io/fr/app/templates.md#delivery-health-pills-on-the-templates-list).

### Messages en échec et Results

Lorsque Meta bloque un envoi en raison de la qualité de votre numéro ([erreur 131048](https://knowledge.flowella.io/fr/whatsapp/errors/error-131048.md)), l'Inbox affiche la raison sous le message. Dans [Results](https://knowledge.flowella.io/fr/app/analytics.md#delivery-read-and-failure-rates), les taux de remise et d'échec dans le temps vous aident à repérer la campagne à l'origine des blocages.

## Comment se rétablir du Jaune

La plupart des notes Jaunes se rétablissent en quelques jours **si** vous changez immédiatement de comportement :

**1. Mettez en pause les envois sortants agressifs**

Arrêtez les envois marketing vers des listes froides ou peu engagées pendant au moins 24 heures.

**2. Trouvez la cause**

Consultez [Results](https://knowledge.flowella.io/fr/app/analytics.md) dans Flowella et le Gestionnaire WhatsApp pour voir quelle campagne ou quel modèle coïncide avec la baisse.

**3. Resserrez l'audience**

Lors de vos prochains envois, ciblez les consentements récents et les contacts qui ont répondu récemment.

**4. Réduisez le volume**

Envoyez à moins de destinataires uniques chaque jour pendant que la qualité se rétablit, et maintenez des modèles de haute qualité pour ne pas bloquer l'augmentation de votre [limite de messagerie](https://knowledge.flowella.io/fr/whatsapp/limits/messaging-limits.md).

**5. Surveillez chaque jour**

Vérifiez dans le Gestionnaire WhatsApp que la note revient vers le Vert avant d'augmenter à nouveau le volume.

## Comment se rétablir du Rouge

Le Rouge est plus grave. Meta peut restreindre le numéro tant qu'il est Rouge, et une longue période en Rouge peut bloquer l'envoi.

* Arrêtez les envois à l'origine des blocages, y compris les modèles marketing que les clients signalent.
* Reprenez progressivement, uniquement avec des audiences engagées.
* Corrigez les noms d'affichage ou les contenus de modèles que les clients ne reconnaissent pas ou n'attendaient pas.
* Si Meta a restreint le numéro, attendez que Meta lève la restriction ou utilisez un autre numéro éligible. Flowella ne peut pas passer outre une restriction de Meta.

## Qualité et erreurs de remise

| Signal | Ce que cela signifie généralement | Guide |
| - | - | - |
| **131048** | Meta a restreint les envois depuis **votre** numéro pour des raisons de spam ou de qualité | [Erreur 131048](https://knowledge.flowella.io/fr/whatsapp/errors/error-131048.md) |
| **131049** | Limite marketing par utilisateur côté destinataire, et non la limite de votre portefeuille | [Erreur 131049](https://knowledge.flowella.io/fr/whatsapp/limits/per-user-marketing-limit.md) |
| Limite de messagerie du portefeuille | Destinataires uniques en dehors de la fenêtre de 24 heures pour le **portefeuille d'activités** | [Limites de messagerie](https://knowledge.flowella.io/fr/whatsapp/limits/messaging-limits.md) |
| Modèle en pause ou Rouge | Les parcours et les actions HubSpot ne peuvent pas compter sur ce modèle | [Modèle rejeté](https://knowledge.flowella.io/fr/troubleshooting/template-rejected.md), [Messages non remis](https://knowledge.flowella.io/fr/troubleshooting/messages-not-delivered.md) |

Flowella affiche un texte d'échec différent pour 131048 (la qualité de votre numéro) et 131049 (la limite marketing du destinataire). Traitez-les comme des problèmes distincts.

## Prévenir les baisses

* Rendez le consentement WhatsApp explicite au moment où vous collectez le numéro.
* Définissez des plafonds de fréquence dans les workflows HubSpot.
* Segmentez les listes plutôt que d'envoyer un même modèle marketing à tous les numéros de téléphone du CRM.
* Surveillez les premiers pics d'échecs dans [Results](https://knowledge.flowella.io/fr/app/analytics.md) et faites une pause avant que Meta ne vous fasse passer au Rouge.

## Guides connexes

* [Rythme et pause des modèles](https://knowledge.flowella.io/fr/whatsapp/limits/template-pacing-and-pausing.md) : les modèles retenus, mis en pause et désactivés
* [Débit](https://knowledge.flowella.io/fr/whatsapp/limits/throughput.md) : le passage à 1 000 messages par seconde exige une qualité Medium
* [Limites de messagerie](https://knowledge.flowella.io/fr/whatsapp/limits/messaging-limits.md) : les limites du portefeuille que la qualité aide à débloquer
* [Erreur 131048](https://knowledge.flowella.io/fr/whatsapp/errors/error-131048.md) : restrictions pour spam ou qualité sur votre numéro
* [Erreur 131049](https://knowledge.flowella.io/fr/whatsapp/limits/per-user-marketing-limit.md) : engagement sain de l'écosystème
* [Messages non remis](https://knowledge.flowella.io/fr/troubleshooting/messages-not-delivered.md) : dépannage de la remise
* [Modèles](https://knowledge.flowella.io/fr/app/templates.md) : pastilles, pauses et envois en attente
* [Gestion des opt-outs](https://knowledge.flowella.io/fr/app/opt-outs.md) : garder un consentement propre
* [Modèle rejeté](https://knowledge.flowella.io/fr/troubleshooting/template-rejected.md) : problèmes de catégorie et d'approbation

Vérifié par rapport à la documentation de Meta le 18 novembre 2026 : [Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality), [Changes to messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/upcoming-messaging-limits-changes) et [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput).


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