API do WhatsApp Business: integração e automação
01 / Integração · WhatsApp Business API
O WhatsApp é o canal onde os clientes já estão e, quase sempre, o pior documentado da empresa. A API muda isso: transforma uma conversa que vivia no celular de alguém em um fluxo com estado, histórico e regras.
Como isso se reconhece de fora
O número da empresa está instalado no telefone de uma pessoa. Se essa pessoa folga, ninguém responde; se sai, o histórico sai junto. E não há como responder com um número à pergunta “quanto tempo levamos para responder?”.
Por quê
A API não é o app, e a diferença importa
Existem três produtos com nomes parecidos: o WhatsApp comum, o app WhatsApp Business e a WhatsApp Business Platform — a API. Só o terceiro permite vários atendentes sobre o mesmo número, integração com outros sistemas, envios em massa aprovados e rastreabilidade. É também o único com custo por mensagem e com processo de verificação do negócio. Começar pelo app e migrar depois é possível, mas implica refazer o cadastro e perder parte do histórico: se o plano é integrar, convém entrar direto pela API.
Fluxos
Os fluxos que precisam ser resolvidos
Cada um com a decisão de projeto que define se aguenta produção.
- 01
Templates e janela de atendimento
A Meta cobra por mensagem enviada, e apenas nas categorias de template: marketing, utility e authentication. Quando o cliente escreve primeiro, abre-se uma janela de atendimento de 24 horas na qual é possível responder com mensagens livres sem custo. Desenhar o fluxo em torno dessa janela é a diferença entre uma fatura razoável e uma desagradável.
Onde quebra
Resolver com template de marketing o que cabia dentro da janela de atendimento multiplica o custo sem melhorar nada. E os templates exigem aprovação prévia, então não se improvisam numa sexta-feira.
- 02
Agente com estado, não árvore de botões
O menu numerado envelhece mal: assim que o cliente escreve algo que não está na lista, o fluxo quebra. Um agente com modelo mantém o contexto da conversa, entende a reformulação e sabe quando não sabe.
Onde quebra
Um agente sem estado persistente perde o fio entre mensagens e repete perguntas. Um agente sem saída para humano frustra exatamente nos casos que mais importam.
- 03
Escalonamento para pessoa, com contexto
Quando a conversa passa para um humano, tem de chegar com o resumo e o histórico, e não com um “olá, em que posso ajudar?” que obriga o cliente a repetir tudo.
Onde quebra
É o ponto onde se perde a confiança conquistada. Um hand-off malfeito faz o cliente preferir o telefone da próxima vez.
- 04
Conexão com o sistema que tem a resposta
Consultar um pedido, marcar um horário ou verificar disponibilidade exige chegar ao ERP, ao CRM ou ao motor de reservas em tempo real. Sem isso, o agente só consegue falar de generalidades.
Onde quebra
Um agente que responde com informação desatualizada porque consulta uma cópia noturna gera mais chamados do que resolve.
Entrega
O que você recebe
- Cadastro e verificação do número na plataforma, com o provedor adequado
- Catálogo de templates aprovados por categoria e caso de uso
- Agente conversacional com estado persistente e saída para humano
- Conexão em tempo real com o sistema que tem o dado
- Métricas de canal: tempo de primeira resposta, resolução e custo por conversa
Princípios
Como construímos
Idempotência por padrão
Toda operação pode ser repetida sem duplicar nada. É o que permite reprocessar sem medo, e sem isso nenhuma integração sobrevive à primeira queda de rede.
Estado observável
Cada mensagem tem estado consultável: pendente, enviada, confirmada, falhada. Uma integração que só aparece quando falha já tinha falhado antes.
Um único dono por dado
Para cada campo há um sistema que manda e os outros obedecem. Sincronização bidirecional sem essa regra termina em loops e em dados que mudam sozinhos.
IA onde se decide, não onde se calcula
Classificar, extrair e redigir são tarefas de modelo. Somar, validar e encaminhar são tarefas de código. Trocar isso de lugar sai caro e fica impossível de auditar.
Método
Como abordamos o problema
Quem diagnostica é quem constrói, sem hand-offs pelo caminho. O método completo e o resto das capacidades estão na página de integração de sistemas.
- 01 · 3–5 dias
Diagnóstico
Mapeamos sistemas, fluxos de dados e dependências reais, inclusive as que ninguém documentou. Saída: escopo fechado e a lista do que hoje está quebrado.
- 02 · 1 semana
Desenho da integração
Contratos de dados, direção da sincronização, política de retentativas e quem é dono de cada campo. Decide-se antes de escrever código porque é o caro de mudar depois.
- 03 · 2–6 semanas
Implementação e testes
Construção com a casuística real, não com o caminho feliz. Testes contra os sistemas de verdade e implantação em fases.
- 04 · contínuo
Produção e observabilidade
Painel de estado, alarmes quando algo passa tempo demais sem confirmação e manutenção das integrações quando as APIs de terceiros mudam.
- Node / TypeScript
- Filas com retentativa
- Supabase / PostgreSQL
- n8n
- Webhooks assinados
- LangChain
- Docker
- Vercel
Relacionado
Relacionado a este caso
O que costuma vir antes ou depois, com o motivo do link.
Chatbots para empresas
O mesmo agente, visto do lado do serviço em vez do lado do canal.
02Integração de CRM
Para que a conversa termine na ficha do cliente e não num celular.
03ChatPlug: WhatsApp ligado à agenda
Um caso real com a API em produção: não traz tabela de preços, mas mostra o que a integração com o sistema de agendamento resolve de fato.
04Chatbot de reservas turísticas
O padrão de agente com estado e escalonamento para pessoa, aplicado a um fluxo de reservas com disponibilidade em tempo real.
Perguntas
Perguntas deste caso
Quanto custa a API do WhatsApp Business?
Há dois custos separados. O da Meta é cobrado por mensagem enviada nas categorias de template — marketing, utility e authentication —, com tarifas que dependem do país de destino; as mensagens recebidas e as enviadas dentro de uma janela de atendimento aberta não são cobradas, assim como as enviadas dentro da janela de free entry point de 72 horas. O segundo custo é o do provedor pelo qual se acessa a plataforma, e varia bastante conforme o modelo comercial. As tarifas concretas mudam com frequência, então são verificadas no momento de dimensionar o projeto, em vez de citadas de memória.
Dá para continuar usando o número atual?
Em geral sim, mas esse número deixa de funcionar no app do WhatsApp: passa para a plataforma e é operado a partir do sistema que integrarmos. Não é possível usar os dois ao mesmo tempo. Se o número é o celular pessoal de alguém, convém planejar a troca antes de começar, e não durante.
Posso enviar campanhas em massa?
Com templates previamente aprovados na categoria correspondente e com consentimento do destinatário. Enviar sem opt-in não é apenas um problema de proteção de dados: é o caminho rápido para os usuários marcarem o número como spam e a plataforma degradar a qualidade da conta, o que reduz o volume que se pode enviar.
O agente resolve sem intervenção humana?
Uma parte, e convém medir qual em vez de prometê-la. Consultas de status, disponibilidade e dados concretos são resolvidas bem de ponta a ponta quando o agente tem acesso ao sistema que guarda a resposta. Negociações, reclamações e tudo o que tenha carga emocional são desenhados para escalar cedo. A métrica que acompanhamos não é “percentual automatizado”, é quantas conversas terminam resolvidas sem que o cliente precise repetir o que já disse.
Seu próximo projeto
Comece pelo diagnóstico
Três a cinco dias para saber o que se conecta primeiro, com escopo e preço fechados antes de escrever uma linha de código.
Falar com um especialista