Integração com WhatsApp, API oficial ou não oficial

Quase todo sistema que fazemos hoje precisa falar com o WhatsApp: confirmar agendamento, avisar que o pedido saiu, mandar a segunda via do boleto, alertar o gestor quando algo sai do normal. Existem dois caminhos para isso, e a diferença entre eles vai muito além do preço.

A API oficial (WhatsApp Business Platform)

É a integração oferecida pela própria Meta. O seu sistema manda mensagens por uma API, com um número registrado na plataforma, sem celular ligado em lugar nenhum. Dá para usar direto pela Meta (a Cloud API) ou por um parceiro oficial, que cobra uma taxa e ajuda na configuração.

Como funciona na prática:

• Mensagens que a empresa inicia precisam usar um modelo (template) aprovado pela Meta antes do envio.
• Quando o cliente manda mensagem, abre uma janela de 24 horas em que a empresa responde livremente.
• A cobrança é por mensagem de modelo enviada, com preços diferentes para marketing, utilidade (aviso de pedido, cobrança) e autenticação (códigos de acesso). Responder o cliente dentro da janela não é cobrado.
• O número pode ganhar o selo de conta verificada e tem limites de envio que crescem conforme a qualidade das conversas.

A vantagem é a segurança: é o caminho permitido pelos termos do WhatsApp, então o número não corre risco de bloqueio por usar automação. A desvantagem é a burocracia (verificação da empresa, aprovação de modelos) e o custo por mensagem, que pesa em envios de marketing em massa.

A API não oficial

São ferramentas que conectam um número comum ao sistema imitando o WhatsApp Web. Você lê um QR Code com o celular e o sistema passa a enviar e receber como se fosse você. Existem projetos de código aberto e serviços pagos que fazem isso.

As vantagens são claras: sem aprovação de modelos, sem custo por mensagem e com liberdade total de conteúdo. Por isso tanta gente começa por aqui.

O problema é que esse uso viola os termos do WhatsApp. O número pode ser bloqueado a qualquer momento, e o risco cresce com envio em massa, muitas mensagens para quem não tem o seu contato salvo ou denúncias. Quando o bloqueio vem, vai junto o número que os clientes conhecem. Além disso, uma atualização do WhatsApp pode quebrar a integração de um dia para o outro.

Qual escolher

Use a API oficial quando:

• A mensagem é crítica para o negócio: cobrança, código de acesso, confirmação de compra.
• O número é o principal canal de atendimento da empresa.
• Você vai enviar para muitos clientes ou para quem nunca falou com você.

A não oficial pode servir quando:

• É um uso interno, como alertas para a própria equipe ou para o gestor.
• O volume é baixo e quem recebe já conversa com aquele número.
• Você aceita o risco e usa um número separado, que não é o do atendimento.

Uma arquitetura que funciona bem é separar os dois. Os alertas internos do sistema saem por um número de serviço, e tudo que vai para o cliente final sai pela API oficial. Se o número interno cair, a operação com o cliente continua.

Cuidados que valem para os dois

• Peça consentimento. Mensagem que o cliente não pediu gera denúncia, e denúncia derruba a qualidade do número em qualquer caminho.
• Guarde o histórico no seu sistema, não só no WhatsApp. Se trocar de fornecedor ou de número, os dados continuam com você.
• Trate o número de telefone como dado pessoal. A LGPD vale aqui, como explicamos em LGPD no desenvolvimento de software.
• Deixe a saída fácil. Uma resposta como "SAIR" deve tirar a pessoa da lista sem intervenção humana.

Automação com IA no WhatsApp

Um uso que cresceu muito é o atendente com IA, que responde dúvidas, qualifica o contato e passa para um humano quando precisa. Funciona bem quando o assistente responde com base nos documentos e dados da empresa, e não com o que o modelo "acha". Falamos disso em IA na empresa, por onde começar.

Se você está escolhendo agora, a pergunta que decide é simples: se esse número fosse bloqueado amanhã, quanto isso custaria? Se a resposta for "muito", o caminho é o oficial.