Limites da API oficial do WhatsApp

Resposta rápida (TL;DR)

O limite de mensagens da API oficial do WhatsApp é a quantidade de números únicos de usuários que a empresa consegue alcançar fora da janela de atendimento, dentro de uma janela móvel de 24 horas. Portfólio novo começa em 250 e pode subir para 2.000, 10.000, 100.000 e ilimitado. O cálculo é feito no nível do portfólio de negócios e compartilhado por todos os números dele, então um único número pode consumir toda a capacidade do período. Conversas iniciadas pelo cliente não entram nessa conta: dentro da janela de 24 horas aberta pela mensagem dele, o teto não se aplica.

Qual é o limite de mensagens da API oficial do WhatsApp

O limite é o número máximo de telefones únicos de usuários do WhatsApp para os quais o seu negócio consegue entregar mensagens, fora de uma janela de atendimento, numa janela móvel de 24 horas. Portfólio de negócios recém-criado nasce com limite de 250. A partir daí existem quatro degraus acima: 2.000, 10.000, 100.000 e ilimitado.

Repare no recorte: o teto vale para mensagens iniciadas pela empresa, que exigem modelo aprovado. Responder alguém que acabou de escrever para você não consome esse limite.

Os cinco degraus e como se chega em cada um

Limite em 24h	Como se alcança	O que isso exige na prática
250	Padrão de portfólio novo	Nada. É o ponto de partida.
2.000	Completar um caminho de escalonamento	Verificar a empresa, ter o provedor verificando por você, ou entregar 2.000 mensagens fora da janela para números únicos em 30 dias com modelos de nota alta.
10.000	Escalonamento automático	Manter qualidade alta e usar ao menos metade do limite atual nos últimos 7 dias.
100.000	Escalonamento automático	Mesmos dois critérios, avaliados de novo.
Ilimitado	Escalonamento automático	Mesmos dois critérios, avaliados de novo.

Depois que o portfólio chega em 2.000, a subida deixa de depender de pedido. A Meta avalia dois critérios: envio de mensagens de alta qualidade em todos os números e modelos, e uso de pelo menos metade do limite atual nos últimos 7 dias. Batendo os dois, o limite sobe um nível em até 6 horas.

Como subir de 250 para ilimitado, passo a passo

Escolha um dos três caminhos para 2.000. Verificação da empresa é o mais rápido de controlar, porque depende de documento e não de volume.
Aguarde a análise de qualidade. Completado o caminho, a Meta analisa a qualidade das suas mensagens e aprova ou nega a elegibilidade para o escalonamento automático.
Se aprovar, o limite vai a 2.000 na hora e você é avisado por e-mail e alerta de desenvolvedor.
Se negar, a Meta indica o caminho alternativo em vez de só recusar: entregar 2.000 mensagens fora da janela para números únicos em 30 dias com modelos de nota alta, ou verificar a identidade.
Use o que você tem. Sem consumir metade do limite atual em 7 dias, o degrau seguinte não vem, por melhor que seja a qualidade.
Segure a nota dos modelos. Qualidade alta é pré-requisito tanto para sair do 250 quanto para cada subida automática.

Por que um número consome a capacidade de todo o portfólio

Porque o limite é calculado e definido no nível do portfólio de negócios, não do número. Todos os números do mesmo portfólio dividem a mesma capacidade. Se a empresa tem um número de suporte e um número de campanha no mesmo portfólio, uma campanha mal dimensionada pela manhã pode deixar o suporte sem margem para mensagens iniciadas à tarde.

Há um efeito colateral positivo: número novo em portfólio maduro já nasce com o limite do portfólio, sem recomeçar do 250, como explica o guia sobre como obter a API oficial do WhatsApp.

A janela de atendimento de 24 horas

Quando um usuário do WhatsApp manda mensagem ou liga para a empresa, começa um cronômetro de 24 horas chamado janela de atendimento. Se ele escrever ou ligar de novo antes de o cronômetro zerar, a janela volta a contar 24 horas.

Com a janela aberta, a empresa responde livremente com mensagens de serviço, incluindo texto, mídia e mensagens interativas. Com a janela fechada, só sai modelo aprovado. É por isso que dois negócios com o mesmo limite de 250 têm capacidades operacionais muito diferentes: quem trabalha com demanda entrante quase não toca no teto.

O limite por usuário, que não aparece no painel

Além do teto do portfólio, existe um limite de quantas mensagens de modelo de marketing cada pessoa recebe de qualquer empresa num período. Ele é dinâmico e leva em conta a taxa de leitura recente daquela pessoa e quantas mensagens ela já tem na caixa de entrada.

Três consequências práticas. Cada mensagem de marketing entregue conta para esse limite. Se a pessoa responde, abre janela de atendimento de 24 horas e as mensagens de marketing enviadas dentro dela deixam de contar. E quando a entrega falha por esse motivo, o webhook devolve o erro 131049: nesse caso, espere ao menos 24 horas antes de tentar de novo, porque insistência em ciclo curto pode bloquear a entrega para aquele usuário por até 24 horas.

Há geografia envolvida. O WhatsApp atualmente não entrega modelos de marketing para números dos Estados Unidos. E o limite por usuário não está ativo em mensagens enviadas de ou para o Espaço Econômico Europeu, Reino Unido, Japão e Coreia do Sul.

