Meta Business Platform (WhatsApp API): como funciona

Por que entender a arquitetura importa

A maioria das empresas brasileiras chega ao WhatsApp Business sem entender o que está contratando. Compra de um BSP, recebe um número, começa a usar. Funciona — até o dia em que precisa trocar de fornecedor, mover o número para outro BSP, abrir múltiplos canais, integrar com sistema corporativo ou simplesmente entender a fatura. Nesse momento, descobre que o número está vinculado a um WABA que não está em seu nome, que os modelos de mensagem aprovados não migram, que a categoria de cobrança das conversas estava errada e que o quality rating despencou sem aviso.

A arquitetura oficial da Meta resolve essas situações — desde que a empresa entenda quem é a titular do WABA, quais decisões dependem do BSP e quais dependem só da Meta, e como funcionam as categorias de cobrança. Este artigo entrega esse mapa.

WhatsApp Business Account (WABA): a entidade-mãe

A WABA é o registro oficial da empresa na Meta Business Platform. Tudo gira em torno dela: números, modelos de mensagem, controles de qualidade, faturas. Uma empresa pode ter uma ou várias WABAs (por marca, por geografia, por unidade de negócio).

Quem é o dono da WABA importa. A WABA pertence a uma Business Manager (gerenciador de negócios na Meta). Essa Business Manager precisa estar em nome da empresa contratante, não do BSP, agência ou consultor. É o ponto mais crítico de governança: empresa que tem WABA em nome de terceiro perde portabilidade — não consegue migrar de BSP sem renegociar tudo, e em casos extremos pode perder acesso ao próprio número se o relacionamento com o parceiro azedar.

Verificação da empresa. A WABA pode estar verificada (selo verde no perfil) — exige documentação (CNPJ, comprovante de presença pública da marca) e libera funcionalidades adicionais (limite mais alto de números, marca verificada no perfil do contato). Vale a pena para qualquer empresa com presença comercial relevante.

Limites por WABA. Uma WABA pode ter até 25 números associados (limite padrão; pode ser elevado por solicitação). Cada número precisa ser dedicado à plataforma — não pode estar simultaneamente em uso no aplicativo WhatsApp normal ou no WhatsApp Business app.

Número de telefone: requisitos e cuidados

O número associado à WABA precisa atender três requisitos:

Próprio da empresa. Linha registrada no CNPJ. Idealmente fixo (DDD da cidade) para passar credibilidade, embora número móvel também funcione tecnicamente. Atenção: uma vez na API, o número não pode voltar a usar o aplicativo WhatsApp comum, então não use o celular pessoal de um sócio.

Capaz de receber SMS ou ligação para verificação. O processo de registro envia código por SMS ou voz para o número. Linhas exclusivamente de dados (alguns tipos de SIP) podem não funcionar.

Limpo de uso anterior em outros aplicativos de mensageria comercial. Número que foi usado em outra plataforma de envio de mensagem em massa pode chegar com reputação ruim — bloqueado ou com quality rating baixo desde o início.

Empresas que mudam de BSP frequentemente esquecem: ao migrar, o número precisa ser portado de uma WABA para outra, processo que envolve a Meta e ambos os BSPs. Se a WABA original está em nome do BSP antigo, a portabilidade depende da boa vontade dele. Por isso, a WABA em nome da empresa é regra inegociável.

BSP versus Cloud API: a escolha técnica

Há dois caminhos técnicos para acessar a WhatsApp Business Platform.

BSP (Business Solution Provider). Empresa certificada pela Meta que intermedeia. No Brasil, os principais são Take Blip, Zenvia, Twilio, 360dialog, e dezenas de plataformas regionais. O BSP oferece: interface de atendimento (caixa de mensagem para o time), criação e gerenciamento de modelos, integração nativa com CRMs, suporte técnico. Cobra fee mensal por usuário, por número ou por mensagem, além de repassar o custo da conversa cobrado pela Meta. É o caminho de menor fricção operacional e o adotado pela maioria das médias empresas brasileiras.

Cloud API (acesso direto via Meta). A Meta hospeda a infraestrutura e a empresa integra diretamente via interface de programação. Não há fee de BSP — apenas o custo da conversa cobrado pela Meta. Em compensação, o anunciante precisa construir ou contratar a camada de software de atendimento, gerenciamento de modelos e integrações. É o caminho de maior controle e menor custo unitário em volume — viável quando há time de tecnologia interno ou parceiro técnico dedicado.

Critério prático de decisão: volume mensal de mensagens abaixo de 100 mil, BSP geralmente vale mais a pena (custo de operar Cloud API supera o fee). Acima de 500 mil, Cloud API começa a fazer sentido econômico se há equipe técnica. Entre 100 mil e 500 mil, decisão depende de quanto a interface do BSP entrega ao time de atendimento.

Modelos de mensagem (templates HSM): a regra de envio proativo

Empresa não pode enviar qualquer mensagem para qualquer pessoa no WhatsApp Business — a Meta protege o canal de spam. A regra: para iniciar conversa proativamente com um contato (fora de uma janela de 24 horas após mensagem do cliente), é obrigatório usar um modelo de mensagem (template HSM — Highly Structured Message) previamente aprovado pela Meta.

