Hướng dẫn thiết lập Trigger Bot API

Bot API đóng vai trò là "cầu nối" kỹ thuật, cho phép các hệ thống bên ngoài (như CRM, Website, Phần mềm quản lý đơn hàng) tự động ra lệnh cho Smax gửi một kịch bản chatbot cụ thể đến khách hàng.

Thay vì nhân viên phải nhắn tin thủ công, hệ thống của bạn sẽ tự động "kích hoạt" Smax gửi tin nhắn đúng thời điểm, đúng đối tượng.

---

💡 Khi nào bạn nên sử dụng Bot API?

Bot API đặc biệt hữu ích khi bạn muốn tự động hóa quy trình chăm sóc khách hàng dựa trên các sự kiện xảy ra trên hệ thống của bạn.

Các kịch bản ứng dụng thực tế:

• Thông báo trạng thái đơn hàng:
  • Luồng chạy: Website cập nhật trạng thái "Đang giao hàng" → Hệ thống gọi Bot API → Smax gửi tin nhắn: "Đơn hàng #123 của bạn đang trên đường giao đến, bạn vui lòng chú ý điện thoại nhé!"
• Chăm sóc Lead từ Landing Page:
  • Luồng chạy: Khách điền form đăng ký tư vấn → Hệ thống gọi Bot API → Smax gửi ngay kịch bản chào mừng và gửi tài liệu giới thiệu sản phẩm.
• Nhắc lịch hẹn tự động:
  • Luồng chạy: Phần mềm quản lý lịch hẹn đến ngày hẹn → Hệ thống gọi Bot API → Smax gửi tin nhắn: "Chào bạn, đừng quên cuộc hẹn tư vấn vào 9h sáng mai nhé!"

---

🛠 Hướng dẫn thiết lập chi tiết

Để triển khai Bot API, bạn cần thực hiện cấu hình trên Smax theo 3 bước sau:

Bước 1: Chọn Trigger

Trong danh sách các trigger có sẵn, bạn tìm và chọn trigger Bot API.

Bước 2: Cấu hình thông số

Tại đây, bạn thiết lập các thông tin định danh để Smax biết cần gửi tin nhắn đến ai và thông qua kênh nào:

1. Kênh áp dụng: Chọn nền tảng bạn muốn gửi tin (ví dụ: Zalo, Messenger...).
2. Loại Token: Lựa chọn mã xác thực bảo mật phù hợp với hệ thống của bạn (để đảm bảo chỉ hệ thống của bạn mới có quyền ra lệnh cho Smax).
3. Loại khách hàng: Xác định đối tượng khách hàng sẽ nhận tin nhắn.

Lưu ý: Cách thiết lập các thông số này tương tự như khi bạn cấu hình trigger Bot API cho Messenger.

Bước 3: Định danh khách hàng (Quan trọng)

Để tin nhắn gửi đúng người, hệ thống của bạn phải cung cấp chính xác Mã định danh của khách hàng đó trên nền tảng tương ứng.

---

👨‍💻 Ghi chú dành cho Kỹ thuật viên (Developer)

Vì Bot API yêu cầu kết nối giữa hai hệ thống, bạn hãy gửi thông tin sau cho đội ngũ kỹ thuật của mình:

1. Yêu cầu: Thiết lập một HTTP Request (thường là phương thức POST) gửi đến Endpoint của Smax.
2. Tham số bắt buộc: Cần truyền đúng access_token, customer_id (pid hoặc page_pid) và scenario_id (ID của kịch bản chatbot muốn kích hoạt).
3. Kiểm tra: Đảm bảo định dạng dữ liệu gửi đi là JSON và khớp với tài liệu kỹ thuật của Smax.

---

📖 Tài liệu tham khảo

Để tìm hiểu chi tiết hơn về cách vận hành và các thông số kỹ thuật cụ thể cho kênh Facebook, bạn có thể tham khảo hướng dẫn tại đây: BOT API