aldinokemal/go-whatsapp-web-multidevice v7.5.1

on GitHub

What's New in v7.5.1

📥 On-Demand Media Download

• Download Media API: New GET /message/:id/download endpoint for downloading media files
  • Organized Storage: Media files stored with chat/date organization for better management
  • All Media Types: Support for images, videos, audio files, documents, and stickers
  • Automatic File Handling: Smart filename generation and duplicate handling
  • Storage Optimization: Efficient storage structure preventing file conflicts

📱 Enhanced Chat Messages UI

• Auto-Download Functionality: Media content automatically downloads and displays in chat interface
  • Real Content Display: Shows actual media instead of "Media Available" labels
  • Loading States: Visual feedback during media downloads
  • Error Handling: Graceful error handling with retry functionality
  • Batch Processing: Intelligent concurrency control (max 3 concurrent downloads)
  • Performance Optimized: Efficient media loading without blocking UI

📦 Updated Dependencies & Security

• Latest MCP Support: Updated mcp-go to v0.39.1 for improved Model Context Protocol integration
  • Better AI Integration: Enhanced compatibility with AI tools and agents
  • Improved Stability: More reliable MCP server operations
  • Updated Protocol Features: Latest MCP specification support
• Enhanced CLI Framework: Updated cobra to v1.10.1 for better command-line experience
• WhatsApp Protocol Updates: Latest whatsmeow library (v0.0.0-20250905121447-8d6da61ecbfa)
  • Connection Stability: Improved WhatsApp Web connection reliability
  • Protocol Compatibility: Latest WhatsApp Web protocol support
  • Bug Fixes: Resolved edge cases in message handling
• Testing Framework: Updated testify to v1.11.1 for better testing capabilities
• Additional Dependencies: Updated protobuf, pflag, and added new indirect dependencies

🔧 Technical Improvements

• Context-Aware Group Creation: Updated group creation methods with proper context handling
• API Method Adjustments: Improved method signatures for better error handling
• Code Organization: Better separation of concerns in media handling logic

🎯 What This Means for You

For End Users

• Better Media Experience: Download and view media files directly from the web interface
• Improved Performance: Faster media loading with smart caching and organization
• Enhanced UI: More intuitive chat interface showing actual media content
• Reliable Downloads: Robust error handling ensures media downloads complete successfully

For Developers & Integrators

• New API Capability: Programmatically download media files from WhatsApp messages
• Better File Management: Organized storage structure makes media files easy to locate
• Enhanced Testing: Improved testing framework for more reliable development
• Latest Dependencies: Updated libraries provide better security and performance

For AI & Automation Users

• Improved MCP Integration: Better support for AI tools using Model Context Protocol
• Enhanced Reliability: More stable AI agent interactions
• Updated Protocol Support: Latest MCP features for advanced AI integrations

For System Administrators

• Better Resource Management: Improved concurrency control prevents system overload
• Enhanced Monitoring: Better error reporting and logging for media operations
• Storage Optimization: Organized file storage prevents disk space issues
• Updated Security: Latest dependency versions include security patches

🛠️ New API Endpoint

Media Download

# Download media from a specific message
GET /message/{message_id}/download?phone={phone_number}

# Response
{
  "code": 200,
  "message": "Success",
  "results": {
    "message_id": "BAE5158B7D2F4F2E",
    "status": "downloaded",
    "media_type": "image",
    "filename": "image_2025-09-06_15-30-45.jpg",
    "file_path": "/app/storages/media/120363402106XXXXX@g.us/2025/09/06/image_2025-09-06_15-30-45.jpg",
    "file_size": 245760
  }
}

Usage Examples

// Download media via API
const response = await fetch(`/message/${messageId}/download?phone=${phoneNumber}`, {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
if (data.code === 200) {
  console.log('Media downloaded:', data.results.file_path);
}

📁 Media Storage Organization

Media files are now organized in a structured directory format:

storages/media/
├── {chat_id}/
│   ├── 2025/
│   │   ├── 09/
│   │   │   ├── 06/
│   │   │   │   ├── image_2025-09-06_15-30-45.jpg
│   │   │   │   ├── document_2025-09-06_15-45-12.pdf
│   │   │   │   └── video_2025-09-06_16-00-33.mp4

This organization provides:

• Easy Navigation: Find media by chat and date
• Storage Efficiency: Prevents filename conflicts
• Backup Simplicity: Easy to backup specific chats or date ranges
• Maintenance: Simple cleanup and management

📱 Enhanced UI Features

Auto-Download in Chat Messages

• Instant Media Loading: Media automatically downloads when viewing chat messages
• Progress Indicators: Visual feedback during download process
• Error Recovery: Automatic retry on failed downloads
• Concurrent Control: Smart batching prevents system overload
• Cache Management: Downloaded media is cached for faster subsequent access

User Experience Improvements

• Real Media Preview: See actual images, documents, and videos instead of placeholders
• Loading States: Clear indicators when media is being processed
• Error Messages: Helpful error messages with actionable guidance
• Responsive Design: Media displays properly across different screen sizes

Important Notes

✅ No Breaking Changes

• All existing APIs continue to work unchanged
• Backward compatible with previous versions
• No configuration changes required
• Existing media files remain accessible

✅ Enhanced Security

• Updated dependencies include latest security patches
• Media download requires proper authentication
• File access controls prevent unauthorized downloads
• Safe filename handling prevents directory traversal

🔧 Recommended Actions

• Update containers to benefit from improved media handling
• Try the new media download functionality in your chat interface
• Consider implementing the new download API in your integrations
• Update any automation that works with media files

💡 Performance Considerations

Media Download Optimization

• Concurrent Limits: Maximum 3 concurrent downloads prevent system overload
• Smart Caching: Downloaded media is cached to prevent duplicate downloads
• Storage Efficiency: Organized file structure improves access times
• Memory Management: Efficient handling of large media files

System Requirements

• Disk Space: Consider storage needs for media files
• Network Bandwidth: Media downloads may increase network usage
• CPU Usage: Media processing may temporarily increase CPU usage

Summary

Version 7.5.1 introduces powerful media download capabilities that significantly enhance the user experience when working with WhatsApp media files. The new on-demand download API, combined with the auto-download UI functionality, makes accessing and managing media content much more intuitive and efficient.

The comprehensive dependency updates, particularly the MCP and WhatsApp protocol libraries, ensure better compatibility with AI tools and more reliable WhatsApp Web connections. The organized media storage system provides a clean, maintainable structure for all downloaded files.

Whether you're using the web interface, building API integrations, or implementing AI-powered WhatsApp automation, this release provides the tools and reliability you need to work effectively with media content. The enhanced error handling, loading states, and concurrent processing controls ensure a smooth experience even when dealing with large volumes of media files.

What's Changed

• feat: add on-demand media download API and auto-download UI by @aldinokemal in #398

Full Changelog: v7.5.0...v7.5.1