v8.2.0

aldinokemal/go-whatsapp-web-multidevicev8.2.0Jan 28, 2026by aldinokemal

AI Summary

Feature release introducing Chatwoot integration for customer support workflows and expanding webhook event coverage for newsletters and groups.

Key Highlights

Full Chatwoot integration with bi-directional message sync
New webhook events for newsletters: newsletter.joined, newsletter.left, newsletter.message, newsletter.mute
Group joined webhook event (group.joined)
Documentation about WhatsApp group listing limitation

New Features

Chatwoot integration with environment variables (CHATWOOT_ENABLED, CHATWOOT_URL, CHATWOOT_API_TOKEN, etc.)
Newsletter/channel webhook events
Group joined notification webhook
Automatic contact and conversation creation in Chatwoot

Full Release Notes

## What's New in v8.2.0

🚀 **Feature Release: Chatwoot Integration & Enhanced Webhook Events**

This release introduces Chatwoot integration for customer support workflows and expands webhook event coverage for newsletters and groups.

---

## ✨ New Features

### Chatwoot Integration
- **New Integration**: Full Chatwoot customer support platform integration for WhatsApp messaging
- **Configuration**: New environment variables for Chatwoot setup:
  - `CHATWOOT_ENABLED`: Enable/disable Chatwoot integration
  - `CHATWOOT_URL`: Your Chatwoot instance URL
  - `CHATWOOT_API_TOKEN`: API token for authentication
  - `CHATWOOT_ACCOUNT_ID`: Your Chatwoot account ID
  - `CHATWOOT_INBOX_ID`: Target inbox ID for conversations
- **Features**:
  - Bi-directional message sync between WhatsApp and Chatwoot
  - Automatic contact and conversation creation
  - Support for sending files from external URLs
  - Phone number normalization for E.164 format
  - Group name caching for improved performance
- **Webhook Handler**: New REST endpoint for receiving Chatwoot webhooks

### Newsletter Webhook Events (#478)
New webhook notifications for WhatsApp newsletter/channel events:
- `newsletter.joined`: Triggered when subscribing to a newsletter/channel
- `newsletter.left`: Triggered when unsubscribing from a newsletter
- `newsletter.message`: Triggered when new messages are posted in a newsletter
- `newsletter.mute`: Triggered when newsletter mute setting changes

### Group Joined Webhook Event
- `group.joined`: Triggered when you are added to a WhatsApp group

---

## 📚 Documentation

### WhatsApp Group Listing Limitation
- Added clear documentation about WhatsApp's limitation that you must interact with a group before it appears in the group list
- Updated OpenAPI specification, README, and code comments to reflect this behavior

---

## 🔧 Technical Improvements

### Dependency Updates
- **Go**: Updated to latest version
- **go.mau.fi/whatsmeow**: Updated to latest version

---

## What's Changed
* feat: add webhook events for newsletters and group.joined by @aldinokemal
* docs: Clarify WhatsApp group listing limitation across code, OpenAPI, and README, and update Go and whatsmeow versions by @aldinokemal
* feat: chatwoot integration by @aldinokemal

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