Skip to content

Conectar via Código de Pareamento

Alternativa ao QR Code quando você não consegue escanear com a câmera. Em vez de imagem, o sistema gera um código de 8 letras que você digita diretamente no WhatsApp.

Quando usar

  • A câmera do celular não está funcionando
  • Você está em uma reunião e não tem o celular em mãos mas tem acesso ao WhatsApp pelo computador (WhatsApp Web ou app desktop)
  • O QR Code está expirando rápido demais

Passo a passo

  1. Acesse Conexões no menu lateral

  2. Localize a conexão Baileys que quer conectar (já precisa existir — se não existe, crie primeiro)

  3. No cartão da conexão, clique em QR Code para abrir o modal de conexão

    Dentro do modal de QR Code, há a opção de mudar para código de pareamento — ou acesse diretamente pelo botão no cartão se ele estiver disponível

  4. Se a conexão ainda não foi iniciada, o sistema inicia a sessão automaticamente

  5. O modal Conectar via Código de Pareamento abre

Modal Código de Pareamento

  1. No campo Número do WhatsApp, informe o número com código do país e DDD, sem espaços ou traços:

    • Exemplo para Brasil: 5511999998888 (55 + 11 + número)
    • O campo aceita entre 10 e 13 dígitos
  2. Clique em Gerar Código

  3. O sistema exibe um código de 8 letras (ex: ABCD-EFGH)

Código expira em 60 segundos

Insira o código no WhatsApp imediatamente após ele aparecer.

  1. No WhatsApp (celular, Web ou app desktop):

    • Vá em Configurações → Dispositivos Vinculados → Vincular um dispositivo
    • Toque em Vincular com número de telefone
    • Digite o código exatamente como exibido, sem espaços
  2. O modal exibe o progresso em 4 etapas:

    1. Código gerado
    2. Aguardando pareamento
    3. Sincronizando
    4. Conectado

Status durante o pareamento

StatusO que está acontecendo
Aguardando códigoCódigo gerado, aguardando você digitar no WhatsApp
PareandoWhatsApp reconheceu o código, sincronizando
SincronizandoQuase lá
ConectadoPronto
Falhou / TimeoutCódigo não foi inserido a tempo ou houve erro — clique em "Tentar Novamente"

Diferença em relação ao QR Code

O resultado final é idêntico: a conexão Baileys fica ativa da mesma forma. A única diferença é o método de autenticação inicial.

O cartão da conexão mostra um badge informando como ela foi autenticada: "QR Code" ou "Código".


Problemas comuns

O campo de telefone deu erro de validação

  • Certifique-se de incluir 55 (código do Brasil) + DDD de 2 dígitos + número de 8 ou 9 dígitos
  • Total: 12 ou 13 dígitos

O código sumiu antes de eu digitar

  • Clique em Tentar Novamente para gerar um novo código

Digitei o código mas o status ficou em "Falhou"

  • Verifique se digitou sem espaços e sem traço
  • O código é case-insensitive mas precisa ser exato
  • Tente gerar um novo código

O número que informei é diferente do número da conexão

  • Isso gera erro. O número informado deve ser exatamente o número do WhatsApp que você quer conectar.