9.6

Author: devlikepro

content/docs/apps/about/-config.md

@@ -8,6 +8,7 @@ To use
 **Apps**:
 
 - `WAHA_APPS_ENABLED=True` - Enables the [**🧩 Apps**]({{< relref "/docs/apps/about" >}}) functionality
+- `WAHA_PUBLIC_URL=https://w.example.com` — the publicly available link to the dashboard (use this if `WAHA_BASE_URL` is set to an internal address for Docker).
 - `REDIS_URL=redis://:redis@redis:6379` - Specifies the Redis URL required for processing background jobs
 - `WHATSAPP_DEFAULT_ENGINE=GOWS` - Sets the recommended engine for reliable **WhatsApp** automation
 - `WAHA_API_KEY_PLAIN=0000000000000000` - plain password **required** for Apps in environment variables
@@ -16,6 +17,8 @@ To use
 **ChatWoot App**:
 
 - `WAHA_APPS_CHATWOOT_LANGUAGES_FOLDER=/app/.languages` - folder for additional languages (if language exists it'll override templates in the original templates)
+- `RACK_TIMEOUT_SERVICE_TIMEOUT=60` — increases the default Rack timeout to 60s (default is 15s).
+
 
 **Jobs**: 
 

content/docs/apps/chatwoot/index.md

@@ -34,6 +34,48 @@ We cover all installation and configuration aspects in the following series of a
 
 {{< include file="content/docs/apps/about/-config.md" >}}
 
+## Conversations
+You can map **WhatsApp** chats to **Chatwoot** conversations in two ways.
+Your **Chatwoot** and **WAHA** settings **must be kept in sync**.
+
+### Single Conversation
+**One conversation** per WhatsApp chat (WhatsApp-like **behavior**). Each message goes
+to a **single** conversation. Every contact in **Chatwoot** has only **one** open (or
+resolved) conversation, and incoming WhatsApp messages are added to that
+conversation (and **reopen** it if it’s closed).
+
+Set in **Chatwoot**:
+- **Inbox** - **Lock to single conversation** - **Enabled**
+
+![](screenshots/single-chatwoot.png)
+
+Set in **WAHA**:
+- **Select conversation behavior** - **Created: Newest**
+- **Use Conversation with Status** - **Use Any Status**
+
+![](screenshots/single-waha.png)
+
+### Multiple Conversations
+**Multiple conversations** per WhatsApp chat (Chatwoot’s **philosophy**).
+
+A conversation remains active until an agent **resolves** it. After resolution,
+a new incoming **message creates a new conversation**.
+
+Set in **Chatwoot**:
+- **Inbox** - **Lock to single conversation** - **Disabled**
+
+![](screenshots/multiple-chatwoot.png)
+
+Set in **WAHA**:
+- **Select conversation behavior** - **Activity: Newest**
+- **Use Conversation with Status** - **Use Only: Open, Pending, Snoozed**
+
+{{< callout context="caution" title="Activity Includes Conversation Status Changes">}}
+If you set **Select conversation behavior** to **Activity: Newest**, **Chatwoot** treats conversation **status changes** as **activity**.
+{{< /callout >}}
+
+![](screenshots/multiple-waha.png)
+
 ## Language
 You can adjust **messages, templates, and branding** in the content WAHA sends to Chatwoot and WhatsApp
 by providing key-value overrides in **YAML**.

content/docs/apps/chatwoot/screenshots/multiple-chatwoot.png

@@ -86,6 +86,7 @@ docker compose up -d
 - `WHATSAPP_API_SCHEMA=https` - it just changes `media.url` schema when you receive media (with files) messages.
 - `WAHA_BASE_URL` - will be used to construct the `media.url` field in the webhook events. 
   - By default, it's `{WHATSAPP_API_SCHEMA}://{WHATSAPP_API_HOSTNAME}:{WHATSAPP_API_PORT}`.
+- `WAHA_PUBLIC_URL=https://w.example.com` — the publicly available link to the dashboard (use this if `WAHA_BASE_URL` is set to an internal address for Docker).
 - `TZ=Europe/Warsaw` - set the timezone for the container. The default value is `UTC`. Find [your timezone in the list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
 - `WAHA_DEBUG_MODE=false` - enables some API only for development or troubleshooting purposes. Disabled by default.
   - Read more on [**🔍 Observability**]({{< relref "/docs/how-to/observability#waha-debug-mode" >}}) page.

content/docs/apps/chatwoot/screenshots/multiple-waha.png

@@ -325,5 +325,5 @@ Fetch the LID for a given phone number (chat ID).
 [**open an issue**](https://github.com/devlikeapro/waha)
 and tell what
 [**🏭 Engine**]({{< relref "/docs/how-to/engines" >}})
-you're using and what behaviour you see.
+you're using and what behavior you see.
 {{< /callout >}}

content/docs/apps/chatwoot/screenshots/single-chatwoot.png

@@ -177,7 +177,7 @@ POST /api/sendText
 }
 ```
 
-If the text has a link - it generates a preview for that link. You adjust the behaviour by setting
+If the text has a link - it generates a preview for that link. You adjust the behavior by setting
 - `linkPreview: true` - to enable link preview
 - `linkPreviewHighQuality: true` - to enable high-quality link preview (requires additional upload to WA servers)
 

content/docs/apps/chatwoot/screenshots/single-waha.png

@@ -57,6 +57,13 @@ Check the [**🔧 Install & Update**]({{< relref "/docs/how-to/install" >}}) pag
 
 **🧩 Apps**
 
+- `2025.9.6` - **ChatWoot** - [**Conversation Control**]({{< relref "/docs/apps/chatwoot#conversations" >}})
+  - {{< issue 1216 >}}, {{< issue 1357 >}}, {{< issue 1237 >}}, {{< issue 1343 >}}, {{< issue 1213 >}}
+- `2025.9.6` - **ChatWoot** - fix Duplicating Audio Message When Automatically transcribe audio enabled - {{< issue 1371 >}}
+- `2025.9.6` - **ChatWoot** - add `ChatWootAppConfig` to OpenAPI - {{< issue 1416 >}}
+- `2025.9.6` - **ChatWoot** - add additional **9** in Brazil phone numbers - {{< issue 1261 >}}
+- `2025.9.6` - **ChatWoot** - check contact attributes before updating - {{< issue 1173 >}}
+- `2025.9.6` - **ChatWoot** - Use group name for contact - {{< issue 1245 >}}
 - `2025.9.5` - **ChatWoot** - group participant at the top by default or [**Language Template - Group Participant At The Bottom**]({{< relref "/docs/apps/chatwoot#language" >}}) - {{< issue 1369 >}}
 - `2025.9.4` - **ChatWoot** - skip `STARTING => WORKING` messages if the session recovers fast (10 seconds) - {{< issue 1342 >}}
 - `2025.9.3` - **ChatWoot** - [**Language Template - Agent Name**]({{< relref "/docs/apps/chatwoot#language" >}}) - {{< issue 1161 >}}
@@ -72,6 +79,8 @@ Check the [**🔧 Install & Update**]({{< relref "/docs/how-to/install" >}}) pag
 
 🛠️ **Fixes**
 
+- `2025.9.5` - **ChatWoot** - fix `/jobs` auth - {{< issue 1398 >}}
+- `2025.9.5` - **ChatWoot** - fix 500 API Error `GET /public/conversations - timeout` - {{< issue 1389 >}}
 - `2025.9.5` - **GOWS** - Fix "typing" after message sent - {{< issue 1364 >}}
 - `2025.9.5` - **NOWEB** - Fix login via phone - {{< issue 1385 >}}
 - `2025.9.5` - **NOWEB** - Fix `fromMe` in group messages - {{< issue 1350 >}}
@@ -397,7 +406,7 @@ Check the [**🔧 Install & Update**]({{< relref "/docs/how-to/install" >}}) pag
 `2025.2.3`
 - Add [**🆔 Profile API**]({{< relref "/docs/how-to/profile" >}} ) to get and update profile information {{< issue 529 >}} 
   - **WEBJS**, **NOWEB**, **GOWS** engines
-- Fix `hasMedia` behaviour - now when you request messages with `downloadMedia=False`, `hasMedia: true` if message has media
+- Fix `hasMedia` behavior - now when you request messages with `downloadMedia=False`, `hasMedia: true` if message has media
   - **WEBJS**, **NOWEB**, **GOWS** engines
 
 `2025.2.2`