Integrar WhatsApp e CRM parece questão técnica, mas quase todo fracasso vem de decisão de negócio mal tomada antes da primeira linha de configuração.
São quatro decisões. Errar qualquer uma gera dado duplicado e desconfiança na equipe — e equipe que não confia no sistema volta para a planilha.
1. Quem manda no cadastro
Se o cliente atualiza o telefone numa conversa, isso sobrescreve o CRM? Se o CRM tem o nome completo e o WhatsApp tem o apelido, qual aparece?
Sem essa definição, os dois sistemas divergem e ninguém sabe qual está certo.
Na maioria das operações, o CRM é a fonte da verdade para cadastro e o WhatsApp é fonte para conversa. O que vem do WhatsApp entra como sugestão, não como sobrescrita automática.
2. A chave de identificação
Como o sistema sabe que o WhatsApp +55 51 9xxxx é o mesmo cliente do CRM?
Parece trivial e não é. No Brasil, o mesmo número aparece com e sem o nono dígito, com e sem DDI, com e sem formatação. Se a integração comparar texto puro, você vai criar contato duplicado no primeiro dia.
E não é só descuido de cadastro: a própria plataforma altera o número. A documentação da Meta diz, sobre Brasil e México, que “the extra added prefix of the phone number may be modified by the Cloud API” — e completa que isso é comportamento padrão do sistema, não um bug. Traduzindo para o seu problema: o identificador que volta na resposta pode não ser idêntico ao número que você enviou. Se a sua chave de comparação é a string do telefone, ela quebra por desenho da plataforma, não por erro seu.
Do outro lado, no envio, a documentação recomenda incluir sempre o sinal de mais e o código do país. Sem o “+”, a Meta assume o código do país da sua empresa e a mensagem pode ir para o número errado — o exemplo que ela mesma dá é um número americano digitado sem “+” por uma empresa na Índia, que vira +91... em vez de +1.... Hífen, parênteses e espaço são aceitos e não atrapalham.
Normalize antes de comparar. Guarde só dígitos, com DDI, e trate a variação do nono dígito nos dois sentidos — a sua base pode ter a versão com nove e a API devolver a sem, ou o contrário. Essa é a causa número um de base duplicada.
3. O que sincronizar de verdade
A tentação é sincronizar tudo. O resultado é um CRM cheio de “ok”, “obrigado” e figurinha.
O que costuma valer:
- Contato — criado ou vinculado na primeira conversa
- Origem — de onde veio o lead
- Etapa — mudança de estágio no funil
- Desfecho — resultado do atendimento e motivo
- Link para a conversa completa
O que raramente vale: cada mensagem individual.
4. O que acontece quando falha
Integração falha. A pergunta é o que acontece depois.
Fila com nova tentativa. Se o CRM estiver fora do ar, o evento espera em vez de sumir.
Alerta para gente. Falha silenciosa é a pior — todo mundo acredita que os dados estão lá.
Registro do que passou. Sem log, não dá para reconstruir o que se perdeu.
Direção dos dados
Vale decidir explicitamente o sentido:
Só entrada (WhatsApp → CRM). Mais simples e seguro. Bom para começar.
Só saída (CRM → WhatsApp). Dispara notificação a partir de evento no sistema.
Bidirecional. Mais poderoso e mais arriscado: exige regra clara de conflito, senão os dois sistemas ficam se sobrescrevendo.
Comece por um sentido. Bidirecional sem regra de conflito é a receita para dado inconsistente.
O teste antes de liberar
Antes de ligar para todo mundo, rode com um cliente real e verifique:
- O contato foi criado uma vez só?
- O número ficou normalizado?
- A origem foi registrada?
- Se eu desligar o CRM, o evento espera ou some?
- Alguém é avisado quando falha?
Se as cinco respostas estiverem certas, a integração sobrevive ao volume.