Chatwoot开源项目详解：全渠道客户支持平台部署教程与Intercom替代方案实战指南

┌─────────────────────────────────────────────────────────────┐
│                      前端界面层                              │
│         (Vue.js SPA / 客服工作台 / 管理后台)                 │
└─────────────────────────────────────────────────────────────┘
                              │
┌─────────────────────────────────────────────────────────────┐
│                      Ruby on Rails API                       │
│     (RESTful API / WebSocket实时通信 / 后台任务)             │
└─────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
┌───────▼──────┐    ┌────────▼────────┐   ┌───────▼──────┐
│  PostgreSQL  │    │     Redis       │   │  Sidekiq     │
│  (主数据库)   │    │  (缓存/会话)     │   │ (后台队列)   │
└──────────────┘    └─────────────────┘   └──────────────┘

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

cp .env.example .env

# 数据库配置
POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=your_secure_password
POSTGRES_DATABASE=chatwoot_production

# Redis配置
REDIS_URL=redis://redis:6379

# 应用密钥（生成随机字符串）
SECRET_KEY_BASE=your_random_secret_key

# 域名配置
FRONTEND_URL=https://chat.yourdomain.com

# SMTP邮件配置（用于发送通知）
SMTP_ADDRESS=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password

# 可选：RAILS_ENV=production

docker compose -f docker-compose.production.yaml up -d

docker compose -f docker-compose.production.yaml exec rails bundle exec rails db:chatwoot_prepare

docker compose -f docker-compose.production.yaml exec rails bundle exec rails c

# 在Rails控制台中执行
Account.create!(name: "Your Company", domain: "yourdomain")
User.create!(email: "admin@yourdomain.com", password: "secure_password", name: "Admin")

# 在DigitalOcean控制台中选择Chatwoot 1-Click App
# 或使用doctl命令行工具
doctl kubernetes 1-click install chatwoot

<script>
  (function(d,t) {
    var BASE_URL="https://your-chatwoot-domain.com";
    var g=d.createElement(t),s=d.getElementsByTagName(t)[0];
    g.src=BASE_URL+"/packs/js/sdk.js";
    g.defer = true;
    g.async = true;
    s.parentNode.insertBefore(g,s);
    g.onload=function(){
      window.chatwootSDK.run({
        websiteToken: 'YOUR_WEBSITE_TOKEN',
        baseUrl: BASE_URL
      })
    }
  })(document,"script");
</script>

规则名称：新对话自动分配
触发条件：对话创建
条件：渠道 = Website
动作：分配给客服组 "在线客服"
        添加标签 "网站咨询"
        发送自动回复 "您好，已收到您的消息，客服将尽快回复。"

# 获取对话列表
curl -X GET "https://your-chatwoot-domain.com/api/v1/accounts/1/conversations" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

# 发送消息
curl -X POST "https://your-chatwoot-domain.com/api/v1/accounts/1/conversations/1/messages" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "这是一条通过API发送的消息",
    "message_type": "outgoing",
    "private": false
  }'