O que acontece quando você bate o teto

Não existe fila mágica. Mensagens iniciadas pela empresa acima da capacidade do período não são entregues, e quem paga a conta é a operação: campanha pela metade, lead frio, cliente sem resposta.

Antes disso, dois mecanismos já podem estar segurando a entrega. O pacing retém mensagens de modelos novos, despausados ou sem nota alta para colher feedback: a resposta da API traz o status retido para avaliação de qualidade e, se o sinal vier ruim, as mensagens seguintes são descartadas com o código 132015. O pausing pausa o modelo que chega à pior nota: 3 horas na primeira vez, 6 horas na segunda, desabilitação na terceira. Tentar enviar modelo pausado não é cobrado e não conta contra o limite, mas a API rejeita a requisição.

Outros limites que costumam pegar de surpresa

Limite	Valor	Como muda
Vazão por número	80 mensagens por segundo	Sobe automaticamente para 1.000 se o portfólio for ilimitado, o número alcançar 100 mil pessoas únicas em 24h e a nota for média ou melhor.
Vazão em uso conjunto com o aplicativo	20 mensagens por segundo	Fixo, por compatibilidade com o aplicativo WhatsApp Business.
Números registrados	2 por portfólio novo	Sobe para 20 com a empresa verificada ou ao alcançar limite de 2.000.
Modelos por conta	250 sem verificação	Sobe para 6.000 com portfólio verificado e nome de exibição aprovado. Criação limitada a 100 modelos por hora.

Custo não entra nessa lista porque não é limite: a Meta cobra por conversa segundo a categoria do modelo, e o valor varia por país e por categoria. O que a categoria define é o preço, e é por isso que a escolha dela merece cuidado, como mostra o guia sobre como aprovar um modelo de mensagem no WhatsApp.

Erros comuns na gestão de limite

Achar que o limite é por número. Ele é do portfólio, e a soma de todos os números divide a mesma capacidade.
Abrir portfólios separados para ganhar capacidade. Cada portfólio novo volta a 250 e perde o histórico de qualidade que faria o limite subir sozinho.
Disparar volume alto em modelo recém-aprovado. Modelo novo nasce sem nota, entra em pacing e pode ser descartado antes de provar valor.
Ficar bem abaixo do limite e reclamar que ele não sobe. Sem usar metade da capacidade em 7 dias, o degrau seguinte não é liberado.
Reenviar em ciclo após o erro 131049. A insistência pode bloquear a entrega para aquela pessoa por até 24 horas.
Ignorar a janela de atendimento. Priorizar conversa iniciada pelo cliente é a forma mais barata de aumentar volume sem tocar no teto.

Como conferir o seu limite hoje

No WhatsApp Manager, o número aparece em Ferramentas da conta, no painel de limites de mensagens. Pela API, consulte o campo de limite de mensagens do portfólio no identificador do número de negócio. O campo antigo que devolvia o nível por número foi descontinuado, então integração velha pode estar lendo um dado que não existe mais.

Perguntas frequentes (FAQ)

Quantas mensagens posso enviar por dia pela API oficial do WhatsApp?

Depende do degrau do seu portfólio de negócios. Portfólio novo alcança 250 números únicos por 24 horas em mensagens iniciadas pela empresa. Os degraus seguintes são 2.000, 10.000, 100.000 e ilimitado. O primeiro salto depende de você (verificar a empresa ou entregar volume com qualidade) e os demais acontecem sozinhos, se a qualidade se mantiver alta e você usar metade da capacidade atual.

Como aumentar o limite de mensagens do WhatsApp Business API?

Para chegar a 2.000, existem três caminhos: verificar a empresa na Meta, pedir que o provedor conduza essa verificação, ou entregar 2.000 mensagens fora da janela de atendimento para números únicos em 30 dias usando modelos com nota alta de qualidade. Passado esse ponto, os aumentos são automáticos: basta manter qualidade alta e consumir pelo menos metade do limite atual em 7 dias.

O que é a janela de 24 horas do WhatsApp?

É o período em que a empresa pode responder livremente. Quando um cliente manda mensagem ou liga, começa um cronômetro de 24 horas, que reinicia a cada nova mensagem dele. Com a janela aberta, você envia texto, mídia e mensagens interativas sem modelo. Quando ela fecha, só é possível enviar modelo aprovado, e esse envio passa a consumir o limite de mensagens do portfólio.

Ter mais números de telefone aumenta o limite de mensagens?

Não. O limite é calculado no nível do portfólio de negócios e compartilhado por todos os números dele, então um único número pode consumir toda a capacidade do período. Abrir um portfólio novo também não resolve, porque ele volta ao patamar inicial de 250 e perde o histórico de qualidade que faz o limite subir automaticamente.

O que acontece se eu atingir o limite de mensagens do WhatsApp?

As mensagens iniciadas pela empresa acima da capacidade daquele período não são entregues. Antes disso, dois mecanismos já podem estar segurando o envio: o pacing retém mensagens de modelos sem reputação até colher feedback, e o pausing pausa o modelo com pior nota por 3 horas, depois 6 horas, e o desabilita na terceira ocorrência. Conversas dentro da janela de atendimento seguem normais.

Continue lendo

Histórico de revisões

2026-07-27 · v1.0 · publicação inicial.

Sobre as marcas mencionadas

Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.