Atualizado em 20/10/2026
O limite de mensagens da API do WhatsApp é o número máximo de usuários diferentes que sua empresa pode receber mensagens fora da janela de atendimento num período móvel de 24 horas. Desde 7 de outubro de 2025, ele é definido por portfólio empresarial e compartilhado por todos os números: começa em 250, sobe para 2.000 depois de um caminho de escala (como verificar a empresa) e, a partir daí, cresce sozinho para 10.000, 100.000 e ilimitado, desde que as mensagens tenham boa qualidade e você use pelo menos metade do limite em 7 dias.
A seguir: o que conta no limite, como subir de nível, como a qualidade entra na conta e como consultar tudo pela API.
O que conta no limite e o que não conta
O limite mede destinatários únicos, não mensagens. E só conta quem recebe mensagem fora da janela de atendimento de 24 horas, ou seja, mensagens que a empresa inicia com template.
| Situação | Conta no limite? |
|---|---|
| Template enviado para um cliente que não escreveu nas últimas 24 horas | Sim, 1 destinatário |
| Três templates para o mesmo cliente no mesmo período de 24 horas | Sim, mas só 1 destinatário |
| Resposta livre a um cliente que escreveu há 2 horas | Não |
| Template enviado como resposta, com a janela aberta | Não, porque está dentro da janela |
| Tentativa de envio de template pausado | Não (a API rejeita sem contar) |
A janela de atendimento é explicada no artigo sobre a janela de 24 horas do WhatsApp. Na prática, atendimento receptivo quase não consome limite; quem esbarra nele são notificações em volume e campanhas.
Os níveis de limite
| Nível | Usuários únicos em 24 horas | Como chegar | Valor na API |
|---|---|---|---|
| Inicial | 250 | Portfólio recém-criado | TIER_250 |
| 2.000 | 2.000 | Concluir um caminho de escala e passar pela análise da Meta | TIER_2K |
| 10.000 | 10.000 | Escala automática | TIER_10K |
| 100.000 | 100.000 | Escala automática | TIER_100K |
| Ilimitado | Sem teto | Escala automática | TIER_UNLIMITED |
O limite é do portfólio, não do número
Antes de outubro de 2025, cada número tinha seu próprio limite. Agora o valor é calculado e definido no portfólio empresarial, e todos os números dele dividem a mesma cota. Duas consequências:
- Número novo já nasce com o limite do portfólio. Não é preciso “aquecer” um número do zero.
- Um número pode consumir a cota inteira. Se o número de cobrança dispara para 9.000 clientes num portfólio com limite de 10.000, sobram 1.000 para o número de vendas nas mesmas 24 horas.
Na migração, a Meta definiu o limite de cada portfólio existente pelo maior limite entre seus números.
Como sair dos 250 e chegar a 2.000
A Meta oferece três caminhos de escala. Basta concluir um:
- Verificar a empresa no portfólio empresarial da Meta.
- Ter a empresa verificada por um parceiro, quando o cadastro foi feito por um provedor que oferece verificação conduzida pelo parceiro.
- Entregar 2.000 mensagens fora da janela de atendimento, para destinatários únicos, num período móvel de 30 dias, usando templates de alta qualidade.
Concluído o caminho, a Meta analisa a qualidade das suas mensagens e aprova ou nega a elegibilidade para escala automática.
- Aprovado: o limite vai para 2.000 na hora. Você recebe e-mail, alerta para desenvolvedores e o webhook
business_capability_updatecommax_daily_conversations_per_businessigual ao novo limite. - Negado: o limite continua o mesmo, e o webhook
account_alertsinforma o motivo emalert_type.
alert_type | O que fazer |
|---|---|
INCREASED_CAPABILITIES_ELIGIBILITY_DEFERRED | Entregar 2.000 mensagens fora da janela, para destinatários únicos, em 30 dias, com templates de alta qualidade |
INCREASED_CAPABILITIES_ELIGIBILITY_FAILED | O mesmo caminho das 2.000 mensagens |
INCREASED_CAPABILITIES_ELIGIBILITY_NEED_MORE_INFO | Verificar sua identidade na Meta ou seguir o caminho das 2.000 mensagens |
A verificação da empresa costuma ser o caminho mais rápido para quem já tem CNPJ e documentação em ordem. O passo a passo está em verificação da empresa no Meta Business. Verificar o portfólio (ou chegar a 2.000) também aumenta de 2 para 20 o número de telefones que o portfólio pode registrar.
Escala automática: de 2.000 para ilimitado
A partir de 2.000, a Meta sobe o limite um nível por vez, sem pedido, quando duas condições são atendidas:
- você envia mensagens de alta qualidade em todos os números e templates do portfólio;
- nos últimos 7 dias, usou pelo menos metade do limite atual.
Com as duas condições cumpridas, o aumento acontece em até 6 horas. Para um portfólio em 10.000, isso significa ter enviado para pelo menos 5.000 usuários únicos fora da janela em algum momento da última semana.
Quem quer chegar a 100.000 para uma data específica (Black Friday, vencimento de boletos, campanha de matrícula) precisa planejar o crescimento com antecedência. Cada degrau exige uso real do degrau anterior.
Não confunda limite com throughput e com limites por usuário
Quatro mecanismos diferentes podem bloquear um envio. Cada um tem sua causa e seu código de erro:
| Mecanismo | O que limita | Valor | Erro |
|---|---|---|---|
| Limite de mensagens | Usuários únicos fora da janela em 24 horas, por portfólio | 250 a ilimitado | — |
| Throughput | Mensagens por segundo, por número | 80/s por padrão; até 1.000/s com upgrade automático | 130429 |
| Limite por par | Muitas mensagens para o mesmo usuário em pouco tempo | Sem valor publicado | 131056 |
| Limite de marketing por usuário | Templates de marketing que um usuário recebe de todas as empresas | Dinâmico, pelo engajamento do usuário | 131049 |
O upgrade para 1.000 mensagens por segundo exige portfólio com limite ilimitado, número que já tenha alcançado 100.000 usuários únicos fora da janela em 24 horas e qualidade média ou alta. Para o 131049, a Meta orienta esperar pelo menos 24 horas antes de reenviar ao mesmo usuário; insistir antes disso pode bloquear novas tentativas por até 24 horas.
Classificação de qualidade
A Meta avalia a qualidade das mensagens pelo que aconteceu nos últimos 7 dias, com peso maior para o mais recente. Os sinais citados na documentação são bloqueios, denúncias, silenciamentos, arquivamentos e os motivos que o usuário informa ao bloquear.
Há duas notas que você deve acompanhar:
| Nota | Onde aparece | Valores |
|---|---|---|
| Qualidade do número | Campo quality_rating do número e WhatsApp Manager | GREEN (alta), YELLOW (média), RED (baixa), NA (ainda sem nota) |
| Qualidade do template | Campo quality_score do template | GREEN, YELLOW, RED, UNKNOWN |
Números com tráfego alto podem mudar de qualidade em intervalos curtos, às vezes em minutos.
O que mudou: qualidade baixa não rebaixa mais o limite
Até outubro de 2025, um número com qualidade “Flagged” por 7 dias perdia um nível de limite. A Meta acabou com esse estado: hoje, se a qualidade do número cai, o limite não é reduzido.
Isso não torna a qualidade irrelevante. Ela continua decidindo três coisas:
- Se o limite sobe. A escala automática exige mensagens de alta qualidade em todos os números e templates.
- Se o template continua no ar. Template que chega a
REDé pausado por 3 horas, depois 6 horas, e na terceira vez é desativado. - Se a empresa sofre medidas. A Meta diz que limita a taxa de envio de empresas com qualidade baixa por período prolongado, e feedback negativo excessivo pode levar a restrições e até à remoção da plataforma. O artigo sobre número bloqueado na API do WhatsApp detalha essas medidas.
O que trava o crescimento
Os motivos mais comuns para o limite parar de subir, ou para as mensagens deixarem de sair, são previsíveis:
- Lista sem opt-in. Contatos que não esperavam a mensagem bloqueiam e denunciam.
- Mensagem genérica. A Meta recomenda evitar mensagens de boas-vindas ou de apresentação abertas e personalizar o conteúdo.
- Frequência alta. Vários templates por dia para o mesmo contato derrubam a nota e esbarram no limite por par.
- Público frio em volume. Mandar a base inteira de uma vez, sem testar a reação de um grupo menor.
- Uso abaixo da metade do limite. Sem uso, não há escala automática.
- Template de marketing classificado como utilidade. Além de reclassificação, gera restrições específicas. Veja o guia de templates da API do WhatsApp.
Como consultar limite e qualidade pela API
Na Graph API, o limite atual do portfólio está no campo whatsapp_business_manager_messaging_limit, que pode ser lido no portfólio, na conta do WhatsApp Business ou no número. O campo antigo messaging_limit_tier foi descontinuado.
curl 'https://graph.facebook.com/v26.0/PHONE_NUMBER_ID?fields=whatsapp_business_manager_messaging_limit' \
-H 'Authorization: Bearer TOKEN_DA_META'
# Resposta
{ "whatsapp_business_manager_messaging_limit": "TIER_250", "id": "PHONE_NUMBER_ID" }Na Vectalk, os dados do número vêm de GET /api/phone-numbers, com o número resolvido pelo token de instância. A documentação mostra o parâmetro fields e uma resposta com quality_rating e o nível de throughput:
curl 'https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,verified_name,quality_rating' \
-H 'Authorization: Bearer SEU_TOKEN_DE_INSTANCIA'Para não depender de consulta, trate os webhooks. A Vectalk repassa os eventos no formato da Meta:
business_capability_update: novo limite do portfólio emmax_daily_conversations_per_business;phone_number_quality_update: mudanças de limite ou de throughput do número;account_alerts: negativa de escala e próximos passos;message_template_quality_updateemessage_template_status_update: nota e pausa dos templates.
Planejando um envio dentro do limite
Para envios em volume, controle os destinatários únicos das últimas 24 horas antes de chamar a API e distribua o restante para o dia seguinte. Um esboço:
const LIMITE = 2000; // leia do webhook business_capability_update
const JANELA_MS = 24 * 60 * 60 * 1000;
async function podeEnviar(waId) {
const desde = new Date(Date.now() - JANELA_MS);
const jaRecebeu = await db.envios.exists({ wa_id: waId, fora_da_janela: true, enviado_em: { $gte: desde } });
if (jaRecebeu) return true; // mesmo destinatário não conta duas vezes
const unicos = await db.envios.countDistinct("wa_id", { fora_da_janela: true, enviado_em: { $gte: desde } });
return unicos < LIMITE * 0.95; // margem para envios de outros números do portfólio
}Lembre de somar todos os números do portfólio na contagem. O artigo sobre disparo em massa pela API oficial cobre fila, cadência e segmentação.
Perguntas frequentes
Posso pedir à Meta para aumentar meu limite manualmente?
A documentação descreve apenas os caminhos de escala para chegar a 2.000 e a escala automática a partir daí. O caminho prático é verificar a empresa e usar o limite com mensagens bem recebidas.
Adicionar mais números aumenta o limite?
Não. O limite é do portfólio e é dividido entre todos os números. Um número novo apenas passa a usar a mesma cota.
Responder clientes consome o limite?
Não. O limite conta só destinatários de mensagens fora da janela de atendimento. Respostas dentro da janela de 24 horas ficam de fora.
Minha qualidade caiu para amarelo. Vou perder o nível?
Pela regra atual, não. A queda de qualidade não reduz o limite, mas pode impedir novos aumentos e levar à pausa de templates. Reveja público, frequência e conteúdo antes do próximo envio.
Escale seus envios com a Vectalk
Com a Vectalk, você conecta seus números pelo cadastro incorporado da Meta e opera todas as contas com um token, recebendo os webhooks de limite e qualidade no formato da documentação oficial. A Vectalk paga a Meta por você, sem cartão cadastrado na Meta, e oferece coexistência com o app WhatsApp Business. Crie sua conta em apps.vectalk.com.br/register, consulte a documentação ou fale com o time pela página de contato.
Fontes oficiais consultadas em 20/10/2026: Limites de mensagens, Mudanças nos limites de mensagens (em vigor desde 7/10/2025), Qualidade de mensagens.