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

Trigger Bot API là "cầu nối" cho phép các hệ thống bên ngoài (như Website, CRM, App, Phần mềm quản lý bá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ì phải thao tác thủ công, Bot API giúp tự động hóa luồng chăm sóc khách hàng ngay lập tức dựa trên các hành động thực tế của khách hàng trên hệ thống của bạn.

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

Bạn hãy sử dụng Bot API khi muốn gửi tin nhắn tự động dựa trên một hành động của khách hàng diễn ra ngoài hệ thống Smax.

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

• Xác nhận đơn hàng:
  • Luồng chạy: Khách bấm "Đặt hàng" trên Website → Website gọi API → Smax gửi tin nhắn: "Chào [Tên], đơn hàng #123 của bạn đã được tiếp nhận!".
• Thông báo thanh toán:
  • Luồng chạy: Cổng thanh toán báo "Thành công" → Gọi API → Smax gửi tin nhắn: "Bạn đã thanh toán thành công gói dịch vụ, hãy bắt đầu trải nghiệm ngay!".
• Nhắc lịch hẹn:
  • Luồng chạy: Phần mềm phòng khám đến giờ hẹn → Gọi API → Smax gửi tin nhắn nhắc lịch cho khách hàng.

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

Để tạo một Trigger Bot API, bạn thực hiện theo 3 bước sau:

Bước 1: Chọn loại Trigger Trong danh sách các Trigger, bạn tìm và chọn Bot API.

Bước 2: Cấu hình thông tin chi tiết

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, Instagram...).
3. Cài đặt thời gian chạy (Tùy chọn): Thiết lập khung giờ cho phép API hoạt động (Ví dụ: Chỉ gửi từ 8h sáng đến 22h đêm để tránh làm phiền khách hàng).
4. Lựa chọn Token bảo mật: Đây là "chìa khóa" để hệ thống bên ngoài xác thực và gọi được API của bạn.
   • API Token (Khuyên dùng): Mỗi Trigger có một mã riêng. Nếu một mã bị lộ, các Trigger khác vẫn an toàn.
   • Biz Token: Một mã dùng chung cho toàn bộ API trong doanh nghiệp. Tiện lợi khi cài đặt nhiều Trigger nhưng mức độ bảo mật thấp hơn.
5. Chọn Block nội dung: Chọn kịch bản/tin nhắn bạn muốn gửi đi.
   • Mẹo: Để tin nhắn cá nhân hóa (ví dụ hiện đúng Tên, Mã đơn hàng), bạn hãy sử dụng các biến trong Block nội dung để khớp với dữ liệu mà hệ thống bên ngoài truyền sang.

Bước 3: Lưu và Hoàn tất Nhấn Lưu để hệ thống khởi tạo đường dẫn API.

👨‍💻 Hướng dẫn bàn giao cho Kỹ thuật viên (Developer)

Sau khi nhấn Lưu, Smax sẽ cung cấp cho bạn một Đường dẫn API (URL) và Mã Token. Vì đây là thao tác kỹ thuật, bạn hãy gửi thông tin cho Developer của mình theo mẫu sau để họ tích hợp nhanh nhất:

Nội dung gửi Developer: "Chào bạn, mình muốn tích hợp gửi tin nhắn tự động từ [Tên hệ thống của bạn] sang Smax. Bạn giúp mình cấu hình gọi API theo thông tin sau:

• API URL: [Dán đường dẫn API tại đây]
• Token: [Dán mã Token tại đây]
• Yêu cầu: Khi có sự kiện [Ví dụ: Đặt hàng thành công], hãy gọi API này và truyền kèm các thông tin khách hàng như [Tên, Số điện thoại, Mã đơn hàng...]."

📌 Lưu ý quan trọng

• Bảo mật: Luôn ưu tiên sử dụng API Token cho các luồng dữ liệu quan trọng của doanh nghiệp.
• Truyền dữ liệu: Để tin nhắn hiển thị đúng thông tin riêng của từng khách hàng, hãy đảm bảo Developer truyền đúng tên biến mà bạn đã thiết lập trong Block nội dung.
• Xem thêm: Nếu bạn muốn truyền dữ liệu từ form Webcake vào bot, hãy tham khảo tài liệu về Webcake.