Como conectar o WhatsApp ao CRM sem quebrar o atendimento
Do cadastro da conexão ao primeiro envio de verdade, com os testes que eu não pulo mais e os pontos onde o time costuma se atrapalhar.
A gente marcou a virada para uma quarta-feira às nove da manhã, com o time inteiro na sala. Ninguém tinha testado envio real antes. Às nove e vinte a conexão estava verde, todo mundo bateu palma, e às nove e quarenta descobrimos que áudio não saía. O canal ficou capenga o dia todo. Foi assim que eu aprendi a conectar o WhatsApp ao CRM com calma, um dia antes, e não na frente de todo mundo.
Conectar é a etapa mais curta do projeto e a que mais gera confusão, porque "está conectado" tem três significados diferentes. Estado verde na tela. Mensagem saindo. Mensagem entrando. As três coisas precisam ser conferidas separadamente.
Se você ainda não escolheu o provedor, pare aqui e leia o comparativo entre Baileys e Meta Cloud API. Escolher depois de conectar dá retrabalho duas vezes.
O que existe por trás da tela de conexões
A configuração da conexão fica no cadastro de conexões do CRM, e o WhatsAppHub resolve qual conector usar por identificador de configuração. É esse hub que expõe conectar sessão, desconectar sessão, obter status, gerar QR Code e processar webhook normalizado. Quando um hub externo está configurado, ele tem prioridade, e os conectores locais continuam compatíveis.
Saber disso muda a forma de diagnosticar. Quando algo falha, a primeira pergunta não é "o WhatsApp caiu?", é "em qual camada isso parou?".
- Cadastro da conexão, que guarda a configuração daquele número.
- Conector, que fala com o provedor escolhido.
- Sessão, que é o vínculo vivo com o WhatsApp.
- Webhook, que traz de volta o que chega.
- Live chat, que é onde tudo isso aparece para o time.
Roteiro para conectar o WhatsApp ao CRM
- Separe o número certoUse um número institucional. Número pessoal de vendedor vira problema no dia em que a pessoa sai da empresa.
- Cadastre a conexãoCrie o registro da conexão com o conector escolhido e salve a configuração exigida pelo provedor.
- Autentique a sessãoPeça o QR Code e faça o pareamento, ou conclua a habilitação exigida pelo canal oficial.
- Confirme o statusConsulte o status pela própria tela. Verde na tela é a primeira confirmação, não a única.
- Envie de verdadeMande texto, imagem, documento, áudio, vídeo, localização e contato para um número seu. Todos.
- Teste a voltaResponda desse número e confira se a mensagem aparece no live chat, com mídia e tudo.
O passo cinco é o que eu pulei naquela quarta-feira. Envie cada tipo de mensagem, um por um. Leva dez minutos e evita descobrir na frente de um cliente que o áudio não sai. E anote qual formato falhou, porque quase sempre a causa está na configuração e você vai querer conferir de novo depois do ajuste. Testar sem saber o que falhou antes é rodar em círculo, e eu rodei bastante.
O webhook é metade da conexão
Mensagem saindo é só metade. O retorno chega por webhook, que é normalizado antes de virar registro de conversa. O webhook de entrada aceita verificação HMAC configurável, e ligar essa verificação é o que impede que qualquer um poste conteúdo no seu endereço fingindo ser o provedor.
Confesso que rodei meses sem essa verificação ligada, com o argumento de que "ninguém sabe o endereço". Sabem. Como assinar e como validar está em webhook assinado com HMAC.
Erros que eu já cometi nesta etapa
| Sintoma | Causa que eu já vi | Onde olhar |
|---|---|---|
| Status verde, nada sai | Configuração incompleta do conector | Cadastro da conexão |
| Texto sai, mídia não | Envio não testado por tipo | Teste manual de cada formato |
| Nada entra no live chat | Webhook não configurado ou bloqueado | Endereço de retorno e verificação |
| Cai toda noite | Sessão sem supervisão de processo | Runtime e saúde da conexão |
Antes de anunciar o número para os clientes
- Todos os tipos de mensagem foram enviados e recebidos ao menos uma vez.
- A conversa de teste apareceu corretamente no live chat.
- A verificação do webhook de entrada está ligada.
- Existe alguém que sabe reconectar sozinho, com o passo a passo escrito.
- O painel de estado da conexão foi aberto e entendido pelo time.
- Os departamentos e a fila já estão configurados para receber o que chegar.
Conectado é quando a mensagem sai, volta e aparece na tela certa. Antes disso, é só uma luz verde.
Equipe Webajato
Depois de conectar
Com o canal de pé, deixe o monitoramento pronto em saúde da conexão WhatsApp e organize quem responde o quê em fila de atendimento. Se o QR Code der trabalho no pareamento, o diagnóstico em ordem está em QR Code que não conecta. E se o volume vier de anúncio, prepare também o acompanhamento dos números antes de abrir a torneira.