Genuka WA docs

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 FlowRestricciónEfecto para los usuarios
PublishedNingunaNinguno
Throttled (132069)10 mensajes de Flow nuevos por horaLos Flows ya recibidos se siguen abriendo y funcionan
Blocked (132068)Ningún envíoLos 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?

CanalLo que recibes
Respuesta de POST /api/v1/messages400, "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_changedLos 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_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: 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

En esta página