WACrew

Guia

QR code de pareamento do WhatsApp: como conectar um aparelho

O QR code de pareamento conecta um aparelho novo (WhatsApp Web, Desktop ou uma automação) à sua conta. Como funciona, por que ele troca a cada poucos segundos e a alternativa por código.

Atualizado em 2 min de leitura
Nesta página
  1. Como aparece na prática
  2. A alternativa: código de pareamento
  3. Erro comum
  4. Perguntas frequentes

O QR code de pareamento é o código que um aparelho novo mostra para ser conectado à sua conta do WhatsApp. Você lê com o celular em Configurações › Aparelhos conectados › Conectar um aparelho, e o aparelho passa a funcionar como um dos seus aparelhos conectados.

Como aparece na prática

No WhatsApp Web o QR aparece na tela. Numa automação (Baileys, whatsmeow, as APIs não oficiais), o QR é gerado pelo servidor e mostrado num painel ou no terminal. No WACrew ele fica em /config: você lê uma vez, a sessão é salva e reconecta sozinha depois.

O QR troca a cada poucos segundos. É de propósito: ele carrega uma chave temporária, e um código velho não serve.

A alternativa: código de pareamento

Em vez do QR, dá para conectar com um código de 8 caracteres: no celular, escolha Conectar com número de telefone e digite o código que o aparelho mostrar. É útil quando o servidor está longe e você não consegue apontar a câmera para a tela.

Erro comum

Gerar QR atrás de QR sem ler, ou pedir código de pareamento por cima de uma sessão que já funciona. Isso pode derrubar a sessão existente e prender o servidor num ciclo de reconexão. Pareie uma vez; se a sessão cair, descubra o motivo antes de parear de novo.

Outro erro é deixar a pasta da sessão sem volume persistente num servidor em nuvem: cada deploy apaga a sessão e pede QR de novo. Veja hospedar bot de WhatsApp 24 horas.

Perguntas frequentes

O QR dá acesso ao meu celular? Dá acesso às conversas da conta, como o WhatsApp Web. Só leia QR de sistema seu ou de confiança.

Por que o QR não lê? Normalmente expirou. Espere o próximo e leia de novo.

Em inglês: pairing QR code.