# Erreur WhatsApp 132069 : Flow limité (throttled)

URL: https://wa.genuka.com/docs/errors/132069
Language: French

> Erreur WhatsApp 132069 : Flow en état throttled, limité à 10 envois par heure parce que son endpoint répond mal. Comment le réparer et revenir à Published.

L'erreur WhatsApp 132069 signifie que votre Flow est en état « throttled » : WhatsApp a détecté que
son endpoint répond mal, par lenteur, erreurs ou indisponibilité, et limite son envoi à 10 messages
par heure. La cause est côté serveur. Réparez l'endpoint ; le Flow redevient publié
automatiquement une fois les métriques rétablies.

## Que signifie l'erreur 132069 ?

> « Flow is in throttled state and 10 messages using this flow were already sent in the last
> hour. »
> — [Meta, codes d'erreur de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

Son code voisin décrit l'étape suivante :

> « Flow is in blocked state. »
> — Meta, code 132068

Pour les deux, la consigne de Meta est la même : corriger le Flow. Ces états ne concernent que les
Flows qui appellent votre endpoint pour obtenir leurs données
([Meta, Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring)).

| État du Flow       | Restriction                         | Effet pour les utilisateurs                             |
| ------------------ | ----------------------------------- | ------------------------------------------------------- |
| Published          | Aucune                              | Aucun                                                   |
| Throttled (132069) | 10 nouveaux messages Flow par heure | Les Flows déjà reçus s'ouvrent et fonctionnent toujours |
| Blocked (132068)   | Plus aucun envoi                    | Les Flows déjà envoyés ne s'ouvrent plus                |

## Quand l'erreur 132069 apparaît-elle ?

WhatsApp surveille trois métriques de l'endpoint d'un Flow : le **taux d'erreur** (côté endpoint
ou côté client), la **latence** et la **disponibilité**. Quand l'une se dégrade nettement, le Flow
passe d'abord en *Throttled*, puis en *Blocked* si la dégradation continue. Meta envoie plusieurs
alertes par webhook avant d'en arriver là.

Les causes typiques :

* un endpoint qui met plusieurs secondes à répondre, parce qu'il interroge une base ou une API
  lente ;
* un endpoint qui ne répond pas aux requêtes de contrôle de santé (*health check*) ;
* un déploiement qui casse le déchiffrement ou renvoie des erreurs en série ;
* un serveur injoignable depuis Internet.

### Où la voir dans Genuka WA ?

| Canal                              | Ce que vous recevez                                                                                          |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| Réponse de `POST /api/v1/messages` | `400`, `"error": "send_template"`, `meta.code: 132069` (ou `132068`)                                         |
| `GET /api/v1/flows/{id}`           | `data.status` relu chez Meta à chaque appel : `published`, `throttled` ou `blocked`, avec `validationErrors` |
| Webhook `flow.status_changed`      | Les événements du champ `flows` que Meta envoie, transmis à votre endpoint                                   |

Genuka WA classe les codes 132xxx en `template` : renvoyer le même message ne changera rien tant
que l'endpoint n'est pas réparé.

## Comment corriger l'erreur 132069 ?

1. **Lisez les alertes reçues** pour ce Flow : elles indiquent laquelle des trois métriques s'est
   dégradée.
2. **Pour une alerte de latence**, accélérez l'endpoint. Meta recommande de répondre en moins d'une
   seconde : mettez en cache, préchargez, sortez les appels lents du chemin de la requête.
3. **Pour une alerte de disponibilité**, vérifiez que l'endpoint est joignable depuis Internet en
   continu et qu'il répond aux requêtes de contrôle de santé. Le gestionnaire `createFlowEndpoint` de
   la librairie y répond automatiquement : voir [Flows dans la librairie](https://wa.genuka.com/sdk/flows).
4. **Pour une alerte de taux d'erreur**, reprenez les erreurs citées dans l'alerte avec la
   référence des codes d'erreur des Flows de Meta.
5. **Attendez la reprise automatique.** WhatsApp détecte la réparation et fait repasser le Flow de
   *Blocked* à *Throttled*, puis de *Throttled* à *Published*. Suivez-le avec
   `GET /api/v1/flows/{id}`.

**curl**

```bash
curl https://wa.genuka.com/api/v1/flows/flw_1 \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
# { "data": { "id": "flw_1", "name": "prise_de_rendez_vous", "status": "throttled", ... }, "validationErrors": [] }
```

**Node.js**

```ts
/** N'envoyez un Flow que s'il est publié ; sinon, passez par un autre parcours. */
export async function flowIsSendable(flowId: string): Promise<boolean> {
  const response = await fetch(`https://wa.genuka.com/api/v1/flows/${flowId}`, {
    headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}` },
  });
  const { data } = await response.json();
  // "throttled" : 10 envois par heure au plus. "blocked" : aucun.
  return data.status === "published";
}
```

## Comment éviter l'erreur 132069 ?

* **Mesurez la latence de votre endpoint** sous charge réelle, pas seulement en développement.
* **Surveillez l'endpoint comme un service de production** : disponibilité, taux d'erreur, temps
  de réponse, avec une alerte avant que WhatsApp ne réagisse.
* **Recevez les événements `flow.status_changed`** pour savoir qu'un Flow change d'état sans
  attendre l'échec d'un envoi.
* **Prévoyez un parcours de repli** (lien web, conversation classique) pour les cas où le Flow
  n'est pas `published`.

## Quels codes sont liés ?

* [131047](https://wa.genuka.com/docs/errors/131047) : un Flow envoyé comme message interactif hors de la fenêtre de
  24 heures est refusé ; il faut alors un template avec un bouton Flow.
* [132001](https://wa.genuka.com/docs/errors/132001) : le template portant le bouton Flow est introuvable dans cette
  langue, ou pas approuvé.

## FAQ

### Mes utilisateurs peuvent-ils encore remplir un Flow limité ?

Oui. En état *Throttled*, les Flows déjà reçus s'ouvrent et fonctionnent ; seul l'envoi de nouveaux
messages est limité à 10 par heure. En état *Blocked*, en revanche, même les Flows déjà envoyés ne
s'ouvrent plus.

### Les Flows sans endpoint sont-ils concernés ?

Non. Meta précise que la surveillance de santé ne s'applique qu'aux Flows qui utilisent les
données de votre endpoint.

### Faut-il republier le Flow après réparation ?

Non. WhatsApp détecte automatiquement que l'endpoint est rétabli et fait remonter l'état du Flow,
de *Blocked* à *Throttled* puis à *Published*.

## Sources

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring)