join group

content/en/docs/how-to/groups/index.md

@@ -59,6 +59,49 @@ GET /api/{session}/groups?limit=10&offset=0&sortBy=subject&sortOrder=desc
   - `desc` - descending order (New first, A-Z)
   - `asc` - ascending order (Old first, Z-A)
 
+### Join group
+If you have invite URL for a group (like `https://chat.whatsapp.com/invitecode`), you can 
+
+```bash
+POST /api/{session}/groups/join
+```
+
+**Body**
+```json
+{
+  "code": "invitecode"
+}
+```
+
+or using full link:
+```json
+{
+  "code": "https://chat.whatsapp.com/invitecode"
+}
+```
+
+**Response**:
+```json
+{
+  "id": "[email protected]"
+}
+```
+
+### Get join info for group
+If you have invite URL for a group (like `https://chat.whatsapp.com/invitecode`), you can get group info:
+
+```bash
+GET /api/{session}/groups/join-info?code=invitecode
+```
+
+or using full link (remember to encode the URL)
+
+```bash
+GET /api/{session}/groups/join-info?code=https%3A%2F%2Fchat.whatsapp.com%2Finvitecode
+```
+
+Response depends on engine you're using
+
 ### Refresh groups
 If you see any inconsistency in groups list or in participants list, you can refresh the groups from the WhatsApp server:
 ```bash

content/en/docs/overview/changelog.md

@@ -31,6 +31,9 @@ Latest Version:
 [![GitHub Release](https://img.shields.io/github/v/release/devlikeapro/waha)](https://github.com/devlikeapro/waha/releases)
 
 ## 2024.12
+`2024.12.4`
+- Add [**👥 Join Group API**]({{< relref "/docs/how-to/groups#join-group" >}}) - {{< issue 688 >}}
+
 `2024.12.3`
 - **NOWEB** - use **NOWEB** engine by default in [devlikeapro/waha-plus:noweb]({{< relref "/docs/how-to/engines#docker-images" >}}) - {{< issue 414 >}}
 - **NOWEB** - fix `rate-overlimit` error on groups API {{< issue 462 >}}