Bloqueio e qualidade

Limite de mensagens da WhatsApp Business API e qualidade

Limite de mensagens da WhatsApp Business API: de 250 a ilimitado, como subir, o que a qualidade verde, amarela e vermelha muda e o que mudou em 2025-2026.

Notebook e smartphone organizados em uma mesa de escritório
Foto ilustrativa · Pexels
Neste artigo

O limite de mensagens da WhatsApp Business API é definido pela Meta, não pelo provedor, e começa em 250 pessoas diferentes por dia para todo negócio novo. Ele sobe em degraus, 2.000, 10.000, 100.000 e ilimitado, conforme a empresa verifica a conta e entrega mensagens de qualidade. Desde outubro de 2025 esse limite é calculado por portfólio de negócios, e não por número, e a qualidade vermelha deixou de rebaixá-lo. Este artigo explica cada regra, de quem ela é e o que fazer quando o número esbarra nela.

Resposta curta: quantas pessoas posso contatar por dia?

Depende do nível em que o seu portfólio de negócios está na Meta. Um negócio recém-conectado pode iniciar conversa com até 250 pessoas diferentes numa janela móvel de 24 horas. Com a empresa verificada no Business Manager, ou depois de um histórico de entregas com boa qualidade, o nível sobe para 2.000, depois 10.000, depois 100.000 e por fim ilimitado.

Três detalhes mudam a leitura desse número:

  • O limite conta pessoas, não mensagens. Três templates para o mesmo contato consomem uma unidade.
  • Só conta mensagem fora da janela de atendimento. Responder quem escreveu para você nas últimas 24 horas não gasta capacidade.
  • O limite é da Meta. Um provedor sério não coloca nada por cima dele. O Frame Conexa, por exemplo, não tem franquia de envio: o número de marketing envia até onde a Meta deixa.

Além desse limite por negócio, existe um limite por pessoa, também da Meta, que nenhum painel consegue mostrar antes do envio. É o que aparece como erro 131049, e tem seção própria mais abaixo.

Os cinco níveis: 250, 2.000, 10.000, 100.000 e ilimitado

A documentação de limites de envio da Meta define a capacidade como o número máximo de telefones diferentes para os quais a empresa pode entregar mensagens, fora de uma janela de atendimento, numa janela móvel de 24 horas. Os degraus são estes:

Nível Pessoas diferentes em 24 horas Como se chega
Inicial 250 Todo negócio novo começa aqui
2.000 2.000 Verificação da empresa, ou 2.000 entregas de qualidade em 30 dias
10.000 10.000 Subida automática por uso e qualidade
100.000 100.000 Subida automática por uso e qualidade
Ilimitado Sem teto de pessoas Subida automática por uso e qualidade

O degrau de 1.000, que aparecia em muitos artigos, deixou de existir. O segundo nível passou a ser 2.000. Se você lê em algum lugar "tier de 1.000 conversas", o texto está desatualizado.

O que conta: pessoas únicas, fora da janela, em 24 horas móveis

A janela é móvel: não zera à meia-noite. Se você iniciou conversa com 250 pessoas entre as 14h de ontem e as 14h de hoje, só recupera capacidade à medida que cada uma dessas entregas completa 24 horas. É por isso que uma campanha grande enviada de uma vez trava o número pelo dia inteiro, enquanto a mesma campanha distribuída em dois ou três dias cabe.

O que consome capacidade é a entrega de um template para alguém que não está com a janela de 24 horas aberta. Uma resposta dentro da janela, seja texto livre ou template de utilidade, não conta. Isso tem uma consequência prática para quem atende: o volume do dia a dia, de responder cliente, nunca compete com a campanha pela mesma capacidade.

Nota: hoje as mensagens de serviço dentro da janela são gratuitas. A Meta anunciou que a partir de 01/10/2026 mensagens de serviço e templates de utilidade dentro da janela passam a ser cobrados por mensagem. Isso muda o custo, não o limite: responder dentro da janela continua sem consumir capacidade. Os valores estão na tabela publicada pela Meta em setembro de 2026, e vale conferir o rate card oficial antes de planejar o orçamento.

Desde outubro de 2025 o limite é do portfólio, não do número

