Quem opera WhatsApp em volume pra negócio cedo ou tarde encara essa decisão: usar API oficial (Cloud API da Meta) ou usar uma das bibliotecas não-oficiais como Z-API, Wppconnect ou Baileys. As não-oficiais são mais baratas no curto prazo, mas têm consequências sérias que ficam claras só depois de queimar 5-10 chips.
Esse guia explica a diferença real entre as duas, quando cada uma faz sentido, e como começar com a API oficial sem complicação.
O que é API oficial do WhatsApp (Cloud API)
Cloud API é a infraestrutura oficial do Meta pra envio de mensagens em volume. Foi lançada em 2022 pra substituir a API on-premise (que exigia servidor próprio) e democratizar o acesso. Você cadastra um número, configura templates aprovados pelo Meta, integra via REST/webhook, e dispara.
Tudo é regulado: número precisa ser opt-in (cliente pediu pra receber), templates de mensagem precisam ser aprovados antes de poder usar, conteúdo é monitorado pela Meta. Em troca, você não derruba número, não queima IP, opera em volume sem perder número, e tem suporte oficial em caso de problema.
Custo é por conversa iniciada (não por mensagem individual). Em 2026, a tabela é ~R$ 0,30 por conversa iniciada por usuário, ~R$ 0,40 por conversa iniciada por empresa, e até 1.000 conversas mensais grátis pra contas novas. Comparado ao custo de um número que queima após 200-500 mensagens (R$ 30-50 perdidos + tempo de reconfiguração), a oficial sai mais barata em qualquer volume sério.
Bibliotecas não-oficiais: como funcionam
Z-API, Wppconnect, Baileys, Whatsapp-web.js e similares funcionam por engenharia reversa do WhatsApp Web. Você loga seu número via QR code, a biblioteca emula o cliente Web e envia mensagens via essa sessão.
Vantagem aparente: barato (geralmente assinatura R$ 30-100 mensais por número), sem aprovação de Meta, sem opt-in obrigatório, dispara qualquer mensagem em qualquer formato.
Desvantagem real: viola explicitamente os termos de uso do WhatsApp. O número é detectado e suspenso após volume relativamente baixo (200-2000 mensagens dependendo do padrão). IP do servidor que hospeda o bot fica marcado e contamina outros números. Não há suporte. Mensagens não chegam de fato em alguns casos (silent block do WhatsApp).
Bibliotecas não-oficiais são úteis pra casos específicos: protótipos, MVP, atendimento individual de baixíssimo volume, dev testing. Não são uma solução de produção pra disparo em volume.
Templates aprovados: o que são e como funcionam
Na Cloud API, mensagens enviadas pela primeira vez (iniciadas pela empresa, fora da janela de 24h de conversa ativa) precisam usar template aprovado pelo Meta. Template é uma mensagem com placeholders que o Meta valida antes de você poder usar.
Categorias de template: Marketing (promoções, ofertas), Utility (notificações transacionais, status de pedido), Authentication (códigos de verificação). Cada categoria tem regras próprias e a aprovação leva de minutos a 24h.
Após o cliente responder qualquer mensagem sua, abre uma janela de 24h em que você pode enviar qualquer conteúdo livre, incluindo mídia. Após 24h sem nova interação, a janela fecha e você precisa de template novamente pra reabrir conversa.
Boas práticas de template: variáveis claras ({{nome}}, {{pedido_id}}), opt-out explícito quando relevante, conteúdo específico não genérico ('Seu pedido #1234 saiu pra entrega' aprova; 'Olá! Tem novidades' não aprova).
Pré-requisitos pra começar com Cloud API
Conta Meta Business (gratuita): crie em business.facebook.com se ainda não tem. BM nova ou existente.
WhatsApp Business Account dentro da BM: associada à BM, vai conter os números cadastrados.
Número novo, não usado em WhatsApp comum nos últimos 30 dias: Cloud API exige número limpo. Chip empresarial novo é o ideal. Se você quer usar um número existente que ainda está em WhatsApp comum, precisa migrar (deletar conta WhatsApp comum e aguardar 30 dias).
Webhook endpoint pra receber mensagens recebidas e eventos: pode ser n8n, Zapier, Make, ou aplicação própria. Endpoint precisa ser HTTPS válido.
Token de acesso: gerado no Developer Portal Meta após confirmar BM e número. É o token que você usa nas chamadas API.
Tier de volume e como subir
Tier 1 (inicial): até 250 conversas iniciadas por empresa em 24h, escopo de marketing limitado. É onde toda BM nova começa.
Tier 2: 1.000 conversas iniciadas em 24h. Liberado automaticamente após 7 dias de uso saudável (taxa de bloqueio do destinatário <2%, sem reclamação).
Tier 3: 10.000 conversas iniciadas em 24h. Liberado após 60 dias com volume consistente em Tier 2 e qualidade alta.
Tier 4: 100.000 conversas iniciadas em 24h. Aprovação manual do Meta, pra empresas com BM verificada e operação grande.
Tier 5 (ilimitado): casos especiais, multinacionais. Aprovação direta com gerente de conta Meta.
Boas práticas pra subir tier: opt-in claro e gravado (cliente sabe o que vai receber), template específico não genérico, segmentação relevante (não dispara pra base inteira), monitoramento de bloqueio (se bloqueio passa de 5% em 24h, pausa).