1. Hiểu đơn giản về Bot API

Bạn không cần là một chuyên gia kỹ thuật để vận hành Trigger này. Hãy hình dung API như một "người đưa tin" hoặc một "cầu nối":

Luồng hoạt động: Sự kiện tại hệ thống ngoài (Ví dụ: Khách điền Form) → Hệ thống ngoài báo cho Smax.ai qua API → Smax.ai kích hoạt chatbot nhắn tin cho khách.

2. Khi nào bạn nên sử dụng Trigger Bot API?

Hãy sử dụng Bot API khi bạn muốn chuyển từ thế "đợi khách nhắn" sang thế "chủ động tiếp cận" trong các trường hợp sau:

• Tăng tỷ lệ chuyển đổi từ Website/Landing Page: Gửi tin nhắn chào mừng hoặc tặng mã giảm giá ngay khi khách vừa đăng ký thông tin.
• Tự động hóa quy trình bán hàng: Gửi tin nhắn xác nhận đơn hàng ngay khi đơn hàng được tạo trên hệ thống quản lý bán hàng.
• Chăm sóc khách hàng tự động (CRM): Khi trạng thái khách hàng thay đổi (ví dụ: từ "Tiềm năng" sang "Đã chốt"), chatbot tự động gửi kịch bản hướng dẫn sử dụng sản phẩm.
• Cá nhân hóa trải nghiệm: Gửi nội dung khác nhau cho từng nhóm khách hàng dựa trên dữ liệu từ hệ thống bên ngoài.

Lưu ý: Nếu bạn chỉ cần chatbot trả lời khi khách hàng chủ động nhắn tin vào Fanpage/Zalo, bạn không cần sử dụng Trigger này.

3. Tổng quan cách hoạt động

4. Hướng dẫn chi tiết cách tạo Trigger Bot API

Bước 1: Khởi tạo Trigger

1. Truy cập vào danh sách Trigger.
2. Chọn Bot API.

Bước 2: Chọn kênh gửi tin

Chọn kênh mà bạn muốn chatbot gửi tin nhắn đến khách hàng (ví dụ: Facebook Messenger, Zalo, Website...).

Bước 3: Lựa chọn loại API Token

Tùy vào nhu cầu bảo mật và quản lý, bạn chọn một trong hai loại Token:

• API Token (Khuyên dùng): Mỗi Trigger sẽ có một Token riêng biệt. Điều này đảm bảo tính bảo mật cao nhất vì nếu một Token bị lộ, các Trigger khác vẫn an toàn.
• Biz Token: Một mã dùng chung cho nhiều API. Phù hợp cho các doanh nghiệp có đội ngũ kỹ thuật quản lý tập trung.

Bước 4: Xác định đối tượng khách hàng

Tại phần Khách hàng, chọn Khách hàng của hệ thống. Smax.ai sẽ xác định chính xác ai là người nhận tin dựa trên mã định danh mà hệ thống bên ngoài gửi sang khi gọi API.

Bước 5: Gán thuộc tính và Chọn kịch bản (Không bắt buộc)

Bạn có thể gắn thêm thông tin (Attributes) để phân loại khách hàng ngay khi họ được kích hoạt bởi API.

Ví dụ thực tế:

• Nguồn khách = Website
• Phân loại = VIP
• Chiến dịch = Khuyến mãi tháng 10

Cách thực hiện:

1. Nhấn Thêm tại phần Đặt Attributes.
2. Chọn Block kịch bản mà bạn muốn chatbot gửi cho khách hàng.
3. Nhấn Lưu.

5. Triển khai sau khi tạo Trigger

Sau khi lưu Trigger, bạn sẽ nhận được các thông tin kỹ thuật để kết nối với hệ thống bên ngoài.

Bước 1: Sao chép thông tin API

Hệ thống sẽ cung cấp cho bạn 3 thông tin quan trọng:

• API URL: Địa chỉ "đích" để hệ thống bên ngoài gửi yêu cầu đến.
• Token bảo mật: "Chìa khóa" để Smax.ai xác thực yêu cầu là hợp lệ.
• Body: Cấu trúc dữ liệu cần gửi kèm (bao gồm thông tin khách hàng).

Bước 2: Xác định định danh khách hàng

Để tin nhắn gửi đúng người, trong phần Body, bạn cần lưu ý 2 thông số:

• pid (Customer ID): Mã định danh duy nhất của khách hàng trên Smax.ai.
• page_pid (Page ID): Mã định danh của kênh/fanpage mà khách sẽ nhận tin.

Bạn có thể lấy các giá trị này trong module /vi/khach-hang.

---

💡 Hướng dẫn phối hợp với đội kỹ thuật (Dành cho CS/PM)

Nếu bạn không chuyên về kỹ thuật, đừng lo lắng. Bạn chỉ cần thực hiện các bước thiết lập trên Smax.ai, sau đó gửi yêu cầu cho đội Dev/Kỹ thuật theo mẫu sau:

Mẫu yêu cầu gửi Dev: *"Chào bạn, mình muốn thiết lập tự động gửi tin nhắn cho khách. Khi có sự kiện [Tên sự kiện, ví dụ: Khách nhấn Đăng ký trên Web], bạn hãy gọi API sau giúp mình:

• URL: [Dán API URL vào đây]
• Token: [Dán Token vào đây]
• Dữ liệu gửi kèm: Gửi kèm pid và page_pid của khách hàng tương ứng. Cảm ơn bạn!"*

---

6. Ứng dụng thực tế

Để giúp bạn hình dung rõ hơn, dưới đây là 3 kịch bản ứng dụng Bot API mang lại hiệu quả cao:

Kịch bản 1: Tối ưu hóa Lead từ Landing Page

• Luồng: Khách điền Form đăng ký tư vấn → Hệ thống gọi Bot API → Chatbot nhắn tin: "Chào [Tên], Smax đã nhận được yêu cầu của bạn. Trong lúc chờ tư vấn viên, bạn có thể xem qua bảng giá tại đây..."
• Kết quả: Giữ chân khách hàng ngay lập tức, tránh việc khách quên hoặc chuyển sang đối thủ trong lúc chờ đợi.

Kịch bản 2: Tự động hóa xác nhận đơn hàng

• Luồng: Đơn hàng được tạo thành công trên CRM → Hệ thống gọi Bot API → Chatbot nhắn tin: "Đơn hàng #[Mã đơn] của bạn đã được ghi nhận thành công. Smax sẽ giao hàng đến bạn trong 2-3 ngày tới!"
• Kết quả: Giảm tải cho nhân viên trực chat, tăng sự chuyên nghiệp và tin tưởng cho khách hàng.

Kịch bản 3: Chăm sóc khách hàng theo phân loại

• Luồng: Nhân viên sale chuyển trạng thái khách thành "VIP" trên CRM → Hệ thống gọi Bot API → Chatbot gửi kịch bản đặc quyền dành riêng cho khách VIP.
• Kết quả: Cá nhân hóa trải nghiệm khách hàng, tăng tỷ lệ trung thành.

Điều gì sẽ xảy ra khi API được gọi thành công?

1. Chatbot gửi kịch bản bạn đã chọn đến khách hàng ngay lập tức.
2. Một hội thoại mới sẽ tự động xuất hiện trong phần Livechat để nhân viên có thể theo dõi và can thiệp khi cần.
3. Mọi thông tin Attributes bạn cài đặt sẽ được lưu vào hồ sơ khách hàng.