Skip to content

Commit 9e0cd6e

Browse files
committed
fixes
1 parent 8275784 commit 9e0cd6e

File tree

8 files changed

+88
-76
lines changed

8 files changed

+88
-76
lines changed

content/blog/apps-chatwoot-1-install/index.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: "WAHA + ChatWoot - Installation Guide"
3-
description: "WAHA + ChatWoot - Installation Guide"
4-
excerpt: "WAHA + ChatWoot - Installation Guide"
2+
title: "WhatsApp + ChatWoot - Installation Guide"
3+
description: "WhatsApp + ChatWoot - Installation Guide"
4+
excerpt: "WhatsApp + ChatWoot - Installation Guide"
55
date: 2025-07-11T08:48:45+00:00
66
draft: false
77
images: [ "waha-chatwoot.png" ]
@@ -31,7 +31,7 @@ After completing the installation guide, you'll have:
3131
{{< include file="content/blog/apps-chatwoot-1-install/-ssh-port-forwarding.md" >}}
3232

3333
## Steps to Deploy
34-
### 0. Add DNS Aliases
34+
### Step 0: Add DNS Aliases
3535
First, we need to add **DNS Aliases** so everything works as inside docker containers.
3636

3737
👉 **Run the below commands on YOUR LAPTOP/PC**, NOT on the **VPS or VM**:
@@ -74,7 +74,7 @@ ping waha
7474
{{< /tab >}}
7575
{{< /tabs >}}
7676

77-
### 1. Install Docker
77+
### Step 1: Install Docker
7878
```bash { title="Install Docker" }
7979
# example in ubuntu
8080
apt-get update
@@ -84,7 +84,7 @@ sudo sh get-docker.sh
8484
apt install docker-compose-plugin
8585
```
8686

87-
### 2. Download the required files
87+
### Step 2: Download the Required Files
8888
```bash { title="Download files" }
8989
# Download the env files
9090
wget -O .waha.env https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/docker-compose/chatwoot/.waha.env
@@ -93,7 +93,7 @@ wget -O .chatwoot.env https://raw.githubusercontent.com/devlikeapro/waha/refs/he
9393
wget -O docker-compose.yaml https://raw.githubusercontent.com/devlikeapro/waha/refs/heads/core/docker-compose/chatwoot/docker-compose.yaml
9494
```
9595

96-
### 3. Configure environment variables
96+
### Step 3: Configure Environment Variables
9797
Now you can tweak `.waha.env`, `.chatwoot.env` and `docker-compose.yaml` according to your preferences.
9898