Até 07/10/2025 cada número tinha o próprio limite. Desde então, segundo a página de mudanças nos limites de envio, o limite é calculado no portfólio de negócios (o Business Portfolio, antigo Business Manager) e compartilhado por todos os números dele. Portfólios que já existiam herdaram o maior limite entre seus números.

Na prática, dois números da mesma empresa dividem a mesma capacidade. Se um deles iniciou 1.500 conversas hoje num portfólio de 2.000, sobram 500 para o outro. E quando o portfólio sobe de nível, todos os números sobem juntos. É um modelo melhor para quem opera várias linhas e pior para quem achava que "conectar mais um número" dobrava o alcance: não dobra.

Como sair dos 250?

Há dois caminhos, e eles não são excludentes. O mais rápido é verificar a empresa. O outro é entregar volume com qualidade.

Verificar a empresa no Business Manager

A verificação da empresa (Business Verification) é feita no próprio Business Manager, com documentos do CNPJ. Ela é o que destrava limites maiores, mais números por conta e a elegibilidade ao selo de Official Business Account. É um processo da Meta, gratuito, e o provedor não faz por você: como Tech Provider, o Frame Conexa conecta o número à API, mas a verificação e o pagamento da conta ficam no Business Manager da sua empresa.

Uma confusão comum: o selo azul ao lado do nome, o Official Business Account, é outra coisa. Ele exige portfólio verificado, ao menos 30 dias na plataforma, verificação em duas etapas ativa e nome de exibição aprovado, e a Meta só o concede a marcas que considera notáveis, segundo a página oficial sobre contas comerciais oficiais. O selo não aumenta limite. A verificação aumenta.

Ou entregar 2.000 mensagens de qualidade em 30 dias

O caminho sem verificação, descrito na documentação de limites: entregar mensagens fora de janela para 2.000 números diferentes em 30 dias, usando templates de alta qualidade. Repare na palavra entregar. Mensagem que falhou, seja por número sem WhatsApp ou por recusa da Meta, não conta. E com 250 por dia o mínimo aritmético são oito dias de envio no teto, o que na vida real vira duas ou três semanas.

Esse é o motivo de a primeira campanha de um número novo não poder ser uma lista fria de 2.000 pessoas. O guia de envio em massa pela API oficial desce nesse ponto: começar com quem já conhece a empresa produz leituras e respostas, que é o que a Meta chama de qualidade e é o que sobe o nível.

Como subir de nível automaticamente: a regra da metade em 7 dias

Depois de sair dos 250, a subida é automática e a regra é objetiva. A Meta sobe o portfólio um nível quando duas condições se cumprem ao mesmo tempo:

  1. As mensagens de todos os números do portfólio têm qualidade alta.
  2. Pelo menos metade do limite atual foi usada nos últimos 7 dias.

Cumpridas as duas, a subida acontece em até 6 horas. Antes de outubro de 2025 o prazo era de 24 horas.

A segunda condição é a que mais engana. Não basta ter qualidade: é preciso usar a capacidade. Um negócio em 2.000 que envia 300 mensagens por semana está com qualidade ótima e nunca vai subir, porque não demonstrou precisar de mais. Quem quer chegar a 10.000 precisa iniciar ao menos 1.000 conversas por semana, com boas leituras e poucos bloqueios, e a Meta faz o resto.

Dica: planeje a escalada. Se a meta é uma campanha de 8.000 pessoas daqui a um mês, o número precisa estar em 10.000 até lá, o que significa passar por 2.000 com pelo menos 1.000 entregas semanais de qualidade. Deixar para descobrir o limite no dia do disparo é a forma mais cara de aprender a regra.

Qualidade do número: verde, amarelo e vermelho

A qualidade do número é a nota que a Meta dá com base no que os destinatários fizeram nos últimos 7 dias: bloquearam o número, denunciaram, e o motivo que informaram ao fazer isso. Verde é qualidade alta, amarelo é média, vermelho é baixa. Ela aparece no WhatsApp Manager e o provedor a recebe por webhook, que é como o painel do Frame Conexa a mostra no detalhe de cada número.

Qualidade é medida por número, mesmo com o limite sendo por portfólio. E entra na conta da escalada: a condição "qualidade alta em todos os números" da seção anterior é exatamente essa nota. Um número amarelo no portfólio segura a subida de todos os outros.

O que mudou: o estado "Flagged" acabou e o limite não cai mais

