Whatsable
Todo mundo presume que integrar o WhatsApp é um projeto de várias semanas. Geralmente não é. A primeira mensagem pode sair em cerca de cinco minutos, desde que você siga os passos certos e evite as armadilhas que silenciosamente transformam uma tarefa rápida em um projeto de um trimestre.
Este guia percorre o caminho rápido, minuto a minuto, e explica por que cada passo importa.
Por que a maioria das integrações empaca
As equipes raramente travam no código. Elas travam em três problemas evitáveis: escolhem uma ferramenta não oficial que acaba bloqueada, deixam os modelos de mensagem para o dia do lançamento e esquecem de encaminhar as respostas para algum lugar útil. Resolva essas três coisas desde o início e o resto fica simples.
Minuto 1: Use a API oficial
Esqueça as bibliotecas não oficiais e os truques de automação de navegador. Parecem mais rápidos no primeiro dia, mas fazem o seu número ser sinalizado e bloqueado assim que você começa a enviar volume real.
Use a WhatsApp Business Platform, também chamada de Cloud API, hospedada pela Meta. Não há servidores para você manter, as mensagens recebidas são gratuitas e você ganha um número de teste do qual pode enviar imediatamente. Crie um app de desenvolvedor na Meta, adicione o produto do WhatsApp, e a Meta entrega na hora um número temporário e um token de acesso.
Minuto 2: Envie sua primeira mensagem de teste
Pegue o ID de telefone do número de teste e o seu token e faça uma única requisição:
curl -X POST \
'https://graph.facebook.com/v21.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"to": "<YOUR_NUMBER>",
"type": "text",
"text": { "body": "It works." }
}'
Se o seu telefone vibrar, o canal está ativo e a parte mais difícil já ficou para trás.
Minuto 3: Envie um modelo
Fora da janela de atendimento ao cliente de 24 horas, o WhatsApp não deixa você enviar texto livre. Você só pode enviar um modelo já aprovado. Envie um agora para que ele seja aprovado em segundo plano enquanto você termina o resto do desenvolvimento:
Olá {{1}}, seu pedido {{2}} está confirmado. Responda aqui se precisar de algo.
Mantenha-o transacional, preencha as variáveis e escolha a categoria correta, como utilidade ou marketing. A aprovação costuma chegar em minutos a poucas horas. Esse atraso é justamente o motivo pelo qual você o envia no minuto três e não na noite do lançamento.
Minuto 4: Configure o webhook de respostas
Uma mensagem que sua equipe não consegue ver é pior do que nenhuma mensagem. Aponte um webhook para a Meta para que as respostas recebidas sincronizem com o seu CRM ou central de atendimento:
POST /webhooks/whatsapp
1. verifique o token
2. analise messages[].text.body
3. envie para a sua caixa de entrada ou CRM
Agora o canal é uma conversa real de mão dupla, e não um buraco negro.
Minuto 5: Entre em produção
Troque o número de teste por um número comercial verificado e mude o seu token de temporário para permanente. O código continua o mesmo. Só as credenciais e o número mudam, e agora você está lidando com tráfego de produção.
A lista dos cinco minutos
- API oficial Cloud, nunca truques de navegador
- Primeira mensagem de teste enviada
- Modelo enviado cedo
- Webhook de respostas sincronizando
- Número real e token permanente
Acerte essas cinco coisas e a integração permanece entediante, no melhor sentido possível. Pule uma e a tarefa de cinco minutos vira, sem você perceber, uma reconstrução de três meses.
Criamos o Whatsable para que essas cinco coisas funcionem desde o início: API oficial, modelos aprovados, sincronização de mão dupla e no ar em minutos. Acesse whatsable.app para experimentar.