# Tổng quan API
# Bắt đầu
## 1. Đăng nhập : [Https://botbanhang.vn/page](https://dev.botbanhang.vn/chatbox/website/untitled)
Màn hình đăng nhập
## 2. Chọn "Chatbot"
# JSON API
Chatbot API
JSON API cho phép bạn gửi request dưới dạng POST (thời gian chờ là 5s) để:
* Tạo nội dung động (gửi các tin nhắn từ CMS hay CRM của bạn đến khách hàng)
* Lưu thông tin khách hàng vào google sheet hoặc lấy thông tin từ google sheet ra cho khách hàng
* Chuyển hướng khách hàng đến các kịch bản khác
* Lưu và cài đặt thuộc tính (attribute) cho khách hàng, ví dụ như điểm thưởng, hành trình,...
## Cú pháp
* URL: `https://api.botbanhang.vn/v1.3/public/json?access_token={{accessToken}}&psid={{clientID}}`
* HEADERS:
`Content-Type: application/json`
* Giải thích các tham số trong URL:
`{{accessToken}}: là mã xác thực trang trong phần "Thiết lập chung". Nếu chưa có mã xác thực thì chỉ cần nhấn Tạo mã mới.`
`{{ clientID}}: là ID của người dùng trên trang. Dùng $ để gọi clientID người dùng trên trang.`
## Các mẫu tham khảo
### 1. Gửi văn bản
Sử dụng mẫu này để gửi tin nhắn văn bản. API ví dụ:
```
{
"messages": [
{"text": "Chào mừng bạn đến với Bot Bán Hàng!"},
{"text": "Chúng tôi có thể giúp gì cho bạn?"}
]
}
```
**Kết quả test từ Postman**
### 2. Gửi hình ảnh
Sử dụng mẫu này để gửi tập tin hình ảnh. Messenger hỗ trợ hình ảnh JPG, PNG và GIF. Nếu bạn gặp sự cố với hình ảnh GIF, vui lòng thử giảm kích thước tệp. API ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "image",
"payload": {
"url": "https://botbanhang.vn/images/logo.png"
}
}
}
]
}
```
### 3. Gửi video
Sử dụng mẫu này để gửi các tập tin video. Messenger hỗ trợ video MP4, có dung lượng lên tới 25MB. API Ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "video",
"payload": {
"url": "https://www.sample-videos.com/video123/mp4/720/big_buck_bunny_720p_5mb.mp4"
}
}
}
]
}
```
Bạn cũng có thể trực tiếp sử dụng Bài đăng trên Facebook với phương tiện truyền thông thay vì tải lên thủ công API Ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "video",
"url": "https://www.facebook.com/unofficial.abio/videos/2593801767328577/",
"buttons": [
{
"title": "Truy cập Bot Bán Hàng!",
"type": "web_url",
"url": "https://botbanhang.vn/"
}
]
}
]
}
},
"quick_replies": [
{
"title": "Tuyệt!",
"set_attributes": {
"feedback": "Cool!"
}
},
{
"title": "Không hay!",
"set_attributes": {
"feedback": "Not good!"
}
}
]
}
]
}
```
### 4. Gửi âm thanh
Sử dụng mẫu này để gửi tập tin âm thanh. Messenger hỗ trợ âm thanh MP3, OGG, WAV, có dung lượng lên tới 25MB. API Ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "audio",
"payload": {
"url": "https://www.sample-videos.com/audio/mp3/wave.mp3"
}
}
}
]
}
```
### 5. Gửi tập tin
Sử dụng mẫu này để gửi bất kỳ tệp nào khác, không lớn hơn 25 MB. API Ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "file",
"payload": {
"url": "https://www.sample-videos.com/pdf/Sample-pdf-5mb.pdf"
}
}
}
]
}
```
### 6. Gửi thẻ ảnh ngang
Sử dụng mẫu này để gửi một bộ sưu tập cuộn ngang. Mỗi mục bao gồm một tệp đính kèm hình ảnh, mô tả ngắn và các nút để yêu cầu người dùng bấm vào. API Ví dụ:
```
{
"messages": [
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"image_aspect_ratio": "square",
"elements":[
{
"title":"ÁO PHÔNG NAM DÀI TAY",
"image_url":"https://canifa.s3.amazonaws.com/media/catalog/product/8/t/8tl18w007-sb505-34.jpg",
"subtitle":"Size: M",
"buttons":[
{
"type":"web_url",
"url":"https://botbanhang.vn",
"title":"Xem chi tiết"
}
]
},
{
"title":"ÁO PHÔNG NAM DÀI TAY",
"image_url":"https://canifa.s3.amazonaws.com/media/catalog/product/8/t/8tl18w007-sb505-33-.jpg",
"subtitle":"Size: L",
"default_action": {
"type": "web_url",
"url": "https://botbanhang.vn",
"messenger_extensions": true
},
"buttons":[
{
"type":"web_url",
"url":"https://botbanhang.vn",
"title":"Xem chi tiết"
}
]
}
]
}
}
}
]
}
```
### 7. Nút bấm
Sử dụng JSON này để thêm các nút vào câu trả lời của bạn. Bạn có thể đặt các nút để liên kết đến một kịch bản khác, mở trang web hoặc gửi yêu cầu api khác. Mỗi tin nhắn được giới hạn 3 nút bấm. API Ví dụ:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "button",
"text": "Hello!",
"buttons": [
{
"type": "show_block",
"block_names": ["ID Kịch bản"],
"title": "Hiện kịch bản"
},
{
"type": "web_url",
"url": "https://botbanhang.vn",
"title": "Truy cập Website"
},
{
"url": "https://fb.com/groups/botbanhang",
"type":"web_url",
"title":"Tham gia cộng đồng"
}
]
}
}
}
]
}
```
Bạn cũng có thể sử dụng nút Gọi, nút này quay số điện thoại khi nghe. API ví dụ:
```
{
"messages":[
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Thông tin liên lạc",
"image_url":"https://ayokaflowers.com/wp-content/uploads/2017/08/contact-us.png",
"subtitle":"Hãy liên hệ chúng tôi để được trợ giúp!",
"buttons":[
{
"type":"phone_number",
"phone_number":"+84763874340",
"title":"Gọi"
}
]
}
]
}
}
}
]
}
```
### 8. Trả lời nhanh
Sử dụng JSON này để thêm trả lời nhanh cho câu trả lời của bạn. Mỗi tin nhắn được giới hạn 11 mục Trả lời nhanh. API Ví dụ:
```
{
"messages": [
{
"text": "Bạn có muốn tiếp tục sử dụng sản phẩm Bot Bán Hàng?",
"quick_replies": [
{
"title":"Có!",
"block_names": ["ID kịch bản 1"]
},
{
"title":"Không!",
"block_names": ["ID kịch bản 2", "ID kịch bản 3"]
},
{
"title":"Đang xem xét...",
"url": "http://www.mocky.io/v2/5d761dc33200002d0029789b",
"type":"json_plugin_url"
}
]
}
]
}
```
Bạn cũng có thể lưu **attribute** (thuộc tính) từ tùy chọn của người dùng. Ví dụ nếu người dùng bấm vào **Sữa** thì sẽ lưu **milk** vào attribute ** drink**, còn nếu người dùng bấm vào **Cà phê** thì sẽ lưu **coffee** vào attribute **drink** API Ví dụ:
```
{
"messages": [
{
"text": "Bạn muốn gọi sữa hay cà phê?",
"quick_replies": [
{
"title": "Sữa",
"set_attributes": {
"drink": "milk"
}
},
{
"title": "Cà phê",
"set_attributes": {
"drink": "coffee"
}
}
]
}
]
}
```
### **9. Cài đặt thuộc tính (attributes) cho người dùng**
Sử dụng JSON này để đặt **thuộc tính** người dùng mà cần người dùng bấm vào bất kỳ nút nào. API Ví dụ:
```
{
"set_attributes":
{
"thanhpho": "Hà Nội",
"email": "tien@botbanhang.vn",
"dienthoai": "0763874340"
},
"block_names": ["5c6796a21e622d0d48fd5645"],
"type": "show_block",
"title": "Go!"
}
```
Hoặc cài đặt **thuộc tính** người dùng kèm theo tin nhắn (văn bản, hình ảnh...) API Ví dụ:
```
{
"set_attributes":
{
"text 1": "some value",
"text 2": "another value",
"number 1": 1,
"number 2": 2
},
"messages":[
. . .
]
}
```
Hoặc cài đặt **thuộc tính** người dùng mà không kèm theo tin nhắn (văn bản, hình ảnh...) API Ví dụ:
```
{
"set_attributes":
{
"text 1": "some value",
"text 2": "another value",
"number 1": 1,
"number 2": 2
},
"messages":[
{"text": ""}
]
}
```
### 10. Chuyển hướng đến các kịch bản khác
Bạn có thể chuyển hướng người dùng đến một kịch bản hoặc đến một chuỗi các kịch bản - không cần hành động của người dùng. API Ví dụ:
```
{
"redirect_to_blocks": ["5c6796a21e622d0d48fd5645", "5c9b9a39f60b4f001164aca2"]
}
```
# Get Attributes
Cho phép bạn lấy các thuộc tính người dùng để đưa ra các hệ thống thứ ba.
## Cú pháp
* URL: `https://api.botbanhang.vn/v1.3/public/ clients?access_token={{accessToken}}&psid={{clientID}}`HEADERS:
* `Content-Type: application/json`
* Giải thích các tham số trong URL:
`{{accessToken}}: là mã xác thực trang trong phần "Thiết lập chung". Nếu chưa có mã xác thực thì chỉ cần nhấn Tạo mã mới.`
`{{ clientID}}: là ID của người dùng trên trang. Dùng $ để gọi clientID người dùng trên trang.`
##
Last updated 3 months ago
# Bot Bán Hàng Pixel
Bot Bán Hàng Pixel (BBH Pixel) giúp bạn tracking người dùng và quản lý tập trung các Lead (thông tin khách hàng tiềm năng) từ các kênh : Website, BotUp, Selling Page, Tiktok, Server API ... về 1 nơi.
## Chức năng
* Tích hợp chạy chuyển đổi các kênh: Chatbot Messenger, Facebook, Tiktok, Google, Zalo, Instagram, Youtube, Landing Page, Selling Page ...
* Tương thích với : Chatbot, BotUp, Wordpress, WooCommerce, Shopify ...
* Tự động thông báo khi khách hàng click vào nút bấm chứa Link trên Chatbot Messenger.
* Tự động đồng bộ UTM có trên URL.
* Tự động gắn UTM từ URL vào Chatbot nếu trong website chứa link **m.me**
* Tự động đồng bộ với các nút bấm chứa link trong Chatbot Bán Hàng.
* Tự động thông báo **khi khách hàng sau 1 thời gian (2 tuần / 1 tháng / 3 tháng...) quay trở lại** Website / LandingPage / Selling Page.
* Tự động tạo các thông tin Lead Form: Tên, số điện thoại, email, địa chỉ, ghi chú, thời gian xem trang.
* Tự động thống kê đo lường chuyển đổi khi khách hàng để lại thông tin. (ấn Submit Form).
* Số lượng sự kiện (miễn phí) : 10 sự kiện tin nhắn / 1 hội thoại.
## Cài đặt vào Website
Nhúng Code bên dưới vào trong trước thẻ **\** của HTML. Thay **\