> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Límites de envío

> GOWA no hace solicitudes de límite de tarifas. ¿Qué límites existen, cómo WhatsApp restringe a los remitentes y cómo medir su tráfico.

> [!WARNING]
>
> **GOWA no tiene límite de tasa.** No cuenta peticiones, devuelve `429` para el volumen de solicitud, o envía cabeceras `X-RateLimit-*`. Cada solicitud que hagas se transmite a WhatsApp inmediatamente. Empacar es tu responsabilidad.

## Límites GOWA fuerza

| Límite | Valor | Resultado cuando se exceda |
| - | - | - |
| Tiempo de espera de solicitud | 45 s | `504 GATEWAY_TIMEOUT` |
| Solicitar cuerpo | 100 MB | Solicitud rechazada (`413`) |
| Imagen / documento / subida de vídeo | 20/50/100 MB | `400` error de validación |
| Entrega de Webhook | 10 s por intento, 5 intentos | Evento soltado |

## Limita las fuerzas de WhatsApp

WhatsApp no publica sus límites para dispositivos enlazados y cambian. Las cuentas que envían demasiado, demasiado rápido, o a personas que nunca les escribieron están restringidas o prohibidas. GOWA no puede detectar o prevenir esto de antemano.

La única señal de superficies GOWA es **`WA_REACHOUT_TIMELOCK`** (HTTP `429`):

```json theme={null}
{
  "code": "WA_REACHOUT_TIMELOCK",
  "message": "..."
}
```

WhatsApp devuelve este error (error 463) cuando la cuenta está temporalmente bloqueada para iniciar **nuevos** chats. No se puede pasar por alto o volver a intentarlo. Hasta que no levante la base:

* Sólo envía mensajes a personas que te han enviado primero o que responden en chats existentes.
* Enviar un mensaje desde el propio teléfono a veces lo borra antes.
* Detener el alcance a granel o frío y ralentizar el proceso.

## Guía de empaquetado

Estos son puntos de partida conservadores, no garantías:

* Enviar secuencialmente por dispositivo; no disparar cientos de solicitudes simultáneas.
* Agrega un retardo entre mensajes (varios segundos, con jitter aleatorio) y pausa más larga entre lotes.
* Los contactos preferidos que optaron por entrar o escribir primero. Los mensajes no solicitados se informan, y los informes llevan a prohibiciones.
* Calienta nuevos números lentamente durante días.
* Personalizar el contenido; texto idéntico a muchos destinatarios se ve como spam.
* Deténgase en `WA_REACHOUT_TIMELOCK` y alerte a un humano.

```python theme={null}
import random, time, requests

session = requests.Session()
session.auth = ("admin", "changeme")
session.headers["X-Device-Id"] = "my-device"

for phone, text in recipients:
    r = session.post("http://localhost:3000/send/message",
                     json={"phone": phone, "message": text}, timeout=60)
    body = r.json()
    if body.get("code") == "WA_REACHOUT_TIMELOCK":
        print("Reach-out blocked; stopping")
        break
    r.raise_for_status()
    time.sleep(random.uniform(5, 12))
```

Para envíos repartidos a lo largo del tiempo, usa [envíos programados](https://gowa-docs.mintlify.site/es/examples/scheduled-sends.md) en lugar de un bucle de larga ejecución.

## Protegiendo a GOWA en sí mismo

Si GOWA es accesible desde Internet, añada límites de solicitudes en su proxy inverso, especialmente para conexiones de Basic Auth fallidas y, con MCP OAuth, `/oauth/authorize`. Por ejemplo, con nginx:

```nginx theme={null}
limit_req_zone $binary_remote_addr zone=gowa:10m rate=10r/s;

server {
    location / {
        limit_req zone=gowa burst=20 nodelay;
        proxy_pass http://127.0.0.1:3000;
    }
}
```


## Related topics

- [Lista de envíos programados](https://gowa-docs.mintlify.site/es/api-reference/send/lista-de-envíos-programados.md)
- [Límites de tasa](https://gowa-docs.mintlify.site/es/api-reference/rate-limits.md)
- [Mensajes interactivos experimentales](https://gowa-docs.mintlify.site/es/examples/interactive-messages.md)
- [Manejo de errores](https://gowa-docs.mintlify.site/es/advanced/error-handling.md)
- [Manejo de medios](https://gowa-docs.mintlify.site/es/examples/media-handling.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.