# Upgrade Guide — v0.12.20

<!-- bump: patch -->
<!-- Valid values: patch, minor, major -->
<!-- patch = bug fixes, refactors, test additions, doc updates -->
<!-- minor = new features, new APIs, new capabilities (backwards-compatible) -->
<!-- major = breaking changes to existing APIs or behavior -->

## What Changed

The setup wizard now presents both Telegram and WhatsApp as messaging options during Phase 3 (Messaging Setup), instead of assuming Telegram-only. Telegram remains the recommended default, but WhatsApp (Baileys or Business API) is offered as a first-class alternative. Phase 4g (WhatsApp Setup) now detects whether it's the primary choice or being added as a second channel and adjusts its flow accordingly.

Wizard completeness tests updated to match the new phase naming (`Phase 3: Messaging Setup`).

## What to Tell Your User

- **Messaging choice during setup**: "You now get to choose between Telegram and WhatsApp when setting up your agent. Telegram is still recommended for its topic threads, but if you prefer WhatsApp, it's fully supported as your primary messaging platform."

## Summary of New Capabilities

| Capability | How to Use |
|-----------|-----------|
| WhatsApp as primary messaging option | Choose option 2 during setup wizard Phase 3 |
| Add second messaging channel | Available in reconfigure menu after initial setup |
