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

on GitHub

What's New in v7.10.1

✨ New Features & Enhancements

• Push-To-Video (PTV) Message Support: Added full support for WhatsApp video notes
  • Video Notes Handling: Automatically processes and handles PTV (Push-To-Video) messages
  • Webhook Integration: PTV messages are now properly forwarded to configured webhooks
  • Media Extraction: Enhanced media extraction to generate filenames and extract details for video notes
  • Auto-Download Support: Respects WHATSAPP_AUTO_DOWNLOAD_MEDIA configuration for PTV messages
  • Complete Metadata: Extracts URL, media keys, and file information for video notes

🔧 Maintenance & Updates

• Dependency Updates: Updated Go module dependencies to latest stable versions
  • Improved security and performance
  • Better compatibility with WhatsApp protocol changes
  • Enhanced stability and reliability

🎯 What This Means for You

For Video Note Users

• Seamless Support: Video notes (PTV messages) are now fully supported
• Webhook Delivery: Video notes are delivered to webhooks with complete metadata
• Automatic Downloads: Video notes can be automatically downloaded based on your configuration
• API Compatibility: Video notes appear in message events with proper media information

For Webhook Users

• Enhanced Payload: Webhook payloads now include PTV message data
• Media Information: Access to video note URLs, media keys, and metadata
• Consistent Format: PTV messages follow the same webhook format as other media types

For All Users

• Better Stability: Updated dependencies improve overall system reliability
• Protocol Compatibility: Enhanced compatibility with latest WhatsApp features
• Future-Proof: Foundation for upcoming WhatsApp message types

Important Notes

✅ PTV (Push-To-Video) Messages

• What are PTV Messages: Video notes sent in WhatsApp (circular video messages)
• Automatic Processing: No configuration changes needed - works out of the box
• Media Download: Controlled by existing `WHATSAPP_AUTO_DOWNLOAD_MEDIA` setting
• Webhook Format: PTV data appears in webhook payload similar to video messages
• API Access: Available through standard message retrieval endpoints

✅ Configuration

• Auto-Download PTV: Set `WHATSAPP_AUTO_DOWNLOAD_MEDIA=true` to download video notes automatically
• Webhook Support: Video notes are included in webhook events when `WHATSAPP_WEBHOOK` is configured
• Backward Compatible: All existing configurations continue to work

✅ Breaking Changes

• None - all changes are backward compatible
• Existing deployments continue to work without configuration changes
• Default behavior unchanged

🔧 Recommended Actions

• Update to v7.10.1 to receive video note support
• No configuration changes required
• Verify webhook handlers can process the new PTV message type
• Check media storage if auto-download is enabled

Configuration Examples

Enable Auto-Download for Video Notes (Environment Variables):
```bash
WHATSAPP_AUTO_DOWNLOAD_MEDIA=true
PATH_MEDIA=./statics/media
```

Webhook with Video Note Support:
```bash
WHATSAPP_WEBHOOK=https://your-webhook.com/handler
WHATSAPP_WEBHOOK_SECRET=super-secret-key
```

Docker Compose:
```yaml
environment:

• WHATSAPP_AUTO_DOWNLOAD_MEDIA=true
• WHATSAPP_WEBHOOK=https://your-webhook.com/handler
• PATH_MEDIA=/app/statics/media
  ```

Webhook Payload Example for PTV Messages

When a video note is received, the webhook payload includes:
```json
{
"message_id": "...",
"from": "1234567890@s.whatsapp.net",
"ptv": {
"url": "https://...",
"filename": "ptv-message-12345.mp4",
"media_key": "...",
"file_sha256": "...",
"file_length": 12345
},
"timestamp": "2025-12-04T00:00:00Z"
}
```

Summary

Version 7.10.1 introduces support for WhatsApp's Push-To-Video (PTV) messages, commonly known as video notes. This enhancement ensures that video notes are properly handled, forwarded to webhooks, and can be automatically downloaded based on configuration settings. The release also includes dependency updates for improved stability and protocol compatibility. All changes are backward compatible, requiring no configuration updates for existing deployments.

What's Changed

• feat: add support for Push-To-Video (PTV) messages in 045d34f
• chore: update dependencies and bump app version to v7.10.1 in cac76e0

Full Changelog: v7.10.0...v7.10.1