Error 4 de WhatsApp: la app alcanzó su límite de llamadas a la API
El código de error 4 indica que la app alcanzó su límite de llamadas a la API. La descripción de Meta es "The app has reached its API call rate limit." Cuenta las llamadas que realiza la app durante una hora continua, no los mensajes enviados desde un número. Comprueba el uso en el App Dashboard, espera y reduce la frecuencia con la que la app llama a la API.
El código de Meta para "The app has reached its API call rate limit."
Las llamadas que una app puede realizar en una hora según Graph API Platform Rate Limits.
El nombre que la guía de gestión de errores de Graph API da al código 4.
¿Qué significa el código de error 4 de WhatsApp?
Significa que tu app realizó demasiadas llamadas a la API durante la ventana actual y que las siguientes llamadas se rechazan hasta que el recuento disminuya.
Meta incluye el código 4 entre los errores de limitación, con el texto detallado "The app has reached its API call rate limit." La guía de gestión de errores de Graph API lo llama API Too Many Calls y lo describe como un problema temporal de limitación.
Aparece junto a otros dos códigos de limitación que se confunden fácilmente. El 80007 indica que la WhatsApp Business Account alcanzó su límite de tasa. El 130429 corresponde al throughput de mensajes de Cloud API. El código 4 no es ninguno de los dos: corresponde al presupuesto propio de llamadas de la app.
¿Cómo se calcula el límite de llamadas de la app?
Para las peticiones realizadas con un token de acceso de la app, la guía de limitación de tasa de Graph API establece una fórmula: las llamadas durante una hora equivalen a 200 multiplicado por el número de usuarios.
El número de usuarios se basa en los usuarios activos diarios únicos de la app, y usa cifras semanales y mensuales cuando el uso diario disminuye. Es un límite para toda la app, no por usuario, así que unos pocos usuarios activos pueden consumir gran parte del presupuesto.
La guía también indica que el uso aparece en el App Dashboard y, después de realizar suficientes llamadas, en un encabezado X-App-Usage de las respuestas. Ese encabezado permite ver que el límite se aproxima antes de que aparezca el error 4.
¿Qué debes hacer después del error 4?
Deja de llamar durante un tiempo y luego llama con menos frecuencia.
La guía de limitación de tasa de Meta es clara sobre el primer punto: cuando se alcanza el límite, deja de realizar llamadas a la API, porque continuar aumenta el recuento y alarga el tiempo hasta que las llamadas vuelvan a funcionar.
El segundo punto es de diseño. Distribuye las peticiones de forma uniforme en lugar de enviarlas en ráfagas, filtra las respuestas para que una llamada devuelva lo que necesitas y evita llamadas que obtengan datos superpuestos. La consulta periódica suele ser la causa. Una integración que solicita el mismo estado de cuenta cada pocos segundos gasta su presupuesto en respuestas que ya tiene.
Errores comunes
- Reintentar en un bucle. Cada llamada adicional aumenta el recuento y retrasa aún más la recuperación.
- Tratarlo como un límite de envío. El código 4 cuenta las llamadas de la app, mientras que el throughput de mensajes es 130429.
- Consultar endpoints de estado con intervalos cortos. Leer repetidamente datos sin cambios consume el presupuesto horario.
EasyCoexistence supervisa cada número conectado las 24 horas, por su cuenta, así que comprobar el estado de la conexión no requiere crear un bucle de consultas contra el presupuesto de llamadas de tu app.
Preguntas frecuentes
¿El error 4 es igual que el error 130429?
No. El 130429 corresponde al throughput de mensajes de un número. El error 4 corresponde al número de llamadas a la API que realizó tu app.
¿Cuánto dura el error 4?
Hasta que el recuento de llamadas de la ventana continua de una hora quede por debajo del límite. Llamar durante ese tiempo lo prolonga.
¿Dónde puedo ver cuánto falta para que mi app alcance el límite?
En la sección Application Rate Limit del App Dashboard y en el encabezado X-App-Usage que devuelven las respuestas.
¿El error 4 es igual que el error 80007?
No. Meta usa el 80007 cuando la WhatsApp Business Account alcanza su límite de tasa, mientras que el error 4 cuenta las llamadas propias de la app.
Sigue leyendo
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisVerificado el