Visão Geral
O EnviaAI aplica limites de requisições (rate limits) para garantir estabilidade e disponibilidade para todos os usuários. Os limites variam por plano e endpoint.Limites por Plano
- Free
- Starter
- Pro
- Enterprise
| Endpoint | Limite | Janela |
|---|---|---|
| Mensagens | 100 req | por minuto |
| Instâncias | 50 req | por minuto |
| Webhooks | 100 req | por minuto |
| Geral | 500 req | por minuto |
Headers de Rate Limit
Toda resposta inclui headers informativos:| Header | Descrição |
|---|---|
X-RateLimit-Limit | Total de requisições permitidas na janela |
X-RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset | Timestamp Unix quando a janela reseta |
Resposta 429
Quando você excede o limite, recebe:Retry-After indica quantos segundos esperar:
Implementando Retry
Exponential Backoff
Queue com Rate Limiting
Bulk Operations
Para enviar muitas mensagens, use batch com controle de rate:Monitoramento
Dashboard
Monitore uso em tempo real no Developer Portal
Alertas
Configure alertas quando atingir 80% do limite
Boas Práticas
Monitore os headers
Monitore os headers
Sempre verifique
X-RateLimit-Remaining antes de enviar em massa.Implemente backoff
Implemente backoff
Use exponential backoff com jitter para evitar thundering herd.
Use filas
Use filas
Para alto volume, use filas (Bull, RabbitMQ) com rate limiting.
Cache quando possível
Cache quando possível
Cache respostas de endpoints de leitura (list, get) quando fizer sentido.
Considere upgrade
Considere upgrade
Se atingir limites frequentemente, considere upgrade de plano.
Limites Especiais
Mensagens por Número
Além do rate limit da API, o WhatsApp tem limites próprios:| Tier | Limite/24h | Como aumentar |
|---|---|---|
| Tier 1 | 1.000 | Verificação de negócio |
| Tier 2 | 10.000 | Bom quality rating |
| Tier 3 | 100.000 | Excelente quality rating |
| Tier 4 | Ilimitado | Enterprise |
Estes limites do WhatsApp se aplicam apenas à API Oficial (Meta).
Precisa de Mais?
Enterprise
Para limites customizados, fale com nosso time comercial.