Integrar o WhatsApp ao seu sistema pela API oficial
Como funciona a integração do WhatsApp pela API oficial, a diferença para as não oficiais, o que dá para automatizar e quanto custa.
Resposta rápida
Integrar o WhatsApp ao seu sistema pela API oficial permite enviar e receber mensagens automaticamente a partir dos eventos do sistema: status do pedido, lembrete de agendamento, aprovação de orçamento, cobrança. A API oficial exige verificação da empresa e modelos de mensagem aprovados antes do envio, o que afasta quem quer disparar em massa — mas é o único caminho que não corre risco de bloqueio do número, e esse risco é o motivo para não usar as soluções não oficiais.
Neste artigo
O pedido muda de status e alguém precisa avisar o cliente. Abre o WhatsApp no celular, procura a conversa, copia o número do pedido, escreve a mensagem. Trinta vezes por dia.
É o tipo de trabalho que some inteiro quando o sistema manda sozinho. E é um dos projetos de automação com retorno mais visível, porque a economia aparece no primeiro dia.
Oficial ou não oficial: decida isso primeiro
Existem duas formas de ligar o WhatsApp a um sistema, e essa escolha importa mais que qualquer detalhe técnico.
As soluções não oficiais simulam um aparelho conectado. São mais baratas, não exigem aprovação e funcionam rápido. Também violam os termos de uso — o número pode ser bloqueado sem aviso, e normalmente isso acontece quando o volume cresce, ou seja, justamente quando a operação já depende dele.
A API oficial exige verificação da empresa e modelos de mensagem aprovados. Dá mais trabalho para começar e tem custo por conversa. Em compensação, não corre risco de bloqueio.
Para sistema de empresa, a conta é simples: o barato só é barato até o número cair. Se o seu atendimento depende daquele número, use a oficial.
O que dá para automatizar
Os usos que mais aparecem, em ordem de retorno:
Status que muda. Pedido aprovado, aparelho pronto, entrega saiu. Substitui a pergunta “já ficou pronto?” antes dela acontecer.
Lembrete de agendamento. Mensagem no dia anterior com opção de confirmar ou remarcar. Reduz falta, que é prejuízo direto em qualquer negócio com agenda.
Aprovação de orçamento. Link com o orçamento detalhado, o cliente aprova e o aceite fica registrado com data e hora. Resolve a discussão de “eu não autorizei isso”.
Régua de cobrança. Lembrete antes do vencimento, aviso no dia, cobrança depois. Com baixa automática quando o pagamento entra, para não cobrar quem já pagou — o erro que mais irrita cliente.
Segunda via e comprovante. O cliente pede, o sistema responde sem ninguém no meio.
Como funciona na prática
A API oficial separa dois tipos de mensagem.
Mensagem iniciada pela empresa usa modelo aprovado previamente: texto fixo com campos variáveis, como em Olá {{nome}}, seu pedido {{numero}} está pronto. A aprovação leva algumas horas ou dias.
Mensagem dentro da conversa acontece depois que o cliente responde: abre-se uma janela em que a conversa flui livremente, sem modelo.
Na prática isso organiza a comunicação, porque obriga a definir antes o que a empresa vai dizer — em vez de cada atendente escrever de um jeito.
O que define o custo
Quantos eventos disparam mensagem. Um evento é um projeto pequeno. Oito eventos, com regras diferentes, é outro tamanho.
Se a conversa volta para o sistema. Só enviar é simples. Receber resposta, registrar junto do pedido e encaminhar para atendente é mais trabalho.
O estado do seu sistema. Se ele já tem API ou banco acessível, a ponte é direta. Se os dados só existem numa tela, o trabalho começa antes.
Tratamento de falha. O que acontece quando o envio falha, quando o número está errado, quando o cliente bloqueia. Integração que ignora isso parece pronta e quebra em produção — o mesmo cuidado vale para qualquer integração, como mostrei no artigo sobre o Bling.
Um aviso sobre volume
A API oficial é desenhada para conversa, não para disparo em massa. Usar notificação operacional é o cenário natural dela.
Se a ideia é marketing em lista grande, duas coisas mudam: o custo por conversa passa a pesar, e o risco de denúncia por parte de quem recebe cresce. São projetos diferentes, com regras diferentes.
Se você tem um fluxo que hoje alguém faz na mão e quer saber se é projeto de uma ou de quatro semanas, me chame.
Perguntas frequentes
Qual a diferença entre a API oficial e as soluções não oficiais?
As não oficiais simulam um aparelho conectado e violam os termos de uso, então o número pode ser bloqueado sem aviso — normalmente no pior momento, com a operação dependendo dele. A oficial é homologada, exige verificação da empresa e modelos aprovados, e não corre esse risco. Para sistema de empresa, só a oficial faz sentido.
Preciso aprovar as mensagens antes de enviar?
Para mensagens que a empresa inicia, sim: são modelos com texto fixo e campos variáveis, submetidos para aprovação. Depois que o cliente responde, abre-se uma janela em que a conversa flui livremente. Na prática isso organiza a comunicação, porque obriga a definir antes o que será dito.
Quanto custa enviar mensagem pela API oficial?
A cobrança é feita pela plataforma do WhatsApp, por conversa, e varia conforme o tipo e o país. É custo recorrente, separado do desenvolvimento da integração. Para notificação operacional o volume costuma ser baixo; para campanha de marketing a conta muda bastante.
Dá para o cliente responder e alguém da equipe atender?
Dá. A integração pode encaminhar a resposta para um atendente, registrar a conversa no sistema junto do pedido ou da OS, e devolver o controle para a automação depois. O cuidado é não deixar o cliente preso num robô sem saída para humano.
Quem escreve
Thainan Prado
Desenvolvedor full stack sênior com mais de 8 anos de experiência, responsável por sistemas em produção para empresas como OXXO, Ambev e Shell Select. Desenvolve sistemas sob medida, automações e integrações para PMEs e empresas médias de todo o Brasil.