Orientações sobre o produto
Como lidar com os limites de verificação da API do WhatsApp Business
Saiba como operar dentro dos limites de verificação da API do WhatsApp Business e usar verificações de registro em tempo real para manter altas classificações de qualidade.
Saiba como as empresas podem usar a API do WhatsApp Business antes da verificação completa da Meta, gerenciar os limites iniciais de mensagens e proteger as classificações de qualidade por meio da verificação síncrona de contatos.
As empresas podem se conectar à API do WhatsApp Business e começar a enviar mensagens imediatamente, sem esperar a conclusão da verificação empresarial da Meta. Nessa fase preliminar, as organizações operam dentro dos limites iniciais de mensagens, que normalmente restringem o alcance de saída a 250 contatos únicos iniciados pela empresa em uma janela móvel de 24 horas. A verificação empresarial da Meta é executada de forma assíncrona, em segundo plano. Como a progressão de nível de mensagens e a situação da conta dependem de manter uma alta classificação de qualidade, as organizações precisam priorizar a higiene dos dados de contato e verificar a alcançabilidade na plataforma antes de disparar campanhas.
O caminho até o acesso à API do WhatsApp Business
Muitas equipes presumem que a verificação empresarial completa da Meta precisa estar finalizada antes de enviar uma única notificação ou resposta de atendimento pelo WhatsApp. Na prática, a verificação empresarial da Meta é um processo assíncrono que corre de forma independente em segundo plano enquanto o onboarding técnico avança. As organizações podem conectar seus números de telefone à API do WhatsApp Business por meio de fluxos de cadastro incorporado ou de onboarding direto pela API. Uma vez conectados, os recursos de mensagens são ativados imediatamente para testes iniciais, programas piloto internos e comunicação de produção de baixo volume. Esse onboarding imediato permite que líderes técnicos e equipes de produto integrem webhooks, configurem modelos de mensagem e testem sistemas operacionais sem esperar dias ou semanas pela conclusão da análise da documentação corporativa.
Entendendo os limites iniciais de mensagens e a progressão de níveis
Operar antes da verificação formal coloca a conta no nível inicial de mensagens. Nesse nível, as mensagens iniciadas pela empresa — como notificações transacionais, alertas de agendamento e contatos proativos — ficam limitadas a 250 números de telefone de destinatários únicos em qualquer janela móvel de 24 horas.
| Fase operacional | Limite de mensagens | Critério de expansão |
|---|---|---|
| Inicial (não verificada) | 250 destinatários únicos / 24 horas | Conclusão da verificação empresarial da Meta |
| Nível 1 (verificada) | 1.000 destinatários únicos / 24 horas | Alta classificação de qualidade + atingir limites de volume |
| Nível 2 (verificada) | 10.000 destinatários únicos / 24 horas | Alta classificação de qualidade + atingir limites de volume |
| Nível 3 (verificada) | 100.000 destinatários únicos / 24 horas | Alta classificação de qualidade + atingir limites de volume |
| Nível 4 (verificada) | Destinatários ilimitados / 24 horas | Alta classificação de qualidade sustentada em escala |
Avançar além do nível inicial exige dois elementos: a verificação empresarial concluída e um histórico ativo de mensagens de qualidade. Quando uma conta envia de forma constante perto de sua cota diária mantendo uma alta classificação de qualidade, a Meta ajusta automaticamente o limite diário para cima. Se os destinatários denunciarem, bloquearem ou excluírem com frequência os modelos recebidos, a classificação de qualidade da conta cai, o que pode restringir a progressão do limite ou sinalizar o número de telefone para revisão administrativa.
Priorizando a higiene de dados antes da verificação
Como o nível inicial oferece apenas 250 envios diários, a higiene dos dados dos destinatários influencia diretamente o sucesso do onboarding. Tentar enviar mensagens a telefones fixos, linhas móveis desativadas ou números sem conta no WhatsApp desperdiça a limitada cota diária de volume e prejudica as métricas de entrega. Incorporar uma verificação dedicada de registro no WhatsApp ajuda as equipes a auditar as listas de contatos antes de iniciar o envio de mensagens. Uma verificação de registro inspeciona um número de telefone enviado para confirmar se existe uma conta na plataforma naquele exato momento. Avaliar o registro fornece um sinal de presença de conta no momento da verificação. Isso informa aos sistemas se um número de destino pode receber conteúdo do WhatsApp.
Integrando fluxos de verificação em tempo real
As equipes técnicas podem incorporar verificações de registro diretamente a pipelines de ingestão do CRM, formulários de cadastro e filas de envio de mensagens usando a API REST do WA Lookup. As verificações são executadas de forma síncrona, devolvendo dados imediatos de presença de conta na própria conexão HTTP que as iniciou, em vez de exigir filas de tarefas, rotinas de consulta periódica ou webhooks assíncronos. As requisições são enviadas para POST /api/v1/check usando o cabeçalho X-API-Key, Content-Type: application/json e um corpo JSON que especifica o identificador de destino e o tipo de verificação:
ws: o WhatsApp Checker principal informa se o número de telefone E.164 enviado está registrado no WhatsApp.ws_avatar: verifica o registro no WhatsApp, confere a disponibilidade do avatar e retorna uma URL do avatar quando houver (o campo de URL pode vir vazio se nenhuma imagem pública estiver configurada).ws_business: avalia o registro e informa se a conta está configurada como perfil do WhatsApp Business.
Todos os números enviados devem seguir rigorosamente o formato padrão E.164. A API entrega um envelope de resposta concluído contendo code, msg e um objeto data que inclui service_type, identifier e o campo booleano registered. Se uma verificação não puder ser decidida, o serviço retorna um código de negócio diferente de zero em vez de um resultado incompleto. Para fluxos com vários contatos, as equipes podem avaliar até 100 identificadores E.164 em uma única requisição por meio do endpoint síncrono em lote, que devolve juntas as avaliações concluídas de todo o lote. O comportamento de uso é regido pelos parâmetros documentados de concorrência por usuário e de timeout; os desenvolvedores devem consultar a documentação oficial da API para conhecer os controles atuais do sistema. Integrar essas verificações automatizadas no início do fluxo garante que as cotas iniciais sejam gastas exclusivamente com destinos alcançáveis.
Perguntas frequentes
As organizações podem usar a API do WhatsApp Business antes de a verificação da Meta terminar?
Sim. A verificação empresarial da Meta não é pré-requisito para conectar um número de telefone à API do WhatsApp Business. As equipes podem iniciar testes, configurar integrações e começar a enviar mensagens de saída em baixo volume imediatamente, dentro das restrições do nível inicial de mensagens.
Quais limites de mensagens se aplicam a contas do WhatsApp Business não verificadas?
Contas não verificadas operam sob os limites iniciais de mensagens, normalmente restritos a 250 destinatários únicos por período móvel de 24 horas para conversas iniciadas pela empresa. As conversas de atendimento iniciadas pelo cliente continuam disponíveis para responder às dúvidas recebidas.
Como os níveis de mensagens aumentam ao longo do tempo?
Os limites de mensagens aumentam automaticamente depois que a verificação empresarial é concluída. A expansão depende de manter uma classificação de qualidade aceitável enquanto a conta se aproxima de forma consistente dos limites de volume do nível atual, levando a Meta a promover a conta para níveis diários mais altos.
Qual é o papel de uma verificação de registro em plataforma nos fluxos de mensagens?
Ela ajuda as organizações a filtrar números não registrados antes do envio, o que favorece a classificação de qualidade do remetente e evita desperdiçar a capacidade do nível inicial de mensagens.
Saiba mais
Escolha as informações de produto que se encaixam na próxima etapa do seu fluxo.