Limites de API e Políticas de Uso
Para garantir a estabilidade da plataforma e proteger contra atividades fraudulentas como SMS pumping, aplicamos os seguintes limites de taxa. Compreender esses limites ajuda você a criar integrações resilientes.
✦ No credit card required · Free plan available · Setup in 5 minutes
Limites da API WhatsApp — Em Breve
Nossa API WhatsApp está em desenvolvimento ativo. Documentação completa cobrindo limites de taxa por endpoint, camadas de throughput de mensagens, permissões de burst e garantias de entrega de webhook está sendo finalizada e será publicada em breve.
Por enquanto, aqui está o que podemos compartilhar:
- Camadas de throughput são gerenciadas pela Meta e escalam automaticamente com base na avaliação de qualidade do seu número: Nível 1 (1.000 contatos/dia), Nível 2 (10.000), Nível 3 (100.000) e Nível 4 (ilimitado).
- Mensagens de template seguem a política de negócios da Meta — todos os templates devem ser pré-aprovados antes do envio.
- Mensagens de sessão só são permitidas dentro de 24 horas da última mensagem recebida do usuário.
Para detalhes específicos de limite ou para solicitar acesso antecipado, entre em contato com nossa equipe.
Limites de API — Perguntas Frequentes
O que acontece quando atinjo o limite de taxa?
Você recebe uma resposta HTTP 429 (Too Many Requests). A resposta inclui um cabeçalho Retry-After indicando o número de segundos para aguardar antes de tentar novamente. Implemente backoff exponencial na sua integração para lidar com isso adequadamente. Para operações de transmissão, nosso motor gerencia automaticamente os limites de throughput da Meta em seu nome.
Por que há um limite de 3 OTPs por número por 5 minutos?
Este limite existe para proteger contra fraude de SMS pumping — um esquema onde atores mal-intencionados usam bots automatizados para inundar números de telefone com solicitações de OTP. Sem esse limite, uma única chave API poderia custar milhares de reais em cobranças fraudulentas. A janela de 3 OTP / 5 minutos está alinhada com as melhores práticas do setor.
Posso solicitar limites mais altos de SMS API para minha conta?
Sim. Se seu caso de uso verificado justificar maior throughput, entre em contato com nossa equipe de suporte com os detalhes do seu caso de uso, volume esperado e informações da conta. Limites personalizados estão disponíveis nos planos Enterprise.
Quando os limites de taxa da API do WhatsApp serão publicados?
Nossa API WhatsApp está em desenvolvimento ativo. Estamos finalizando as especificações técnicas e a documentação completa para todos os endpoints. Limites detalhados serão publicados aqui assim que a API atingir disponibilidade geral. Entre em contato conosco se precisar de detalhes atuais ou desejar participar do nosso programa de acesso antecipado.
O que é uma chave de idempotência e por que devo usá-la?
Uma chave de idempotência é um identificador único que você passa com cada solicitação de API (via header X-Idempotency-Key). Se sua solicitação de rede falhar e você tentar novamente, nossa API reconhecerá a mesma chave e retornará a resposta original em vez de enviar um SMS duplicado. Isso evita que usuários recebam vários OTPs e protege você de ser cobrado duas vezes.
Precisa de Limites Maiores ou Acesso Antecipado ao WhatsApp?
Nossa equipe pode explicar as capacidades atuais, acordos de limites personalizados e acesso antecipado à API do WhatsApp.