Buscar

WhatsApp Business API: automação de atendimento e marketing

Como funciona a WhatsApp Business Platform de verdade: app x API, acesso por BSP ou Cloud API, opt-in, janela de 24h, templates aprovados e automação por webhook, n8n e CRM.

Gabriel Pedroso11 min de leitura
WhatsApp Business API: guia de automação de atendimento e marketing

Toda semana aparece alguém confundindo o app WhatsApp Business, que você baixa de graça na loja, com a WhatsApp Business API — e é uma confusão que custa caro, porque leva a escolher a ferramenta errada. A WhatsApp Business Platform é a solução da Meta para empresas automatizarem e escalarem mensagens de forma programática; você não a baixa, você a acessa por um provedor oficial (BSP) ou pela Cloud API, sempre com número verificado e dentro das regras da Meta. Entender essa distinção antes de tudo poupa semanas de retrabalho.

Este guia mostra como a plataforma funciona de verdade: os caminhos de acesso, as três regras que moldam qualquer automação — opt-in, janela de 24h e templates aprovados — e como plugar isso a webhook, n8n e CRM sem cair em atalho que derruba o número.

1Opt-ino contato autoriza receber mensagens antes de qualquer envio
2Contanúmero verificado no Business Manager acessa a API por um BSP ou pela Cloud API
3Templatea Meta aprova a mensagem por categoria: marketing, utilidade, autenticação ou serviço
4Envioa API dispara respeitando a janela de 24h — texto livre dentro, só template fora
5Webhooka resposta do cliente volta por webhook e alimenta a automação no n8n ou CRM
O ciclo da automação na WhatsApp Business Platform: o contato dá opt-in, o número verificado acessa a API por um BSP, a mensagem sai por template aprovado respeitando a janela de 24h e a resposta volta por webhook.

App WhatsApp Business x WhatsApp Business Platform

A primeira decisão não é técnica, é de escopo. O app e a plataforma resolvem problemas diferentes, e usar um no lugar do outro é a fonte da maioria das frustrações.

App WhatsApp BusinessWhatsApp Business Platform (API)
Para quemmicro negócios e autônomosempresas que escalam atendimento e mensagens
Como se usamanual, no celularprogramático, via API
Automaçãolimitada (respostas rápidas, mensagem de ausência)fluxos, chatbot, CRM e envio por template
Acessobaixar o app, grátisBSP ou Cloud API + número verificado no Business Manager
Custográtismodelo de cobrança da Meta + margem do provedor

Se o volume ainda é de conversas contadas nos dedos, o app resolve. A partir do momento em que você quer disparar mensagens a partir de um formulário, de um evento no CRM ou de um bot, o caminho é a plataforma — e daí vêm as regras.

Como se conecta: BSP ou Cloud API

Você não fala com a API do WhatsApp por conta própria a partir de um número qualquer. O acesso passa por um número verificado, vinculado ao seu Business Manager, e por um de dois caminhos:

CaminhoComo funcionaQuando escolher
BSP oficial (Twilio, 360dialog, Zenvia, Take Blip, Infobip…)o provedor hospeda a conexão e te entrega API, painel e suportequando você quer menos infraestrutura e, muitas vezes, suporte em português
Cloud API da Metavocê chama a API hospedada pela própria Meta, sem intermediárioquando quer controle total e tem time técnico para tocar a integração

Um BSP (Business Solution Provider) é um parceiro certificado pela Meta que embrulha a API e cuida da verificação, do painel e, em muitos casos, do suporte no seu fuso. A Cloud API é o caminho direto, hospedado pela Meta, para quem quer mexer no baixo nível. Os dois usam a mesma plataforma por baixo e obedecem exatamente às mesmas regras — a escolha é sobre quanta infraestrutura você quer carregar.

As três regras que definem a automação

Antes de desenhar qualquer fluxo, três regras da Meta decidem o que é possível. Ignorá-las é o jeito mais rápido de derrubar a qualidade do número e, no limite, ser bloqueado.

RegraO que significaEfeito na sua automação
Opt-ino contato precisa autorizar receber mensagens antes do primeiro enviosó entra no fluxo quem consentiu; guarde a prova
Janela de 24hapós o cliente te escrever, você tem 24h para responder com texto livreatendimento humano e chatbot cabem dentro da janela
Templates (HSM)fora da janela, só mensagens pré-aprovadas pela Meta, por categoriacampanhas disparam templates, não texto solto

Os templates — o antigo HSM, hoje chamados só de mensagens de template — se dividem em categorias: marketing, utilidade, autenticação e serviço. Cada uma tem regra e preço próprios, e a Meta os aprova antes do uso. Uma confirmação de pedido (utilidade) e uma oferta promocional (marketing) não são a mesma coisa aos olhos da plataforma, e submeter um no lugar do outro é motivo de reprovação. Some a tudo isso a LGPD: o opt-in do WhatsApp e o consentimento legal andam juntos, mas são exigências distintas — registre prova das duas.

Automação de verdade: webhook, n8n e CRM

É aqui que a API justifica o esforço. O padrão de qualquer automação séria tem duas pernas: saída, quando algo do seu lado dispara uma mensagem, e entrada (inbound), quando o cliente responde e você reage.

A entrada é sempre por webhook: quando o contato manda uma mensagem, o BSP (ou a Cloud API) faz um POST para uma URL sua com o telefone, o texto e o horário. Você recebe esse evento, encontra o contato e decide o que fazer — responder pelo bot, abrir a janela de 24h para um humano, atualizar o CRM.