9999
Here are a few environment variables we suggest that you change before going forward (in this guide we'll use **the default values**):
@@ -106,7 +106,7 @@ WHATSAPP_SWAGGER_USERNAME=admin
106106
WHATSAPP_SWAGGER_PASSWORD=11111111111111111111111111111111
107107
```
108108

109-
### 5. Pull docker images
109+
### Step 5: Pull Docker Images
110110
{{< tabs "download-docker-image" >}}
111111

112112
{{< tab "➕ WAHA Plus" >}}
@@ -164,17 +164,17 @@ docker compose pull
164164

165165
{{< /tabs >}}
166166

167-
### 6. Prepare ChatWoot database
167+
### Step 6: Prepare ChatWoot Database
168168
```bash { title="Prepare ChatWoot Database" }
169169
docker compose run --rm chatwoot bundle exec rails db:chatwoot_prepare
170170
```
171171

172-
### 7. Start the services
172+
### Step 7: Start the Services
173173
```bash { title="Start Services" }
174174
docker compose up -d
175175
```
176176

177-
### 8. Access your WAHA
177+
### Step 8: Access Your WAHA
178178
**Open** [**http://localhost:3000/dashboard**](http://localhost:3000/dashboard) with credentials:
179179
- User: `admin`
180180
- Password: `11111111111111111111111111111111`
@@ -185,7 +185,7 @@ docker compose up -d
185185
![](waha-dashboard-key.png)
186186

187187

188-
### 9. Access your ChatWoot
188+
### Step 9: Access Your ChatWoot
189189
**Open** and **finish** the onboarding guide on [**http://localhost:3009/**](http://localhost:3009/)
190190

191191
![](chatwoot-onboarding.png)
@@ -194,6 +194,6 @@ docker compose up -d
194194
## What is next?
195195

196196
👉 Connect **WhatsApp** to **ChatWoot** in
197-
[**WAHA + ChatWoot - Configuration Guide**]({{< relref "/blog/apps-chatwoot-2-config" >}})
197+
[**WhatsApp + ChatWoot - Configuration Guide**]({{< relref "/blog/apps-chatwoot-2-config" >}})
198198

199199
{{< include file="content/docs/apps/chatwoot/-chatwoot-articles.md" >}}

content/blog/apps-chatwoot-2-config/index.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: "WAHA + ChatWoot - Configuration Guide"
3-
description: "WAHA + ChatWoot - Configuration Guide"
4-
excerpt: "WAHA + ChatWoot - Configuration Guide"
2+
title: "WhatsApp + ChatWoot - Configuration Guide"
3+
description: "WhatsApp + ChatWoot - Configuration Guide"
4+
excerpt: "WhatsApp + ChatWoot - Configuration Guide"
55
date: 2025-07-10T08:48:45+00:00
66
draft: false
77
images: [ "waha-chatwoot.png" ]
@@ -31,15 +31,15 @@ At this point you should have:
3131
- **ChatWoot** on [**http://localhost:3009**](http://localhost:3009)
3232

3333
If you don't have it - kindly follow
34-
[**WAHA + ChatWoot - Installation Guide**]({{< relref "/blog/apps-chatwoot-1-install" >}})
34+
[**WhatsApp + ChatWoot - Installation Guide**]({{< relref "/blog/apps-chatwoot-1-install" >}})
3535

3636
{{< include file="content/blog/apps-chatwoot-1-install/-ssh-port-forwarding.md" >}}
3737

3838
## Steps to Configure ChatWoot App
3939
Now you're ready to setup **WhatsApp** to **ChatWoot** connection using
4040
**WAHA** [**🧩 ChatWoot App**]({{< relref "/docs/apps/chatwoot" >}})!
4141

42-
### 1. WAHA: Create Session
42+
### Step 1: Create Session in WAHA
4343
{{< tabs "waha-create-session" >}}
4444
{{< tab "➕ WAHA Plus" >}}
4545
- Open [http://localhost:3000/dashboard](http://localhost:3000/dashboard)
@@ -58,7 +58,7 @@ Now you're ready to setup **WhatsApp** to **ChatWoot** connection using
5858

5959
{{< /tabs >}}
6060

61-
### 2. WAHA: Copy Webhook URL
61+
### Step 2: Copy Webhook URL in WAHA
6262
- Open [http://localhost:3000/dashboard](http://localhost:3000/dashboard)
6363
- Click **Apps**
6464
- Click **Add App**
@@ -67,7 +67,7 @@ Now you're ready to setup **WhatsApp** to **ChatWoot** connection using
6767

6868
![](waha-add-chatwoot-app.png)
6969

70-
### 3. ChatWoot: Create API Inbox
70+
### Step 3: Create API Inbox in ChatWoot
7171
- Go to **ChatWoot** [http://localhost:3009](http://localhost:3009)
7272
- Open **Settings → Inboxes**
7373
- Click **Add Inbox**, choose **API**
@@ -79,7 +79,7 @@ Now you're ready to setup **WhatsApp** to **ChatWoot** connection using
7979
![](chatwoot-create-inbox.png)
8080

8181

82-
### 4. WAHA: Get Required Fields from ChatWoot
82+
### Step 4: Collect ChatWoot Fields for WAHA
8383
Now we'll need to find those fields in **ChatWoot**
8484

8585
![](waha-chatwoot-fields.png)
@@ -101,12 +101,12 @@ Check the screenshots below, but here's the path how you can find the values:
101101
![](chatwoot-inbox-fields.png)
102102
{{< img-sign text="Inbox ID, Inbox Identifier: Settings → Inboxes → {Inbox} → Configuration" >}}
103103

104-
### 5. WAHA: Save App
104+
### Step 5: Save App Configuration in WAHA
105105
Click **Save** after you finish all fields.
106106

107107
![](waha-chatwoot-fields.png)
108108

109-
### 6. ChatWoot: Check Integration
109+
### Step 6: Test Integration in ChatWoot
110110
Now you can open a new conversation created by WAHA and send `status` or `help` to check that integration is working.
111111

112112
- Go to **ChatWoot** [http://localhost:3009](http://localhost:3009)
@@ -115,7 +115,7 @@ Now you can open a new conversation created by WAHA and send `status` or `help`
115115

116116
![](chatwoot-send-status.png)
117117

118-
### 7. ChatWoot: Start Session, Scan QR
118+
### Step 7: Start Session and Scan QR in ChatWoot
119119
{{< callout context="caution" title="Get your phone with WhatsApp App" icon="outline/shield-check" >}}
120120
Now we're ready to connect your phone with WAHA and ChatWoot.
121121

@@ -131,7 +131,7 @@ Open **WhatsApp** on the phone and click on three dots at the right and **Linked
131131

132132
![](chatwoot-start-session.png)
133133

134-
### 8. ChatWoot: Test WhatsApp
134+
### Step 8: Test WhatsApp Integration in ChatWoot
135135
Now let's see how ChatWoot WhatsApp integration works!
136136

137137
- Send a message from **another** phone to **a connected** account using **WhatsApp**
@@ -141,6 +141,6 @@ Now let's see how ChatWoot WhatsApp integration works!
141141
## What is next?
142142

143143
👉 Setup **HTTPS** for **ChatWoot** in
144-
[**WAHA + ChatWoot - HTTPS Guide**]({{< relref "/blog/apps-chatwoot-3-https" >}})
144+
[**WhatsApp + ChatWoot - HTTPS Guide**]({{< relref "/blog/apps-chatwoot-3-https" >}})
145145

146146
{{< include file="content/docs/apps/chatwoot/-chatwoot-articles.md" >}}

content/blog/apps-chatwoot-3-https/index.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: "WAHA + ChatWoot - HTTPS Guide"
3-
description: "WAHA + ChatWoot - HTTPS Guide"
4-
excerpt: "WAHA + ChatWoot - HTTPS Guide"
2+
title: "WhatsApp + ChatWoot - HTTPS Guide"
3+
description: "WhatsApp + ChatWoot - HTTPS Guide"
4+
excerpt: "WhatsApp + ChatWoot - HTTPS Guide"
55
date: 2025-07-07T08:48:45+00:00
66
draft: false
77
images: [ "waha-chatwoot.png" ]
@@ -36,17 +36,17 @@ If you don't have it - kindly follow **the previous guides in the series above
3636

3737
Now you're ready to publish your **ChatWoot** and **WAHA** instances on the internet!
3838

39-
### Configure DNS
39+
## Configure DNS
4040
If you have VPS with a Public IP address, you need to configure DNS - add **A** records to point those domains:
4141
1. `waha.<yourdomain.com>` => `YOUR_VPS_IP_ADDRESS`
4242
2. `chatwoot.<yourdomain.com>` => `YOUR_VPS_IP_ADDRESS`
4343

4444
## Configure HTTPS for ChatWoot
45-
### 1. Install Nginx
45+
### Step 1: Install Nginx
4646
```bash { title="Install Nginx" }
4747
sudo apt-get install nginx
4848
```
49-
### 2. Add Nginx config
49+
### Step 2: Add Nginx Config
5050
```bash { title="Add Nginx config" }
5151
cd /etc/nginx/sites-enabled
5252
nano chatwoot.<yourdomain.com>.conf
@@ -89,21 +89,21 @@ server {
8989
listen 80;
9090
}
9191
```
92-
### 3. Verify and reload Nginx config
92+
### Step 3: Verify and Reload Nginx Config
9393
```bash { title="Verify and reload Nginx config" }
9494
nginx -t
9595
systemctl reload nginx
9696
```
9797

98-
### 4. Run Lets Encrypt to configure SSL certificate
99-
```bash { title="Run Lets Encrypt to configure SSL certificate" }
98+
### Step 4: Run Let's Encrypt to configure SSL certificate
99+
```bash { title="Run Let's Encrypt to configure SSL certificate" }
100100
apt install certbot
101101
apt-get install python3-certbot-nginx
102102
mkdir -p /var/www/ssl-proof/chatwoot/.well-known
103103
certbot --webroot -w /var/www/ssl-proof/chatwoot/ -d chatwoot.<yourdomain.com> -i nginx
104104
```
105105

106-
### 5. Update env variables
106+
### Step 5: Update env variables
107107
Update `FRONTEND_URL` in `.chatwoot.env`
108108
```bash
109109
nano .chatwoot.env
@@ -118,11 +118,11 @@ Apply the changes:
118118
docker compose up -d
119119
```
120120

121-
### 6. Access your installation
121+
### Step 6: Access your installation
122122
- Open `https://chatwoot.<yourdomain.com>`
123123
- Make sure it's working
124124

125-
### 7. Update ChatWoot URL in WAHA
125+
### Step 7: Update ChatWoot URL in WAHA
126126
- Open **WAHA** [http://localhost:3000](http://localhost:3000)
127127
- Open **Apps** and **Edit App**
128128
- Update **ChatWoot URL** from `http://chatwoot:3009` to `https://chatwoot.<yourdomain.com>`
@@ -138,12 +138,12 @@ Otherwise - use ssh port forwarding to manage WAHA, it's usually enough.
138138

139139
{{< include file="content/blog/apps-chatwoot-1-install/-ssh-port-forwarding.md" >}}
140140

141-
### 1. Install Nginx
141+
### Step 1: Install Nginx
142142
```bash { title="Install Nginx" }
143143
sudo apt-get install nginx
144144
```
145145

146-
### 2. Add Nginx config
146+
### Step 2: Add Nginx config
147147
```bash { title="Add Nginx config" }
148148
cd /etc/nginx/sites-enabled
149149
nano waha.<yourdomain.com>.conf
@@ -182,21 +182,21 @@ server {
182182
listen 80;
183183
}
184184
```
185-
### 3. Verify and reload Nginx config
185+
### Step 3: Verify and reload Nginx config
186186
```bash { title="Verify and reload Nginx config" }
187187
nginx -t
188188
systemctl reload nginx
189189
```
190190

191-
### 4. Run Lets Encrypt to configure SSL certificate
192-
```bash { title="Run Lets Encrypt to configure SSL certificate" }
191+
### Step 4: Run Let's Encrypt to configure SSL certificate
192+
```bash { title="Run Let's Encrypt to configure SSL certificate" }
193193
apt install certbot
194194
apt-get install python3-certbot-nginx
195195
mkdir -p /var/www/ssl-proof/waha/.well-known
196196
certbot --webroot -w /var/www/ssl-proof/waha/ -d waha.<yourdomain.com> -i nginx
197197
```
198198

199-
### 5. Update env variables
199+
### Step 5: Update env variables
200200
Update `WAHA_BASE_URL` in `.waha.env`
201201
```bash
202202
nano .waha.env
@@ -211,11 +211,11 @@ Apply the changes:
211211
docker compose up -d
212212
```
213213

214-
### 6. Access your installation
214+
### Step 6: Access your installation
215215
- Open `https://waha.<yourdomain.com>`
216216
- Make sure it's working
217217

218-
### 7. Update Webhook URL in ChatWoot
218+
### Step 7: Update Webhook URL in ChatWoot
219219
- Open **ChatWoot** `https://chatwoot.<yourdomain.com>`
220220
- Go to **Settings → Inboxes → {Inbox}**
221221
- Update **Webhook URL** from `http://waha:3000/{WEBHOOKURL}` to `https://waha.<yourdomain.com>/{WEBHOOKURL}`
@@ -228,4 +228,4 @@ docker compose up -d
228228
[**🧩 ChatWoot App**]({{< relref "/docs/apps/chatwoot" >}})
229229
to see features available for **WhatsApp ChatWoot** integration using **WAHA**.
230230

231-
{{< include file="content/docs/apps/chatwoot/-chatwoot-articles.md" >}}
231+
{{< include file="content/docs/apps/chatwoot/-chatwoot-articles.md" >}}

content/docs/apps/about/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ slug: "about"
1717

1818
{{< include file="content/docs/apps/about/apps-vs-integrations.md" >}}
1919

20+
## Apps
21+
- [**ChatWoot**]({{< relref "/docs/apps/chatwoot" >}}) - use your **WhatsApp** in **ChatWoot CRM**
22+
2023
## Apps SDK
2124

2225
WIP

content/docs/apps/chatwoot/-chatwoot-articles.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<div></div>
22
{{< callout context="tip" title="ChatWoot Articles" icon="outline/article" >}}
33
There's a series of articles about WhatsApp and ChatWoot integrations:
4-
1. [**WAHA + ChatWoot - Installation Guide**]({{< relref "/blog/apps-chatwoot-1-install" >}})
5-
2. [**WAHA + ChatWoot - Configuration Guide**]({{< relref "/blog/apps-chatwoot-2-config" >}})
6-
3. [**WAHA + ChatWoot - HTTPS Guide**]({{< relref "/blog/apps-chatwoot-3-https" >}})
4+
1. [**WhatsApp + ChatWoot - Installation Guide**]({{< relref "/blog/apps-chatwoot-1-install" >}})
5+
2. [**WhatsApp + ChatWoot - Configuration Guide**]({{< relref "/blog/apps-chatwoot-2-config" >}})
6+
3. [**WhatsApp + ChatWoot - HTTPS Guide**]({{< relref "/blog/apps-chatwoot-3-https" >}})
77

88
You can follow them **one by one** or skip some parts if you don't need them.
99

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,6 @@
11
<div></div>
22
{{< callout context="info" title="Disclaimer" icon="outline/gavel" >}}
3-
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with **WhatsApp** or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at https://whatsapp.com.
3+
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with **WhatsApp**, **ChatWoot**, or any of their respective subsidiaries or affiliates. The official websites can be found at [https://whatsapp.com](https://whatsapp.com) and [https://chatwoot.com](https://chatwoot.com).
44

5-
This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with **ChatWoot** or any of its subsidiaries or its affiliates. The official ChatWoot website can be found at https://chatwoot.com.
6-
7-
For any businesses looking to integrate with WhatsApp for critical applications, we highly recommend using
8-
[officially supported methods](https://www.chatwoot.com/hc/user-guide/articles/1677832735-how-to-setup-a-whats_app-channel).
5+
For businesses seeking to integrate with WhatsApp for critical applications, we strongly recommend using [officially supported methods](https://www.chatwoot.com/hc/user-guide/articles/1677832735-how-to-setup-a-whats_app-channel).
96
{{< /callout >}}

content/docs/integrations/chatwoot/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,6 @@ To set up **WhatsApp ChatWoot** integration you'll need few things:
3131
1. To use **ChatWoot Cloud** you need to make sure your **n8n** webhook is accessible from the internet
3232
4. **PostgreSQL** - to store ChatWoot data (and WAHA-ChatWoot relations)
3333

34-
👉 Check out [**WAHA + ChatWoot Templates**](https://waha-n8n-templates.devlike.pro/chatwoot/)
34+
👉 Check out [**WhatsApp + ChatWoot Templates**](https://waha-n8n-templates.devlike.pro/chatwoot/)
3535
to start from the scratch and create your first **ChatWoot** integration!
3636

0 commit comments

Comments
 (0)