InícioBlogAPI Oficial

API Oficial

Todos os limites da API Oficial do WhatsApp, com os números da documentação

Quantos números, quantos templates, quantas mensagens por segundo, quantos dias de prazo. A referência completa, cada número com a página da Meta que o registra.

Quase todo problema sério de operação no WhatsApp é, no fundo, alguém esbarrando num limite que não sabia que existia. A campanha que não sai, o template que não pode ser criado, o número que não pode ser adicionado, o prazo que passou.

Esta página reúne os limites documentados da plataforma, cada um com a página da Meta que o registra. É para consultar, não para ler de uma vez.

Card com nove números de referência da API Oficial do WhatsApp: 2 a 20 números por portfólio, 250 clientes por dia no primeiro degrau, 80 mps de throughput padrão, 20 mps em coexistência, 250 a 6.000 templates, 10 mudanças de nome por 30 dias, 14 dias para registrar, 24h e 72h de janelas, e 36h de reenvio do webhook
Os números que mais aparecem no dia a dia de uma operação

Números de telefone

Limite Valor
Números por portfólio novo 2
Depois da verificação de negócio ou ao atingir 2.000 mensagens 20
Códigos curtos (short codes) não são suportados

Esse é o primeiro teto que aparece para quem planeja operar matriz e filiais, ou montar uma operação de revenda.

Limite de envio

Os degraus, contados em clientes únicos para quem você inicia conversa a cada 24 horas:

250 → 2.000 → 10.000 → 100.000 → ilimitado

Pontos que mudaram e que muito conteúdo ainda erra:

  • Desde 7 de outubro de 2025, o limite é calculado por portfólio de negócios, compartilhado por todos os números dele — não mais por número.
  • Um número novo registrado num portfólio já estabelecido herda o limite do portfólio.
  • O salto para 2.000 vem da verificação de negócio ou do envio de 2.000 mensagens entregues fora da janela de atendimento, com templates de boa qualidade.
  • Os aumentos seguintes são automáticos quando você envia mensagens de qualidade e usou pelo menos metade do limite atual nos últimos 7 dias. O aumento acontece em até 6 horas.

Detalhamos a escada em quantas mensagens posso enviar por dia.

Throughput — velocidade, não volume

Não confunda com o anterior: throughput é quantas mensagens saem por segundo.

Situação Throughput
Padrão da Cloud API 80 mps
Com upgrade automático até 1.000 mps
Número em coexistência 20 mps, fixo

Os três critérios documentados para o upgrade a 1.000 mps: o portfólio precisa ter limite de envio ilimitado; o número precisa ter enviado mensagens para 100 mil ou mais usuários únicos numa janela móvel de 24 horas; e a qualidade precisa estar em amarelo ou acima.

O teto de 20 mps na coexistência existe para manter a compatibilidade com o aplicativo — é o preço de ter o número nos dois lados.

Um detalhe operacional: o upgrade pode levar até um minuto, e durante a transição a API retorna o código 131057.

Templates

Limite Valor
Templates por conta, portfólio não verificado 250
Templates por conta, portfólio verificado e com ao menos um número com nome aprovado 6.000
Tempo de análise até 24 horas
Tempo de análise de uma apelação até 24 horas

Repare na condição do segundo caso: não basta verificar o portfólio, é preciso também ter pelo menos um número com nome de exibição aprovado.

Os motivos de reprovação e o processo de apelação estão em template reprovado no WhatsApp.

Nome de exibição

Limite Valor
Alterações de nome 10 a cada 30 dias
Prazo para registrar o número depois da aprovação 14 dias

O segundo é o que mais machuca: aprovou o nome e não registrou em 14 dias, o nome volta para a fila. Por isso não faz sentido aprovar nome com muita antecedência — veja o cronograma em quanto tempo leva para colocar a API no ar.

Janelas

Janela Duração O que ela decide
Atendimento 24 horas desde a última mensagem do cliente se você pode escrever texto livre
Free entry point (anúncio) 72 horas se a entrega é gratuita

As duas são independentes e podem estar em estados diferentes ao mesmo tempo — assunto de a janela de 72 horas do anúncio.

Limite de marketing por usuário

Este não tem número, e é de propósito: o WhatsApp pode limitar quantos templates de marketing cada pessoa recebe de qualquer empresa num período, e o teto se adapta ao engajamento recente dela — taxa de leitura e quantas mensagens ela já tem na caixa de entrada.

Quando a entrega é barrada por isso, o webhook traz status failed com o código 131049, e a recomendação é esperar pelo menos 24 horas antes de tentar de novo. Detalhes em erro 131049.