Na saída, o gatilho costuma vir de um formulário ou de um evento no CRM. O ponto que os tutoriais pulam é que o CRM raramente chama a API do WhatsApp sozinho — o Mautic, por exemplo, não tem conector nativo. Algo precisa ficar no meio, receber o evento e traduzir para a chamada do provedor. Na prática, essa peça costuma ser o n8n:

  1. O lead preenche o formulário com telefone e opt-in.
  2. O CRM dispara um webhook para o n8n.
  3. O n8n valida o número e confere o opt-in, descartando o que não passa.
  4. Um nó HTTP (ou o nó do BSP) chama a API com o template certo, respeitando a janela de 24h.
  5. O n8n escreve de volta no CRM: tag, nota ou pontos, alimentando a próxima etapa.

A vantagem sobre o webhook cru é o miolo: dá para tratar erro, tentar de novo com backoff, ramificar por idioma ou horário e logar cada passo. O passo a passo desse trilho para o Mautic está no guia de integração WhatsApp + Mautic. Para o chatbot dentro da janela, dá para plugar um modelo de linguagem que responde às perguntas comuns e escala para um humano quando trava — mas isso é uma camada por cima do fluxo, não um substituto das regras.

Qualidade do número e limites de envio

A Meta não deixa você sair disparando à vontade no primeiro dia. Cada número tem uma classificação de qualidade (quality rating), influenciada por bloqueios, denúncias e taxa de resposta, e opera dentro de limites de mensagens (tiers) que sobem conforme o número se comporta bem e entrega volume com engajamento. Mandar para quem não pediu derruba a qualidade; respeitar opt-in e enviar conteúdo relevante faz o limite crescer. É o mecanismo que transforma boa prática em capacidade real de envio — e por isso a régua de consentimento não é burocracia, é o que mantém o canal vivo.

Quanto custa (sem cravar número)

Custo é a parte que mais tutorial erra, porque copia preço velho. A Meta cobra pelo modelo dela, e esse modelo muda. O que antes era cobrado por conversa passou a considerar a mensagem e a categoria do template, com valores diferentes por país. Por cima disso vem a margem do seu BSP e, se você roda CRM e n8n em servidor próprio, o custo da infraestrutura. Em vez de decorar um valor, consulte a tabela vigente do seu provedor e a documentação oficial da WhatsApp Business Platform antes de dimensionar campanha.

Automação não oficial: o atalho que derruba o número

Vale o alerta que sempre repito: automatizar o WhatsApp comum — o app pessoal ou o Business do celular — com bibliotecas e "robôs" não oficiais viola os termos de uso e coloca o número em risco de banimento. Essas ferramentas prometem envio em massa barato justamente porque burlam a plataforma, e a Meta detecta e bloqueia. O único caminho suportado para escala é a API oficial, via BSP ou Cloud API. É mais trabalho no começo, mas é o que não some do dia para a noite levando sua base junto.

Perguntas frequentes sobre WhatsApp Business API

Qual a diferença entre o app WhatsApp Business e a WhatsApp Business API?

O app WhatsApp Business é gratuito, roda no celular e foi feito para o micro negócio atender manualmente. A WhatsApp Business Platform (a API) é a solução da Meta para empresas automatizarem e escalarem mensagens de forma programática — por webhook, chatbot ou CRM. Uma coisa você baixa na loja; a outra você acessa por um provedor (BSP) ou pela Cloud API, com número verificado no Business Manager.

Preciso de opt-in para enviar mensagem pela API do WhatsApp?

Sim, e por dois motivos. A Meta exige opt-in explícito antes do primeiro envio pela API, e a LGPD exige consentimento para tratar o dado e contatar a pessoa. São exigências distintas que andam juntas: registre quem autorizou e quando, num campo ou tag do seu CRM, para ter prova. Sem opt-in, o número perde qualidade e corre risco de bloqueio.

O que é a janela de 24 horas e o que muda fora dela?

Depois que o cliente te manda uma mensagem, abre uma janela de 24 horas em que você pode responder com texto livre — é onde cabem o atendimento humano e o chatbot. Fora dessa janela, você só consegue iniciar contato com um template pré-aprovado pela Meta, na categoria certa (marketing, utilidade, autenticação ou serviço). Toda automação de reengajamento precisa respeitar essa regra.

Quanto custa usar a WhatsApp Business API?

Não dá para cravar um valor. A Meta cobra pelo modelo dela, que muda com frequência — deixou de ser só por conversa e passou a considerar mensagem e categoria do template, com preço diferente por país. Some a isso a margem do BSP e, se for o caso, o servidor onde roda seu CRM. Consulte a tabela vigente no seu provedor e na documentação da Meta antes de dimensionar; número de tutorial antigo engana.

Como integrar a WhatsApp Business API ao Mautic ou a outro CRM?

Por API e webhook, não por conector mágico. O Mautic, por exemplo, não tem integração nativa de WhatsApp: o CRM dispara um evento, uma ferramenta como o n8n recebe, chama a API do BSP com o template certo e escreve a resposta de volta. É o mesmo padrão para outros CRMs — o WhatsApp entra como mais uma API na sua automação, orquestrada por webhook.

Por onde começar

Não monte o funil inteiro de uma vez. Escolha um caminho de acesso — um BSP com suporte no seu fuso, se você quer menos infraestrutura —, verifique o número e faça um único envio funcionar: captura no formulário, opt-in registrado, um template de boas-vindas disparado por webhook. Só depois feche o loop com a mensagem de entrada e a resposta automática. É o trecho de maior retorno e o que ensina a lógica toda. Com ele estável, expanda para uma sequência de nutrição pelo CRM — e, se ainda está escolhendo as peças da automação, a lista de APIs públicas ajuda a enxergar o que mais dá para plugar no mesmo fluxo.