v8.4.0

supertone-oss-archive/supertonicv8.4.0Apr 18, 2026by aldinokemal

AI Summary

This minor release introduces Meta Ads referral context for CTWA, GIF playback support for video messages, and enhanced group-admin bot message revocation capabilities. It also addresses several bug fixes regarding LID auto-reply and link preview handling.

Key Highlights

Added Click-to-WhatsApp (CTWA) referral metadata to incoming messages for campaign attribution.
New 'gif_playback' flag on the /send/video endpoint allows videos to be rendered as animated GIFs.
Group-admin bots can now revoke messages sent by other participants, not just their own.
Fixed auto-reply functionality for LID-based WhatsApp accounts.
Enhanced link preview thumbnail upload to support cases without explicit width/height.

New Features

Meta Ads Referral / CTWA Context
GIF Playback on /send/video
Group-Admin Bot Revocation

Full Release Notes

## What's New in v8.4.0

🚀 **Minor Release: Meta Ads (CTWA) Referrals, GIF Video Playback & Group Admin Moderation**

This release adds Click-to-WhatsApp Ads referral context, GIF playback flag for video messages, group-admin bot message revocation, and fixes LID auto-reply and link preview thumbnail handling.

---

## ✨ New Features

### Meta Ads Referral / CTWA Context
- Expose Click-to-WhatsApp (CTWA) / Meta Ads referral metadata on incoming messages so bots can attribute conversations to specific ad campaigns

### GIF Playback on `/send/video` (#611)
- New `gif_playback` flag on the send-video endpoint marks the video as animated (WhatsApp renders it like a GIF)
- OpenAPI spec and frontend UI updated to expose the option

### Group-Admin Bot Revocation (#640)
- When the bot account is a group admin, it can now revoke messages sent by other participants — not just its own

---

## 🐛 Bug Fixes

### Auto-Reply on LID Accounts (#634)
- Fix auto-reply not firing for accounts using the new LID-based JID format

### Link Preview Thumbnail (#627)
- Allow link preview thumbnail upload when explicit width/height dimensions are not provided

---

## 🔧 Technical Improvements

### Dependency Updates
- `go.mau.fi/whatsmeow`: updated to latest (multiple passes)
- All Go dependencies kept up-to-date

### Docs
- Replace `AGENTS.md` with `CLAUDE.md` as the canonical agent guide

---

## What's Changed

- feat: Add GifPlayback support to /send/video endpoint by @bysiber in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/611
- feat: allow group-admin bots to revoke other members' messages by @aldinokemal in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/640
- feat: add Meta Ads referral (CTWA) support and replace AGENTS.md with CLAUDE.md by @aldinokemal
- fix: allow link preview thumbnail upload without explicit dimensions by @aldinokemal
- fix: auto-reply not working for LID-based WhatsApp accounts by @aldinokemal
- chore: update whatsmeow and dependencies to latest by @aldinokemal

## New Contributors

- @bysiber made their first contribution in https://github.com/aldinokemal/go-whatsapp-web-multidevice/pull/611

**Full Changelog**: https://github.com/aldinokemal/go-whatsapp-web-multidevice/compare/v8.3.5...v8.4.0