Skip to content

Commit 7c45c24

Browse files
devlikeprodevlikepro
committed
6.3
1 parent 6517244 commit 7c45c24

4 files changed

Lines changed: 141 additions & 0 deletions

File tree

‎AGENTS.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,13 @@ POST /api/...
2121
}
2222
```
2323

24+
## Release Post
25+
26+
- Check existing posts under `content/blog/waha-*/` before writing a new one — match their structure and tone.
27+
- Never use backtick `code` syntax inside markdown headers (`##`, `###`) — write identifiers and API paths as plain text in headings.
28+
- For every change that has a GitHub issue in the changelog, append the issue link(s) at the end of the line in the post: `— [#1234](https://github.com/devlikeapro/waha/issues/1234)`. Multiple issues comma-separated.
29+
- Generate the cover with `./scripts/generate-waha-cover.sh` — pick a fresh gradient per release.
30+
2431
## Changelog Style Guide
2532
- Add entries under the correct version and section header. Available sections:
2633
- **🆕 New** - new features, new APIs, and new events.

‎content/blog/waha-2026-3/index.md‎

Lines changed: 118 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
---
2+
title: "WAHA 2026.3 - WPP Engine, LID Merge Control, GOWS & NOWEB Upgrades"
3+
description: "A new WPP engine, per-engine @lid/@c.us merge control, GOWS image sizes and device sync depth, NOWEB view-once messages, storage namespaces, and a new contacts endpoint."
4+
excerpt: "WAHA 2026.3 ships a new WPP engine, LID merge control for NOWEB and GOWS, image sizes, view-once messages, storage namespaces, and more."
5+
date: 2026-03-31T00:00:00+00:00
6+
draft: false
7+
images: [ "waha-2026-3.png" ]
8+
categories: [ "Releases" ]
9+
tags: [ ]
10+
contributors: [ "devlikeapro" ]
11+
pinned: false
12+
homepage: false
13+
slug: waha-2026-3
14+
---
15+
16+
## ⚡ New Engine: WPP
17+
18+
**WPP** is a new browser-based engine powered by [wppconnect](https://github.com/wppconnect-team/wppconnect). It runs WhatsApp Web in a Puppeteer browser — same approach as **WEBJS**, different underlying library. `forwardMessages` is supported from the start.
19+
20+
```bash
21+
WHATSAPP_DEFAULT_ENGINE=WPP
22+
```
23+
24+
Check the [**WPP engine docs**]({{< relref "/docs/engines/wpp" >}}) for details.
25+
- Issue: [#101](https://github.com/devlikeapro/waha/issues/101)
26+
27+
## 🔀 LID / @c.us Merge Control (**NOWEB** + **GOWS**)
28+
29+
WhatsApp uses two ID formats for the same contact: `@lid` (newer) and `@c.us` (phone-number-based). WAHA merges them by default so they appear as a single thread. That's still the default, but now you can turn it off with a `merge` flag in session config.
30+
31+
- **NOWEB** — controls merging in `/overview` and `/messages`.
32+
- Issues: [#1444](https://github.com/devlikeapro/waha/issues/1444), [#1419](https://github.com/devlikeapro/waha/issues/1419), [#1683](https://github.com/devlikeapro/waha/issues/1683), [#1432](https://github.com/devlikeapro/waha/issues/1432)
33+
- **GOWS** — same, for `/messages`, `/overview`, and `/chats`.
34+
- Issues: [#1684](https://github.com/devlikeapro/waha/issues/1684), [#1817](https://github.com/devlikeapro/waha/issues/1817), [#1910](https://github.com/devlikeapro/waha/issues/1910)
35+
36+
This also covers the underlying merge fixes — duplicate chats, missing messages, wrong `@lid`↔`@c.us` mapping that piled up since `@lid` was introduced.
37+
38+
## 📦 GOWS
39+
40+
A few additions for **GOWS** this release:
41+
42+
- Image messages now include `width` and `height`.
43+
- Issues: [#1402](https://github.com/devlikeapro/waha/issues/1402), [#901](https://github.com/devlikeapro/waha/issues/901)
44+
- `WAHA_GOWS_DEVICE_*` env variables to control how far back historical messages sync on first connect.
45+
- Issue: [#1963](https://github.com/devlikeapro/waha/issues/1963)
46+
- `sendContactVcard` now includes `displayName` in the payload.
47+
- Issue: [#1978](https://github.com/devlikeapro/waha/issues/1978)
48+
- CPU spikes in PostgreSQL storage — fixed.
49+
- Issue: [#1955](https://github.com/devlikeapro/waha/issues/1955)
50+
51+
## 👁️ NOWEB
52+
53+
**NOWEB** picks up a couple of additions in message handling:
54+
55+
- View-once messages now appear in the `message` event.
56+
- Issue: [#1972](https://github.com/devlikeapro/waha/issues/1972)
57+
- Image size (`width`/`height`) is included when sending to a newsletter.
58+
- Issue: [#1980](https://github.com/devlikeapro/waha/issues/1980)
59+
- CPU spikes from the `@lid`/`@c.us` merge path — fixed.
60+
- Issue: [#1955](https://github.com/devlikeapro/waha/issues/1955)
61+
62+
## 🗄️ Storage Namespaces
63+
64+
Two new env variables for storage path isolation:
65+
66+
- `WAHA_NAMESPACE` — top-level prefix applied to all storage in this instance.
67+
- `WAHA_SESSION_NAMESPACE` — per-session path override.
68+
69+
Useful when multiple WAHA instances share the same storage backend (S3, mounted volume, etc.) and you need their data kept separate. See [**🗄️ Storages – Namespace**]({{< relref "/docs/how-to/storages#namespace" >}}).
70+
71+
## 🔍 New API: GET /api/{session}/contacts/{id}
72+
73+
Fetch a single contact by ID without pulling the full list:
74+
75+
```http request
76+
GET /api/{session}/contacts/{id}
77+
```
78+
79+
## 🧩 Apps: No Queue Required
80+
81+
Apps are now enabled by default and can run in-memory — no Redis or other queue needed. If you have a queue configured, nothing changes on your end.
82+
83+
## 🧩 ChatWoot
84+
85+
- Message sync now targets only the `@c.us` chat when both `@lid` and `@c.us` are present — stops duplicate conversations from appearing.
86+
- Group participant is now mapped to the message, so replies in group chats correctly attribute the sender.
87+
88+
## 📊 Dashboard
89+
90+
Chat UI got some layout and rendering cleanup.
91+
92+
## 🛠️ Other Fixes
93+
94+
**WEBJS**
95+
- QR Code generation failure in some environments.
96+
- Issues: [#1923](https://github.com/devlikeapro/waha/issues/1923), [#1918](https://github.com/devlikeapro/waha/issues/1918)
97+
- Profile picture endpoint and channels list broken.
98+
- Issues: [#1707](https://github.com/devlikeapro/waha/issues/1707), [#1947](https://github.com/devlikeapro/waha/issues/1947), [#1959](https://github.com/devlikeapro/waha/issues/1959)
99+
- Apps endpoints (`GET`/`PUT`/`DELETE`) returning 403.
100+
- Issue: [#1926](https://github.com/devlikeapro/waha/issues/1926)
101+
- Stale browser processes on restart — now cleaned up, Singleton removed.
102+
103+
**NOWEB**
104+
- Out-of-order messages and timestamp-based sorting.
105+
- Issues: [#1912](https://github.com/devlikeapro/waha/issues/1912), [#1712](https://github.com/devlikeapro/waha/issues/1712)
106+
107+
**Other**
108+
- Brazilian landline number normalization.
109+
- Issue: [#1974](https://github.com/devlikeapro/waha/issues/1974)
110+
- Send media crash: `user_agents_1.default is not a constructor`.
111+
- Issue: [#1946](https://github.com/devlikeapro/waha/issues/1946)
112+
- `yarn` now supports all CPU/OS architectures.
113+
- Issue: [#1952](https://github.com/devlikeapro/waha/issues/1952)
114+
- Auth middleware no-auth case.
115+
- Issue: [#1939](https://github.com/devlikeapro/waha/issues/1939)
116+
117+
## ⚙️ Full Changelog
118+
All versions, issue links, and engine bumps are in the [**🆕 WAHA 2026.3 Changelog**]({{< relref "/docs/overview/changelog#20263" >}}).

‎content/blog/waha-2026-3/waha-2026-3.png‎

78.9 KB
Loading

‎hugo_stats.json‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -433,6 +433,8 @@
433433
"-and-more",
434434
"-and-plenty-of-fixes",
435435
"-api-and-security-fixes",
436+
"-apps-enabled-by-default--in-memory-mode",
437+
"-apps-no-queue-required",
436438
"-breaking-changes",
437439
"-breaking-changes-1",
438440
"-bulk-read-support",
@@ -444,6 +446,7 @@
444446
"-channels",
445447
"-channels-and-media-fixes-noweb--gows",
446448
"-chats",
449+
"-chatwoot",
447450
"-chatwoot--contacts-sync",
448451
"-chatwoot--messages-sync",
449452
"-chatwoot-11",
@@ -452,6 +455,7 @@
452455
"-chatwoot-improvements",
453456
"-contacts",
454457
"-custom-device-name",
458+
"-dashboard",
455459
"-dashboard-i18n",
456460
"-engine-updates",
457461
"-engine-updates--full-list",
@@ -460,9 +464,13 @@
460464
"-faq",
461465
"-filter-by-ack",
462466
"-final-word",
467+
"-fixes",
468+
"-fixes---gows",
463469
"-fixes--stability",
464470
"-fixes-and-updates",
465471
"-full-changelog",
472+
"-gows",
473+
"-gows-improvements",
466474
"-gows-storage-toggle",
467475
"-group-receipts-tracking",
468476
"-groups",
@@ -473,6 +481,7 @@
473481
"-key-fixes",
474482
"-labels",
475483
"-labels-gows",
484+
"-lid--cus-merge-control-noweb--gows",
476485
"-lid-to-cus-api",
477486
"-lighter-engines",
478487
"-mark-messages-as-read",
@@ -481,7 +490,12 @@
481490
"-message-edit-event",
482491
"-messages",
483492
"-new---swagger-white-label",
493+
"-new-api-get-apisessioncontactsid",
494+
"-new-engine-wpp",
495+
"-notable-fixes",
496+
"-noweb",
484497
"-noweb-70-rc",
498+
"-noweb-view-once-messages--newsletter-images",
485499
"-observability",
486500
"-other-fixes",
487501
"-other-fixes--read-more",
@@ -503,6 +517,7 @@
503517
"-sessions---ignore-chats",
504518
"-stability-improvements",
505519
"-status",
520+
"-storage-namespaces",
506521
"-storages",
507522
"-update-contact-on-phone",
508523
"-update-group-picture-api",
@@ -754,6 +769,7 @@
754769
"global-proxy-configuration",
755770
"global-webhooks",
756771
"gows",
772+
"gows----fixes",
757773
"gows---pprof",
758774
"gows-10",
759775
"gows-engine",

0 commit comments

Comments
 (0)