O modelo tem texto fixo (com variáveis substituíveis: nome, número de pedido, data), categoria declarada (marketing, utilidade, autenticação ou serviço) e idioma. Após submissão, a Meta aprova em horas ou dias. Modelos rejeitados costumam ter problemas claros: linguagem promocional explícita em categoria de utilidade, ausência de variáveis quando deveriam existir, conteúdo proibido (jogo de azar, produtos sensíveis sem autorização específica).

Após aprovação, o modelo pode ser usado em produção. Cuidado importante: a Meta reavalia modelos automaticamente quando detecta uso fora da categoria declarada (modelo de utilidade sendo usado em campanha de promoção, por exemplo). Modelo despromovido vira pendente — não pode ser usado até nova aprovação.

Conversation pricing: como a Meta cobra

A Meta cobra por conversa iniciada, em janelas de 24 horas. Quatro categorias com preços diferentes:

Marketing. Promoção, anúncio, oferta. Categoria mais cara — preço por conversa varia por país (no Brasil, faixa de R$ 0,40 a R$ 0,80 a depender de promoções e contrato). É onde a Meta concentra restrições adicionais (necessidade de opt-in claro, modelos com aprovação mais rigorosa).

Utilidade. Confirmação de pedido, atualização de envio, lembrete de compromisso, recibo. Categoria intermediária de preço (no Brasil, faixa de R$ 0,20 a R$ 0,40). Foco em comunicação transacional sobre uma compra ou serviço já contratado.

Autenticação. Códigos de verificação, autenticação de dois fatores, recuperação de senha. Categoria de preço mais baixo (faixa de R$ 0,10 a R$ 0,20). Restrita a casos específicos de segurança.

Serviço. Conversa iniciada pelo próprio cliente (cliente manda mensagem, empresa responde dentro da janela de 24 horas). Gratuita até o limite mensal incluso no plano, depois cobrada como categoria mais barata.

Erro frequente: empresa usa modelos de marketing para tudo (incluindo confirmações de pedido) e paga preço de marketing onde poderia pagar preço de utilidade. Auditoria mensal de modelos por categoria revela essas economias rapidamente.

Janela de 24 horas: quando o cliente envia mensagem para a empresa, abre uma janela de 24 horas em que a empresa pode responder com mensagem livre (texto, imagem, qualquer formato) sem precisar de modelo aprovado. Após 24 horas sem nova mensagem do cliente, qualquer envio precisa ser modelo aprovado novamente.

Opt-in registrado, quality rating e limites

Opt-in. A Meta exige que o destinatário tenha consentido em receber mensagens no WhatsApp da empresa. O opt-in pode vir de diversos canais (formulário no site, caixa marcada na compra, conversa anterior em outro canal), mas precisa ser registrado e auditável. Mensagens enviadas sem opt-in geram reclamações, que afetam o quality rating.

Quality rating. Cada número tem uma classificação dinâmica (verde, amarelo, vermelho) com base em três sinais: bloqueios pelos destinatários, marcações como spam e taxas de entrega. Número em verde tem limite alto de envio (até 100.000 conversas iniciadas por dia no tier mais alto). Número em vermelho perde capacidade de envio e pode ser banido. Recuperação de quality rating leva semanas e exige reduzir frequência, melhorar relevância e parar campanhas que geram reclamação.

Tiers de mensagem. Número novo começa em tier inferior (1.000 conversas iniciadas por dia) e progride conforme demonstra qualidade. Tier máximo atual é "ilimitado" (sem cap diário, sujeito a quality rating). Progressão depende de manter quality rating verde por janelas determinadas.

Erros comuns na arquitetura

WABA em nome do parceiro. Empresa "alugou" o número via BSP que registrou a WABA em nome próprio. Resultado: ao trocar de fornecedor, o número fica preso. Renegociação cara e demorada. Regra: WABA sempre em nome da empresa, ponto final.

Número não corporativo. Número de celular pessoal de sócio ou funcionário entrou na API. Quando a pessoa sai, sai com o número. Use sempre linha registrada no CNPJ.

Modelos rejeitados em massa. Submissão em lote sem revisão prévia. Modelos com linguagem promocional em categoria errada, sem variáveis quando deveriam existir, com conteúdo proibido. Crie checklist interno e revise antes de submeter.

Quality rating em queda sem ação. Time não monitora a métrica, descobre quando o número já está em vermelho. Configure alertas — todos os principais BSPs oferecem — e tenha protocolo claro do que fazer ao primeiro sinal (amarelo).

Sem governança de múltiplos números. Empresa abre dez números para áreas diferentes (vendas, suporte, marketing, regionais) sem padronização. Cada um faz como quer, modelos divergentes, custos descontrolados. Defina governança central a partir do terceiro número.

Custos fora do orçamento. Não houve auditoria das categorias de conversa — campanhas de marketing rodando como "utilidade" são pegas pela Meta e recategorizadas (e re-cobradas); mensagens transacionais classificadas como "marketing" pagam mais que deveriam. Auditoria mensal por categoria evita surpresa.