> For the complete documentation index, see [llms.txt](https://tailieu.smax.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tailieu.smax.ai/bot-auto/trigger/facebook/bot-api.md).

# Bot API

{% hint style="info" %}
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…
{% endhint %}

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**

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F7KLrA3r54e47nKEYWhrL%2FScreenshot%202026-01-19%20at%2014.19.57.png?alt=media&amp;token=9869e861-f79d-4af8-aa53-0ad5cd254014" alt=""><figcaption></figcaption></figure>

### **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

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FIi0WMVNySx1WJ4pmE62T%2Fimage.png?alt=media&amp;token=5e95ff54-7c76-4706-86a2-496d08a20ada" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FbC3A7cWWW23VjblCJUWM%2Fimage.png?alt=media&amp;token=143f1193-0c64-42a5-a63a-acc440ccc7fb" alt=""><figcaption></figcaption></figure>

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**

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FQLlZxTfOZBMdGBUbiRmR%2Fimage.png?alt=media&amp;token=f1f0a17a-7cc2-4baf-be74-fc71a3a66157" alt=""><figcaption></figcaption></figure>

**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**

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FSqlgALajhBG5Yv0tUc3p%2Fimage.png?alt=media&amp;token=cf647602-4088-4f55-8bbb-1193b670c883" alt=""><figcaption></figcaption></figure>

Ở 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 API**Bước 5: (Không bắt buộc) Gán thông tin cho khách hàng**Bạ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:

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F7VJpp0g1NGI4yS8SNYNZ%2Fimage.png?alt=media&amp;token=43e2362a-500c-43b1-979a-7fa57d2fe5dd" alt=""><figcaption></figcaption></figure>

1. Chọn Thêm tại phần Đặt Attributes
2. Chọn Block kịch bản để gửi cho khách hàng khi gọi API
3. 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:

1. 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

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FzBko5ababfN8kVjCYyso%2Fimage.png?alt=media&amp;token=a4584168-3497-495b-9c90-5a73083798b3" alt=""><figcaption></figcaption></figure>

2. 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)

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F9lg0rnJu8VxAsA6YfDmO%2Fimage.png?alt=media&amp;token=a33ea527-ffb3-41b7-9a36-b07af35625e5" alt=""><figcaption></figcaption></figure>

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”