Aqui está a correção mais importante deste artigo, porque a maioria dos textos em português ainda repete a regra antiga.

Regra antiga: número com qualidade vermelha entrava no estado "Flagged" (sinalizado). Se não melhorasse em 7 dias, o limite de envio caía um nível, de 100.000 para 10.000 por exemplo, e não era possível subir enquanto estivesse sinalizado.

Regra atual, desde 07/10/2025: o estado "Flagged" foi eliminado e, nas palavras da página de mudanças da Meta, o limite de envio não é mais rebaixado por queda de qualidade. A qualidade passou a contar para duas coisas: decidir se o portfólio sobe e disparar as restrições de spam e pausas de template descritas abaixo.

Ou seja: qualidade vermelha hoje não tira capacidade que você já conquistou. Ela impede que você ganhe mais e liga os freios automáticos. Se você leu que "qualidade vermelha derruba o tier em 7 dias", a informação está desatualizada há quase um ano.

O que ainda cai: pausa de template e restrições de spam

O que a qualidade baixa ainda provoca, e isso não mudou:

Pausa de template. Cada template tem a própria nota de qualidade, calculada por uso, bloqueios, denúncias e taxa de leitura. Quando um template chega a qualidade baixa, a Meta o pausa automaticamente: 3 horas na primeira vez, 6 horas na segunda e, na terceira, ele é desativado em definitivo, segundo a página oficial sobre pausa de templates. Template pausado não sai: a API recusa. É possível despausar manualmente no WhatsApp Manager, mas reenviar o mesmo texto para o mesmo público só acelera a terceira pausa. O artigo sobre template aprovado explica o que costuma derrubar a nota.

Restrição por spam. Quando a taxa de denúncia de um número sobe, a Meta passa a recusar envios com o código 131048. Não é banimento, é um freio. A saída é reduzir o ritmo e revisar o público antes de retomar.

A Meta também avisa que um número que insiste em enviar templates de qualidade baixa pode, com o tempo, ser afetado como um todo. Esse "afetado" é o território do artigo sobre WhatsApp Business bloqueado: a escada de sanções começa muito antes da perda do número, e cada degrau tem um código de erro que diz onde você está.

Limite por pessoa: o erro 131049 que não aparece em nenhum painel

Existe um segundo limite, e ele não está no seu número nem no seu portfólio. Está na pessoa que recebe.

A Meta limita quantos templates de marketing um mesmo usuário do WhatsApp pode receber num período, somando todas as empresas que falam com ele. O número não é divulgado. A página sobre limites por usuário o descreve como dinâmico e adaptativo: quem lê as mensagens de marketing que recebe pode receber mais; quem ignora, recebe menos. Cada template de marketing entregue conta. Mensagens dentro de uma janela aberta pela própria pessoa não contam, e templates de utilidade e de autenticação não são afetados.

Quando a pessoa já bateu o limite dela, a Meta não entrega e devolve o código 131049, com a explicação de que a mensagem não foi entregue para manter o engajamento saudável do ecossistema. A orientação oficial é esperar ao menos 24 horas antes de tentar de novo. Reenviar repetidamente antes disso pode prolongar o bloqueio por mais 24 horas.

Por que "não aparece em nenhum painel": porque o limite é do destinatário, e o seu provedor não sabe quantas mensagens de marketing aquela pessoa recebeu de outras empresas hoje. Nenhuma verificação prévia consegue prever esse erro. Ele só existe depois do envio, como resultado. É o mesmo que acontece com o 130472, o experimento da Meta em que um grupo pequeno de usuários não recebe marketing de empresa com quem nunca conversou. Nos dois casos a pessoa não está com problema e o seu número também não: é uma decisão da Meta sobre aquele destinatário, naquele momento.

No painel do Frame Conexa esse motivo aparece ao lado de cada destinatário como "limite da Meta por pessoa", com a ação "espere pelo menos 24 horas". O dicionário de erros da API traz o código 131049 junto dos outros que uma campanha real costuma devolver.

Importante: numa lista fria é normal que uma parte das falhas seja 131049. Não é sinal de que o número está mal. É sinal de que aquelas pessoas já recebem marketing demais, de todo mundo. Reenviar no mesmo dia piora, e tirar do público quem falha duas vezes seguidas melhora a qualidade do que sobra.

