O que é a WhatsApp Business API — e o que ela não é

A Meta disponibiliza três produtos distintos sob a marca WhatsApp para negócios:

A API não é um aplicativo que você instala. É um conjunto de endpoints HTTP que a Meta expõe para que sistemas externos — plataformas de atendimento, CRMs, ferramentas de disparo — se comuniquem com o WhatsApp de forma programática. Você não acessa a API diretamente pelo celular; acessa pelo servidor da plataforma que contratou.

Para uma comparação técnica detalhada entre a API e o WhatsApp Web, consulte o artigo WhatsApp Business API versus WhatsApp Web para envio em massa, que detalha as restrições de cada abordagem.

Para quem a WhatsApp Business API faz sentido

A API resolve problemas que o app gratuito não consegue endereçar. Avalie se você se encaixa em pelo menos um dos perfis abaixo:

• Volume acima de 500 conversas/mês: o app gratuito não oferece fila, histórico centralizado nem relatórios. Com esse volume, a operação se torna ingerenciável sem uma plataforma.
• Equipe de atendimento com mais de 2 agentes: a API permite múltiplos atendentes no mesmo número, com distribuição de conversas e monitoramento em tempo real.
• Necessidade de notificações transacionais: confirmações de pedido, alertas de entrega, lembretes de consulta — todos exigem templates HSM aprovados pela Meta, disponíveis apenas via API.
• Integração com CRM ou ERP: a API se conecta via webhook a qualquer sistema que aceite requisições HTTP, eliminando retrabalho manual.

Casos de uso mais comuns no Brasil incluem e-commerce (rastreamento de pedidos), saúde (confirmação de consultas), financeiro (alertas de cobrança) e varejo (recuperação de carrinho abandonado). Para estratégias de conversão via WhatsApp, o guia de melhores práticas de marketing via WhatsApp para campanhas que convertem complementa o que a API viabiliza tecnicamente.

Se o seu cenário envolve disparos para listas grandes, o artigo como enviar mensagens em massa no WhatsApp com segurança detalha os limites operacionais e as boas práticas associadas.

Como funciona na prática: BSPs, Cloud API e aprovação de templates

O papel do BSP (Business Solution Provider)

Até 2022, a única forma de acessar a API era por meio de um BSP — empresa homologada pela Meta para provisionar o acesso, hospedar a infraestrutura e garantir conformidade com as políticas da plataforma. Em 2022, a Meta lançou a Cloud API, hospedada nos próprios servidores da Meta, que permite acesso direto sem intermediário obrigatório — conforme documentação oficial da WhatsApp Business Platform (Meta Developers).

Na prática, a maioria das empresas brasileiras ainda contrata via BSP ou plataforma de comunicação porque:

• A Cloud API exige conhecimento técnico para configurar webhooks, gerenciar tokens e tratar erros de entrega.
• BSPs e plataformas oferecem interface visual, relatórios prontos e suporte local em português.
• A integração com CRM e ferramentas de disparo já está pré-construída nessas soluções.

Templates HSM: o que são e como aprovar

Toda mensagem que a empresa envia fora da janela de 24 horas precisa usar um template HSM (Highly Structured Message) — formato pré-aprovado pela Meta. O processo de aprovação ocorre dentro do Meta Business Manager e leva entre alguns minutos e 24 horas, dependendo da categoria.

As categorias de template disponíveis são:

• Utilitária: confirmações de transação, atualizações de conta, alertas operacionais.
• Autenticação: OTP (senhas de uso único), verificação de identidade.
• Marketing: promoções, ofertas, conteúdo promocional — categoria com custo mais alto por conversa.

Templates com linguagem ambígua, promessas exageradas ou que violam as políticas de comércio da Meta são reprovados. A taxa de reprovação cai quando o texto é direto, identifica claramente o remetente e inclui variáveis apenas onde necessário.

Webhooks: como a API entrega mensagens ao seu sistema

Quando um usuário responde, a Meta envia um payload JSON para o endpoint (webhook) configurado na sua plataforma. Esse endpoint precisa responder com HTTP 200 em menos de 20 segundos; caso contrário, a Meta tenta reenviar. Plataformas como a Comunicação Em Massa abstraem essa camada — você vê a conversa na interface sem precisar configurar servidores.

Custos e modelo de cobrança da WhatsApp Business API

O modelo de precificação da Meta é baseado em conversas, não em mensagens individuais. Uma conversa é uma janela de 24 horas que se abre quando a primeira mensagem é trocada. Todas as mensagens dentro dessa janela fazem parte da mesma conversa e são cobradas uma única vez.

Existem dois tipos de conversa:

• Iniciada pela empresa (outbound): a empresa envia um template HSM para iniciar o contato. Custo mais alto, pois a empresa está “abrindo” a conversa.
• Iniciada pelo usuário (inbound): o usuário manda a primeira mensagem. A empresa tem 24 horas para responder com qualquer conteúdo, sem custo de template. Custo menor.

