Skip to content
/docs/whatsapp-pairing

Getting started

WhatsApp pairing

By QR code or pairing code, like WhatsApp Web.

Pairing happens from the panel: open Connection and either scan the QR with WhatsApp → Settings → Linked devices → Link a device, or choose Pairing Code, enter your number and type the 8-character code into WhatsApp → Linked Devices → Link a Device → Link with phone number instead. Pairing code is the easier option when you can't scan your own screen — on the Android app it's the default.

The session is portable

The WhatsApp session lives in the data directory alongside everything else. Copying that directory to another machine and starting Levix there keeps the pairing — you don't even rescan the QR.

If the bot stops answering

WhatsApp dropped the link, usually because the phone was offline for a long time. Open the panel; if it asks for a QR, scan it again.