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

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

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#throttling-errors)

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#rate-limits)).
Abarcan estos endpoints:

| Solicitud               | Endpoint                              |
| ----------------------- | ------------------------------------- |
| `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](https://developers.facebook.com/docs/graph-api/overview/rate-limiting)).

## ¿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 WA                                            | Llamada a Meta contabilizada                                                     |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `POST /api/v1/templates`                                         | `POST /{WABA_ID}/message_templates`                                              |
| `DELETE /api/v1/templates/{id}`                                  | `DELETE /{WABA_ID}/message_templates`                                            |
| `POST /api/v1/templates/sync`, `GET /api/v1/templates?sync=true` | `GET /{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](https://wa.genuka.com/es/docs/api)). Lee el estado HTTP antes que el cuerpo, y trata
este caso como un fallo transitorio.

## ¿Cómo corrijo el error 80007?

1. **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](https://wa.genuka.com/es/docs/webhooks)). Suscribe un endpoint a él
   y elimina el bucle de lectura.
2. **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](https://wa.genuka.com/es/docs/api#plantillas)).
3. **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.
4. **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](https://developers.facebook.com/docs/graph-api/overview/rate-limiting)).

**Node.js**

```ts
// 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);
  }
}
```

**Python**

```python
import os
import requests

response = requests.post(
    "https://wa.genuka.com/api/v1/templates/sync",
    headers={"Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}"},
    json={"companyId": "cmp_1"},
    timeout=60,
)
try:
    body = response.json()
except ValueError:
    body = {}  # un 502 llega sin JSON: nuestra CDN lo reemplaza por "error code: 502"

if not response.ok:
    print("Ninguna cuenta respondió", response.status_code, body.get("message"))
else:
    for waba in body["data"]["wabas"]:
        if not waba["ok"]:
            print("Cuenta no actualizada, reintenta la próxima hora", waba["wabaId"], waba.get("error"))
```

**PHP**

```php
<?php
$ch = curl_init("https://wa.genuka.com/api/v1/templates/sync");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => "acme-crm/1.0 (+https://example.com)",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("GENUKA_WA_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["companyId" => "cmp_1"]),
]);
$raw = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); // 0 cuando la solicitud nunca terminó
curl_close($ch);
// Un 502 llega sin JSON: nuestra CDN lo reemplaza por "error code: 502".
$body = is_string($raw) ? json_decode($raw, true) : null;

if ($status === 0 || $status >= 400 || !is_array($body)) {
    error_log("Ninguna cuenta respondió: HTTP $status " . ($body["message"] ?? ""));
} else {
    foreach ($body["data"]["wabas"] as $waba) {
        if (!$waba["ok"]) error_log("Cuenta no actualizada: {$waba['wabaId']} " . ($waba["error"] ?? ""));
    }
}
```

**curl**

```bash
# Un 502 llega como texto plano ("error code: 502"), que jq entonces no puede leer.
curl -s -X POST https://wa.genuka.com/api/v1/templates/sync \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "companyId": "cmp_1" }' \
  | jq '.data.wabas[] | select(.ok == false)'
```

## ¿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](https://wa.genuka.com/es/docs/errors/4): el límite de llamadas de toda la aplicación.
* [130429](https://wa.genuka.com/es/docs/errors/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](https://wa.genuka.com/es/docs/errors/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

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — About the platform, rate limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#rate-limits)
* [Meta — Graph API, Rate limits](https://developers.facebook.com/docs/graph-api/overview/rate-limiting)
