github aldinokemal/go-whatsapp-web-multidevice v9.10.0

one hour ago

What's New in v9.10.0

📚 Full History on Pairing, Recoverable Media & Better Chatwoot Sync

GOWA can now request full WhatsApp history when pairing a new device and ask the paired phone to re-upload expired media. This release also adds private replies to group messages, detailed contact records, caption edits, and richer webhook payloads. Chatwoot gains its own event filter and fixes for poll noise, resolved conversations, and proxy compatibility.


✨ Features

Full History on New Pairings (#855)

  • Opt in to requesting full history when pairing a new device. You can set the requested history window and size limit.

Private Replies, Detailed Contacts & Caption Edits (#871, #969, #918)

  • Reply privately to a group message while keeping the quote linked to the original group.
  • Use GET /user/my/contacts/detailed to retrieve detailed contact records, including available contact names.
  • Edit an image or document caption by passing media_type: image or media_type: document to the message update endpoint.

Expired Media Recovery (#959, #960)

  • Ask the paired phone to re-upload expired media for downloads, forwarding that requires a re-upload, and Chatwoot history import. Recovery depends on the phone responding and still having the file.
  • During Chatwoot history import, the first unanswered recovery request stops further recovery attempts for that import.

Webhook Mentions & Quoted Authors (#888)

  • Include mentions and replied_to_sender when available, with mentions_lid and replied_to_sender_lid where applicable.

Chatwoot Event Filtering & Message Revocation (#974, #900)

  • Use CHATWOOT_EVENTS to select events forwarded to Chatwoot independently of webhook event selection.
  • Enable CHATWOOT_REVOKE_ON_DELETE=true to revoke linked outbound WhatsApp messages when an agent deletes their Chatwoot message, including messages sent as multiple attachments.

🐛 Bug Fixes

Lower Memory Use & Correct Media Extensions (#874, #898)

  • Stream received media downloads to disk to avoid buffering the entire file in memory.
  • Set default MIME types when rebuilding stored media so downloads can retain a file extension.

Read and Played Receipts From Linked Devices (#865)

  • Forward eligible read and played receipts from a contact's linked devices to webhooks.

Chatwoot History, Polls & Delivery (#822, #973, #972, #912)

  • Avoid reopening resolved conversations during history sync when there are no new messages to import.
  • Keep individual poll votes out of Chatwoot conversations while still forwarding them to webhooks.
  • Start Chatwoot forwarding before webhook delivery so retries at a webhook endpoint do not delay Chatwoot forwarding.
  • Send Chatwoot API credentials in the hyphenated api-access-token header so requests work through proxies that discard headers containing underscores. Strip the token on cross-origin redirects.

🔧 Technical Improvements

  • Update goquery to v1.14.0. (055d428)
  • Add the Contributor Covenant code of conduct and update the maintainer release-note guide. (#958, 07c20ff)

Upgrade Notes

  • Full history requests are off by default and apply to new pairings. Set WHATSAPP_FULL_HISTORY_SYNC=true before pairing and use WHATSAPP_FULL_HISTORY_DAYS and WHATSAPP_FULL_HISTORY_SIZE_MB to adjust the request.
  • When CHATWOOT_EVENTS is unset, Chatwoot follows WHATSAPP_WEBHOOK_EVENTS. Set CHATWOOT_EVENTS=message if your webhook filter excludes messages but Chatwoot should still receive them. The message event also covers related reactions, receipts, edits, and deletes.
  • Treat the new webhook mention and quoted-author fields as optional.

What's Changed

  • chore: update skill release note (07c20ff) by @aldinokemal
  • feat(message): edit image and document captions (#918) by @nasirnaqash
  • fix(media): set mime type when rebuilding stored media for download (#898) by @tupy
  • feat(chatwoot): revoke on WhatsApp what the agent deletes in Chatwoot (#900) by @felipemotter
  • docs: add Contributor Covenant code of conduct (#958) by @aldinokemal
  • feat(message): re-request expired media from the phone on download (#959) by @jotafurtado
  • feat(media): re-request expired media from the phone for forward and Chatwoot history import (#960) by @aldinokemal
  • fix(webhook): start Chatwoot forwarding before webhook delivery (#972) by @aldinokemal
  • chore(deps): update Go dependencies (055d428) by @aldinokemal
  • fix(chatwoot): stop posting a message for every poll vote (#973) by @aldinokemal
  • feat(chatwoot): add CHATWOOT_EVENTS event filter (#974) by @aldinokemal
  • fix(chatwoot): don't reopen resolved conversations on history sync (#822) by @aguinaldotupy
  • feat(user): add GET /user/my/contacts/detailed (#969) by @fra-itc
  • fix(chatwoot): use proxy-compatible API token headers (#912) by @gobeyondpty
  • fix(media): download received media straight to disk instead of memory (#874) by @ElioBonfim
  • fix(webhook): forward read and played receipts from contacts' linked devices (#865) by @thealejandro
  • feat(send): support replying privately to a group message (#871) by @thealejandro
  • feat(webhook): expose mentions and the quoted message's author (#888) by @stockarea
  • feat: opt-in full history sync on pairing (#855) by @gcampaner
  • chore(release): bump version to v9.10.0 (c24d02c) by @aldinokemal

Contributors

Full Changelog: v9.9.0...v9.10.0

Don't miss a new go-whatsapp-web-multidevice release

NewReleases is sending notifications on new releases.