Broadcast API - Gửi tin nhắn đến Messenger của khách hàng
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 đến Messenger của khách hàng hoàn toàn miễn phí.
Điều kiện áp dụng:
- Bạn kết nối fanpage với Fchat
- Khách hàng nhắn tin vào page, sau đó để lại Email hoặc SĐT
- Thông tin khách hàng được đồng bộ từ Fchat về CRM / Website của bạn:
- User_id
- Page_id
- Phone
- ...
- Từ lúc này trở đi, bạn có thể gửi tin nhắn từ CRM / Website đến Messenger của khách hàng
Danh sách API:
1. API gửi tin nhắn trực tiếp
API URL: https://fchat.vn/api/v1/message/send
Method: POST
Header:
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN (Lấy giá trị token shop tại đây) |
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
|
JSON | 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
| code | msg |
|---|---|
| 200 | Thành công |
2. API lấy danh sách tin nhắn mẫu
Tin nhắn mẫu (Utility template) là tin nhắn được facebook duyệt có thể gửi cho khách hàng bất kỳ lúc nào. Bạn phải đăng ký và được duyệt trước khi sử dụng, xem thêm tại đây.
API URL: https://fchat-app.salekit.com:4039/api/v1/pages/utility/template
Method: POST
Header
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN (Lấy giá trị Token tại đây) |
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
| status | msg | data |
|---|---|---|
| 1 | OK |
JSON: [{
name: "Tên template",
template_id: "mã template",
variable_data: "danh sách biến"
}]
|
3. API gửi tin nhắn theo mẫu
API URL: https://fchat-app.salekit.com:4039/api/v1/broadcast/utility/send
Method: POST
Header
| Key | Value |
|---|---|
| Content-Type | application/json |
| Token | TOKEN (Lấy giá trị Token tại đây) |
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 | JSON | 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"
}
|
Lưu ý: user_id và template_id phải cùng fanpage (page_id)
Response
| status | msg |
|---|---|
| 1 | OK |