Chuyển tới nội dung chính

6. Tự Động Hóa & Marketing

6.1 Liệt Kê Quy Tắc Tự Động Hóa​

GET /api/v1/automation/rules

Liệt kê các quy trình tự động hóa.

Tham Số Truy Vấn:

  • page - Số trang
  • limit - Mục mỗi trang
  • status - Lọc: draft, active, paused
  • type - Lọc theo loại quy tắc

Phản hồi:

{
  "data": [
    {
      "id": "rule-001",
      "name": "Chào Mừng Lead Mới",
      "description": "Gửi tin nhắn chào mừng cho lead mới",
      "type": "sequence",
      "trigger": {
        "type": "contact_created",
        "conditions": [{ "field": "source", "operator": "equals", "value": "zalo" }]
      },
      "actions": [
        {
          "type": "send_message",
          "template": "welcome_message"
        }
      ],
      "status": "active",
      "createdAt": "2026-05-01T10:00:00Z"
    }
  ],
  "pagination": { "total": 12, "page": 1, "limit": 50 }
}

6.2 Tạo Quy Tắc Tự Động Hóa​

POST /api/v1/automation/rules

Tạo quy trình tự động hóa mới.

Thân Yêu Cầu:

{
  "name": "Cảnh Báo Lead Giá Trị Cao",
  "description": "Thông báo cho đội khi lead có giá trị cao được tạo",
  "type": "sequence",
  "trigger": {
    "type": "contact_created",
    "conditions": [
      { "field": "leadScore", "operator": "gte", "value": 80 }
    ]
  },
  "actions": [
    {
      "type": "send_notification",
      "template": "high_value_alert"
    },
    {
      "type": "assign_user",
      "userId": "user-125"
    }
  ]
}

Phản hồi: 201

{
  "id": "rule-002",
  "name": "Cảnh Báo Lead Giá Trị Cao",
  "status": "draft",
  "createdAt": "2026-06-05T17:35:00Z"
}

6.3 Liệt Kê Mẫu Tin Nhắn​

GET /api/v1/automation/templates

Liệt kê các mẫu tin nhắn đã lưu.

Phản hồi:

[
  {
    "id": "tpl-001",
    "name": "Tin Nhắn Chào Mừng",
    "content": "Xin chào {{contactName}}, chào mừng đến dịch vụ của chúng tôi!",
    "category": "greeting",
    "variables": ["contactName"],
    "createdAt": "2026-05-01T10:00:00Z"
  }
]

6.4 Tạo Mẫu Tin Nhắn​

POST /api/v1/automation/templates

Tạo mẫu tin nhắn mới với các biến.

Thân Yêu Cầu:

{
  "name": "Ưu Đãi Đặc Biệt",
  "content": "Xin chào {{contactName}}, chúng tôi có ưu đãi đặc biệt cho bạn: {{offerDetails}}",
  "category": "offer",
  "variables": ["contactName", "offerDetails"]
}

Phản hồi: 201

{
  "id": "tpl-002",
  "name": "Ưu Đãi Đặc Biệt",
  "createdAt": "2026-06-05T17:35:00Z"
}

6.5 Liệt Kê Danh Sách Khách Hàng​

GET /api/v1/customer-lists

Liệt kê các phân đoạn khán giả.

Phản hồi:

[
  {
    "id": "list-001",
    "name": "Lead Nóng - Tháng 6",
    "description": "Lead có điểm > 80",
    "contactCount": 150,
    "status": "active",
    "createdAt": "2026-06-01T10:00:00Z"
  }
]

6.6 Tạo Danh Sách Khách Hàng​

POST /api/v1/customer-lists

Tạo khán giả/phân đoạn mới.

Thân Yêu Cầu:

{
  "name": "Khách Hàng VIP",
  "description": "Khách hàng có lịch sử mua hàng > 5000 USD",
  "criteria": {
    "filters": [
      { "field": "status", "operator": "equals", "value": "customer" },
      { "field": "leadScore", "operator": "gte", "value": 85 }
    ]
  }
}

Phản hồi: 201

{
  "id": "list-002",
  "name": "Khách Hàng VIP",
  "status": "draft",
  "createdAt": "2026-06-05T17:35:00Z"
}

6.7 Liệt Kê Chiến Dịch​

GET /api/v1/campaigns

Liệt kê các chiến dịch marketing.

Phản hồi:

[
  {
    "id": "campaign-001",
    "name": "Khuyến Mãi Mùa Hè",
    "type": "email",
    "status": "active",
    "contactCount": 500,
    "sentCount": 350,
    "openRate": 0.42,
    "createdAt": "2026-06-01T10:00:00Z"
  }
]

6.8 Tạo Chiến Dịch​

POST /api/v1/campaigns

Tạo chiến dịch marketing mới.

Thân Yêu Cầu:

{
  "name": "Chiến Dịch Bán Hàng Tháng 7",
  "description": "Thông báo bán hàng tháng 7 cho tất cả khách hàng",
  "type": "broadcast",
  "listId": "list-001",
  "templateId": "tpl-001",
  "schedule": "2026-07-01T08:00:00Z",
  "variables": {
    "discount": "30%"
  }
}

Phản hồi: 201

{
  "id": "campaign-002",
  "name": "Chiến Dịch Bán Hàng Tháng 7",
  "status": "draft",
  "createdAt": "2026-06-05T17:35:00Z"
}