v8.4.0

aldinokemal/go-whatsapp-web-multidevicev8.4.0Apr 18, 2026by aldinokemal

AI Summary

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

Key Highlights

  • Exposure of Meta Ads (CTWA) referral metadata
  • GIF playback flag for video messages
  • Group-admin bots can now revoke messages sent by other participants
  • Fix for auto-reply not firing on LID-based WhatsApp accounts
  • Link preview thumbnail upload without explicit dimensions

New Features

  • CTWA/Ad campaign context on incoming messages
  • New `gif_playback` flag on `/send/video` endpoint
  • Revocation of messages by group admin bots
  • Auto-reply support for LID-based JID formats

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