Límites y cuotas
Por plan de suscripción
Sección titulada «Por plan de suscripción»| Límite | Free | Pro | Admin |
|---|---|---|---|
| Sesiones simultáneas | 1 | 10 | Sin límite |
| Mensajes/mes | 100 | 10.000 | Sin límite |
| Plantillas por sesión | 3 | Sin límite | Sin límite |
| API Keys | No | Sí | Sí |
Ver Suscripciones.
Por sesión (anti-baneo)
Sección titulada «Por sesión (anti-baneo)»Independiente del plan — aplica a cómo se envían los mensajes, no a cuántos podés programar:
| Parámetro | Default | Variable de entorno |
|---|---|---|
| Delay entre mensajes | 8–25s aleatorio | WA_SEND_MIN_DELAY_MS / WA_SEND_MAX_DELAY_MS |
| Máx. mensajes/hora | 60 | WA_SEND_MAX_PER_HOUR |
| Máx. mensajes/día | 300 | WA_SEND_MAX_PER_DAY |
| Rampa de warmup para cuentas nuevas | desactivada | WA_WARMUP_ENABLED |
| Pausa larga cada N mensajes | cada 25, 3 min | WA_LONG_PAUSE_EVERY / WA_LONG_PAUSE_MS |
| Quiet hours | desactivadas | WA_QUIET_HOURS_START / WA_QUIET_HOURS_END |
Estos valores se fijan por sesión la primera vez que se necesitan (al primer envío) y quedan fijos desde entonces para esa sesión — cambiar la variable de entorno no afecta sesiones que ya tienen una política creada.
Ver el detalle completo en Envío masivo seguro.
Throttling de la API HTTP
Sección titulada «Throttling de la API HTTP»Además de las cuotas de negocio, los endpoints tienen rate-limiting propio con @nestjs/throttler (independiente de lo anterior — esto protege la API en sí, no el canal hacia WhatsApp):
| Endpoint | Límite |
|---|---|
POST /sessions |
10/min |
POST /sessions/:id/pairing-code |
5/min (más estricto: pedir códigos en loop es en sí mismo abuso hacia WhatsApp) |
GET /sessions/:id/qr, GET /sessions/:id/health |
30/min |
| Resto de endpoints de sesiones/schedules/templates | 10–100/min según el endpoint |
Qué pasa al chocar un límite
Sección titulada «Qué pasa al chocar un límite»- Límite de plan (sesiones, mensajes, templates, API Keys) →
403 Forbiddeninmediato con el motivo. - Cuota anti-baneo o quiet hours → el schedule no falla, se reprograma automáticamente para cuando vuelva a ser válido.
- Rate-limit HTTP →
429 Too Many Requests.