Genuka WA docs

Error 80007 de WhatsApp: límite de velocidad de la cuenta alcanzado — solución

Error 80007 de WhatsApp: la cuenta de WhatsApp Business alcanzó su límite de llamadas a la API (200 o 5.000 por hora). Qué llamadas cuentan y cómo evitarlo.

El error 80007 de WhatsApp significa que una aplicación hizo demasiadas llamadas sobre una cuenta de WhatsApp Business en la misma hora: 200 de forma predeterminada, 5.000 para una cuenta activa con un número registrado. Las llamadas que cuentan son las de administración de la cuenta, como plantillas y números de teléfono, no los envíos de mensajes. Espera y luego llama con menos frecuencia.

¿Qué significa el error 80007?

Meta lo clasifica entre los errores de limitación (throttling):

"The WhatsApp Business Account has reached its rate limit." — Meta, códigos de error de la Cloud API

Solución sugerida: consultar los límites de velocidad de la cuenta de WhatsApp Business y luego "try again later or reduce the frequency or amount of API queries the app is making" (volver a intentarlo más tarde o reducir la frecuencia o la cantidad de consultas a la API que hace la app).

Esos límites se describen en la descripción general de la plataforma: las solicitudes de una app sobre una cuenta se cuentan sobre una hora móvil, a razón de 200 por hora, por app y por cuenta de forma predeterminada, y 5.000 por hora para una cuenta activa con al menos un número de teléfono registrado (Meta, About the platform). Abarcan estos endpoints:

SolicitudEndpoint
GET/{WABA_ID}
GET, POST, DELETE/{WABA_ID}/assigned_users
GET/{WABA_ID}/phone_numbers
GET, POST, DELETE/{WABA_ID}/message_templates
GET, POST, DELETE/{WABA_ID}/subscribed_apps
GET/{WABA_TO_NUMBER_CURRENT_STATUS_ID}

La página general de límites de velocidad de Graph también asocia el código 80008 al tipo de límite "WhatsApp Business Management API". Trata ambos de la misma manera (Meta, Rate limits).

¿Cuándo ocurre el error 80007?

  • Consultar las plantillas periódicamente (polling). Volver a leer la lista de plantillas cada minuto para ver si alguna fue aprobada cuesta 60 llamadas por hora sobre esa cuenta, antes de cualquier otra cosa.
  • Creación masiva de plantillas. Un script que envía, elimina y vuelve a crear decenas de plantillas una tras otra.
  • Una cuenta que todavía no está activa. Mientras no tenga un número registrado, la cuenta se queda en 200 llamadas por hora.

¿Dónde lo ves en Genuka WA?

El límite se cuenta por aplicación y por cuenta de WhatsApp. Con Genuka WA, la aplicación es la de Genuka: todas las llamadas hechas sobre la cuenta de un cliente cuentan juntas, ya vengan de tu código, del panel o del portal del cliente. En cambio, la cuenta de un cliente nunca agota el límite de otro cliente.

Del lado de Genuka WA, estas llamadas pasan por:

Endpoint de Genuka WALlamada a Meta contabilizada
POST /api/v1/templatesPOST /{WABA_ID}/message_templates
DELETE /api/v1/templates/{id}DELETE /{WABA_ID}/message_templates
POST /api/v1/templates/sync, GET /api/v1/templates?sync=trueGET /{WABA_ID}/message_templates, una vez por cada cuenta de WhatsApp cubierta

Genuka coloca el código 80007 en la clase retryable. Una creación de plantilla rechazada llega como 422 meta_rejected con meta.retryable: true, o como un 502 si Meta respondió con un 429 o un 5xx. Una actualización sigue siendo un 200 mientras al menos una cuenta haya respondido: la cuenta limitada muestra "ok": false con el motivo de Meta en error. Si todas las cuentas lo rechazaron, la respuesta es un 502 meta_rejected.

Un 502 te llega sin cuerpo JSON: nuestra CDN lo reemplaza por la única línea error code: 502 (referencia de la API). Lee el estado HTTP antes que el cuerpo, y trata este caso como un fallo transitorio.

¿Cómo corrijo el error 80007?

Deja de pedir lo que llega por sí solo. La revisión de una plantilla llega por webhook, como un evento message_template_status_update (Webhooks). Suscribe un endpoint a él y elimina el bucle de lectura.

Reserva la actualización para las reparaciones. POST /api/v1/templates/sync existe para recuperar un webhook perdido: una vez por hora es más que suficiente, y companyId o connectionId la acotan a la única cuenta afectada (referencia de la API).

Reintenta más tarde lo que fue rechazado. Una creación de plantilla marcada como retryable se puede enviar de nuevo después de una espera; el límite se libera a medida que avanza la hora móvil.

Escalona la creación masiva. Envía las plantillas de un cliente nuevo en lotes pequeños en lugar de en una sola ráfaga.

Si llamas tú mismo a Graph, el encabezado X-Business-Use-Case-Usage indica la proporción de llamadas usadas (call_count) y, una vez limitado, estimated_time_to_regain_access, la cantidad de minutos antes de que todo vuelva a la normalidad (Meta, Rate limits).

// Una actualización por hora, acotada a un cliente, que reporta las cuentas que fallaron.
const response = await fetch("https://wa.genuka.com/api/v1/templates/sync", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ companyId: "cmp_1" }),
});
// Un 502 llega sin JSON: nuestra CDN lo reemplaza por "error code: 502".
const json = await response.json().catch(() => null);

if (!response.ok) {
  console.error("Ninguna cuenta respondió", response.status, json?.message ?? "");
} else {
  for (const waba of json.data.wabas.filter((w: { ok: boolean }) => !w.ok)) {
    console.warn("Cuenta no actualizada, reintenta la próxima hora", waba.wabaId, waba.error);
  }
}

¿Cómo evito el error 80007?

  • Primero los webhooks. El estado de una plantilla, un cambio de calidad o una actualización de la cuenta te llegan sin que tengas que pedirlos.
  • Una actualización programada, no una disparada por las visitas a una página. Un panel que vuelve a consultar a Meta cada vez que se abre multiplica las llamadas por la cantidad de visitantes.
  • Conecta el número antes de crear plantillas. Una cuenta activa con un número registrado obtiene 5.000 llamadas por hora en lugar de 200.

Códigos de error relacionados

  • 4: el límite de llamadas de toda la aplicación.
  • 130429: el rendimiento de mensajes de un número.
  • 80008: el código que la página de límites de velocidad de Graph asocia a la WhatsApp Business Management API.

Preguntas frecuentes

¿Por qué mi cuenta está limitada a 200 llamadas por hora en lugar de 5.000?

Meta reserva las 5.000 llamadas por hora para las cuentas activas con al menos un número registrado. Una cuenta creada sin número, o cuyo número todavía no está registrado, se queda en 200.

¿Los envíos de mensajes cuentan para este límite?

Los endpoints que Meta lista para este límite son de administración de la cuenta, no de envío. Los envíos tienen sus propios topes, entre ellos el rendimiento por número, código 130429.

¿La cuenta de un cliente puede agotar el límite de otro?

No. El límite se cuenta por aplicación y por cuenta de WhatsApp: cada cuenta tiene el suyo.

Fuentes

En esta página