Bot API
Trigger Bot API giúp bạn chủ động gửi chatbot đến khách hàng từ các hệ thống khác, ví dụ như: website, form đăng ký, hệ thống bán hàng, CRM…
Hiểu một cách đơn giản: Khi một sự kiện xảy ra ở hệ thống bên ngoài, chatbot sẽ tự động nhắn tin cho khách hàng.
API là gì?
Bạn không cần biết kỹ thuật vẫn dùng được Trigger này. API có thể hiểu là: Một cách để hệ thống khác ra lệnh cho Smax.ai làm việcVí dụ: Khách gửi form trên website → Website “báo tin ” cho Smax.ai → Chatbot tự động nhắn tin cho khách hàngTrigger Bot API chính là cầu nối cho việc đó
Khi nào bạn nên dùng Trigger Bot API?
Bạn nên dùng trigger này khi:
Bạn muốn chatbot chủ động nhắn tin, không cần khách nhắn trước
Bạn có:
Website
Form đăng ký
CRM / phần mềm bán hàng
Bạn muốn:
Gửi tin xác nhận
Gửi kịch bản chăm sóc
Cá nhân hóa chatbot theo từng khách
Nếu bạn chỉ dùng chatbot trả lời tin nhắn khách gửi vào, bạn chưa cần trigger này.
Tổng quan cách hoạt động

Các bước tạo Trigger Bot API
Bước 1: Tạo Trigger Bot API
Vào danh sách Trigger
Chọn Bot API

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

Chọn kênh mà chatbot sẽ gửi tin cho khách (ví dụ: Facebook Messenger, Website, Zalo…) Chatbot sẽ nhắn tin cho khách qua kênh này
Bước 3: Chọn loại API Token

API Token (Khuyên dùng nếu bạn đã quen với API)
Chỉ sử dụng được cho riêng API được tạo ra do trigger đó, không sử dụng được cho API do trigger khác tạo ra
Ưu tiên sử dụng API này để đảm bảo bảo mật
Biz Token
Dùng chung cho nhiều API
Phù hợp khi có đội kỹ thuật quản lý
Bước 4: Chọn khách hàng

Ở phần Khách hàng, chọn Khách hàng của hệ thống. Khách hàng sẽ được xác định khi hệ thống bên ngoài gọi APIBước 5: (Không bắt buộc) Gán thông tin cho khách hàngBạn có thể gắn thêm thông tin cho khách khi chatbot được gửi.Ví dụ:
Nguồn khách = Website
Loại khách = VIP
Chiến dịch = Form đăng ký
Cách làm:

Chọn Thêm tại phần Đặt Attributes
Chọn Block kịch bản để gửi cho khách hàng khi gọi API
Chọn Lưu
Sau khi tạo xong Trigger thì làm gì?
Bạn cần làm các bước sau đây:
Sao chép thông tin APISau khi lưu trigger, hệ thống sẽ cung cấp cho bạn API để call tới block trong module Bot - Auto bao gồm:
Địa chỉ API (API URL): Địa chỉ để gửi yêu cầu đến Smax.ai
Token bảo mật: Mã bảo mật (Token) để Smax.ai biết yêu cầu này là hợp lệ
Body: Thông tin về khách hàng và dữ liệu muốn gửi kèm

Xác định khách hàng sẽ nhận tin nhắn
Trong phần nội dung mẫu (Body), có 2 thông tin quan trọng bạn cần điền:
pid: mã khách hàng
page_pid: kênh mà khách sẽ nhận tin nhắn (ví dụ: Fanpage Facebook)
Bạn có thể lấy giá trị pid và page_pid này trong module Khách hàng (xem hình dưới)

Tới bước này, nếu bạn là user không chuyên về kỹ thuật, hãy gửi Gửi API và Token cho đội kỹ thuật Nếu bạn là CS / PM, hãy dùng trigger này để thiết kế hành trình chăm sóc tự động.
Điều gì sẽ xảy ra khi API được gọi?
Chatbot sẽ gửi kịch bản đã chọn
Khách nhận được tin nhắn ngay
Hội thoại xuất hiện trong Livechat
Thông tin khách được lưu lại
Ví dụ thực tế:
Ví dụ 1: Form đăng ký
Khách điền form trên website
Chatbot tự động gửi: “Cảm ơn bạn đã đăng ký, mình có thể hỗ trợ gì thêm không?”
Ví dụ 2: Tạo đơn hàng
Đơn hàng được tạo trong hệ thống bán hàng
Chatbot tự động gửi: “Đơn hàng của bạn đã được ghi nhận”
Last updated