A Meta atualiza os preços por região periodicamente. Para o Brasil, os valores vigentes estão disponíveis na página oficial de preços da WhatsApp Business Platform. Além da taxa da Meta, o BSP ou plataforma cobra uma margem própria — que varia conforme o plano contratado.

Para comparar planos e entender o que cada camada inclui, consulte a página de preços e planos da Comunicação Em Massa, que detalha o que está incluído em cada nível de serviço.

Ponto de atenção: as primeiras 1.000 conversas iniciadas por usuário por mês são gratuitas — conforme política da Meta vigente em 2024. Esse limite se aplica por número de telefone registrado, não por conta.

Implementação passo a passo

O processo de ativação da WhatsApp Business API segue uma sequência definida. Desviar da ordem aumenta o risco de rejeição ou atraso:

1. Criar ou verificar a conta no Meta Business Manager: a conta precisa estar verificada (verificação de negócio da Meta) para acessar limites de mensagens mais altos.
2. Escolher a plataforma ou BSP: avalie interface, suporte em português, integrações nativas com o seu CRM e modelo de cobrança.
3. Registrar o número de telefone: o número não pode estar ativo em nenhuma conta WhatsApp. Se estiver, é necessário desvinculá-lo antes.
4. Configurar o perfil comercial: nome da empresa, categoria, descrição, endereço e site — campos que aparecem para o usuário antes de aceitar a conversa.
5. Criar e submeter templates HSM: comece com templates utilitários, que têm aprovação mais rápida e custo menor.
6. Configurar webhooks ou usar a interface da plataforma: defina para onde as mensagens recebidas serão roteadas.
7. Testar em sandbox antes de ir ao ar: a maioria dos BSPs oferece ambiente de teste para validar fluxos sem custo.

Para organizar sua base de contatos antes do primeiro disparo, o tutorial de importação de contatos para campanhas de WhatsApp via CSV cobre o formato correto e os campos obrigatórios.

A Comunicação Em Massa oferece onboarding guiado e integração nativa com os principais CRMs do mercado. Veja os recursos e funcionalidades disponíveis na plataforma para entender o que está disponível sem desenvolvimento adicional.

Compliance, LGPD e opt-in: o que você precisa garantir

A Lei Geral de Proteção de Dados (Lei nº 13.709/2018) exige base legal para o tratamento de dados pessoais. No contexto da WhatsApp Business API, o envio de mensagens a contatos que não deram consentimento explícito configura infração tanto à LGPD quanto às próprias políticas da Meta — que podem suspender o número sem aviso prévio.

Os requisitos mínimos de compliance são:

• Opt-in documentado: o usuário precisa ter concordado, de forma ativa e registrável, em receber mensagens da sua empresa via WhatsApp. Checkbox em formulário web, confirmação por SMS ou aceite em ponto de venda físico são formas válidas.
• Opt-out funcional: toda comunicação deve oferecer mecanismo claro de descadastramento. Ignorar pedidos de opt-out é motivo de bloqueio pela Meta.
• Finalidade declarada: o consentimento precisa especificar para qual tipo de mensagem o usuário está se inscrevendo (promoções, atualizações de pedido, suporte).
• Retenção de registros: guarde logs de opt-in com timestamp, canal de coleta e versão do texto apresentado ao usuário.

Enviar mensagens para listas compradas ou sem opt-in verificável é o caminho mais rápido para ter o número banido. O artigo sobre como evitar bloqueios ao enviar mensagens em massa no WhatsApp detalha os sinais que a Meta monitora e como estruturar campanhas dentro dos limites aceitáveis.

Perguntas frequentes sobre WhatsApp Business API

Posso usar meu número pessoal na API?

Não. O número registrado na API não pode estar associado a nenhuma conta WhatsApp ativa — pessoal ou Business App. Você precisará de um número dedicado (pode ser uma linha virtual) ou deverá desvincular o número atual antes do registro.

Qual é o limite de mensagens por dia?

O limite depende do nível de qualidade da conta. Contas novas começam no Tier 1 (1.000 conversas únicas por dia). Com histórico positivo de qualidade, o limite sobe automaticamente para Tier 2 (10.000) e Tier 3 (100.000) — conforme documentação da WhatsApp Business Platform.

A API funciona sem internet no celular?

Sim. A API opera em servidores, não no dispositivo móvel. O número precisa estar registrado, mas não há celular físico envolvido na operação diária.

Quanto tempo leva para ativar?

Com documentação em ordem, o processo leva entre 1 e 5 dias úteis: verificação do Meta Business Manager (até 2 dias), registro do número (imediato a 24h) e aprovação dos primeiros templates (minutos a 24h).