Vale notar as exceções geográficas: o limite não está ativo para números do Espaço Econômico Europeu, Reino Unido, Japão e Coreia do Sul, e mensagens de marketing não são entregues a números dos Estados Unidos.

Chamadas de voz

Limite Valor
Pedidos de permissão 1 a cada 24h e 2 a cada 7 dias, por usuário
Duração da permissão temporária 7 dias (168 horas)
Chamadas conectadas até 100 a cada 24 horas, por número
Chamadas seguidas sem resposta até o usuário receber aviso 2
Chamadas seguidas sem resposta até a permissão ser revogada 4
Unidade de cobrança pulsos de 6 segundos, arredondando para cima

Chamadas iniciadas pelo usuário são gratuitas. Mais em chamadas de voz pela API.

WhatsApp Flows

Limite Valor
Componentes por tela 50
Título e subtítulo 80 caracteres
Corpo de texto 4.096 caracteres
Rótulo de campo 20 caracteres
Opções em seleção única ou múltipla 20
Opções em lista suspensa 1 a 200 (100 com imagem)
Imagens por tela 3
Payload total 1 MB
Envio quando o flow é limitado (throttled) 10 mensagens por hora

Esse último é o que derruba campanha sem aviso. Ver WhatsApp Flows: os limites reais.

Coexistência

Limite Valor
Histórico sincronizado 6 meses (180 dias) de conversas individuais
Mídia sincronizada apenas mensagens dos 14 dias anteriores
Prazo para sincronizar o histórico 24 horas após o onboarding
Versão mínima do aplicativo 2.24.17
Dispositivos conectados que dá para reconectar 4

Webhook

Limite Valor
Resposta esperada do seu servidor 200 OK por HTTPS
Reenvio quando falha imediato, depois com frequência decrescente por 36 horas
Depois disso a notificação é descartada
Ordem de entrega não garantida

O detalhe cruel: a janela de atendimento é de 24 horas e o reenvio vai até 36. Explicamos a consequência em as mensagens não aparecem no sistema.

Conta oficial (o selo)

Requisito Valor
Tempo mínimo registrado na plataforma 30 dias
Outros requisitos conformidade com a política, verificação de negócio, verificação em duas etapas, nome aprovado
Critério subjetivo ser considerado um negócio notável

O critério de notabilidade é o que trava quase todo mundo — ele é sobre presença em imprensa, não sobre faturamento. Ver o selo de verificado.

Como usar esta página

A maioria desses números só importa quando você bate neles. Mas três merecem atenção antes:

O limite de 250 no primeiro dia, porque quem planeja campanha grande para a semana de estreia planeja frustração.

Os 14 dias do nome de exibição, porque é o único da lista que pune quem se antecipou demais.

O throughput de 20 mps na coexistência, porque é uma decisão que se toma no começo e não é trivial de desfazer.

Onde a gente entra

Conhecer os limites é uma coisa. Operar dentro deles sem ficar olhando painel é outra.

Com o AtendeChat, sua operação roda na API Oficial com a estrutura que transforma esses números em rotina: vários atendentes no mesmo número, fila de distribuição, histórico centralizado, funil e relatórios que mostram o que foi entregue e o que falhou — com o motivo.

Somos parceiros oficiais da Meta e conduzimos com você a verificação de negócio — que é o que destrava metade dos limites desta página —, o registro do número e a aprovação dos templates.

Se você não sabe hoje em qual degrau está o seu limite de envio, fale com a gente: é a primeira coisa que a gente olha.

Fontes

  1. Meta — Business phone numbers: limite de dois números para portfólios novos, subindo para vinte
  2. Meta — Messaging Limits: degraus de 250 a ilimitado, cálculo por portfólio e critérios de aumento
  3. Meta — Throughput: 80 mps padrão, até 1.000 mps por upgrade automático e 20 mps fixo em coexistência
  4. Meta — WhatsApp Business Accounts: limite de 250 templates para portfólio não verificado e 6.000 para verificado
  5. Meta — Display names: dez alterações a cada trinta dias e prazo de catorze dias para re-registrar
  6. Meta — Per-user marketing template message limits: limite dinâmico por usuário e código 131049
  7. Meta — Webhooks: reenvio por 36 horas e descarte das notificações não confirmadas

Rode seu WhatsApp na API Oficial da Meta

O AtendeChat é parceiro oficial da Meta: multiatendimento, Kanban, campanhas e IA — dentro das regras.

Leia também