QR Code do WhatsApp não conecta: minha ordem de checagem
Uma ordem de diagnóstico que vai do mais simples ao mais raro, para parar de tentar a sorte lendo o mesmo código dez vezes seguidas.
Uma vez fiquei quarenta minutos apontando o celular para a tela, com dois colegas em volta dando palpite, tentando ler um QR Code do WhatsApp que simplesmente não aceitava. Trocamos de celular. Trocamos de navegador. Limpamos cache. No fim, o código estava expirado desde o primeiro minuto e a tela não tinha atualizado. Quarenta minutos.
Depois daquele dia eu escrevi uma ordem de checagem e nunca mais improvisei. O problema de diagnosticar sem ordem é que você resolve por acidente e não aprende nada. Na vez seguinte, começa tudo de novo.
A geração do código faz parte do contrato comum dos conectores, junto com conectar, desconectar e obter status. Isso ajuda, porque o caminho de checagem é o mesmo independente do provedor. Se você ainda está montando a conexão, comece por como conectar o WhatsApp ao CRM.
Antes de tudo, o óbvio
Vou parecer bobo, mas oitenta por cento dos casos que eu atendi morriam aqui. Faça essas cinco conferências antes de chamar alguém técnico.
- O código está fresco? Peça um novo antes de tentar de novo.
- O celular tem internet de verdade, e não só barra de sinal?
- O aplicativo está na tela de aparelhos conectados, e não na tela de conversas?
- A tela está com brilho suficiente e sem zoom estranho?
- O número que você está pareando é o número que você acha que é?
Esse último item parece piada. Não é. Já vi um pareamento inteiro feito com o celular pessoal de alguém que estava por perto, e a descoberta veio dois dias depois, quando as conversas da empresa apareceram no aparelho errado. O rapaz nem percebeu o que tinha acontecido. Ele só achou estranho começar a receber mensagem de cliente no domingo à noite. Desde então eu falo em voz alta o número que vamos parear e alguém confirma antes de qualquer clique. Parece exagero até o dia em que evita esse tipo de confusão.
A ordem de checagem quando o QR Code do WhatsApp insiste
- Regenere o códigoPeça um novo QR Code e leia imediatamente. Código antigo na tela é a causa número um.
- Consulte o statusVeja o que a consulta de status responde. Ela diz se a sessão nem começou ou se travou no meio.
- Desconecte antesSe existe uma sessão pendurada, desconecte de forma explícita e só depois tente parear de novo.
- Confira o runtimeSe o conector fala com um runtime próprio, confirme que ele está no ar antes de culpar o celular.
- Cheque a rede do servidorO código nasce no servidor. Se ele não alcança o provedor, a tela mostra código, mas o pareamento nunca fecha.
- Refaça em outro aparelhoSó agora troque de celular. Fazer isso primeiro é o que faz você perder quarenta minutos.
Sintoma por sintoma
| O que acontece | Causa provável | Primeiro movimento |
|---|---|---|
| Código aparece e some rápido | Expiração normal do código | Regenerar e ler na hora |
| Código não aparece | Runtime ou conector fora do ar | Conferir o serviço antes do celular |
| Lê e volta para o começo | Sessão anterior ainda pendurada | Desconectar e refazer |
| Conecta e cai em minutos | Sessão sem supervisão ou rede instável | Verificar saúde da conexão |
| Conecta no número errado | Aparelho errado no pareamento | Desconectar e refazer com o celular certo |
Quando o problema não é o pareamento
Tem um caso que engana muito: a sessão conecta, o status responde certinho, e mesmo assim ninguém recebe mensagem no sistema. Isso não é problema de pareamento, é problema de retorno. O caminho de volta passa pelo webhook, e o diagnóstico é outro.
Aprendi a separar as duas coisas depois de gastar uma tarde inteira reconectando uma sessão que estava perfeitamente conectada. A parte de assinatura e entrega está detalhada em webhook assinado com HMAC.
Depois que voltar, feche o ciclo
- Anote o que resolveu, mesmo que pareça bobo demais para anotar.
- Confirme envio e recebimento reais, e não só o status verde.
- Verifique se alguma conversa ficou parada durante a queda.
- Avise o time que o canal voltou, com horário, para conferirem pendências.
- Se caiu mais de uma vez no mês, trate como problema de supervisão, não de sorte.
Diagnóstico sem ordem resolve por acidente. Na próxima vez, você começa do zero de novo.
Equipe Webajato
Para não passar por isso de novo
A melhor forma de não repetir a cena é enxergar o estado antes de o cliente reclamar. Deixe o painel pronto seguindo saúde da conexão WhatsApp e, se a queda for recorrente, considere tirar a sessão de dentro do sistema principal, como descrito em hub independente de WhatsApp. Vale conferir também se a fila absorveu o acúmulo, com o que está em relatórios e indicadores.