Primeiros passos
Limites de uso
Orçamento por chave para leituras, escritas e envios.
Os limites são contados por chave, em janelas fixas. Cada rota pertence a um balde, indicado na página dela.
| Balde | Limite | Cobre |
|---|---|---|
| Leitura | 120 requisições / minuto | Todo GET, mais o próprio endpoint MCP. |
| Escrita | 60 requisições / minuto | Mudanças que ficam dentro do BatZap: etiquetas, atribuição, status, anotações. |
| Envio | 10 / minuto e 300 / dia | Tudo que chega no WhatsApp: enviar, editar, iniciar conversa, subir mídia, criar grupo e adicionar participantes. |
Passar do limite devolve 429 com o header Retry-After, em segundos. Espere esse tempo antes de tentar de novo; repetir em loop só prolonga o bloqueio.
O balde de envio é pequeno de propósito. Ele protege o seu número: o WhatsApp bane números que parecem automatizados, e isso não tem como ser desfeito do nosso lado.