# Upgrade Guide — v0.12.21

<!-- bump: patch -->

## What Changed

WhatsApp Baileys pairing is now fully automated during setup wizard. Instead of telling users to "check the server logs for a pairing code" and run `tmux attach`, the wizard now:

1. Starts the server automatically
2. Opens a browser with the dashboard QR code (or WhatsApp Web as fallback)
3. Walks the user through scanning the QR with their phone
4. Polls the connection status and confirms when paired
5. Falls back to pairing code method if QR fails
6. Falls back to manual relay of pairing code if no browser tools available

The wizard also sends a WhatsApp greeting message after pairing (mirroring the Telegram Lifeline greeting), and does NOT declare "All done" until WhatsApp is actually connected.

## What to Tell Your User

- **WhatsApp setup is now hands-free**: "Setting up WhatsApp is now just as smooth as Telegram — the wizard handles everything automatically. You just scan a QR code when prompted."

## Summary of New Capabilities

| Capability | How to Use |
|-----------|-----------|
| Browser-automated WhatsApp QR pairing | Automatic during setup wizard when Baileys is selected |
| WhatsApp greeting on setup completion | Automatic — agent introduces itself via WhatsApp |
| QR → pairing code fallback | Automatic if QR scanning fails after 2 minutes |
