2026.8.2

t8y2/dbx2026.8.2Sep 1, 2026by devlikepro

AI Summary

This release introduces APIs for sending stickers, managing group membership approvals, and OpenTelemetry tracing. It also adds Prometheus metrics and updates for the Brazilian Phone Numbers app.

Key Highlights

  • New API endpoint for sending WebP stickers
  • Granular download control for media and events
  • Group security features: membership approval and join request APIs
  • OpenTelemetry integration (trace_id/span_id in logs)
  • Prometheus metrics endpoint

New Features

  • POST /api/sendSticker endpoint
  • Granular media download control
  • Group settings for membership approval
  • Join requests API
  • OpenTelemetry trace context support
  • Prometheus metrics
  • Brazilian Phone Numbers app update
  • Purge API for apps

Full Release Notes

**Full Changelog**: https://github.com/devlikeapro/waha/compare/2026.8.1...2026.8.2


🆕 **New**

-   `2026.8.2` - API - `POST /api/sendSticker` - send stickers (WebP) - [**📤 Send messages**](https://waha.devlike.pro/docs/how-to/send-messages/#send-sticker) - [#1287](https://github.com/devlikeapro/waha/issues/1287), [#2240](https://github.com/devlikeapro/waha/pull/2240)
-   `2026.8.2` - Media - granular download control for events and API - [**⚙️ Configuration**](https://waha.devlike.pro/docs/how-to/config/#media-download) - [#2211](https://github.com/devlikeapro/waha/pull/2211)
-   `2026.8.2` - Groups - approve new members setting - `GET/PUT /api/{session}/groups/{id}/settings/security/membership-approval` - [**👥 Groups**](https://waha.devlike.pro/docs/how-to/groups/#security---approve-new-members) - [#2200](https://github.com/devlikeapro/waha/pull/2200)
-   `2026.8.2` - Groups - join requests API - `GET /api/{session}/groups/{id}/participants/join-requests` + `/approve` and `/reject` - [**👥 Groups**](https://waha.devlike.pro/docs/how-to/groups/#join-requests)
-   `2026.8.2` - Groups - `group.v2.participants.join-request` event - a request to join a group is created, rejected or revoked - [**👥 Groups**](https://waha.devlike.pro/docs/how-to/groups/#groupv2participantsjoin-request)
-   `2026.8.2` - OpenTelemetry trace context - `trace_id`/`span_id` in logs, `traceparent` response header, no export by default - [**🔍 Observability**](https://waha.devlike.pro/docs/how-to/observability/#tracing)
-   `2026.8.2` - Prometheus metrics - `GET /metrics` (optional) - [**🔍 Observability**](https://waha.devlike.pro/docs/how-to/observability/#prometheus-metrics) - [#2245](https://github.com/devlikeapro/waha/pull/2245)
-   `2026.8.2` - Docs - how to extend WAHA with apps, modules and session plugins - [**🛠️ Development**](https://waha.devlike.pro/docs/how-to/development/#extending-waha)

🧩 **Apps**

-   `2026.8.2` - [**Brazilian Phone Numbers**](https://waha.devlike.pro/docs/apps/brazilian-phone-numbers/) - resolves the 9th digit for Brazilian numbers - [#2180](https://github.com/devlikeapro/waha/pull/2180)
-   `2026.8.2` - Purge API - `POST /api/apps/{id}/purge` - delete the app’s stored data, keep the app configured - [**🧩 Apps**](https://waha.devlike.pro/docs/apps/about/#purge-app-storage)
-   `2026.8.2` - Logout purge - `POST /api/sessions/{session}/logout` accepts `{"apps": {"purge": true}}` to purge apps’ storage on logout
-   `2026.8.2` - Unique apps - one instance per session for **ChatWoot**, **Reject Calls** and **Brazilian Phone Numbers**

🧩 **ChatWoot**

-   `2026.8.2` - match existing contacts by resolved phone number for `@lid` chats and backfill missing `phone_number` - [#2208](https://github.com/devlikeapro/waha/issues/2208)
-   `2026.8.2` - name LID contacts by push name instead of raw `@lid` id - [#1493](https://github.com/devlikeapro/waha/pull/1493)

🛠️ **Fixes**

-   `2026.8.2` - **WEBJS**, **NOWEB** - Channels - `reply_to` was silently ignored when sending messages to channels - [#2233](https://github.com/devlikeapro/waha/issues/2233)
-   `2026.8.2` - **WEBJS** - Channels - deleting a message in a channel failed - [#2236](https://github.com/devlikeapro/waha/issues/2236)
-   `2026.8.2` - **WEBJS** - first incoming message triggered events 2-3 times - [#2235](https://github.com/devlikeapro/waha/issues/2235)
-   `2026.8.2` - **GOWS** - `fromMe` messages mirrored to the wrong contact/conversation - [#2241](https://github.com/devlikeapro/waha/issues/2241)
-   `2026.8.2` - **GOWS** - unable to retrieve WhatsApp groups - [#2234](https://github.com/devlikeapro/waha/issues/2234)
-   `2026.8.2` - **GOWS** - group messages carrying a new sender key in `@lid` groups were silently lost - [#2242](https://github.com/devlikeapro/waha/issues/2242)
-   `2026.8.2` - **GOWS** - undecryptable messages are logged at `error` level instead of being silently dropped
-   `2026.8.2` - Media - keep the original `.zip` for Lottie stickers when converting to an image fails - #2239
-   `2026.8.2` - Media - `downloadMedia=true` downloads media even when disabled by env vars - [#2211](https://github.com/devlikeapro/waha/issues/2211)
-   `2026.8.2` - Media - `media` attrs (`mimetype`, `filename`) always set; `url: null` when not downloaded
-   `2026.8.2` - honor `HTTP_PROXY`/`HTTPS_PROXY`/`NO_PROXY` env vars when downloading media - [#2224](https://github.com/devlikeapro/waha/pull/2224)

📊 **Dashboard**

-   `2026.8.2` - up dashboard

⚙️ **Updates**

-   `2026.8.2` - **WPP** - up engine
-   `2026.8.2` - up `axios` to `1.19.0`