What's New in v8.3.2
🛠️ Patch Release: ContactsArray Webhook, Display Name Fixes & Media History Improvements
This release adds support for multi-contact webhook payloads, fixes display name resolution issues, improves media representation in chat history, and updates core dependencies.
✨ New Features
Webhook: ContactsArrayMessage Support (#594)
- New: When a user shares multiple contacts at once, the webhook now includes a
contacts_arrayfield with all shared contacts - Format: Each entry contains
displayNameandvcardfields — consistent with the existing singlecontactfield - Display Text:
BuildEventMessagenow shows a summary like👥 3 contactsfor multi-contact messages - Backward Compatible: Existing
contactfield for single contacts is unchanged; webhook consumers that don't handlecontacts_arrayare unaffected - Contributor: Thanks to @lowprofix for this contribution!
🐛 Bug Fixes
Display Name & User Info Resolution (#595, fixes #590)
- Fix: Fallback logic now uses clean phone numbers when a push name is unavailable, preventing internal device IDs from appearing as chat names
- API Enhancement: Added a
namefield to the/user/inforesponse - Data Persistence: The
Userusecase now queries local chat storage to provide push name if the live WhatsApp query returns empty values - Sync Improvement: History sync now proactively creates chat entries when push names are received, ensuring availability for future lookups
Media Representation in Chat History (#597, fixes #596)
- Documents: Now uses the actual filename (e.g.,
📄 report.pdf) in history when no caption is provided, instead of the generic📄 Documentlabel - Documents: Trims filename used for document representation fallback to avoid whitespace issues
- Images: Removed redundant
🖼️prefix from user-provided captions to keep history clean - Inbound Support: Enhanced
ExtractMessageTextFromEventto extract filename from incoming WhatsApp messages when caption is empty
🔧 Technical Improvements
Dependency Updates
- go.mau.fi/whatsmeow: Updated to latest version
- All Go dependencies kept up-to-date
New Contributors
- @lowprofix made their first contribution in #594
What's Changed
- feat: add ContactsArrayMessage support in webhook payloads by @lowprofix in #594
- fix: resolve display name issues and missing user info names (#590) by @aldinokemal in #595
- fix: improve media representation in chat history (#596) by @aldinokemal in #597
Full Changelog: v8.3.1...v8.3.2