Pairing code expirou
Resumo: O código de pareamento tem validade de cerca de 3 minutos. Se demorou, gere outro pelo painel — basta clicar de novo em "Gerar código de pareamento".
Quando usar isso
Você está tentando conectar um número via código de pareamento e:
- O WhatsApp do celular mostrou erro "código inválido" ou "código expirado".
- Você digitou tudo certo mas não conectou.
- O código no painel mudou enquanto você digitava.
Por que o código expira
O código de pareamento é gerado pela Meta e tem validade curta intencional (proteção de segurança — para evitar que alguém intercepte e use depois).
A validade típica é de:
- 3 minutos desde a geração no painel
- 1 tentativa válida — após digitar errado 3 vezes, o WhatsApp pode bloquear novas tentativas por alguns minutos
Como resolver
Opção 1: gerar novo código
- Na tela onde apareceu o código antigo, clique em Gerar novo código (ou cancele e tente novamente).
- Vai aparecer um novo código de 8 caracteres.
- Imediatamente vá ao celular e digite — não deixe passar 2-3 minutos.
- Se errar, gere outro.
Opção 2: usar QR Code
Se você está tendo dificuldade com o código, troque para conexão por QR Code. É mais simples — não tem digitação que possa dar erro.
Erros comuns na digitação
| Erro | Causa |
|---|---|
Digitou O em vez de 0 (zero) | Olhe atentamente — códigos não usam letra O maiúscula, só números |
Digitou I em vez de 1 | Similar — o código costuma evitar caracteres ambíguos, mas confira |
| Esqueceu de digitar o traço | O traço entre os 4 primeiros e os 4 últimos é opcional (o WhatsApp aceita com ou sem) |
| Espaço extra no início/fim | O WhatsApp do celular ignora espaços, mas confirme |
💡 Dica: Copie o código com o botão do painel (se houver) em vez de digitar manualmente. Reduz erro de digitação.
"Tentei 3 vezes e o WhatsApp bloqueou"
Após errar várias vezes seguidas, o WhatsApp do celular pode mostrar:
Muitas tentativas. Tente novamente em X minutos.
Solução:
- Aguarde 10-15 minutos sem tentar.
- Gere um código novo no gateway.
- Digite com atenção.
- Se o bloqueio persistir, mude para QR Code.
"Gerei o código mas continua em PENDING"
Se você gerou o código mas o canal não muda do status PENDING_QR para CONNECTED:
- Confirme que digitou no celular certo (o que tem o número que você quer conectar — não outro).
- Veja se o WhatsApp do celular mostrou "Aparelho conectado" após digitar. Se sim, espere mais alguns segundos — o gateway pode demorar para sincronizar.
- Se não conectou no celular, gere novo código.
"Está dando erro 425 ou 404 quando tento ver o código"
O que aparece: No painel: "Timeout aguardando pairing code" ou "Pairing code não disponível".
Causa: O worker que cria a sessão Baileys ainda não terminou o handshake inicial com o WhatsApp. Leva cerca de 6 segundos depois de você clicar em "Gerar".
Solução: Aguarde até 20 segundos. Se passar disso, recarregue a tela e tente novamente.
Dúvidas comuns
Posso usar o mesmo código várias vezes? Não. Cada código vale para uma única tentativa. Após usar (mesmo errado), é necessário gerar novo.
Quantos códigos posso gerar? Sem limite explícito, mas evite gerar dezenas seguidos — pode acionar proteção da Meta. Espere alguns segundos entre tentativas.
O código aparece em letras minúsculas no celular, é problema? Não. O WhatsApp aceita maiúsculas e minúsculas. O código gerado pelo gateway costuma vir em maiúsculas, mas pode digitar como quiser.
Após digitar, o WhatsApp mostrou "Aparelho conectado" mas o painel continua PENDING. Aguarde 30 segundos. Se não mudar, recarregue o painel. Em casos raros, há atraso de sincronização entre Baileys e a UI.