# Tìm hiểu về ChatBot
Tài liệu hướng dẫn sử dụng Smax.bot
### Chatbot là gì?
Hiểu đơn giản chatbot là một con robot :robot: giúp bạn trò chuyện (chat) với khách hàng một cách tự động theo kịch bản mà bạn đã cài đặt sẵn.
Chatbot có thể hoạt động trên bất kỳ trình nhắn tin nào (**FB messenger**, Zalo, Wechat...) thậm chí là cả SMS các bạn đang sử dụng để nhắn tin hằng ngày cho mục đích Marketing và chăm sóc khách hàng.
(Trong khuôn khổ tài liệu này chúng ta chỉ tìm hiểu về chatbot cho **FB messenger**)
{% hint style="info" %}
VD: Tổng đài trả lời tự động các bạn gọi lên hằng ngày cũng có thể hiểu như 1 loại bot, nhưng là tương tác bằng giọng nói chứ ko phải bằng chữ viết.
{% endhint %}
### Có nên sử dụng Chatbot để chăm sóc khách hàng?
Có nhiều người quan niệm rằng chi phí marketing (FB ads...) để mang lại 1 khách hàng ngày càng lớn. Nên việc để khách hàng cho 1 "con bot" vô thức chăm sóc là điều không nên.
Đúng là việc giao khách hàng cho 1 "con bot" chăm sóc là điều không nên, nhưng nếu chúng ta chỉ tận dụng chat bot trong một vài quy trình chăm sóc khách hàng thì mọi thứ sẽ hoàn toàn khác:
{% hint style="info" %}
VD1: Đối với shop bán hàng 1 ngày các bạn nhận được bao nhiêu câu hỏi về : chương trình khuyến mãi tháng này, chính sách đổi trả, địa chỉ cửa hàng, giờ mở cửa...
*Nếu các thông tin này các bạn chuyển cho bot trả lời, thì nhân viên sẽ giảm thiểu được khối lượng công việc rất nhiều, tập trung cho việc chăm sóc về chuyên môn.*
{% endhint %}
{% hint style="info" %}
VD2: Bạn có 1 sản phẩm mới, hoặc 1 khuyến mãi bạn muốn gửi tin nhắn giới thiệu kèm ưu đãi tới tất cả khách hàng cũ của mình?
*Chatbot làm điều đó chỉ với 1 nốt nhạc khi nhân viên của bạn vẫn đang tìm lại từng khách một và nhắn tin cho họ.*
{% endhint %}
{% hint style="info" %}
VD3: Nhân viên của bạn không thể 24/24 để ngồi trả lời khách hàng, khi có 1 khách vào hỏi giá sản phẩm, nếu họ đợi quá lâu họ sẽ mua của cửa hàng khác.
*Chatbot làm việc ngay cả khi bạn không ngồi trước máy tính. Sáng, trưa, chiều, tối bất kể nắng mưa :D. Có thể bạn không cần sử dụng bot để chốt sale luôn với khách, mà chỉ cần:*\
*"hiện tại bà chủ xinh đẹp của tôi đang đi vắng, quý khách vui lòng để lại sđt ngày mai sẽ bà chủ sẽ gọi điện tư vấn cho bạn" → khách sẽ yên tâm mà đợi hơn là ko có 1 tín hiệu hồi âm nào từ shop.*
{% endhint %}
### Tính chất chatbot
***Nhanh chóng:*** Chatbot tương tác lại với khách hàng gần như ngay lập tức sau khi tiếp nhận thông tin.
***Mạnh mẽ:*** Chatbot có thể chăm sóc cùng 1 lúc hàng triệu, thậm chí hàng tỉ khách hàng.
***Chính xác:*** Chatbot làm việc 1 cách chính xác với những gì bạn đã thiết lập sẵn cho nó.
***Không nghỉ:*** Chatbot có thể làm việc 24/7, 365 ngày 1 năm mà không ngừng nghỉ 1 phút giây nào.
Chính những tính chất này mà chatbot đem lại rất nhiều lợi ích đáng giá cho người sử dụng:
* **Tiết kiệm sức người, chi phí cho nhân sự** cho những việc tư vấn lặp đi lặp lại nhàm chán (một số lĩnh vực kinh doanh có sự lặp lại như Thời Trang, nội thất...)
* **Phân loại khách hàng và Remarketing**: Bằng cách gắn thẻ để phân loại nhóm khách hàng, rồi gửi tin nhắn trực tiếp. Bạn có thể tiết kiệm rất nhiều chi phí và tăng hiệu quả chuyển đổi đó.
* **Tăng tính chuyên nghiệp của thương hiệu**: tạo ra những trải nghiệm cá nhân hóa cho khách hàng (chúc mừng khách nhân ngày lễ tết, thời tiết, chúc mừng sinh nhật...)
* **Giúp đo lường hiệu quả chiến dịch quảng cáo của Agency:** Đặc biệt dành cho việc đo lường khách ở điểm bán, nếu không có chatbot rất khó để công nhận doanh số đến từ Fb ads cho cửa hàng.
### **VD về tính ứng dụng?**
Chatbot ứng dụng được rất nhiều trong việc tương tác, bán hàng, chăm sóc khách hàng ở tất cả mọi loại hình dịch vụ kinh doanh online có trên thị trường.
> Một shop bán hàng cho phép xem sản phẩm, đặt hàng.
>
> Một khách sạn cho phép book phòng và tra cứu thông tin giá phòng.
>
> Một đại lý vé máy bay cho phép check và đặt vé.
>
> Một đơn vị vận chuyên dùng chatbot để chăm sóc vận đơn.
>
> Một trung tâm giáo dục dùng chatbot để nhắc lịch học, lịch thi...
>
> v.v…
***Sẽ còn vô vàn những điều mà chatbot có thể làm được; điều chúng ta cần là khám phá và sử dụng chúng giúp cho cuộc sống tốt hơn!***
# Công cụ Smax.bot
Giới thiệu về nền tảng Chatbot by Smax - Smax.bot - VIK Solutions.
[***Smax.bot***](https://smax.bot/) ***là nền tảng công cụ*** [***chatbot***](https://tailieu.smax.bot/) ***được phát triển bởi VIK Solutions giúp bạn xây dựng kịch bản tương tác, chăm sóc khách hàng của mình trên fanpage (VD: Chatfuel, manychat...)***
**Smax.bot** là 1 sản phẩm của đội ngũ startup người Việt đã gắn bó cùng nhau suốt hơn 10 năm. Với bằng ấy thời gian phát triển về lập trình phần mềm, và hơn 6 năm về phát triển các ứng dụng marketing, chăm sóc khách hàng, quản lý bán hàng online...
### Nền tảng với những gì tinh túy nhất.
**Smax.bot** học hỏi và phát triển những tính năng tốt nhất từ nhu cầu thị trường, để tạo nên 1 sản phẩm đột phá, thông minh, sáng tạo, tính ứng dụng cực cao... Mang đến trải nghiệm dễ dàng nhất có thể cho người dùng tiếp cận với lĩnh vực Chatbot.
### Cộng đồng Agency đông đảo nhất.
**Smax.bot** được cộng đồng Agency trên khắp Việt Nam tin tưởng sử dụng để cung cấp cho các khách hàng của mình. Từ các bên làm về dịch vụ Ads, marketing, content, edu, các Speaker.
# Các thuật ngữ
Các thuật ngữ trong quá trình sử dụng Smax.Bot
### 1. Chatbot:
Là 1 con robot tự động trả lời, tương tác giao tiếp với khách hàng dựa trên những gì bạn đã thiết lập sẵn.
### **2. Fanpage:**
Là một tài khoản fanpage của Facebook kết nối với chatbot để chatbot có thể giao tiếp với khách hàng của fanpage.
{% hint style="info" %}
VD: Chatbot giống như 1 nhân viên chăm sóc khách hàng bạn thuê về, để họ có thể nói chuyện với khách trên fanpage thì bạn phải kết nối nhân viên đó vào fanpage của bạn
{% endhint %}
### 3. Kịch bản:
Là tất cả những gì bạn thiết lập cho 1 con bot sẽ tương tác với khách hàng của mình (trải nghiệm của khách hàng có với fanpage có tốt hay không là do người thiết lập).
{% hint style="info" %}
VD: bạn xây dựng 1 cái khách sạn và bạn sẽ phải thiết lập khách sạn đó có chức năng gì, vận hành ra sao, giao tiếp phục vụ khách hàng thế nào.
{% endhint %}
### **4. Element** (Card/ thẻ) và **Block** (khối)
**Element** (Card/ thẻ) là một công việc (chức năng) cụ thể mà bot sẽ làm (gửi ảnh, gửi nội dung, gửi tùy chọn, lưu thông tin...). Trong khung màu đỏ (hình dưới) là list các **Element** (Card/ thẻ) bạn có thể sử dụng.
{% hint style="info" %}
VD: Hiểu nôm na nó là các vật mà bạn dùng để xây nên các khách sạn của mình, mỗi vật sẽ có các chức năng riêng (bàn ăn để ăn, giường để ngủ, vòi hoa sen để tắm...)
{% endhint %}
**Block** là tập hợp các **Element** (hình trên là giao diện khi chỉnh sửa 1 block, bạn có thể thấy block được xây dựng bởi tập hợp các Element)
Trong hình dưới hình số 1 là giao diện 1 block ở khu vực quản lý, hình 2 là giao diện block ở khu vực mindmap. Các bạn click vào icon (số 3) để chỉnh sửa 1 block.
{% hint style="info" %}
VD: Nếu vẫn là câu chuyện khách sạn thì bạn cứ hiểu block là 1 cái phòng chứa các vật dụng (Element) (phòng ăn có bàn ăn, có bát có đũa/ phòng ngủ có giường có chiếu, có chăn...phòng tắm có bồn tắm vòi hoa sen)
{% endhint %}
* ***Welcome block:*** Đây là block mà người dùng sẽ gặp khi lần đầu tiên nhắn tin vào 1 fanpage.
* ***Default block:*** Đây là block mà trong quá trình chat với bot, người dùng nhắn 1 tin nào đó không trùng với bất kỳ kịch bản nào bạn đã thiết lập sẵn.
{% hint style="info" %}
VD: Welcome block bạn cứ hiểu là cái phòng lễ tân, khi bạn tới khách sạn lần đầu tiên thì luôn phải qua đó (còn khi bạn đã ở đó rồi thì sẽ ko cần mà cứ lên thẳng phòng của mình)
Default block giống như phòng chờ, nếu bạn tới khách sạn và phòng của bạn khai báo không khớp với phòng nào khách sạn đã có sẵn có bạn sẽ phải vào phòng chờ.
{% endhint %}
### **5.** Sequence (kịch bản chăm sóc tự động)
Là 1 quy trình tương tác với khách hàng mà bạn lên lịch sẵn. dùng để gửi một chuỗi các kịch bản chia theo thời gian đến khách hàng (Ví dụ: ngày 1 gửi kịch bản giới thiệu khóa học, ngày 2 gửi bài học đầu tiên...
{% hint style="info" %}
OK quay trở lại với câu chuyện khách sạn, bạn sẽ tạo ra 2 kịch bản chăm sóc khách hàng là **ĂN** và **SPA**.
Kịch bản ăn: Khi khách hàng đăng ký 1 tiếng sau bạn sẽ đưa khách vào phòng ăn để khách ăn, 30 phút sau bạn sẽ đưa khách sang phòng uống nước, 15 phút sau bạn đưa khách ra ban công hóng gió...
Kịch bản Spa: 15 phút bạn đưa khách vào phòng xông hơi, 20 phút sau đưa vào phòng spa da mặt, 15 phút sau đưa qua phòng foot massage...
{% endhint %}
### **6. Gửi broadcast:**
#### Là chức năng gửi tin nhắn hàng hoạt tới khách hàng của mình.
{% hint style="info" %}
VD: Ở khách sạn thì bạn có thể dùng loa để phát tới tất cả khách hàng.
{% endhint %}
### **7. Khách hàng:**
Là tất cả những người (nick Facebook) đã tương tác với fanpage của bạn qua inbox.
### **8. Attribute** (custom field):
Là thuộc tính của 1 khách hàng
* **System Attribute**: Là các thuộc tính của khách hàng do hệ thống tự sinh ra mà bạn không thể sửa được (VD: giới tính, thời gian vào bot, số tin nhắn đã nhắn, fullname (FB trả về theo tài khoản FB của khách)
* **Custom Attribute**: Là các thuộc tính của khách hàng do bạn tự đặt trong quá trình xây dựng bot (khách này ở đâu, đã mua gì, mua bao nhiêu, số điện thoại, địa chỉ ship hàng...)
### **9. HÀM**
Là 1 đoạn cú pháp để thực hiện 1 chức năng nào đó.
VD: 2 hình dưới mình sử dụng hàm **UPPER** để viết hoa toàn bộ tên của user, hoặc dùng hàm **GENDER** để hệ thống tự nhận dạng cách xưng hô với khách hàng.
### 10. Reflink
Ref link là 1 đường dẫn có định dạng [https://m.me/\[IDPAGE\]**?ref=Welcome-Block**](https://m.me/116264036416212?ref=SanPham) dùng để truy cập trực tiếp vào 1 block nào đó (nếu user không vào qua reflink thì sẽ phải đi qua welcome block)
*Reflink ngoài việc rất hữu ích cho tính năng test trong quá trình xây dựng block thì còn rất mạnh trong việc triển khai các chiến dịch và đo lường.*
# Các Menu chính
Các menu tính năng chính của Smax.bot
### 1. Kịch Bản
Nơi xây dựng kịch bản chính của chatbot, quản lý các block tính năng...
### 2. Keyword (Từ Khóa)
Nơi xây dựng kịch bản chatbot theo từ khóa.
### 3. Bot Menu
Cấu hình menu của Fanpage (sẽ hiển thị ở cửa sổ chat của khách hàng khi chat với Fanpage)
### 4. Kịch Bản Chăm Sóc
Xây dựng kịch bản tự động chăm sóc cho khách hàng
### 5. Khách Hàng
Quản lý những khách hàng đã inbox cho fanpage của bạn.
### 6. Gửi BroadCast
Tính năng gửi tin nhắn hàng loạt tới khách hàng.
### 7. Thống Kê
Thống kê lịch sử tương tác của khách hàng với bot.
### 8. Công Cụ
Khu vực quản lý các công cụ nâng cao cho chatbot.
### 9. Cấu Hình
Khu vực cấu hình chung - Kết nối bot với fanpage, quản lý admin...
# \_1.1 Tạo bot đầu tiên
Cùng bắt tay tạo ra con bot đầu tiên của bạn nào.
## 1. Truy cập Smax.bot và đăng nhập
Có 2 cách đăng nhập vào Smax.bot
**1. Click vào Đăng Nhập**
**2. Click vào "Thử nghiệm miễn phí"**
## 2. Liên kết với Facebook
* Sau khi click login hệ thống sẽ hiện ra một popup để bạn cung cấp những quyền fanpage cho **Smax.bot**. Chọn "Tiếp tục dưới tên ..." để liên kết Smax.bot với facebook của bạn
* Chọn đăng nhập tài khoản khác nếu tài khoản facebook không phải của bạn.
* Tiếp đến sẽ tới trang tích hợp fanpage vào **Smax.bot**. Bạn hãy chọn những fanpage muốn tích hợp chatbot nhé. Nếu muốn chọn hết và mỗi khi tạo page mới sẽ tự động cập nhật với Smax.bot thì bấm "Chọn tất cả".
* Tiếp đến là những quyền mà Smax muốn bạn cung cấp để hoạt động được trên fanpage của bạn.
Bạn có thể bỏ **chọn** nếu không muốn cung cấp quyền nào đó cho **Smax.bot.** Nhưng lưu ý:
* Bước cuối cùng, bạn hãy nhấn Ok để hoàn thành đăng nhập.
## 3. Tạo bot mới
Click "Add New Bot" để tạo bot mới.
Có 2 cách để tạo bot mới
1\. Tạo bot trống chưa có giữ liệu gì.
2\. Tạo bot theo Template có sẵn do Smax cung cấp.
3\. Bot từ nguồn clone
Targer:
* Clone bot sẽ copy ra con bot tương tự ngay trên giao diện smax.bot của mình.
* Clone code sẽ là url để gửi qua cho người khác hoặc copy qua trình duyệt khác để copy bot (Sẽ có 2 tùy chọn là Mod và Admin với những quyền hạn nhất định - Với admin sẽ có quyền cấu hình bot)
# \_1.2 Kết nối bot với Fanpage
Cách kết nối Smax.bot với Fanpage của bạn
### 1. Có 3 cách kết nối bot với Fanpage.
Kết nối bên ngoài giao diện bot.
* Tại bên ngoài giao diện hiển thị các bot, bạn có thể kết nối fanpage với bot mà bạn muốn kết nối bằng cách: Nhấn **Connect page** → Nhấn **Connect to Page** trên Page mà bạn muốn kết nối với bot
Kết nối bên trong giao diện bot:
* Bên trong giao diện chat bot, bạn nhìn góc trên bên trái có chữ **Connect page** → Nhấn **Connect to Page** trên fanpage mà bạn muốn kết nối với bot.
Kết nối bot với fanpage trong phần setting (Cấu hình).
* Trên thanh công cụ màu xanh phía bên trái giao diện bot chọn: **Setting (Cấu hình) → Connect Page → Nhấn Connect to Page** trên Page mà bạn muốn kết nối với bot.
### 2. Lưu Ý:
1. Một page chỉ connect được với 1 bot.
2. Smax bot chỉ hiển thị những fanpage bạn cung cấp quyền cho Smax khi login. Để cập nhật page mới vào Smax bạn vui lòng logout ra và login lại để cấp quyền cho fanpage đó.
3. Chỉ có thể kết nối bot với fanpage khi bạn là admin của fanpage đó.
###
# \_1.3 Tạo kịch bản chatbot đầu tiên
Thao tác cơ bản để thiết lập kịch bản chatbot đầu tiên với Smax.bot
Mời bạn xem video hướng dẫn dưới đây:
[**Phần 1: Tạo chatbot đầu tiên**](https://bot.vn/hoc-chatbot/chatbot-thuc-chien-2020/tao-chatbot-dau-tien-5.html)
[**Phần 2: Tạo chatbot đầu tiên**](https://bot.vn/hoc-chatbot/chatbot-thuc-chien-2020/tao-chatbot-dau-tien-5.html)
# \_2.1 Text
Tin nhắn văn bản.
### 1. Văn Bản
* Tin nhắn có nội dung dạng văn bản dùng để gửi cho khách hàng.
* Dùng '{' để hiển thị các thuộc tính của khách hàng.
* Dùng '\[' để liệt kê các hàm được hỗ trợ trong **Smax.bot**
### 2. Button
* Là nút bấm khi người dùng bấm vào sẽ điều phối sang 1 kịch bản tiếp theo.
* Hỗ trợ tối đa 3 button trong 1 thẻ text.
* Có 3 hỗ trợ cho mỗi button là Block, URL, Phone
* Có thể set [Attibute](https://tailieu.smax.bot/bat-dau-voi-smax.bot/cac-thuat-ngu#8-attribute-custom-field) ngay trong Button để phân loại khách hàng.
1\. **Block**: Gửi 1 block cho người dùng khi họ click vào button đó. Nếu có nhiều block bên trong sẽ gửi lần lượt từng block theo thứ tự thời gian tạo block đó. Block nào tạo trước sẽ được chạy trước.
2\. **URL**: Dùng để gọi 1 trang Web hoặc 1 địa chỉ URL. Có 2 chế độ để bật URL là Newtab và PopUp.
**Lưu Ý**: Khi chọn chế độ **PopUp**
* Bạn có 3 lựa chọn về size hiển thị popup là 40%, 70% và 100%.
* Để URL hiển thị trên PopUp cần phải add domain vào trong Domain Whitelisting:
* Cách 1: Click "Add url into domain whitelist (popup open)" màu xanh ngay trên Button
* Cách 2: Copy Domain → Cấu Hình → Domain Whitelisting → Add Domain
* Kiểm tra domain đã được add hay chưa có thể xem trong cấu hình bot hoặc cài đặt nhắn tin nâng cao **của** page trên facebook.
3\. **Phone**: Gọi tới số điện thoại được set (Chỉ gọi được trên mobile)
4\. **Set Attribute:** Gắn thẻ điều kiện để phân loại những người ấn và không ấn button
5\. **Goto Block:** Chuyển đển block khác sau khi nhấn button chứa url (Chỉ áp dụng cho gói Pro)
# \_2.2 Typing
Giả lập gõ của người dùng.
1. **Chức Năng**: Tạo hiệu ứng như người dùng đang nhập.
2\. Có thể tùy chỉnh từ 0 đến 20 giây cho hiệu ứng giống người đang gõ.
# \_2.3 Image
Thẻ ảnh
**Chức Năng**: Dùng để gửi hình ảnh cho khách hàng. Bạn có thể tải ảnh bằng cách truyền vào đó Attribute ảnh (nếu bạn đã có setup từ trước đó), đường link ảnh từ một trang web khác (*Image URL or Attribute*) hoặc cũng có thể tải ảnh trực tiếp ảnh lên bằng cách nhấn vào (*Add image*).
**Lưu ý:**
1. Link ảnh không được chứa dấu cách. Nên tải ảnh lên hệ thống để tránh bị lỗi khi gửi cho người dùng.
2. Có thể copy các URL ảnh từ block này sang block khác hoặc các bot khác mà không cần mất công upload lên thêm một lần nữa.
# \_2.4 Quick Reply
Gợi ý trả lời nhanh.
## 1. Button
* Là nút bấm khi người dùng bấm vào sẽ điều phối sang 1 block tiếp theo.
* Chỉ hỗ trợ gửi Block không hỗ trợ URL và Phone.
* **Title**: Là tiêu đề của nút bấm
* **Set Attribute**: Dùng để lưu lại lựa chọn của khách hàng.
{% hint style="info" %}
VD: Khách hàng chọn nút bấm Sản phẩm 1, sau khi bấm xong hệ thống sẽ lưu attribute {{DaAnNut}} có giá trị là Sản phẩm 1.
{% endhint %}
### Lưu Ý:
* FaceBook hỗ trợ tối đa 13 nút bấm nên giới hạn của thẻ Quick Reply là 13 nút bấm.
* Bắt buộc phải có thẻ Text hoặc Image, Gallery, Video, Audio, Media phía trên mới chạy được thẻ Quick Reply
* Bắt buộc phải có Title cho mỗi button
* Set Attribute là lựa chọn hỗ trợ trong **Smax bot,** có thể điền hoặc không.
* Trong 1 block khi chạy tới thẻ Quick Reply hệ thống sẽ dừng lại để khách hàng lựa chọn các button trong thẻ. Nếu trong button được lựa chọn không có go to block thì hệ thống sẽ chạy tiếp các thẻ bên dưới thẻ Quick Reply. Trường hợp trong button lựa chọn có go to block, bot sẽ chạy theo block được set trong button và không chạy những thẻ bên dưới thẻ Quick Reply nữa.
# \_2.5 Gallery
Tạo Album ảnh.
**Chức Năng**: Dùng để tạo list ảnh sản phẩm để gửi cho khách hàng.
### 1. Image
* Truyền vào Attribute là link ảnh hoặc một link ảnh từ một trang web khác hoặc có thể tải ảnh trực tiếp lên bằng cách nhấn vào Add image.
* Có 2 chế độ hiển thị ảnh: dọc và ngang.
* Hỗ trợ tối đa 10 ảnh trên mỗi Gallery.
### 2. Heading và Subtitle
* Heading là phần tiêu đề của ảnh được hiển thị in đậm.
* Subtitle là phần phụ đề mô tả ảnh được hiển thị màu nhạt.
* Hiển thị tối đa 80 kí tự trên mỗi Heading và Subtitle. Khi số kí tự vượt quá 80 sẽ hiển thị dấu ...
### 3. Button:
Xem trong \_2.1 Text (Mục 2 - Button)**.**
{% content-ref url="/pages/-Ln335GRZW7qAPEqOvuy" %}
[\_2.1 Text](/2.-gioi-thieu-cac-element-card/_2.1-text)
{% endcontent-ref %}
### 4. Thay đổi thứ tự, vị trí hiển thị của ảnh trong Gallery (Update 2019)
Bằng cách kéo thả và thay đổi vị trí của các icon bên dưới Element Gallery (ảnh bên dưới)
# \_2.6 User Input
Lưu câu trả lời của khách hàng.
**Chức năng**: Tạo 1 câu hỏi cho người dùng để người dùng nhập ý kiến của mình gửi cho hệ thống. Hệ thống sẽ lưu câu trả lời của khách hàng vào một attribute.
### 1. Message To User:
* Là tin nhắn câu hỏi gửi cho khách hàng.
* Có thể sử dụng hàm và attribute giống như element text.
* Khi có nhiều câu hỏi trong thẻ User input, Bot sẽ hỏi từ trên xuống dưới từng câu 1 đợi khách hàng trả lời xong mới chạy tới câu tiếp theo.
* Click Add Fields để thêm câu hỏi cho khách hàng.
### 2. Validation.
* Là những hàm hỗ trợ check thông tin khách hàng nhập vào.
* Hỗ trợ 7 lựa chọn là:
* *Number*: Kiểm tra khách hàng nhập vào có phải là số không.
* *Text*: Kiểm tra khách nhập nội dung bất kỳ
* *Phone*: Kiểm tra khách hàng nhập vào có phải là số điện thoại không.
* *Phone - Suggestion*: Chức năng giống Phone nhưng Bot sẽ gợi ý câu trả lời số điện thoại khách dùng để xác minh Facebook, khách chỉ việc bấm nút mà không cần nhập dữ liệu.
* *Email*: Kiểm tra khách hàng nhập vào có định dạng giống Email không.
* *Email - Suggestion:* giống Phone - Suggestion nhưng thay vì số điện thoại thì Facebook sẽ gợi ý email đăng ký tài khoản của họ.
* Cột số bên cạnh hiển thị số lần bot gọi lại Message to User khi người khách nhập sai hoặc không đúng dữ liệu khiến bot không hiểu được nội dung nhập. Quá số lần nhập không chính xác bot sẽ bỏ qua Element User Input để tránh spam gây khó chịu.
* Khi khách hàng nhập thông tin sai định dạng đã chọn, hệ thống sẽ thông báo tin nhắn Default Phrase gửi cho khách hàng. Tin nhắn bên trái là tin nhắn mặc định của hệ thống, có thể sửa lại vào các ô bên phải (CHANGE TO) nếu muốn thông báo tin nhắn khác.
Lưu ý:
* Mỗi câu hỏi khách hàng chỉ có thể nhập trả lời 1 lần.
* Tin nhắn báo nhập sai thông tin phải được sửa đúng theo thứ tự đã được định dạng trong các dòng.
* Dòng 1: Thông báo tin nhắn thông tin khách hàng nhập không phải là một số.
* Dòng 2: Thông báo tin nhắn thông tin khách hàng nhập không phải là một email.
* Dòng 3: Thông báo tin nhắn khách hàng nhập không phải là một số điện thoại.
### 3. Save Answer to attributes.
* Lưu câu trả lời của khách hàng vào attribute.
* Có thể lưu vào attribute đã có sẵn hoặc tạo 1 attribute mới để lưu.
* Không thể lưu vào các attribute của hệ thống VD: Lưu tên khách hàng nhập vào {{full name}}.
# \_2.7 Set Attribute
Set giá trị cho Attribute
**Chức Năng**: Lưu 1 giá trị vào 1 Attribute cho khách hàng. Hành động này sẽ được hệ thống thực hiện ngầm mà không hiện ra cho khách hàng.
### 1. Điều kiện lọc:
Xem lại \_2.6 Go to Block (Mục 1: Điều kiện (Bộ lọc))
{% content-ref url="/pages/-Ln33L4jrA\_cUA\_h765C" %}
[\_2.8 Go to Block](/2.-gioi-thieu-cac-element-card/_2.8-go-to-block)
{% endcontent-ref %}
### 2. User Attribute
* Là tên attribute của khách hàng.
* Có thể tạo 1 attribute mới cho khách hàng hoặc set lại 1 attribute cũ của khách hàng đã có với một giá trị mới.
* Thêm các attribute bằng cách click Add Item.
### 3. Value
* Là giá trị được set cho attribute.
* Có thể lưu giá trị là text hoặc số.
* Có thể thực hiện các phép tính +; -; \*; / ( Cộng; Trừ ; Nhân; Chia ) trong phần Value để tính toán giá trị cho khách hàng.
* Ghép các attribute text lại với nhau bằng cách điền 2 attribute liền nhau.
**Lưu Ý**:
* Chỉ thực hiện các phép tính +; -; \*; / khi attribute đó có giá trị là số.
* Có thể sử dụng hàm trong phầm Value.
![VD sử dụng hàm \[=SEPRATOR(number)\] để in số tiền có dấu phẩy](/files/-LtJtGpyVFyeTnVGYtZd)
# \_2.8 Go to Block
Rẽ nhánh theo điều kiện
**Chức năng**: Dùng để điều hướng khách hàng đến một block khác.
### 1. Điều Kiện (Bộ lọc):
1\. Thêm điều kiện Attribute:
* Thêm điều kiện bằng cách click thêm bộ lọc trong element Go to block.
* Thêm nhiều kiều kiên bằng cách click Add new.
* Các điều kiện được khớp từ trên xuống dưới theo 2 luồng là or (hoặc) hoặc and (và).
* Các phương thức so sánh điều kiện trong Attribute.
* \= : So sánh ngang bằng.
* != : So sánh không bằng.
* \> : So sánh lớn hơn.
* < : So sánh nhỏ hơn.
* \>= : So sánh lớn hơn bằng.
* <= : So sánh nhỏ hơn bằng.
* start : Kiểm tra giá trị của attribute có bắt đầu với điều kiện không.
* end : Kiểm tra giá trị của attribute có kết thúc với điều kiện không.
* have : Kiểm tra giá trị của attribute có chứa điều kiện không.
* have not : Kiểm tra giá trị của attribute có không chứa điều kiện không.
* any : Kiểm tra attribute có giá trị không.
* null : Kiểm tra attribute có đang null (không có giá trị gì) không.
{% hint style="info" %}
VD: Attribute {{HoTen}} có giá trị là Nguyễn Văn A.
* Attribute {{HoTen}} start Nguyễn → Điều kiện đúng.
* Attribute {{HoTen}} end B → Điều kiện sai.
* Attribute {{HoTen}} have Nguyễn → Điều kiện đúng.
* Attribute {{HoTen}} have not Văn → Điều kiện sai.
* Attribute {{HoTen}} have not Đào → Điều kiện đúng.
* Attribute {{HoTen}} any → Điều kiện đúng.
* Attribute {{HoTen}} null → Điều kiện sai.
{% endhint %}
2\. Điều kiện Sequence:
* Kiểm tra xem người dùng đã (Đang trong; Đang không trong; Đã từng; Chưa từng) sequence đó chưa.
* Kiểm tra xem người dùng đã (Đang trong; Chưa vào; Đã vào; Đã ra) sequence đó chưa.
* \=: Đang trong sequence.
* !=: Đang không trong sequence.
* was: Đã từng vào sequence.
* was not: Chưa từng vào sequence.
3\. Phép so sánh **AND** và **OR** giữa các điều kiện.
* Chỉ được chọn 1 phương thức là and hoặc or trong bộ lọc.
* Điều kiện được kiểm tra từ trên xuống dưới theo phép so sánh đã set trong bộ lọc.
| Phép So Sánh | Kết Quả |
| ------------ | -------------------------------------------------------------------------------------------------------- |
| AND | Trả về ĐÚNG nếu tất cả các điều kiện là Đúng.
Trả về SAI nếu một trong các điều kiện là Sai
|
| OR | Trả về ĐÚNG nếu một trong các điều kiện là Đúng.
Trả về SAI nếu tất cả điều kiện là Sai
|
{% hint style="info" %}
VD: Attribute {{Tuoi}} có giá trị là 20; Attribute {{HoTen}} có giá trị 'Nguyễn Văn A'
{{Tuoi}} > 20 or {{HoTen}} start Nguyễn → Đúng
{{Tuoi}} = 20 and {{HoTen}} start Nguyễn → Đúng
{{Tuoi}} > 20 and {{HoTen}} start Nguyễn → Sai
{% endhint %}
### 2. Block được go to:
* Chọn block gửi cho khách hàng khi điều kiện của khách hàng đó thỏa mãn bộ lọc phía trên.
* Có thể gửi nhiều lựa chọn block bằng cách click random block. Các block từ trên xuống dưới được hệ thống tự động chọn ngẫu nhiên 1 trong các block đã set để gửi cho khách hàng khi điều kiện của khách hàng thỏa mãn bộ lọc.
* Số lượng block random là không giới hạn.
# \_2.9 Sequence
Kịch bản chăm sóc khách hàng.
**Chức Năng**: Element Sequence dùng để thêm khách hàng vào 1 kịch bản chăm sóc hoặc xóa khách hàng ra khỏi kịch bản chăm sóc dựa theo điều kiện đã set trong thẻ Sequence.
### 1. Điều kiện lọc:
Xem lại \_2.6 Go to Block (Mục 1: Điều kiện (Bộ lọc)).
{% content-ref url="/pages/-Ln33L4jrA\_cUA\_h765C" %}
[\_2.8 Go to Block](/2.-gioi-thieu-cac-element-card/_2.8-go-to-block)
{% endcontent-ref %}
### 2. Hành động:
* Có 2 hành động trong thẻ Sequence là Add và Remove.
* Add: Thêm khách hàng vào 1 kịch bản chăm sóc.
* Remove: Xóa khách hàng ra khỏi kịch bản chăm sóc.
**Lưu Ý**:
* Khi muốn thêm nhiều kịch bản chăm sóc hoặc xóa kịch bản chăm sóc cho khách hàng trong 1 element sequence thì click Add hoặc Remove bên dưới.
* Khi khách hàng đã vào kịch bản chăm sóc nào đó, họ sẽ không thể vào lại được.
* Cách vào cho khách hàng vào lại kịch bản chăm sóc: Phải remove kịch bản chăm sóc sau đó mới add lại.
* Chọn Now để thêm vào sequence ngay hoặc At để chọn thời gian thêm vào sequence
# \_2.10 JsonAPI
Gửi Request để kết nối với bên thứ 3.
**JSON API**
The JSON API plugin enables you to integrate your backend into your chat bots on **Smax bot**.
It allows you to
* Generate dynamic content
* Get and set user attributes
* Redirect users to another block in the bot
* Create postbacks
You can use GET and POST requests - the max. timeout is always 10 seconds. There are four options to enter data that will be sent with your request:
1\. URL — This field supports user attributes, they will be URL-encoded with your request
2\. Full JSON profile (POST requests only) — This will send all the user attributes of the user to your backend
3\. JSON Body (POST requests only) — This is a customizable field and will be validated as JSON.
4\. URL Encoded (POST requests only) — The data will be encoded before sending your request.
In your responses, you can
* combine several messages in one answer by sending several dictionaries in the messages array.
* use any content type header.
* send an empty response to not show the user any dynamic content.
### Response Reference
**Sending text**
Use this response to send text messages.
```
{
"messages": [
{"text": "Welcome to the Smax Rockets!"},
{"text": "What are you up to?"}
]
}
```
**Sending images**
Use this response to send image files. Messenger supports JPG, PNG and GIF images. If you are having issues with GIF rendering, please try to reduce the file size.
```
{
"messages": [
{
"attachment": {
"type": "image",
"payload": {
"url": "https://smax.bot/assets/images/homepage/ourprod-bot.png"
}
}
}
]
}
```
You can also directly use Facebook Posts with media instead of uploading it manually:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "image",
"url": "https://www.facebook.com/smaxbot/photos/1087668107975064",
"buttons": [
{
"title": "Go to Smax!",
"type": "web_url",
"url": "https://smax.bot/"
}
]
}
]
}
},
"quick_replies": [
{
"title": "That's cool!",
"payload": "string"
}
]
}
]
}
```
**Sending video**
Use this response to send video files. Messenger supports MP4 videos, which are up to 25MB in size.
```
{
"messages": [
{
"attachment": {
"type": "video",
"payload": {
"url": "https://rockets.smax.bot/assets/video.mp4"
}
}
}
]
}
```
You can also directly use Facebook Posts with media instead of uploading it manually:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "video",
"url": "https://www.facebook.com/smaxbot/videos/252894858962779/",
"buttons": [
{
"title": "Go to Chatfuel!",
"type": "web_url",
"url": "https://smax.bot/"
}
]
}
]
}
},
"quick_replies": [
{
"title": "That's cool!",
"payload": "string"
}
]
}
]
}
```
**Sending audio**
Use this response to send audio files. Messenger supports MP3, OGG, WAV audios, which are up to 25MB in size.
```
{
"messages": [
{
"attachment": {
"type": "audio",
"payload": {
"url": "https://rockets.smax.bot/assets/hello.mp3"
}
}
}
]
}
```
**Sending files**
Use this response to send any other files, which are no larger than 25 MB.
```
{
"messages": [
{
"attachment": {
"type": "file",
"payload": {
"url": "https://rockets.smax.bot/assets/ticket.pdf"
}
}
}
]
}
```
**Sending galleries**
Use this response to send a horizontal scrollable gallery. Each item is composed of an image attachment, short description and buttons to request input from the user.\
Note: messenger\_extensions should only be added if you are using [Messenger Extensions](https://docs.chatfuel.com/configure/chat-extensions).
```
{
"messages": [
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"image_aspect_ratio": "square",
"elements":[
{
"title":"Chatfuel Rockets Jersey",
"image_url":"https://rockets.smax.bot/assets/shirt.jpg",
"subtitle":"Size: M",
"buttons":[
{
"type":"web_url",
"url":"https://rockets.smax.bot/store",
"title":"View Item"
}
]
},
{
"title":"Chatfuel Rockets Jersey",
"image_url":"https://rockets.smax.bot/assets/shirt.jpg",
"subtitle":"Size: L",
"default_action": {
"type": "web_url",
"url": "https://rockets.smax.bot/store",
"messenger_extensions": true
},
"buttons":[
{
"type":"web_url",
"url":"https://rockets.smax.bot/store",
"title":"View Item"
}
]
}
]
}
}
}
]
}
```
**Sending receipts**
Use this response to send an order confirmation. It may include an order summary, payment details, and shipping information.
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "receipt",
"recipient_name": "Mark Zuckerberg",
"order_number": "12345678901",
"currency": "USD",
"payment_method": "Visa 2345",
"order_url": "https://rockets.smax.bot/store?order_id=12345678901",
"timestamp": "1428444666",
"address": {
"street_1": "1 Hacker Way",
"street_2": "",
"city": "Menlo Park",
"postal_code": "94025",
"state": "CA",
"country": "US"
},
"summary": {
"subtotal": 105,
"shipping_cost": 4.95,
"total_tax": 9,
"total_cost": 118.95
},
"adjustments": [
{
"name": "CF Rockets Superstar",
"amount": -25
}
],
"elements": [
{
"title": "Chatfuel Rockets Jersey",
"subtitle": "Size: M",
"quantity": 1,
"price": 65,
"currency": "USD",
"image_url": "http://rockets.smax.bot/assets/shirt.jpg"
},
{
"title": "Chatfuel Rockets Jersey",
"subtitle": "Size: L",
"quantity": 1,
"price": 65,
"currency": "USD",
"image_url": "http://rockets.smax.bot/assets/shirt.jpg"
}
]
}
}
}
]
}
```
**Buttons**
Use this JSON to add buttons to your responses. You can set buttons to link to a block in the dashboard, open a website, or send another request to your backend. Buttons are limited to 3 items per message.
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "button",
"text": "Hello!",
"buttons": [
{
"type": "show_block",
"block_names": ["name of block"],
"title": "Show Block"
},
{
"type": "web_url",
"url": "https://rockets.chatfuel.com",
"title": "Visit Website"
},
{
"url": "https://rockets.smax.bot/api/welcome",
"type":"json_url",
"title":"Postback"
}
]
}
}
}
]
}
```
You can also use the Call button, this button dials a phone number when tapped.
```
{
"messages":[
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Get in touch",
"image_url":"https://rockets.smax.bot/assets/contact.jpg",
"subtitle":"Feel free to hit us up!",
"buttons":[
{
"type":"phone_number",
"phone_number":"+19268881413",
"title":"Call"
}
]
}
]
}
}
}
]
}
```
**Quick replies**
Use this JSON to add quick replies to your responses. Quick replies are limited to 11 items per message.
```
{
"messages": [
{
"text": "Did you enjoy the last game of the CF Rockets?",
"quick_replies": [
{
"title":"Loved it!",
"block_names": ["Block 1", "Block 2"]
},
{
"title":"Not really...",
"url": "https://rockets.smax.bot/api/sad-match",
"type":"json_url"
},
{
"title": "More...",
"payload": "string"
}
]
}
]
}
```
**Setting user attributes**
You can set user attributes by having the field set\_attributes as bellow
```
{
"set_attributes":
{
"some attribute": "some value",
"another attribute": "another value"
},
"messages":[
. . .
]
}
```
**Redirect to blocks**
You can redirect a user to a block or to a sequence of blocks — no user action is needed.
```
{
"redirect_to_blocks": ["Welcome Message", "Default Answer"]
}
```
\
Do keep in mind that for other functionalities or compiling functions to work altogether is out of Smax's scope of support and we suggest to get help from an [Expert](https://www.messenger.com/t/smax.apps).
# \_2.11 Attr to Sheet
Lưu dữ liệu vào google sheet
### 1. Hướng dẫn kết nối:
1. Bước 1: Click thẻ Attr to Sheet. Thẻ Attr to sheet được tạo.
1. Bước 2: Chọn Add new để kết nối với tài khoản Google sheet.
1. Bước 3: Chọn Google Auth → Chọn tài khoản kết nối -> Chọn Allow để đồng ý cấp quyền
Có một sheet có các giá trị như trên, cột tìm kiếm Messanger User ID có 3 giá trị trùng nhau thì các attribute trong bot sẽ lưu các giá trị tương ứng trong hàng cuối cùng
{% endhint %}
{% hint style="info" %}
**VD dùng element Sheet to Attr**:
Khi sử dụng chatbot viral để thu thập thông tin khách hàng. Sau khi thu thập thông tin ta sẽ đưa qua hãng vận đơn để nhận mã vận đơn. Và nếu khách hàng muốn kiểm tra đơn hàng của mình sẽ dùng mã vận đơn này. \
Đầu tiên, ta sẽ dùng cột tìm kiếm là Messenger user id có giá trị là {{messenger user id}}. Tức là nếu khách hàng đã tồn tại trên sheet thì bot sẽ trả về mã vận đơn và lưu nó vào thuộc tính {{mahoadon}}. Từ đó, khách hàng có thể biết được tình trạng đơn hàng của mình thông qua thuộc tính {{mahoadon}}.
{% endhint %}
# \_2.13 Note
Thẻ ghi chú
**Chức Năng**: Là một loại thẻ chức năng dùng để ghi chú trong bot (Không hiển thị khi chạy trên messenger). Nội dung bên trong là đoạn văn bản giúp người dùng **Smax bot** ghi chú lại các nội dung khi xây dựng kịch bản.
# \_2.14 On/Off Bot
Thẻ dừng bot
**Chức Năng**: Dùng để dừng bot không giao tiếp với khách hàng nữa. Khi có 1 người dùng chạy tới thẻ On/Off Bot thì người dùng đó sẽ bị dừng giao tiếp với bot theo thời gian đã cài đặt trong thẻ.
* Chọn dạng bật (on) hoặc tắt (off) để dừng hoặc chạy bot
* Có 3 kiểu tắt trong thẻ On/Off Bot: Tắt trong khoảng thời gian, Tắt đến thời điểm và Tắt đến khi bật lại.
1\. Tắt đến khi bật lại:
* Kiểu tắt này sẽ giúp bot tắt giao tiếp với user bị stop bot đến khi admin vào bật lại bot cho user đó.
* Sau khi bật lại bot cho user bị tắt bot, hệ thống sẽ tự động gửi cho user đó 1 block được set trong thẻ (Go to block có thể điền hoặc không).
* **Bật bot**: Kiểu tắt này bắt buộc admin phải vào bật lại bot cho user bị stop bot. Muốn bật lại bot làm theo hướng dẫn sau: Vào bot → Khách Hàng → Tìm user muốn bật → Click vào user đó → Turn On.
2\. Tắt đến thời điểm
* Kiểu tắt này giúp bot tắt giao tiếp với 1 user đến 1 thời điểm nào đó được set trong thẻ.
* Khi tới thời điểm được set, hệ thống sẽ tự động bật lại bot cho user đó. Nếu có Go to block, hệ thống sẽ tự động gửi block được chọn cho user.
3\. Tắt trong khoảng thời gian
* Kiểu tắt này giúp bot tắt giao tiếp với 1 user trong 1 thời điểm được set trong thẻ.
* Trường thời gian tắt là 1 số.
* Trường đơn vị: Ngày; Giờ và Phút.
* Sau khi hệ thống đếm ngược thời gian tắt về đến 0 thì bot đó sẽ được tự động bật lại giao tiếp với user.
# \_2.15 Send Block
Gửi Block cho 1 uer khác
**Chức Năng**:
* Khi bot chạy tới block này, hệ thống sẽ tự động gửi các block tới những người có ID được set trong thẻ Send Block.
* Element này thường được dùng để thông báo cho những admin khi có khách hàng vào hỏi sản phẩm hoặc cần tư vấn.
* **Đặc Biệt** dùng nhiều trong trường hợp gửi thông báo cho người share khi có người tham gia các chiến dịch **Viral Bot.**
**1. GỬI BLOCK**
Là trường set những block muốn gửi cho một ai đó.
**2. NGƯỜI NHẬN**
Có **3** lựa chọn là Admin Page, PSID (messenger user ID) hoặc PSID in reflink.
1. PSID (messenger user ID)
* Copy ID của người muốn gửi cho vào PSID or list PSIDs.
* Muốn gửi cho nhiều người thì copy ID từng người muốn gửi cho vào PSID or list PSIDs, mỗi ID nằm trên 1 dòng.
2. Admin Page - Chọn những admin muốn gửi
3. Ref
**Lưu Ý**: Muốn lấy attribute hoặc hàm của người gửi cho người được gửi thì dùng ${{attribute}}$ hoặc $\[=FOMULA(x)]$
{% hint style="info" %}
VD: Muốn gửi tin: Anh Nguyễn Văn A ơi có chị Phạm Thị N cần được tư vấn.
\*\* Chúng ta sẽ set tin nhắn trong block gửi đi như sau:
\[=GENDER(Anh,Chị,Bạn)] {{full name}} ơi có $\[=GENDER(anh,chị,bạn)]$ ${{full name}}$ cần được tư vấn.
\*\* Trong đó:
\+ \[=GENDER(Anh,Chị,Bạn)] = Anh (Giới tính của người nhận block).
\+ {{full name}} = Nguyễn Văn A (Tên của người nhận block).
\+ $\[=GENDER(anh,chị,bạn)]$ = chị (Giới tính của người gửi block)
\+ ${{full name}}$ = Phạm Thị N (Tên của người gửi block)
{% endhint %}
# \_2.16 A/B Testing
Lựa chọn 1 block ngẫu nhiên theo tỉ lệ % gửi cho khách hàng.
**Chức Năng**: Gửi một block ngẫu nhiên trong những block được lựa chọn trong thẻ để gửi cho khách hàng theo tỉ lệ % đã set trong element A/B Testing.
1\. Tên Nhánh: Là tên để phân biệt giữa các nhánh, không có chức năng gì.
2\. Phần trăm: Là tỉ lệ phần trăm gửi những block trong 1 nhánh.
* Nếu trên 1 nhánh có nhiều Block thì bot sẽ gửi tất cả những block trên nhánh đó nếu hệ thống lựa chọn nhánh đó để gửi.
* Muốn thêm nhánh mới Click Thêm nhánh.
**Lưu Ý**: Check box " Luôn random trên một khách hàng " dùng để random lại luồng kịch bản khi khách hàng đó chạy lại đến thẻ A/B Testing.
# \_2.17 Page Event
Tính năng: Thẻ này dùng để đo lường sự kiện người dùng đồng bộ lên quảng cáo Facebook.
**EVENT NAME:** Chọn sự kiện mà bạn muốn đo lường hành động của khách hàng (hành động này sẽ đồng bộ với trình quảng cáo của bạn)
> View Content: Hành động khách hàng đang tham khảo
>
> Add to cart: Hành động khách hàng đã mua hàng
>
> Purchase: Hành động khách hàng đã thanh toán
**CURRENCY:** Lựa chọn tiền tệ mà khách hàng thanh toán
**CONTENT ID:** Hiểu là ID sản phẩm của bạn trên phần mềm quản lý của bạn.
**CONTENT TYPE:** bạn bán gì thì nhập cái đó vào (product, video, document...)
**PRICE OF ITEM VIEWED:** Giá của sản phẩm mà khách hàng đang quan tâm (hệ thống sẽ nhận dạng từ attribute được set)
# \_2.18 Check Like
Kiểm tra người dùng đã like fanpage chưa.
**Chức năng**: Kiểm tra user đang tương tác đã like Page chưa, nếu đã like sẽ gửi Block 1, chưa like gửi Block 2.
\*\* Thẻ chức năng giúp tăng lượt like Page một cách hiệu quả trong các chiến dịch tặng quà. Nếu check like khách hàng đã like thì được nhận quà, chưa like sẽ hướng khách hàng tới block nhắc nhở like và có nút like dẫn đường link tới Page của mình để khách hàng like.
{% hint style="info" %}
Lưu ý: Tính năng này gặp lỗi không check được like và báo rằng người dùng chưa like page. Nguyên nhân là do người dùng đó đặt bảo mật trang cá nhân cao, làm ẩn đi phần hiển thị page đã like dẫn tới chatbot không thể biết được họ đã like hay chưa (dù khách đã like rồi). Cần cân nhắc cẩn thận khi sử dụng tính năng này cho chiến dịch của bạn.
{% endhint %}
# \_2.19 Send Video
**Chức năng**: Gửi video cho khách hàng
**Link Facebook:** Bạn có thể update video lên fanpage, hoặc lên trang cá nhân (profile) của các bạn, copy link trên trình duyệt và dán vào
**Link Cloud:** Bạn có thể upload video lên cloud (các hosting hoặc tài khoản cloud storage) lấy link trực tiếp theo định dạng
**Link Dropbox:** Bạn có thể upload video lên dropbox, sau đó chọn vào "***Share***"
Tiếp theo hệ thống sẽ hiện ra 1 popup bạn chọn vào "***Create link***"
Đợi 1 vài giây hệ thống sẽ sinh ra đường link, bạn click vào "***Copy Link***"
Copy xong bạn dán trực tiếp vào thẻ Video của Smax.bot mà không cần chỉnh sửa gì.
VD định dạng link: [https://www.dropbox.com/s/p9oq6r80a7ia6417/video2.wmv?dl=0](https://www.dropbox.com/s/p9oq6r80a7ia417/video.wmv?dl=0)
# \_2.20 Delay
Chức năng: tạm dừng 1 thời gian.
Thông thường khi bạn sử dụng bot để chạy các tính năng như lưu thông tin vào sheet, gửi broadcast... , sẽ gặp vấn đề nếu quá nhiều người dùng cùng lưu thì dễ dẫn tới việc kết nối với Google Sheet sẽ bị gián đoạn => Sót dữ liệu
Các bạn có thể sử dụng thẻ Delay này để "làm chậm" tiến độ, tránh việc quá tải cho file sheet.
# \_2.21 Audio
**Chức năng**: Gửi file Audio cho khách hàng
**Link Cloud:** Bạn có thể upload audio lên cloud (các hosting hoặc tài khoản cloud storage) lấy link trực tiếp theo định dạng
**Link Dropbox:** Bạn có thể upload audio lên dropbox, sau đó chọn vào "***Share***"
Tiếp theo hệ thống sẽ hiện ra 1 popup bạn chọn vào "***Create link***"
Đợi 1 vài giây hệ thống sẽ sinh ra đường link, bạn click vào "***Copy Link***"
Copy xong bạn dán trực tiếp vào thẻ Audio của Smax.bot mà không cần chỉnh sửa gì.
VD định dạng link: [https://www.dropbox.com/s/p9oq6r80a7ia6417/audio.mp3?dl=0](https://www.dropbox.com/s/p9oq6r80a7ia417/video.wmv?dl=0)
# \_2.22 Add Album
**Chức Năng:** Đăng một nội dung tự động lên trên một Album của Fanpage.
1. ALBUM ID OR LINK: Link album hoặc id của album cần đăng nội dung lên.
2. MASSAGE: Nội dung content trong bài đăng Album. Hỗ trợ truyền Attribute, Hàm, Spin.
3. URL: Link của hình ảnh muốn đăng. Truyền vào là một link cố định hoặc một attribute link hình ảnh.
**Cách sử dụng hiệu quả:** Sử dụng tích hợp với plugin Custom Image của botplus để tạo thẻ giảm giá, ảnh quà tặng, thẻ thành viên... để đăng những hình ảnh đó kèm nội dung chúc mừng khách hàng lên album.
# \_2.23 SmaxChat Tags
Cấu hình Smaxbot tự động gắn thẻ khách hàng trên SmaxChat
Bạn đang sử dụng Smax.chat để quản lý tin nhắn với khách hàng và đang chạy quảng cáo, muốn tự động gắn thẻ để nhân viên có thể theo dõi, chăm sóc theo kịch bản. Thì element này sẽ hỗ trợ bản làm điều đó:
### 1- Tạo tags bên SmaxChat
\- Bạn vào mục **Cấu hình (1)** sau đó đến phần **Tags (2)**, nhấn **Thêm Tag Mới (3)**, tạo **tên Tag (4)**
### 2- Kết nối với SmaxBot.
\- Bạn vào mục **Cấu hình (1)** sau đó đến phần **Integrations (2)**, nhấn nút bật kết nối với SmaxBot **(3)**
### 3- Tạo thẻ (card) để gắn tags.
\- Bạn vào 1 block và thêm thẻ **SmaxChat Tags (1)**\
\- Sau đó chọn **Add** hoặc **Remove** Tags tùy nhu cầu của bạn **(2)**\
\- Chọn **tên Tag (3)** mà bạn mới tạo ở hướng dẫn phía trên
### 3- Lưu ý:
\- Bạn phải chọn **đúng page** ở cả **SmaxChat** và **SmaxBot** nhé, nhiều bạn chọn sai page nên sẽ không gắn tags được.
# \_2.24 Media
### **Chức Năng**:
Dùng để gửi 1 hình ảnh hoặc 1 video đã được upload lên fanpage hoặc từ fanpage khác cho người dùng.
### **Media Type:**
Dùng để lựa chọn dạng media để gửi, có 2 loại: một là Video hai là Image
### Facebook URL:
Là đường dẫn của nội dung bạn muốn gửi cho khách.
{% hint style="info" %}
Ví dụ: bạn bán sản phẩm giày, bạn muốn gửi video trực tiếp cho khách mà không phải tải video về máy (hoặc ảnh) thì bạn có thể sử dụng tính năng này, Copy đường dẫn trên trình duyệt rồi dán vào. Smax sẽ tự lấy nội dung đó và gửi cho khách của bản.
{% endhint %}
# \_2.25 One-Time Notification
Thông báo cho người dùng
**Thẻ này dùng trong trường hợp nào?**
Mình lấy 1 ví dụ nhỏ: khách hàng của bạn muốn mua iphone 11 nhưng 3 tháng nữa mới có hàng. Vậy làm thế nào để 3 tháng sau bạn có thể nhắn được tin cho khách hàng để thông báo "Chiếc iphone 11" đã có hàng mà ko bị vi phạm chính sách 24h?
OK Facebook cho ra 1 loại thẻ gọi là One-Time Notification. Thẻ này sẽ gửi 1 yêu cầu tới người dùng và nếu người dùng click "chấp nhận" thì bạn sẽ nhận được 1 cái "chìa khóa" (key). Với chìa khóa này bạn có thể gửi tin nhắn (cả tin quảng cáo) cho khách hàng đó trong vòng 1 năm chứ không phải 24h nữa (tiếc là chiếc chìa khóa này chỉ dùng đc 1 lần 😭)
**Cách thức thiết lập thẻ này trên Smax:**
**Get Notified:** bạn nhập nội dung thông báo vào đấy (VD: có iphone 11 mới, có hàng mới, có giảm giá mới...)
**Save One-Time Token to:** bạn tạo ra 1 attribute để lưu trữ chìa khóa "key" của mỗi khách hàng
**After Click Notify Me:** sau khi khách hàng "chấp nhận" sẽ goto sang block mới (bên này bạn có thể hiển thị các nội dung như: Cảm ơn khi nào có hàng/giảm giá... shop sẽ nhắn tin cho bạn. Chúc bạn 1 ngày tốt lành.
\=> OK như vậy bạn có thể hình dung đc là Page sẽ gửi 1 nội dung là "Có Iphone 11 mới thì Page sẽ nhắn cho bạn => Nếu khách Ấn "OK báo cho tôi" thì Lập tức FB sẽ cấp cho Page 1 cái chìa khóa (key) => lưu vào trong attribute {{one-time-iphone11}} mà bạn đã tạo sẵn. (lưu ý key sẽ đi theo từng khách hàng không có chuyện ông A muốn nhận thông báo khi có Iphone 11 mà bạn lại dùng key ông A để gửi cho ông B được)
**Lưu ý:** Bạn cần phải yêu cầu xét duyệt One Time thông qua Facebook thì mới sử dụng được tính năng
# \_2.27 Attach File
Gửi tệp đính kèm cho người dùng.
Tương tự với Email của google, chức năng Attach File cho phép bạn đính kèm một file bất kỳ
Khá đơn giản và dễ dùng, bạn chỉ cần làm theo hướng dẫn có trong thẻ là có thể sử dụng được chức năng này rồi.
# \_2.29 Sub/UnSub
Tạo tùy chọn cho người dùng nhận hoặc không nhận tin nhắn nữa.
Nếu bạn muốn tạo cho khách hàng tùy chọn không nhận [Broadcast](https://tailieu.smax.bot/3.-cac-tinh-nang-chinh/_3.5-gui-broadcast) trong tương lai thì đây là chức năng của thẻ đó. Việc gửi broadcast hàng loạt đôi khi khiến khách hàng cảm thấy phiền phúc, họ rất muốn dừng nhận tin nhắn nhưng không còn cách nào khác ngoài việc block page.
Điều này ảnh hưởng đến hoạt động Remarketing của bạn rất lớn, vì khả năng facebook hạn chế gửi tin nhắn của page là rất cao. Hiểu được điều đó, Smax đã thêm vào thẻ này để hỗ trợ bạn.
Tính năng của thẻ này dùng khá đơn giản, hãy tạo một tùy chọn ngưng nhận tin nhắn cho khách hàng trong kịch bản của bạn.
Sau đó điều hướng sang block chứa thẻ này kèm theo một nội dung cảm ơn là ok!
{% hint style="info" %}
Bạn yên tâm, nếu sau này họ tương tác lại với bạn thông qua inbox. Họ sẽ được chuyển sang Subscribe và có thể nhận được tin nhắn trong tương lai.
{% endhint %}
# \_2.30 Find Customer
(Tính Năng đang phát triển - Pro Version)
# \_2.31 Split Attribute
Chia nhỏ cấu trúc Attribute thành nhiều Attribute nhỏ khác
Đây là một tính năng mới được Smax bot cập nhật trong thời gian gần đây. Nhằm mục đích hỗ trợ các nhà quảng cáo chạy mục tiêu chuyển đổi quả Landing Page (Ladipage) có thể truyền được dữ liệu về chatbot.
Hiểu đơn giản về thẻ Split Attribute có tính năng "chặt nhỏ" các Attribute ra và gán giá trị Attribute được "chặt" mà bạn muốn.
* **Content Attribute**: Là nội dung của Attribute bạn muốn gọi ra để "Chặt"
* **Map Attribute**: Mô tả cho bot là bạn sẽ chặt Attribute kia như thế nào và phân loại ra sao.
Mình có hướng dẫn chi tiết trong Video:
Chúc bạn thành công!
# \_2.32 Comment
Hỗ trợ botcomment kèm theo ảnh
Đối với chức năng Comment sẵn có của công cụ BotComment sẽ không thể gửi hình ảnh, vì vậy thẻ Comment sẽ bổ trợ cho chức năng đó gửi thêm ảnh kèm theo.
Để sử dụng được thẻ này bạn cần phải tạo kịch bản botcomment trước, sau đó sẽ dùng chức năng **Lưu comment ID vào Attribute** hoặc **Lưu Post ID vào attribute** để lấy attribute đó sử dụng.
Tiếp theo, tạo block chứa thẻ Comment, sau đó chọn **Post ID/ Comment ID (1)**, tiếp đến nhập nội dung **Text (2)** mình muốn và gửi ảnh **Image (3)** kèm theo nếu cần thiết.
# \_2.33 Fb Audience
Thẻ thêm khách hàng vào 1 tệp đối tượng facebook
Thẻ này giúp bạn thêm khách hàng vào 1 tệp đối tượng
**ACTION:** Add là thêm/Remove là xóa khách hàng khỏi tệp Audience
**FB AUDIENCE AUTHOR:** Người đang sở hữu tệp Audience đó (trong con bot của bạn có nhiều quản trị viên, bạn có thể chọn 1 tài khoản mà có quyền trên tệp Audience đó)
**FB AUDIENCE ID:** Nhập ID tệp đối tượng của bạn (cách lấy ID bạn vào trình quản lý đối tượng và bật cột ID đối tượng lên để xem)
# \_2.34 Send Gmail
Để sử dụng thẻ Send Gmail các bạn chọn theo thứ tự:
> 1- Chọn Tab Google
>
> 2- Chọn thẻ Send Gmail
>
> 3- Chọn mục Integration và chọn Add New để thêm kết nối mới.
Tiếp theo bạn nhập tên và mô tả sau đó chọn vào Nút "Google Auth" để kết nối vào tài khoản google.
Ở các cửa sổ hiện lên các bạn chọn tiếp tục (hoặc đồng ý) cho tới khi kết nối thành công như hình dưới thì các bạn chọn "Update"
Sau đó các bạn cấu hình thông số gửi mail:
> To Email Attr: Attribute chứa email của khách hàng
>
> Email Subject: Tiêu đề email
>
> Email Content: Nội dung email
# \_3.1 Từ Khóa
Nhận diện từ khóa (keyword) và trả lời theo kịch bản hoặc block
Ngoài việc bạn có thể điều hướng kịch bản chatbot bằng các [button ](https://app.gitbook.com/@smax-bot/s/workspace/~/drafts/-MLjyqH6RbscSstWQM1k/2.-gioi-thieu-cac-element-card/_2.1-text#2-button)(khách hàng sẽ phải click vào button để chuyển sang kịch bản sau) Vậy nếu trường hợp khách hàng không chọn vào button mà lại gõ một nội dung bất kỳ thì sao?
[Smax.bot](https://smax.bot/) hỗ trợ việc cấu hình chatbot theo từ khóa cực kỳ đơn giản.
1. "Click Add Keyword Group" để phân chia thư mục các từ khóa cho tiện quản lý.
2. Smax.bot hỗ trợ 2 loại tin nhắn và nhiều loại khớp từ khóa: \
2.1. Loại tin nhắn
* **Tin nhắn của Khách hàng**: Tin nhắn mà khách hàng nhắn với page.
* **Tin nhắn của Page**: Tin nhắn từ page nhắn cho khách.
2.2. Loại khớp từ khóa
* **Trùng khớp**: Khớp với nội dung khách nhắn
* **Chứa nội dung**: Chứa nội dung khách nhắn
* **Bắt đầu với nội dung**: Chứa nội dung bắt đầu giống khách nhắn
* **Chứa từ khóa:** Kiểm tra từng chữ khớp với các chữ trong cụm từ
* **Bắt đầu với từ khóa:** Kiểm tra chữ hoặc cụm chữ đầu có trong từ
* **Có Email là:** Khớp với email khách nhắn
* **Có Email:** Nội dung có chứa email
* **Có Email kết thúc với:** Email kết thúc với đuôi bất kì
* **Có SĐT là:** Khớp với sđt khách nhắn
* **Có SĐT:** Nội du~~n~~g có chứa sđt
* **Có SĐT bắt dầu với:** SĐT bắt đầu với đầu bất kì
* **Khớp regex:** Khớp với đoạn regex khách nhắn
3. Nhập các từ khóa mà bạn cho là khách hàng có thể hỏi
4. Cấu hình cách bot trả lời tương tứng. Bạn có thể trả lời bằng **"Text"** hoặc một **"Block"**. Bạn có thể cấu hình nhiều Block hoặc nhiều Text, nhưng bot sẽ lựa chọn **ngẫu nhiên** 1 phương án để trả lời lại khách hàng.
#### Các lưu ý về việc cấu hình Keyword:
* Bot sẽ **KHÔNG** phân biệt chữ hoa và chữ thường
* Bot sẽ **PHÂN BIỆT** từ khóa có dấu và không có dấu.
# \_3.2 Bot Menu
Tính năng tạo menu cho bot
Facebook hỗ trợ tạo menu để khách hàng có thể truy cập nhanh ở màn hình chat. Các menu này tương tự như 1 button để truy cập vào 1 block hoặc website.
Trả về ĐÚNG nếu tất cả các điều kiện là Đúng.
Trả về SAI nếu một trong các điều kiện là Sai
|
| OR | Trả về ĐÚNG nếu một trong các điều kiện là Đúng.
Trả về SAI nếu tất cả điều kiện là Sai
|
{% hint style="info" %}
VD: Attribute {{Tuoi}} có giá trị là 20; Attribute {{HoTen}} có giá trị 'Nguyễn Văn A'
{{Tuoi}} > 20 or {{HoTen}} start Nguyễn → Đúng
{{Tuoi}} = 20 and {{HoTen}} start Nguyễn → Đúng
{{Tuoi}} > 20 and {{HoTen}} start Nguyễn → Sai
{% endhint %}
### 4. Thêm điều kiện theo Subcriber
Đây là một trong những điều kiện mới được Smax cập nhật trong tháng 10/2020. Hiểu đơn giản Subcriber là những người được bot ghi nhận đã tương tác với page (ấn nút Bắt Đầu hoặc Get Started).
* Điều kiện **No**: Người dùng chưa là Subscriber của page.
* Điều kiện **Yes:** Người dùng đã là Subcriber của page.
* Điều kiện **In 24H**: Người dùng là Subcriber của page trong vòng 24h (liên quan đến [chính sách 24h của Messenger](https://tailieu.smax.bot/7.-thong-tin-khac/chinh-sach-facebook-messenger-nam-2020))
* Điều kiện **Over 24H:** Người dùng là Subcriber của page ngoài 24h.
### **5. Thêm điều kiện theo Attribute Vs Attribute**
Nằm trong đợt update bộ lọc vừa qua, đây là một điều kiện lọc cực kỳ thú vị. Hiểu đơn giản là tệp này nằm trong tệp kia, với điều kiện lọc mới này độ chính xác khi gửi tin hoặc setup kịch bản của bạn sẽ cực kỳ chi tiết.
{% hint style="info" %}
Ví Dụ: Bạn muốn gửi tin nhắn đến những người đã tương tác gần nhất và có quan tâm đến sản phẩm hoặc dịch vụ/sự kiện. Sau khi gắn thẻ các cho các điều kiện bạn có thể dùng bộ lọc này để set gửi đi.
{% endhint %}
Bạn đừng quên lựa chọn dấu để kết nối các điều kiện với nhau nhé.
### **6. Thêm điều kiện theo SmaxChatTag**
Ngoài chatbot thì Smax còn phát triển thêm 1 nền tảng nữa nhằm quản lý, phân loại comment và inbox. [Smax.chat](https://smax.chat/) còn cho phép bạn kết nối với Smaxbot, **Push Sale, Sapo, KiotViet** (các nền tảng quản lý bán hàng, kho vận dành cho các shop).
Với thẻ điều kiện này, Smax bot sẽ dựa trên các tag bạn lựa chọn trên Smax Chat để lọc các đối tượng lưu trong dữ liệu để gửi đến các đối tượng mà bạn muốn.
{% hint style="info" %}
Is - Lọc các đối tượng có chứa tag
Is\_not - Lọc các đối tượng có chứa tag.
{% endhint %}
# 5.1 Đăng ký gói cước
Để đăng ký gói cước mới trên Smax, bạn bấm vào nút ["Gói Cước"](https://smax.bot/packages) trên giao diện quản lý bot:
Tiếp theo, trong phần **"Gói Cước Đã Kích Hoạt"** bạn bấm vào nút **"Đắng Ký Mới":**
Bảng **"Đăng Ký Gói Cước"** hiện ra, trong phần này bạn cần điền các thông số và hệ thống sẽ tự tính tiền cho bạn:
* Số lượng Chatbot bạn muốn mua tương ứng với số lượng Page bạn muốn triển khai.
* Số Sub/ 1 Page là giới hạn Sub mà bot sẽ lưu trữ trên 1 page (càng nhiều càng rẻ)
* Tiếp theo là lựa chọn thời gian sử dụng gói cước (tối thiểu 3 tháng)
* Cuối cùng là nhập số điện thoại của bạn để nhân viên hỗ trợ có thể liên hệ
* Sau khi nhập đủ dữ liệu bạn hãy Submit để gửi yêu cầu.
Sau khi nhân viên hỗ trợ liên hệ hỗ trợ thanh toán, bạn sẽ được kích hoạt gói cước.
# 5.2 Nâng cấp gói cước
Giống với **"Đăng Ký Gói Cước"**, bạn chỉ cần bấm thêm vào nút Nâng cấp, sau đó chọn page bạn muốn nâng cấp và điều chỉnh tăng giới hạn Sub/page hoặc thời gian.
Sau khi Submit, nhân viên hỗ trợ sẽ liên hệ xác nhận và kích hoạt gói cước cho bạn.
# 5.3 Đổi page sang gói cước mới
Bạn chỉ cần add page của bạn vào gói cước khác là được.
# Broadcasting API
## Broadcasting API - V1
The Broadcasting API enables you to send any block from the bot’s structure or set user attributes via an API call.
All queries to the Broadcasting API must be served via **POST**, with the content type **application/json** and need to be presented in this form:
```
https://api.smax.bot/bots//users//send?bot_token=&block_name=&=&=&messaging_tag="CONFIRMED_EVENT_UPDATE"
```
* **\** — A unique secret token obtained for each bot. You are able to find and reset the token in Configure tab of the dashboard at any time.
* **\** — {{messenger user id}} attribute that you should get from a JSON plugin call prior to sending a message. {{messenger user id}} and {{fb\_id}} are accepted as well.
* **\** — ID of the bot you want to send the message from.
* **\** \[optional] — URL-encoded name of the block you want to send to a user. You can also use **\** — ID of the block you want to send to a user, instead.
* **\=\** \[optional] — Name and value of a user attribute you want to set up before rendering the block.
* **`messaging_tag`** — You can use 1 of the following tags: "CONFIRMED\_EVENT\_UPDATE"
* " **CONFIRMED\_EVENT\_UPDATE**"
* "**POST\_PURCHASE\_UPDATE"**
* "**ACCOUNT\_UPDATE"**
The response contains a JSON object, which always has a Boolean field success and may have an optional String field result with a human-readable description of the result. If success equals true, the request was successful. In the case of an unsuccessful request, success equals false and the error is explained in the result field.\
\
**Note:**
* You can send up to 25 RPS per bot to the Broadcasting API.
* All parameters starting with chatfuel\_ are reserved and should not be used.
## Broadcasting API - V2
```
Post API: https://api.smax.bot/public/bots//send
Headers:
{"Authorization":"Bearer "}
Body:
{
"customer_id":"", // Id khach hang
"customer_email":"", // Email khach hang
"customer_phone":"", // Phone của khach hang
"customer_fbid":"", // Id FV khach hang
"block_id":"", // nếu muốn gửi 1 block
"messages":[ // nếu muốn gửi trực tiếp nội dung
{"text":"Noi dung tin nhan"}
],
"notification_messages_token": "token NTN",
"one_time_notif_token": "token OTN",
"messaging_tag": "CONFIRMED_EVENT_UPDATE", // CONFIRMED_EVENT_UPDATE/POST_PURCHASE_UPDATE/ACCOUNT_UPDATE/HUMAN_AGENT
"priority": ["fbid","phone","email"]
}
Note:
- customer_id/email/phone/fbid: Bắt buộc phải có 1 trường, nếu có thêm thì hệ thống sẽ tự cập nhật
```
# JSON API
## JSON API
See [**here**](https://tailieu.smax.bot/2.-gioi-thieu-cac-element-card/_2.10-jsonapi)
The JSON API plugin enables you to integrate your backend into your chat bots on **Smax bot**.
It allows you to
* Generate dynamic content
* Get and set user attributes
* Redirect users to another block in the bot
* Create postbacks
You can use GET and POST requests - the max. timeout is always 10 seconds. There are four options to enter data that will be sent with your request:
1\. URL — This field supports user attributes, they will be URL-encoded with your request
2\. Full JSON profile (POST requests only) — This will send all the user attributes of the user to your backend
3\. JSON Body (POST requests only) — This is a customizable field and will be validated as JSON.[](https://chatfuel.intercom-attachments-7.com/i/o/134722067/2a574e7d0099d8b664f4e3fe/PM19ZEIe1JcF2EvLRloHceSsUx_jD0GB9HUtA5RnxhfbHP0mCF8_Lv8VeE7sh9aQ63T9ZNFlzXPWL5UrjFwxI1YhT4jh1KQkhO_Nc3qV5FGlDXRYX5OaiRo9dm9mWHhPuJN7QwMh)
4\. URL Encoded (POST requests only) — The data will be encoded before sending your request.[](https://chatfuel.intercom-attachments-7.com/i/o/134722070/2c67adf598e36f85233037a3/rx7L76uuB3w20AdmaOcM8I_5v36VEGaCpAGdlqsN8vPdhvZxq7IPY70AlxJAvv8xeE6XVH0Ny-_-bedeHZTsDzTASj6TiHH_s15MUt60SHMXOH_9fG2f-hw8OsxiOCLwzQALqHgC)
In your responses, you can
* combine several messages in one answer by sending several dictionaries in the messages array.
* use any content type header.
* send an empty response to not show the user any dynamic content.
### Response Reference
**Sending text**
Use this response to send text messages.
```
{
"messages": [
{"text": "Welcome to the Smax Rockets!"},
{"text": "What are you up to?"}
]
}
```
**Sending images**
Use this response to send image files. Messenger supports JPG, PNG and GIF images. If you are having issues with GIF rendering, please try to reduce the file size.
```
{
"messages": [
{
"attachment": {
"type": "image",
"payload": {
"url": "https://rockets.chatfuel.com/assets/welcome.png"
}
}
}
]
}
```
You can also directly use Facebook Posts with media instead of uploading it manually:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "image",
"url": "https://www.facebook.com/chatfuelrockets/photos/1087668107975064",
"buttons": [
{
"title": "Go to Chatfuel!",
"type": "web_url",
"url": "https://chatfuel.com/"
}
]
}
]
}
},
"quick_replies": [
{
"title": "That's cool!",
"payload": "string"
}
]
}
]
}
```
**Sending video**
Use this response to send video files. Messenger supports MP4 videos, which are up to 25MB in size.
```
{
"messages": [
{
"attachment": {
"type": "video",
"payload": {
"url": "https://rockets.chatfuel.com/assets/video.mp4"
}
}
}
]
}
```
You can also directly use Facebook Posts with media instead of uploading it manually:
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "media",
"elements": [
{
"media_type": "video",
"url": "https://www.facebook.com/chatfuelrockets/videos/252894858962779/",
"buttons": [
{
"title": "Go to Chatfuel!",
"type": "web_url",
"url": "https://chatfuel.com/"
}
]
}
]
}
},
"quick_replies": [
{
"title": "That's cool!",
"payload": "string"
}
]
}
]
}
```
**Sending audio**
Use this response to send audio files. Messenger supports MP3, OGG, WAV audios, which are up to 25MB in size.
```
{
"messages": [
{
"attachment": {
"type": "audio",
"payload": {
"url": "https://rockets.chatfuel.com/assets/hello.mp3"
}
}
}
]
}
```
**Sending files**
Use this response to send any other files, which are no larger than 25 MB.
```
{
"messages": [
{
"attachment": {
"type": "file",
"payload": {
"url": "https://rockets.chatfuel.com/assets/ticket.pdf"
}
}
}
]
}
```
**Sending galleries**
Use this response to send a horizontal scrollable gallery. Each item is composed of an image attachment, short description and buttons to request input from the user.\
Note: messenger\_extensions should only be added if you are using [Messenger Extensions](https://docs.chatfuel.com/configure/chat-extensions).
```
{
"messages": [
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"image_aspect_ratio": "square",
"elements":[
{
"title":"Chatfuel Rockets Jersey",
"image_url":"https://rockets.chatfuel.com/assets/shirt.jpg",
"subtitle":"Size: M",
"buttons":[
{
"type":"web_url",
"url":"https://rockets.chatfuel.com/store",
"title":"View Item"
}
]
},
{
"title":"Chatfuel Rockets Jersey",
"image_url":"https://rockets.chatfuel.com/assets/shirt.jpg",
"subtitle":"Size: L",
"default_action": {
"type": "web_url",
"url": "https://rockets.chatfuel.com/store",
"messenger_extensions": true
},
"buttons":[
{
"type":"web_url",
"url":"https://rockets.chatfuel.com/store",
"title":"View Item"
}
]
}
]
}
}
}
]
}
```
**Sending receipts**
Use this response to send an order confirmation. It may include an order summary, payment details, and shipping information.
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "receipt",
"recipient_name": "Mark Zuckerberg",
"order_number": "12345678901",
"currency": "USD",
"payment_method": "Visa 2345",
"order_url": "https://rockets.chatfuel.com/store?order_id=12345678901",
"timestamp": "1428444666",
"address": {
"street_1": "1 Hacker Way",
"street_2": "",
"city": "Menlo Park",
"postal_code": "94025",
"state": "CA",
"country": "US"
},
"summary": {
"subtotal": 105,
"shipping_cost": 4.95,
"total_tax": 9,
"total_cost": 118.95
},
"adjustments": [
{
"name": "CF Rockets Superstar",
"amount": -25
}
],
"elements": [
{
"title": "Chatfuel Rockets Jersey",
"subtitle": "Size: M",
"quantity": 1,
"price": 65,
"currency": "USD",
"image_url": "http://rockets.chatfuel.com/assets/shirt.jpg"
},
{
"title": "Chatfuel Rockets Jersey",
"subtitle": "Size: L",
"quantity": 1,
"price": 65,
"currency": "USD",
"image_url": "http://rockets.chatfuel.com/assets/shirt.jpg"
}
]
}
}
}
]
}
```
**Buttons**
Use this JSON to add buttons to your responses. You can set buttons to link to a block in the dashboard, open a website, or send another request to your backend. Buttons are limited to 3 items per message.
```
{
"messages": [
{
"attachment": {
"type": "template",
"payload": {
"template_type": "button",
"text": "Hello!",
"buttons": [
{
"type": "show_block",
"block_names": ["name of block"],
"title": "Show Block"
},
{
"type": "web_url",
"url": "https://rockets.chatfuel.com",
"title": "Visit Website"
},
{
"url": "https://rockets.chatfuel.com/api/welcome",
"type":"json_url",
"title":"Postback"
}
]
}
}
}
]
}
```
You can also use the Call button, this button dials a phone number when tapped.
```
{
"messages":[
{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Get in touch",
"image_url":"https://rockets.chatfuel.com/assets/contact.jpg",
"subtitle":"Feel free to hit us up!",
"buttons":[
{
"type":"phone_number",
"phone_number":"+19268881413",
"title":"Call"
}
]
}
]
}
}
}
]
}
```
**Quick replies**
Use this JSON to add quick replies to your responses. Quick replies are limited to 11 items per message.
```
{
"messages": [
{
"text": "Did you enjoy the last game of the CF Rockets?",
"quick_replies": [
{
"title":"Loved it!",
"block_names": ["Block 1", "Block 2"]
},
{
"title":"Not really...",
"url": "https://rockets.chatfuel.com/api/sad-match",
"type":"json_url"
},
{
"title": "More...",
"payload": "string"
}
]
}
]
}
```
**Setting user attributes**
You can set user attributes by having the field set\_attributes as bellow
```
{
"set_attributes":
{
"some attribute": "some value",
"another attribute": "another value"
},
"messages":[
. . .
]
}
```
**Redirect to blocks**
You can redirect a user to a block or to a sequence of blocks — no user action is needed.
```
{
"redirect_to_blocks": ["Welcome Message", "Default Answer"]
}
```
\
Do keep in mind that for other functionalities or compiling functions to work altogether is out of Chatfuel's scope of support and we suggest to get help from an expert.
# Chính sách Facebook Messenger năm 2020
Facebook Messenger thay đổi những gì?
Chính sách mới của **Facebook Messenger** sẽ hạn chế doanh nghiệp chỉ có thể gửi lượng tin nhắn giới hạn thay vì sử dụng chatbot như trước đây. Cụ thể hơn, dự kiến kể từ ngày 4/3/2020, trừ phi chạy quảng cáo trên Messenger, doanh nghiệp chỉ có thể inbox cho khách hàng nếu thỏa mãn ít nhất một trong ba điều kiện: inbox được gửi chỉ trong vòng 24h, ngoài 24 giờ thì tin nhắn thuộc về một trong bốn loại tag, và mã API 1 lần cho khách hàng đã đăng kí (subscribe).
#### **1. Chính sách 24h**
Mỗi khi khách hàng trả lời chatbot, doanh nghiệp sẽ có 24 tiếng tiếp theo để gửi tin nhắn inbox mà không gặp giới hạn nào về nội dung. Ví dụ như sau:
Chatbot gửi tin cho khách hàng vào phút 0.
TH1: Khách tương tác sau X phút. Chatbot có thể gửi tin tiếp theo trong vòng 24 giờ kể từ X.
TH2: Khách không tương tác sau Y giờ. Cửa sổ nhắn tin chỉ còn hiệu lực sau 24-Y giờ. Nếu sau 24 giờ khách vẫn không trả lời thì chatbot không thể gửi tin tới khách được nữa.
Đây là những hành động được coi là phản ứng khách hàng:
* Khách hàng gửi tin nhắn về trang
* Khách hàng click vào một nút trên Main Menu
* Khách hàng click vào 1 phím trả lời nhanh
* Khách hàng lựa chọn trong 1 tin nhắn thăm dò hoặc 1 tin nhắn khuyến mại
* Khách hàng bấm nào phím ” Bắt đầu” ( Get Started ) trên màn hình chào ban đầu
* Khách hàng bấm vào Tin nhắn tài trợ (tin nhắn trả tiền cho Facebook)
* Khách hàng bấm vào link chuyển hướng tới Messenger bên trong email.
#### **2. Thẻ tin nhắn (Tag)**
Vậy còn những tin nhắn gửi ngoài 24h? Doanh nghiệp vẫn có thể gửi tin nhắn tới khách hàng nếu tin nhắn đó thuộc vào một trong bốn loại dưới đây và được gắn thẻ đúng với nội dung nó truyền tải. Facebook Messenger cho phép các loại tin nhắn sau:
* **Xác nhận sự kiện (Confirmed event reminder)**
Thẻ này dùng để gửi cho khách hàng lời nhắc hoặc cập nhật về 1 sự kiện mà họ đã đăng kí ( ví dụ như cập nhật sự kiện hoặc nhắc nhở về việc mua vé, giờ giấc khai mạc..)
* **Cập nhật sau mua hàng (Post purchase update)**
Tin nhắn xác nhận với khách hàng sau sự kiện mua hàng. Ví dụ như xác nhận giao dịch đã thành công hoặc thông báo tình trạng vận chuyển.
* **Cập nhật tài khoản (Account Update)**
Tin nhắn thông báo cho người dùng về thay đổi trên tài khoản hoặc mẫu form đăng kí, đăng nhập. Ví dụ như hoàn tất nộp đơn, hoặc thông báo có hoạt động khả nghi bất thường trên tài khoản.
* **Nhân sự tư vấn (Human Agent)**
Thẻ này cho phép các tư vấn viên thật sự có thể hồi đáp yêu cầu của khách hàng. Tin nhắn có thể gửi trong vòng 7 ngày sau tin nhắn của khách hàng. Tuy nhiên thẻ này vẫn trong tình trạng thử nghiệm trong nội bộ Facebook và chưa ứng dụng ra bên ngoài.
#### **3. Thông báo một lần (One Time Notification)**
One Time Notification dành cho các khách hàng đã yêu cầu được nhận thông báo từ doanh nghiệp (Ví dụ như khách đăng kí nhận thông báo đã có hàng trở lại, khách đăng kí nhận vé đã mở bán, thông báo chương trình ưu đãi tháng..)
Khi người dùng yêu cầu được thông báo, trang sẽ nhận được mã API tương đương với quyền gửi một tin nhắn cho người dùng. Mã này chỉ có thể được sử dụng một lần và sẽ hết hạn trong vòng 1 năm kể từ khi tạo.
Như vậy nếu khách hàng đã đăng kí nhận tin nhắn từ doanh nghiệp, khi tới chương trình/ sự kiện/ nội dung mà khách hàng yêu cầu, doanh nghiệp có thể inbox thông tin đó tới những người đã đăng kí, cho dù đã quá 24h sau lần tương tác cuối.
Tại sao Facebook Messenger thay đổi chính sách nhắn tin?
Theo **thông báo chính thức từ Facebook,** nguyên nhân khiến Facebook đưa ra thay đổi này là để:
+/ Trả lời khách hàng kịp thời, đúng lúc ngay khi khách hàng cần
+/ Doanh nghiệp cần tăng cường chia sẻ những cập nhật trực tiếp liên quan tới khách hàng.
+/ Chấm dứt tình trạng spam qua Facebook Messenger.
Hiện tại doanh nghiệp có những cách nào để gửi tin nhắn Facebook Messenger tới khách hàng?
\- Gắn tin nhắn với 1 trong 4 thẻ trên hoặc tuân thủ luật 24h. Lưu ý nội dung của bạn cần phù hợp với các thẻ đó.
\- Với những tin nhắn ngoài khung 24h hoặc không thuộc vào 1 trong 4 thẻ trên, bạn có thể dùng tin nhắn được tài trợ, nói cách khác là chạy quảng cáo Messenger. Về cơ bản bạn phải trả tiền để gửi tin nhắn tiếp tới những người chưa từng tương tác với chatbot.