Hướng Dẫn Tích Hợp API Fchat: Gửi Tin Nhắn & Quản Lý Template Utility
Bạn có thể dễ dàng kết nối website, CRM hoặc hệ thống quản lý đơn hàng của mình với Fchat để gửi thông báo, mã đơn hàng hoặc nội dung cá nhân hóa đến khách hàng chỉ trong tích tắc.
1. API Gửi Tin Nhắn Trực Tiếp (Message Send)
Sử dụng API này để gửi tin nhắn văn bản hoặc hình ảnh trực tiếp cho khách hàng thông qua Token Shop
Sử dụng phương thức POST với URL và các tham số như dưới đây:
https://fchat.vn/api/v1/message/send
Tất cả các request đến API service của Fchat sẽ được xác thực theo giá trị "Token" trong header của request
Lấy giá trị Token tại đây
Header
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN |
Nội dung param
| Tên tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| user_id | String | Có | User_id khách hàng trên hệ thống Fchat.vn |
|
message
|
Array | Có |
Mảng các tin nhắn muốn gửi Ví dụ: - Gửi text: [{"text":"Hello"}] - Gửi ảnh: [
{
"attachment": {
"type": "image",
"payload": {
"url": "LINK_ANH"
}
}
}
]
|
|
block_id
|
String | Không |
Block ID trên Fchat.vn |
Response
| Tham số | Giá trị |
|---|---|
| code | 200 |
| msg | Thành công |
2. API Quản Lý Template Utility (Tin nhắn tiện ích)
Trước khi gửi tin nhắn Utility, bạn cần lấy danh sách các mẫu (template) đã được phê duyệt.
Sử dụng phương thức POST với URL và các tham số như dưới đây:
https://fchat-app.salekit.com:4039/api/v1/pages/utility/template
Tất cả các request đến API service của Fchat sẽ được xác thực theo giá trị "Token" trong header của request
Lấy giá trị Token tại đây
Header
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN |
Params
| Tên tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| page_id | String | Có | ID page trên hệ thống Fchat.vn |
Response
| Tham số | Giá trị |
|---|---|
| status | 1 |
| msg | OK |
|
data
|
Danh sách template name: Tên template
template_id: mã template
variable_data: danh sách biến
|
3. API Gửi Tin Nhắn Utility Theo Mẫu
Sau khi có template_id, bạn có thể gửi tin nhắn thông báo tự động (như mã đơn hàng, lịch hẹn) cho khách hàng
Sử dụng phương thức POST với URL và các tham số như dưới đây:
https://fchat-app.salekit.com:4039/api/v1/broadcast/utility/send
Tất cả các request đến API service của Fchat sẽ được xác thực theo giá trị "Token" trong header của request
Lấy giá trị Token tại đây
Header
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN |
Body
| Tên tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| page_id | String | Có | ID page trên hệ thống Fchat.vn |
| user_id | String | Có |
ID của người dùng |
| template_id | String | Có |
ID mẫu template |
| variable_data | Object | Không |
Mảng chứa các biến thay thế trong mẫu Ví dụ: {
"order_code": "100",
"event_id": 1,
"event_name": "Tết nguyên đán"
}
|
Response
| Tham số | Giá trị |
|---|---|
| status | 1 |
| msg | OK |
|
result
|
Kết quả gửi tin recipient_id: ID người nhận
message_id: ID tin nhắn
|
Xem thêm: Cách sử dụng License Key để kích hoạt gói dịch vụ Fchat.