Código de pareamento

A autenticação por código de pareamento permite vincular o Baileys ao WhatsApp usando um código de 8 dígitos em vez de um QR code. Útil em ambientes headless ou quando você quer vincular um aparelho digitando um código no celular.

O código de pareamento é um método para conectar ao WhatsApp Web sem escanear um QR code. Não é a Mobile API. Você só pode vincular um aparelho por número de telefone com este método. Veja a FAQ do WhatsApp.

Configuração

Crie o socket

Crie o socket sem renderizar QR code. Você pode simplesmente ignorar o campo qr em connection.update ao usar códigos de pareamento.

import makeWASocket from '@whiskeysockets/baileys'

const sock = makeWASocket({})

A opção legada printQRInTerminal está obsoleta e não deve ser definida.

Solicite um código de pareamento

Verifique sock.authState.creds.registered antes de pedir um código. Se o socket já estiver registrado, não precisa solicitar um novo.

if (!sock.authState.creds.registered) {
  const number = '15551234567'
  const code = await sock.requestPairingCode(number)
  console.log(`Pairing code: ${code}`)
}

O code retornado é uma string de 8 dígitos que você digita no celular.

Digite o código no celular

No celular, abra o WhatsApp e vá em Configurações → Aparelhos conectados → Conectar um aparelho. Selecione Conectar com número de telefone e digite o código de 8 dígitos.Após confirmar, o evento connection.update dispara com connection: 'open'.

Formato do número de telefone

O número que você passa para requestPairingCode deve seguir estas regras:

Inclua o código do país (ex.: 1 para EUA, 55 para Brasil)
Apenas dígitos — sem +, (, ) ou -
Sem espaços

const code = await sock.requestPairingCode('15551234567')
const code = await sock.requestPairingCode('5511999999999')

const code = await sock.requestPairingCode('+1 (555) 123-4567')
const code = await sock.requestPairingCode('555-123-4567')

Exemplo completo

O exemplo a seguir usa readline para pedir o número em tempo de execução:

import makeWASocket, { useMultiFileAuthState } from '@whiskeysockets/baileys'
import readline from 'readline'

const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
const question = (text: string) => new Promise<string>((resolve) => rl.question(text, resolve))

async function connect() {
  const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys')

  const sock = makeWASocket({
    auth: state,
  })

  sock.ev.on('connection.update', async ({ connection, qr }) => {
    if (qr && !sock.authState.creds.registered) {
      const number = await question('Enter your phone number (digits only, with country code):\n')
      const code = await sock.requestPairingCode(number)
      console.log(`Pairing code: ${code}`)
    }

    if (connection === 'open') {
      console.log('Connected to WhatsApp')
      rl.close()
    }
  })

  sock.ev.on('creds.update', saveCreds)
}

connect()

O campo qr em connection.update dispara mesmo no modo de pareamento. Use-o como gatilho para chamar requestPairingCode.

Combine com useMultiFileAuthState para que o código de pareamento só seja necessário uma vez. Veja Salvar e restaurar sessões do WhatsApp.

Comece aqui

Autenticação

Conceitos principais

Mensagens

Funcionalidades

Avançado

Migração

Comunidade

Código de pareamento

Configuração

Formato do número de telefone

Exemplo completo

​Configuração

​Formato do número de telefone

​Exemplo completo

Configuração

Formato do número de telefone

Exemplo completo