Velocidade: 80 msg/s, 20 msg/s em coexistência e o erro 130429

Limite de pessoas por dia e velocidade de envio são grandezas diferentes, e a segunda também é da Meta. Segundo a página de throughput, um número na Cloud API envia por padrão até 80 mensagens por segundo. A Meta sobe isso automaticamente e sem custo até 1.000 por segundo para portfólios com limite ilimitado que iniciam mais de 100.000 conversas em 24 horas com qualidade amarela ou melhor. É um patamar de operação grande e não é o que muda a vida de uma clínica ou de uma loja.

O que muda é o caso da coexistência: um número que continua no app WhatsApp Business do celular e ao mesmo tempo na API tem velocidade fixa de 20 mensagens por segundo. Não sobe. Para 2.000 mensagens são 100 segundos no ritmo máximo, o que na prática não é um problema: a capacidade diária de pessoas chega muito antes da velocidade.

Quando o ritmo passa do permitido, a Meta devolve o código 130429. O Frame Conexa evita esse erro por construção: os envios são serializados por número a no máximo 20 por segundo, o slot é compartilhado entre campanhas e envios avulsos daquele número, e cada campanha tem o próprio ritmo, de 1 a 20 mensagens por segundo. Duas campanhas ao mesmo tempo nunca formam uma rajada. Se ainda assim o 130429 aparecer, o painel mostra "ritmo acima do permitido" e a ação é reenviar mais devagar.

Atenção: ritmo menor é uma escolha de operação, não de limite. Mandar 2.000 mensagens em dois minutos e em uma hora chega ao mesmo lugar para a Meta. A diferença é que, em uma hora, dá tempo de ver as primeiras falhas e pausar antes de queimar a qualidade do número inteiro.

Número saudável que não envia: a conta bloqueada por falta de pagamento

Há um caso que não aparece na qualidade nem na capacidade: número verde, com limite folgado, que não entrega nenhum template. O motivo costuma ser o pagamento da conta na Meta.

Quem paga as mensagens de template é a sua empresa, diretamente à Meta, com um cartão cadastrado no Business Manager. Sem método de pagamento válido, com limite de crédito estourado ou com a linha de faturamento inativa, a conta do WhatsApp Business entra em estado bloqueado e a API devolve o código 131042, descrito na lista oficial de códigos de erro como problema no método de pagamento da conta.

Dois esclarecimentos que evitam chamados de suporte:

  • O provedor não cadastra o cartão por você. Como Tech Provider, o Frame Conexa não tem acesso ao faturamento da sua conta na Meta. Isso é exclusividade de outro tipo de parceiro, o Solution Partner, que fatura o cliente com linha de crédito própria. Aqui o cartão é cadastrado pela sua empresa, no seu Business Manager.
  • Responder dentro da janela continua funcionando. O bloqueio por pagamento afeta o que é cobrado, ou seja, templates. Uma conversa aberta pelo cliente segue respondível. Por isso um número "bloqueado" pode parecer normal no atendimento e falhar só na campanha.

O painel do Frame Conexa lê o estado de saúde da conta junto com a qualidade do número e, quando a conta está bloqueada, recusa criar a campanha antes de gastar qualquer coisa, com um aviso que leva ao Business Manager da sua empresa. Uma conta em estado limitado, que é o teto de negócio não verificado, não é bloqueada: ela envia dentro do limite dela, e travar ali proibiria disparo de quem pode.

Como o Frame Conexa mostra a capacidade do número

Tudo acima é regra da Meta. O que o provedor faz é tornar a regra visível antes de ela virar falha em massa. No Frame Conexa isso acontece em cinco pontos:

Capacidade do número. Em Disparos existe a aba "Capacidade do número", que mostra o nível atual lido da Meta, quantas pessoas diferentes receberam template nas últimas 24 horas e quanto sobra. A Visão geral ganha uma faixa a partir de 80% de uso, que muda de tom em 100%. A conta das 24 horas é uma aproximação feita do nosso lado, a partir das entregas que passaram por aqui, e é por isso que ela erra para o lado seguro.

Verificação antes da campanha. Criar uma campanha maior do que a capacidade disponível é recusado antes de qualquer envio, com o código TIER_INSUFICIENTE, e a resposta diz os números:

