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/detailedto retrieve detailed contact records, including available contact names. - Edit an image or document caption by passing
media_type: imageormedia_type: documentto 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
mentionsandreplied_to_senderwhen available, withmentions_lidandreplied_to_sender_lidwhere applicable.
Chatwoot Event Filtering & Message Revocation (#974, #900)
- Use
CHATWOOT_EVENTSto select events forwarded to Chatwoot independently of webhook event selection. - Enable
CHATWOOT_REVOKE_ON_DELETE=trueto 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-tokenheader so requests work through proxies that discard headers containing underscores. Strip the token on cross-origin redirects.
🔧 Technical Improvements
- Update
goquerytov1.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=truebefore pairing and useWHATSAPP_FULL_HISTORY_DAYSandWHATSAPP_FULL_HISTORY_SIZE_MBto adjust the request. - When
CHATWOOT_EVENTSis unset, Chatwoot followsWHATSAPP_WEBHOOK_EVENTS. SetCHATWOOT_EVENTS=messageif your webhook filter excludes messages but Chatwoot should still receive them. Themessageevent 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
- @aguinaldotupy
- @aldinokemal
- @ElioBonfim
- @felipemotter
- @fra-itc — first contribution in #969
- @gcampaner — first contribution in #855
- @gobeyondpty
- @jotafurtado — first contribution in #959
- @Kizuno18
- @nasirnaqash
- @stockarea — first contribution in #888
- @thealejandro
- @tupy — first contribution in #898
Full Changelog: v9.9.0...v9.10.0