Error 132069 de WhatsApp: Flow limitado (throttled) — causa y solución
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
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).
| 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?
Lee las alertas que recibiste para este Flow: indican cuál de las tres métricas se degradó.
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.
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.
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.
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 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": [] }¿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_changedpara 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: 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: 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
Error 132015 de WhatsApp: plantilla pausada — causa y solución
Error 132015 de WhatsApp: Meta pausó la plantilla por baja calidad. Cuánto duran las pausas (3 h, 6 h y luego desactivada con 132016) y cómo reanudar sin riesgo.
Comparativas de APIs de WhatsApp: Twilio, 360dialog, WATI
Genuka WA frente a Twilio, 360dialog, WATI y las APIs no oficiales de WhatsApp: modelo de precios, tarifas de Meta, coexistencia, webhooks y riesgos, lado a lado.