---
name: chatwoot-support
description: Self-host Chatwoot — omnichannel customer support desk. WhatsApp/FB Messenger/web/email + AI agent Captain. UI Vietnamese sẵn.
---

# Skill: Chatwoot — Omnichannel customer support

## Skill này làm gì

Chatwoot là phần mềm hỗ trợ khách hàng đa kênh mã nguồn mở — self-host trên server của bạn, gộp inbox từ Facebook Messenger, Instagram, WhatsApp, email, web chat, SMS, API channel vào 1 dashboard duy nhất. Có sẵn AI agent **Captain** auto-reply + copilot gợi ý câu trả lời. Free unlimited agent khi self-host (vs Intercom/Zendesk $50-100/agent/tháng).

## Khi nào dùng

- Bạn có team CSKH 2-20 người cần inbox chung
- Muốn gộp **FB Messenger + email support@ + web chat website** vào 1 nơi
- Cần auto-reply 24/7 qua AI Captain cho câu hỏi lặp
- Cần SLA + assignment rule (auto giao ticket cho nhân viên theo team/skill)
- Muốn thoát Intercom/Zendesk/Freshdesk tiết kiệm $500-2000/tháng
- Cần multilingual: UI hỗ trợ 30+ ngôn ngữ trong đó có **Tiếng Việt**

## Cách cài (Docker, 15 phút)

```bash
git clone https://github.com/chatwoot/chatwoot.git
cd chatwoot

cp .env.example .env
nano .env  # đổi SECRET_KEY_BASE + POSTGRES_PASSWORD + FRONTEND_URL + SMTP

docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d

# Mở http://localhost:3000 → tạo admin
# Profile → Settings → đổi UI Tiếng Việt
```

Production: reverse proxy Nginx/Caddy + SSL + Postgres backup daily.

## Câu lệnh chủ đạo

```
Tôi vừa self-host Chatwoot tại https://support.[domain].com.
Giúp tôi setup channel đầu tiên:

1. Kết nối inbox Facebook Messenger fanpage [tên]
   - Hướng dẫn lấy Page Access Token từ Meta Developer
   - Setup webhook URL trong app FB
   - Verify message test từ Messenger về Chatwoot

2. Tạo team "CSKH" 3 nhân viên (email + tên):
   [Nhân viên 1]: ...
   [Nhân viên 2]: ...
   [Nhân viên 3]: ...

3. Tạo 2 automation rule:
   - Tin nhắn ngoài giờ (18h-8h) → auto-reply "Cảm ơn bạn, sáng mai phản hồi trước 9h"
   - Tin nhắn có "giá" / "bảng giá" → auto-assign team CSKH priority Medium

4. Setup canned response cho 5 tình huống (chào / xin SĐT / gửi bảng giá / hẹn callback / đóng ticket)

Trả kết quả mỗi bước + screenshot setup screen.
```

## Quyền hạn cần thiết

- **VPS Linux** (Ubuntu 22.04+) ≥4GB RAM + 2 vCPU + 40GB SSD (~$20-40/tháng)
- **Docker + Docker Compose**
- **Domain riêng** + SSL cert (Caddy auto-renew)
- **SMTP outbound** (Resend / Postmark / SendGrid / Brevo)
- **Meta Developer account** (Business Verification ~3-7 ngày)
- **WhatsApp Business API** (qua 360dialog / Twilio / Meta Cloud API) nếu cần
- **Backup hàng ngày** Postgres + storage uploads

## Lưu ý cho doanh nghiệp Việt Nam

- **KHÔNG có Zalo OA native channel** → đây là gap lớn nhất cho VN. Cần build custom channel qua Chatwoot **API channel** + bridge service forward webhook Zalo OA → Chatwoot
- HOẶC giải pháp lai: **Ahachat (Zalo OA + Messenger plain)** + **Chatwoot (email + web chat + ticketing)** — chia theo điểm mạnh
- UI **Tiếng Việt** sẵn (Settings → Language → Vietnamese) ~85% dịch
- VPS đặt **Singapore / Tokyo / Hong Kong** thay US/EU (latency 50-80ms vs 250-350ms)
- **WhatsApp ít phổ biến** VN (<5%) — không ưu tiên trừ khi bán quốc tế
- **Email channel** kết nối IMAP + SMTP domain doanh nghiệp (vd `cskh@tencongty.com`)
- **Captain AI** dùng OpenAI/Anthropic key — ~$10-50/tháng tuỳ volume

## Mẹo dùng hiệu quả

1. **Bắt đầu với 1 channel** (FB Messenger HOẶC email) — đừng cố kết nối hết 5 kênh ngày đầu
2. **Setup canned response sớm** — 80% câu hỏi lặp. 20-30 mẫu trả lời giảm 60% thời gian xử lý 1 ticket
3. **Đo CSAT + First Response Time** hàng tuần — mục tiêu FRT <5 phút + CSAT >4.5/5
4. **AI Captain dùng cho FAQ tier 1 thôi** — refund/khiếu nại/hợp đồng route human

---

**Tác giả:** Eroca Thanh + claude-lm7-skills-anthropic · 2026-05-28
