Rate Limits
A Wapizap API implementa rate limiting para garantir estabilidade e disponibilidade do serviço para todos os usuários.Limites por Operação
| Operação | Limite | Janela |
|---|---|---|
| Enviar mensagens | 30 | por minuto / instância |
| Criar instâncias | 10 | por hora |
| Listar recursos | 60 | por minuto |
| Operações gerais | 120 | por minuto |
| Upload de mídia | 20 | por minuto |
Limites por Plano
| Plano | Requisições/min | Instâncias | Mensagens/dia |
|---|---|---|---|
| Free | 60 | 1 | 1.000 |
| Starter | 120 | 3 | 10.000 |
| Pro | 300 | 10 | 100.000 |
| Enterprise | Personalizado | Ilimitado | Ilimitado |
Headers de Rate Limit
Toda resposta inclui headers informativos:| Header | Descrição |
|---|---|
X-RateLimit-Limit | Limite total de requisições no período |
X-RateLimit-Remaining | Requisições restantes |
X-RateLimit-Reset | Timestamp Unix quando o limite reseta |
Resposta de Rate Limit Excedido
Quando você excede o limite, recebe HTTP 429:Como Lidar com Rate Limits
1. Verificar Headers
2. Implementar Exponential Backoff
3. Implementar Queue de Mensagens
4. Distribuir entre Instâncias
Para alto volume, use múltiplas instâncias:Boas Práticas
Monitore os Headers
Acompanhe
X-RateLimit-Remaining para evitar bloqueios.Use Queues
Implemente filas para controlar o fluxo de mensagens.
Cache Respostas
Cache dados que não mudam frequentemente (listas, configurações).
Batch Requests
Agrupe operações quando possível.
Limites do WhatsApp
Além dos limites da API, o WhatsApp tem suas próprias restrições: Recomendações:- Não envie mais de 200 mensagens/dia para números novos
- Aguarde respostas antes de enviar mais mensagens
- Evite mensagens idênticas em massa
- Varie o conteúdo das mensagens
Solicitar Aumento de Limite
Se seu caso de uso requer limites maiores:- Upgrade de plano - Planos maiores têm limites mais altos
- Enterprise - Limites personalizados para grandes volumes
- Contato - [email protected]
- Volume esperado (msgs/dia, msgs/min)
- Caso de uso
- Plano atual
- Instâncias necessárias
FAQ
O rate limit é por API key ou por instância?
O rate limit é por API key ou por instância?
Depende da operação:
- Envio de mensagens: Por instância
- Operações administrativas: Por API key
O que acontece se eu exceder continuamente?
O que acontece se eu exceder continuamente?
Exceder continuamente pode resultar em bloqueio temporário. Implemente backoff para evitar isso.
Posso ver meu histórico de uso?
Posso ver meu histórico de uso?
Sim, no Dashboard em Analytics → Uso da API.