aldinokemal/go-whatsapp-web-multidevice v8.1.0

on GitHub

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:

# 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:

POST /send/message
{
  "phone": "120363123456789@g.us",
  "message": "Hello everyone!",
  "ghost_mentions": ["6281234567890", "6289876543210"]
}

Send Audio with PTT:

POST /send/audio
{
  "phone": "6281234567890",
  "audio": "<base64-encoded-audio>",
  "ptt": true
}

⚙️ Configuration

Webhook Event Whitelist:

# 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 935262c
• feat: add whitelist event in 5087c11
• feat: add PTT support for audio messages in fb2a9fa
• fix: resolve false connection state and duplicate messages (issue #509) in 6f98115
• fix: user check always returning true for invalid numbers (issue #496) in 346fb32
• fix: add request timeouts to prevent indefinite hangs in d4f9985
• feat: send webp sticker improvement in 1cd15e0
• fix: issue #512 encodeURIComponent in a5532c0
• feat: add ghost mentions feature for group messages in e8ef5a2
• feat: data leak issue #513 in b48e387
• feat: enhance avatar retrieval logic for community groups #514 in 007c033

Full Changelog: v8.0.0...v8.1.0