# Error 132069 de WhatsApp: Flow limitado (throttled) — causa y solución

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

> Error 132069 de WhatsApp: el Flow está limitado a 10 envíos por hora porque su endpoint no está en buen estado. Cómo corregir el endpoint y volver a Published.

El error 132069 de WhatsApp significa que tu Flow está en estado "throttled" (limitado): WhatsApp detectó que su
endpoint no está en buen estado, por latencia, errores o caídas, y limita el envío a 10 mensajes por
hora. La causa está en tu servidor. Corrige el endpoint; el Flow vuelve a publicado por sí solo
cuando las métricas se recuperan.

## ¿Qué significa el error 132069?

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

Su código vecino describe la etapa siguiente:

> "Flow is in blocked state."
> — Meta, código 132068

Para ambos, la indicación de Meta es la misma: corregir el Flow. Estos estados solo se aplican a los Flows que
llaman a tu endpoint para obtener sus datos
([Meta, Flow health and monitoring](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/healthmonitoring)).

| Estado del Flow    | Restricción                         | Efecto para los usuarios                              |
| ------------------ | ----------------------------------- | ----------------------------------------------------- |
| Published          | Ninguna                             | Ninguno                                               |
| Throttled (132069) | 10 mensajes de Flow nuevos por hora | Los Flows ya recibidos se siguen abriendo y funcionan |
| Blocked (132068)   | Ningún envío                        | Los Flows ya enviados dejan de abrirse                |

## ¿Cuándo ocurre el error 132069?

WhatsApp supervisa tres métricas del endpoint de un Flow: la **tasa de errores** (del lado del endpoint o del
cliente), la **latencia** y la **disponibilidad**. Cuando una de ellas se deteriora de forma significativa, el
Flow pasa primero a *Throttled* y luego a *Blocked* si la situación empeora. Meta envía varios webhooks
de alerta antes de llegar a ese punto.

Causas típicas:

* un endpoint que tarda varios segundos en responder porque consulta una base de datos o una API lenta;
* un endpoint que no responde a las solicitudes de verificación de estado (health check);
* un despliegue que rompe el descifrado o devuelve errores en serie;
* un servidor que no es accesible desde internet.

### ¿Dónde lo ves en Genuka WA?

| Canal                                | Lo que recibes                                                                                               |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| Respuesta de `POST /api/v1/messages` | `400`, `"error": "send_template"`, `meta.code: 132069` (o `132068`)                                          |
| `GET /api/v1/flows/{id}`             | `data.status` leído desde Meta en cada llamada: `published`, `throttled` o `blocked`, con `validationErrors` |
| Webhook `flow.status_changed`        | Los eventos del campo `flows` que envía Meta, reenviados a tu endpoint                                       |

Genuka WA clasifica los códigos 132xxx como `template`: volver a enviar el mismo mensaje no cambia nada
hasta que se corrija el endpoint.

## ¿Cómo corrijo el error 132069?

1. **Lee las alertas que recibiste** para este Flow: indican cuál de las tres métricas se degradó.
2. **Ante una alerta de latencia**, acelera el endpoint. Meta recomienda responder en menos de un segundo:
   caché, precarga, sacar las llamadas lentas del camino de la solicitud.
3. **Ante una alerta de disponibilidad**, verifica que el endpoint sea accesible de forma continua desde internet
   y que responda a las solicitudes de verificación de estado. El handler `createFlowEndpoint` de la biblioteca las responde
   automáticamente: consulta [Flows en la biblioteca](https://wa.genuka.com/sdk/flows).
4. **Ante una alerta de tasa de errores**, revisa los errores listados en la alerta con la referencia de
   códigos de error de Flows de Meta.
5. **Espera la recuperación automática.** WhatsApp detecta la corrección y pasa el Flow de *Blocked* a
   *Throttled* y luego de *Throttled* a *Published*. Síguelo con `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": "book_appointment", "status": "throttled", ... }, "validationErrors": [] }
```

**Node.js**

```ts
/** Envía un Flow solo cuando está publicado; de lo contrario, usa otra vía. */
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 envíos por hora como máximo. "blocked": ninguno.
  return data.status === "published";
}
```

## ¿Cómo evito el error 132069?

* **Mide la latencia de tu endpoint** con carga real, no solo en desarrollo.
* **Supervisa el endpoint como un servicio de producción**: disponibilidad, tasa de errores, tiempo de respuesta,
  con una alerta que se active antes de que WhatsApp reaccione.
* **Recibe los eventos `flow.status_changed`** para saber cuándo un Flow cambia de estado sin esperar
  a que falle un envío.
* **Prevé una vía alternativa** (enlace web, conversación normal) para cuando el Flow no esté `published`.

## Códigos de error relacionados

* [131047](https://wa.genuka.com/es/docs/errors/131047): un Flow enviado como mensaje interactivo fuera de la ventana de 24 horas
  se rechaza; en ese caso necesitas una plantilla con un botón de Flow.
* [132001](https://wa.genuka.com/es/docs/errors/132001): la plantilla que lleva el botón de Flow no existe en ese
  idioma o no está aprobada.

## Preguntas frecuentes

### ¿Mis usuarios todavía pueden completar un Flow limitado?

Sí. En el estado *Throttled*, los Flows ya recibidos se abren y funcionan; solo el envío de mensajes nuevos está
limitado a 10 por hora. En cambio, en el estado *Blocked*, ni siquiera los Flows ya enviados se abren.

### ¿Se ven afectados los Flows sin endpoint?

No. Meta indica que la supervisión de estado solo se aplica a los Flows que usan datos de tu endpoint.

### ¿Tengo que volver a publicar el Flow después de corregirlo?

No. WhatsApp detecta automáticamente que el endpoint se recuperó y vuelve a subir el Flow,
de *Blocked* a *Throttled* y luego a *Published*.

## Fuentes

* [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)