json
{
  "error": "o número está no nível de 250 conversas/24h e já iniciou ~180 - a campanha de 500 não cabe",
  "code": "TIER_INSUFICIENTE",
  "details": { "capacity": 250, "used24h": 180, "recipients": 500 }
}

A alternativa seria deixar a Meta recusar um a um, no meio do disparo, com o mesmo resultado e o dobro do dano à qualidade.

Pausa automática. Uma campanha em andamento é pausada sozinha quando o número cai para qualidade vermelha, quando a Meta devolve o 131048 ou quando a taxa de falha passa do limite configurado com uma amostra mínima. Retomar é uma ação da pessoa, depois de revisar o público.

Aviso por e-mail. Quando um número esgota a capacidade das 24 horas, a conta recebe um e-mail por número, uma vez por dia, dizendo de quem é o limite e quando ele volta. O ponto que esse e-mail existe para deixar claro é que o limite não é nosso.

Motivo por destinatário. Cada falha de campanha aparece com o rótulo, a explicação e a ação do código que a Meta devolveu, no mesmo dicionário que o artigo de erros reproduz. Os limites da própria API do Frame Conexa, que são de requisição e não de mensagem, estão em erros e limites.

Quem quiser entender o mecanismo por trás de tudo isso, e por que a API oficial do WhatsApp troca a incerteza do bloqueio por regras publicadas, encontra o quadro completo no artigo-base.

Perguntas frequentes

Qual é o limite inicial de envio da API do WhatsApp?

Todo negócio novo começa podendo iniciar conversa com 250 pessoas diferentes numa janela móvel de 24 horas, contando só mensagens enviadas fora da janela de atendimento. O limite é da Meta, calculado por portfólio de negócios e compartilhado por todos os números dele. Responder quem escreveu para você nas últimas 24 horas não consome esse limite.

Como aumentar o limite de 250 para 2.000?

De duas formas, que podem ser combinadas: verificar a empresa no Business Manager, com os documentos do CNPJ, ou entregar mensagens fora de janela para 2.000 números diferentes em 30 dias, com templates de alta qualidade. A partir daí a subida é automática: qualidade alta em todos os números do portfólio e pelo menos metade do limite atual usado nos últimos 7 dias fazem a Meta subir um nível em até 6 horas.

Número com qualidade vermelha perde limite?

Não, desde 07/10/2025. A Meta eliminou o estado "Flagged" e declarou que o limite de envio não é mais rebaixado por queda de qualidade. O que a qualidade vermelha faz hoje é impedir a subida de nível, pausar templates de qualidade baixa por 3 horas, depois 6 e depois em definitivo, e disparar a restrição por spam, o erro 131048. A regra dos "7 dias para cair de tier" que muitos artigos repetem está obsoleta.

O que é o erro 131049?

É a recusa da Meta por limite de marketing por pessoa: o destinatário já recebeu templates de marketing demais, somando todas as empresas, e a Meta segura a entrega para preservar o engajamento. O limite é dinâmico e não é divulgado. A orientação oficial é esperar pelo menos 24 horas antes de reenviar; insistir antes pode prolongar o bloqueio. Templates de utilidade e autenticação e respostas dentro da janela não são afetados.

Por que meu número conectado não envia nada?

Se a qualidade está verde e a capacidade sobra, o motivo mais comum é o pagamento da conta na Meta: sem cartão válido no Business Manager, a API devolve o código 131042 e nenhum template sai, embora as respostas dentro da janela continuem funcionando. O cartão é cadastrado pela sua empresa, no Business Manager dela; o Frame Conexa, como Tech Provider, não tem acesso a esse faturamento. Outros motivos são template pausado por qualidade baixa, restrição por spam e, no envio em massa, o ritmo acima de 20 mensagens por segundo em número em coexistência.

Próximo passo

Se o seu número ainda está em 250, o caminho mais curto é verificar a empresa no Business Manager e começar a enviar para quem já conhece o negócio. O Frame Conexa mostra a capacidade do número antes de cada campanha e recusa o que não cabe. Veja os planos por número e, se você integra por código, os limites da API.

Leia também

Conecte o número que você já usa à API oficial do WhatsApp.

Sem trocar de número, sem perder o aplicativo e sem cobrança por mensagem da nossa parte. Você paga por número; a Meta, você paga direto.