InícioGlossário › Rate Limit no WhatsApp Business API
Glossário

O que é Rate Limit no WhatsApp Business API?

Rate limit no WhatsApp Business API é o teto de velocidade com que a Meta aceita seus envios: quantas mensagens por segundo (MPS) e quantas chamadas de API por período ela processa antes de responder com erro. É diferente do limite de mensagens, que trata de quantos contatos únicos você alcança por dia. Rate limit é sobre velocidade; tier de mensagens é sobre volume.

Rate limit e limite de mensagens não são a mesma coisa

Muita gente mistura os dois, e o resultado é diagnóstico errado quando o disparo trava. São eixos diferentes.

O rate limit controla a velocidade: quantas mensagens por segundo (MPS) a Meta aceita do seu número e quantas chamadas de API por minuto você pode fazer. Já o limite de mensagens — os tiers de 1.000, 10.000, 100.000 e ilimitado contatos por dia — controla o volume, ou seja, para quantas pessoas distintas você pode iniciar conversa em 24 horas.

Na prática: você pode estar em um tier alto e mesmo assim tomar erro se disparar rápido demais. E pode estourar o volume diário rodando bem devagar. São dois tetos separados, cada um com sua causa.

Os dois números que importam: MPS e chamadas de API

A Cloud API tem por padrão uma vazão de cerca de 80 mensagens por segundo (MPS) por número de telefone. Contas com boa reputação e volume sustentado podem ser elevadas até 1.000 MPS.

Além do MPS, existe o rate limit das chamadas à API de gerenciamento (criar template, consultar status, etc.). Estourar esse teto costuma devolver um erro HTTP 429 (Too Many Requests) — o pedido não falhou por conteúdo, falhou por frequência.

ConceitoO que medeValor de referência (Cloud API)
Throughput (MPS)Mensagens por segundo por número≈ 80 MPS padrão, até 1.000 MPS
Rate limit de APIChamadas por período à APIRetorna HTTP 429 ao estourar
Tier de mensagensContatos únicos iniciados/24h1.000 → 10.000 → 100.000 → ilimitado

O que acontece quando você estoura o rate limit

Quando a velocidade passa do teto, a Meta não bane na hora — ela devolve erro. No caso das chamadas de API, o código típico é o 429. No envio em alta vazão, mensagens acima do MPS podem ser recusadas ou enfileiradas pelo provedor.

A resposta certa não é insistir. É aplicar recuo com espera crescente (backoff): errou, espera, tenta de novo mais devagar. Reenviar em loop sem pausa só empilha 429 e, aí sim, começa a arranhar a reputação do número.

Vale lembrar de um detalhe: o rate limit vale para mensagens iniciadas por você. Se o cliente mandou mensagem primeiro, você tem a janela de atendimento de 24 horas para responder, e essas respostas não pesam da mesma forma.

Como o rate limit aumenta

A vazão não sobe pedindo — sobe por comportamento. A Meta reavalia as contas periodicamente e eleva o teto de quem mantém qualidade estável e usa o limite atual de forma consistente.

O gatilho mais citado: manter o quality rating em médio ou alto em todos os números e templates, e ter usado boa parte do limite nos últimos 7 dias. Para chegar ao patamar de 1.000 MPS, o número precisa estar com qualidade média ou superior. Reputação baixa faz o caminho contrário — pode travar o aumento e até reduzir o teto.

Perguntas frequentes

Rate limit é o mesmo que limite de mensagens no WhatsApp?
Não. Rate limit é velocidade (mensagens por segundo e chamadas de API por período). Limite de mensagens é volume (quantos contatos únicos você inicia por dia, nos tiers de 1.000 a ilimitado). Você pode esbarrar em um sem chegar perto do outro.
Qual o rate limit padrão da Cloud API do WhatsApp?
Por padrão, cerca de 80 mensagens por segundo (MPS) por número. Contas com qualidade média ou alta e volume sustentado podem ser elevadas gradualmente até 1.000 MPS.
O que significa o erro 429 no WhatsApp Business API?
HTTP 429 (Too Many Requests) indica que você fez chamadas de API rápido demais e estourou o rate limit. A correção é aplicar backoff — esperar um intervalo crescente antes de tentar de novo — em vez de reenviar em loop.
Estourar o rate limit bane meu número?
Não diretamente. O primeiro efeito é erro (429 ou mensagens recusadas). O risco vem depois: insistir em alta frequência degrada o quality rating, e é a queda de reputação que abre caminho para restrições e banimento.

Termos relacionados

← Ver glossário completo