v8.1.0

## What's New in v8.1.0

🚀 **Feature Release: Enhanced Messaging & Stability Improvements**

This release introduces new messaging features, important bug fixes for multi-device stability, and security improvements.

---

## ✨ New Features & Enhancements

### Ghost Mentions for Group Messages
- **Invisible Mentions**: Mention users in group messages without displaying the mention text
- **API Support**: New `ghost_mentions` parameter in the send message endpoint
- **Use Cases**: Useful for notifying users without cluttering the message with @mentions

### Chat Archive & Unarchive
- **Archive Chats**: New API endpoint to archive conversations
- **Unarchive Chats**: Restore archived chats when needed
- **MCP Support**: Available in both REST API and MCP server modes

### Push-to-Talk (PTT) Audio Messages
- **Voice Message Support**: Send audio messages as push-to-talk/voice notes
- **API Parameter**: New `ptt` option when sending audio files
- **UI Enhancement**: Toggle PTT mode in the web interface

### Whitelist Event Webhook
- **Event Filtering**: Configure which webhook events to receive
- **New Configuration**: `WHATSAPP_WEBHOOK_WHITELIST_EVENTS` environment variable
- **Reduced Noise**: Only receive the events you care about

### WebP Sticker Improvements
- **Enhanced Processing**: Improved WebP sticker handling and conversion
- **Better Compatibility**: More reliable sticker sending across devices

### Enhanced Avatar Retrieval for Community Groups
- **Community Support**: Fixed avatar retrieval for community group types (#514)
- **Improved Logic**: Better handling of group avatar requests

---

## 🐛 Bug Fixes

### Critical: Data Leak Between Devices (#513)
- **Issue**: `status@broadcast` was resolving to contact names from different devices
- **Fix**: Proper device isolation for contact resolution in multi-device setup
- **Impact**: Critical security fix for multi-device users

### False Connection State & Duplicate Messages (#509)
- **Issue**: Device showed "Connected" after mobile logout; messages duplicated between devices
- **Fix**: Proper connection state tracking and message deduplication
- **Impact**: Improved reliability for multi-device setups

### User Check Returning True for Invalid Numbers (#496)
- **Issue**: User check always returned "User is on WhatsApp" regardless of input
- **Fix**: Proper validation of phone numbers before checking
- **Impact**: Accurate user existence verification

### Device ID with Unicode Characters (#512)
- **Issue**: Could not delete devices with non-ASCII characters in Device ID
- **Fix**: Proper URL encoding for device IDs in the UI
- **Impact**: Full Unicode support for device identifiers

### Request Timeouts
- **Issue**: API requests could hang indefinitely
- **Fix**: Added request timeouts and proper error handling
- **Impact**: More responsive API with predictable timeout behavior

---

## 🔧 Technical Improvements

### Stability Enhancements
- **Request Timeouts**: Prevent indefinite hangs with configurable timeouts
- **Recovery Middleware**: Improved panic recovery in REST API
- **Error Handling**: New generic error types for better error management

### Multi-Device Reliability
- **Connection Tracking**: Better tracking of device connection states
- **Event Handling**: Improved message event processing
- **Database Isolation**: Enhanced device data separation

---

## 📚 API Changes

### New Endpoints

**Chat Archive/Unarchive:**
```bash
# Archive a chat
POST /chat/archive
{
  "phone": "6281234567890",
  "archive": true
}

# Unarchive a chat
POST /chat/archive
{
  "phone": "6281234567890",
  "archive": false
}
```

### Updated Endpoints

**Send Message with Ghost Mentions:**
```bash
POST /send/message
{
  "phone": "120363123456789@g.us",
  "message": "Hello everyone!",
  "ghost_mentions": ["6281234567890", "6289876543210"]
}
```

**Send Audio with PTT:**
```bash
POST /send/audio
{
  "phone": "6281234567890",
  "audio": "<base64-encoded-audio>",
  "ptt": true
}
```

---

## ⚙️ Configuration

**Webhook Event Whitelist:**
```bash
# Only receive message and connection events
WHATSAPP_WEBHOOK_WHITELIST_EVENTS=message,connection

# Receive all events (default)
WHATSAPP_WEBHOOK_WHITELIST_EVENTS=
```

---

## ⚠️ Important Notes

- This release includes critical security fixes for multi-device setups
- Users running v8.0.0 with multiple devices should upgrade immediately
- All fixes are backward compatible with v8.0.0

---

## What's Changed
* feat: add chat archive and unarchive functionality in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/935262c
* feat: add whitelist event in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/5087c11
* feat: add PTT support for audio messages in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/fb2a9fa
* fix: resolve false connection state and duplicate messages (issue #509) in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/6f98115
* fix: user check always returning true for invalid numbers (issue #496) in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/346fb32
* fix: add request timeouts to prevent indefinite hangs in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/d4f9985
* feat: send webp sticker improvement in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/1cd15e0
* fix: issue #512 encodeURIComponent in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/a5532c0
* feat: add ghost mentions feature for group messages in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/e8ef5a2
* feat: data leak issue #513 in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/b48e387
* feat: enhance avatar retrieval logic for community groups #514 in https://github.com/aldinokemal/go-whatsapp-web-multidevice/commit/007c033

**Full Changelog**: https://github.com/aldinokemal/go-whatsapp-web-multidevice/compare/v8.0.0...v8.1.0