Hướng dẫn sử dụng Bot API (Trigger Bot API)

Bot API là giải pháp kết nối mạnh mẽ, cho phép bạn đồng bộ hệ thống bên ngoài (Website, CRM, Phần mềm quản lý đơn hàng...) với Smax.

Thay vì nhân viên phải nhắn tin thủ công, Bot API đóng vai trò như một "lệnh điều khiển" tự động, yêu cầu Smax gửi chính xác một kịch bản chatbot đến khách hàng ngay khi có một sự kiện cụ thể xảy ra.

🎯 Tại sao doanh nghiệp nên sử dụng Bot API?

Việc triển khai Bot API không chỉ là thay thế thao tác tay, mà còn mang lại giá trị vận hành thực tế:

• Tối ưu nguồn lực: Giảm 80% thời gian nhân viên chăm sóc khách hàng phải gửi các tin nhắn thông báo lặp đi lặp lại.
• Tăng trải nghiệm khách hàng: Khách hàng nhận được thông tin tức thời (Real-time), tạo cảm giác chuyên nghiệp và tin cậy.
• Thúc đẩy chuyển đổi: Gửi đúng thông điệp vào đúng thời điểm (ví dụ: gửi mã giảm giá ngay khi khách bỏ giỏ hàng) giúp tăng tỷ lệ chốt đơn.

💡 Ví dụ thực tế

---

🛠 Hướng dẫn cài đặt Trigger Bot API

Để bắt đầu, bạn cần tạo một Trigger (điểm kích hoạt) trong hệ thống Smax.

Trong danh sách trigger, bạn chọn Bot API và thực hiện cấu hình theo 5 bước sau:

1. Đặt tên trigger: Đặt tên gợi nhớ để dễ quản lý (Ví dụ: API_Xac_Nhan_Don_Hang).
2. Chọn kênh áp dụng: Chọn nền tảng bạn muốn gửi tin nhắn (Facebook, Zalo, v.v.).
3. Cài đặt thời gian chạy: Thiết lập khung giờ gửi tin để tránh làm phiền khách hàng vào ban đêm.
4. Lựa chọn Token bảo mật:
   • API Token: Chỉ có hiệu lực cho riêng trigger này. (Khuyến khích sử dụng để bảo mật tối đa).
   • Biz Token: Token dùng chung cho toàn bộ các API trong doanh nghiệp.
5. Chọn block gửi: Chọn kịch bản (block) đã soạn sẵn trong AI Chatbot mà bạn muốn gửi cho khách → Nhấn Lưu.

---

🚀 Hướng dẫn gọi API (Dành cho Kỹ thuật/Developer)

Sau khi lưu trigger, hệ thống sẽ cung cấp các thông số chi tiết để thực hiện lệnh gọi (call) API.

Thông số kỹ thuật:

• Phương thức: POST

• Chi tiết yêu cầu:

  1. API URL: Đường dẫn định danh duy nhất của trigger.
  2. Authorization: Mã token bảo mật (API Token hoặc Biz Token).
  3. Body: Nội dung dữ liệu định dạng JSON.

Cấu trúc Body của API (JSON)

javascript
{
    "customer": {
        "pid": "<customer_pid_here>",
        "page_pid": "<page_pid_here>"
    },
    "attrs": [
        {
            "name": "tên_thuộc_tính",
            "value": "giá_trị_cần_truyền"
        }
    ]
}

Giải thích chi tiết:

• pid & page_pid: Mã định danh duy nhất của khách hàng và trang. Bạn có thể trích xuất các giá trị này từ module Khách hàng.
• attrs (Attributes): Đây là phần quan trọng để cá nhân hóa tin nhắn. Bạn có thể truyền các thông tin như: Mã đơn hàng, Tên sản phẩm, Tên nhân viên tư vấn... vào đây. Khi đó, kịch bản chatbot sẽ hiển thị chính xác thông tin của khách hàng đó thay vì một tin nhắn chung chung.

---

💡 Mẹo dành cho chủ doanh nghiệp (Non-Tech)

Nếu bạn không phải là lập trình viên, bạn không cần quá lo lắng về các đoạn mã JSON hay phương thức POST. Hãy thực hiện theo quy trình đơn giản sau:

1. Bước 1: Thực hiện cài đặt từ (1) đến (5) trong phần hướng dẫn cài đặt ở trên.

2. Bước 2: Chụp ảnh màn hình hoặc copy toàn bộ thông tin API URL, Authorization và Body mẫu.

3. Bước 3: Gửi thông tin này cho nhân viên IT hoặc đơn vị đối tác vận hành Website/CRM của bạn kèm yêu cầu:

   "Hãy tích hợp API này vào hệ thống của tôi. Cụ thể: Khi [Sự kiện A xảy ra - ví dụ: Khách thanh toán xong], hệ thống hãy tự động gọi API này để Smax gửi tin nhắn cho khách."

Gợi ý thêm: Nếu bạn muốn khách hàng chủ động nhấn vào một đường link để kích hoạt kịch bản (thay vì hệ thống tự động gửi), bạn có thể tham khảo thêm về Messenger Ref Link.