# Giới thiệu SMS Chatbot Banking

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPzMpoZVJGGFQYZD3c%2F-MjQ-TV1eSmlMBaVbcNw%2Fimage.png?alt=media\&token=c103fb8e-324e-4b7b-9c20-40b80cc3b922)

### ✅ SMS Chatbot Banking giúp bạn:

* Gửi tin nhắn SMS từ sim điện thoại của bạn.
* Gửi tin nhắn SMS hàng loạt có cá nhân hoá nội dung.
* Lên lịch gửi tin nhắn SMS.
* Trả lời SMS tự động dựa theo từ khoá.
* Quản lý nhiều thiết bị, nhiều sim trong cùng 1 tài khoản.
* Ra lệnh gửi SMS đến các thiết bị quản lý qua đăng nhập trên app và web.
* Xem lịch sử trạng thái các tin nhắn.
* API tích hợp để gửi tin nhắn từ hệ thống khác.
* API check nội dung, từ khoá theo Brandname.
* API lưu nội dung bất kỳ lên hệ thống như 1 SMS.
* Webhook đẩy SMS nhận được qua bên khác.
* Webhook đẩy SMS nhận được dựa theo từ khoá.
* Hỗ trợ tốt Broadcast API của chatbot Smax.Bot.
* Plugin tích hợp nhắn tin SMS cho Woocommerce.
* Plugin tích hợp Xác nhận thanh toán tự động cho Woocommerce.


# Đăng ký tài khoản

Để đăng ký tài khoản dùng thử phần mềm, các bạn truy cập vào website <https://sms.quanchatbot.com>.&#x20;

Bấm link đăng ký để bắt đầu:

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNZqj-ETVSgCy5zgRk%2F-MjPVj0ZijM2NYXn3lfW%2Fimage.png?alt=media\&token=7d92129f-3710-4c36-9d52-4f2195d1259b)

Tại form đăng, ký, bạn nhập thông tin bao gồm tên và địa chỉ email. Địa chỉ email được yêu cầu nhập 2 lần để đảm bảo chính xác. Nhập xong nhấn vào nút Đăng ký:

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNZqj-ETVSgCy5zgRk%2F-MjPVtZelB4wQcsZjQlU%2Fimage.png?alt=media\&token=11cf78f8-4d4d-4fa4-be17-fc01123fa023)

Sau khi nhấn đăng ký, hệ thống sẽ gửi email chứa thông tin truy cập, các bạn mở hộp thư và lấy thông tin truy cập để đăng nhập vào hệ thống.


# Cài đặt phần mềm lên điện thoại Android

Sau khi đã đăng nhập vào hệ thống, các bạn thực hiện theo hướng dẫn để cài đặt file APK lên điện thoại Android. Ứng dụng được cài đặt này sẽ thực hiện các mệnh lệnh gửi tin nhắn theo yêu cầu từ hệ thống và gửi lên hệ thống các tin nhắn đến.

Đầu tiên, bạn tải file APK về máy điện thoại của mình. Link tải tại đây: <https://sms.quanchatbot.com/sms-gateway.apk> (Các bạn dùng điện thoại có thể quét mã QR bên dưới để tải)

![Quét mã để tải file apk ứng dụng](https://xep.li/smschatbot/qr)

Trên điện thoại, các bạn chọn file APK đã tải để bắt đầu cài đặt. Lưu ý: để cài đặt được các file APK, điện thoại phải được cho phép cài đặt file từ nguồn không xác định. Thực hiện theo hướng dẫn: <https://quantrimang.com/file-apk-la-gi-lam-the-nao-de-tai-va-cai-dat-file-apk-124538>

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNOmIsweAVocoLkwKF%2F-MjNPwS7ZlxRyn-nXRRZ%2Fimage.png?alt=media\&token=a644ffa8-3b67-43eb-bb6b-c364fedcf062)


# Thêm thiết bị Android vào hệ thống

Sau khi đã cài đặt thành công, các bạn bật app SMS Gateway vừa cài xong và đăng nhập bằng 1 trong 2 cách:

1. Đăng nhập theo tài khoản được cung cấp qua email.
2. Chọn **SIGN IN USING QR CODE**: Đăng nhập trên máy tính, vào mục Thiết bị và bấm nút Thêm thiết bị. Dùng chức năng quét mã QR của ứng dụng SMS Gateway để quét mã được cung cấp trên màn hình máy tính.

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNOmIsweAVocoLkwKF%2F-MjNQuqALUN9d2VmNSU3%2Fimage.png?alt=media\&token=6ab0c3fb-4fbf-49db-aa05-7617b242b10b)

Lặp lại thao tác cài đặt và thêm thiết bị cho các điện thoại Android khác vào tài khoản của bạn.

{% hint style="warning" %}
Nên thêm **nhiều thiết bị** để sử dụng khi cần nhắn tin hàng loạt. Sử dụng ngẫu nhiên các sim, nội dung tin nhắn... nhằm hạn chế bị khoá sim do gửi quá nhiều tin một ngày.
{% endhint %}


# Nâng cấp tài khoản

## Tài khoản đăng ký mới sẽ có:

* Thời gian hoạt động: 15 ngày.
* Credits: 200.
* Số lượng thiết bị: Không giới hạn.
* Số lượng liên hệ: Không giới hạn.
* API gửi tin nhắn: Có.
* API kiểm tra Banking: Có
* Webhook cho chatbot: Không.

### Credit trừ dần khi thực hiện các hành động sau:

* Gửi SMS thông qua hệ thống hoặc qua API.
* Gọi API kiểm tra tin nhắn biến động số dư.

## Cách nâng cấp tài khoản:

1. Vào menu Nâng cấp tài khoản.
2. Thực hiện chuyển khoản hoặc Quét mã QR để chuyển khoản theo đúng hướng dẫn trên màn hình.

### Quyền lợi gói nâng cấp:

* +10.000 credits (cộng dồn với số credits đã có)
* 3 tháng sử dụng kể từ ngày chuyển khoản nâng cấp (không cộng dồn)
* Số lượng thiết bị: Không giới hạn.
* Số lượng liên hệ: Không giới hạn.
* API gửi tin nhắn: Có.
* API kiểm tra Banking: Có
* Webhook cho chatbot: Có.


# Gửi tin nhắn SMS lẻ

Để gửi tin nhắn, các bạn truy cập vào mục Gửi tin nhắn trên hệ thống ở trình duyệt (hoặc Sender trên app). Tại đây, bạn có thể gửi tin nhắn lẻ hoặc gửi tin nhắn hàng loạt theo dữ liệu từ file Excel.

Ở phần gửi tin nhắn lẻ, các bạn chọn thiết bị và sim sẽ thực hiện gửi tin nhắn đi, nhập các số điện thoại cần gửi (cách nhau bằng dấu phẩy), lên lịch gửi, nhập nội dung tin nhắn rồi nhấn GỬI để gửi.

Để gửi được tin nhắn thành công, điện thoại của bạn phải được kết nối với hệ thống và đang có kết nối Internet.

![Giao diện Gửi tin trên trình duyệt](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPmw4R0MUMI82yAwsq%2F-MjPshMhw0LxWtTcyrgP%2Fimage.png?alt=media\&token=22c89fb7-eac9-47eb-9145-4f9f5b0301cb)


# Gửi tin nhắn SMS hàng loạt

Trong phần Gửi tin nhắn của hệ thống trên trình duyệt, khi kéo xuống dưới bạn sẽ thấy chức năng gửi tin nhắn hàng loạt theo dữ liệu file Excel.

Giao diện mục gửi tin hàng loạt như sau:

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPmw4R0MUMI82yAwsq%2F-MjPuY1cdKR9r7G1CSmb%2Fimage.png?alt=media\&token=35c03745-a302-428c-8e37-389f365767bd)

Mục Thiết bị cho phép bạn chọn Thiết bị hoặc Sim sẽ thực hiện gửi tin nhắn. Nếu bạn kết nối nhiều điện thoại vào hệ thống và chọn nhiều điện thoại, hệ thống sẽ tự động phân chia gửi tin cho tất cả các sim và các điện thoại được chọn.

Mục Lịch gửi cho phép bạn lên lịch để gửi tin nhắn. Để thực hiện đúng phần lên lịch, bạn phải đảm bảo múi giờ bạn cài đặt cho Tài khoản (trong trang Tài khoản) và múi giờ cài đặt trên các điện thoại kết nối vào hệ thống phải đồng nhất với nhau.

Tiếp theo, các bạn cần upload file Excel đã chứa dữ liệu để có thể gửi tin nhắn. Các bạn tải file mẫu về và nhập số điện thoại ở mục Mobile Number, mục Message (Tin nhắn) không bắt buộc.

**Tin nhắn:** Mục này nếu bạn không nhập gì thì hệ thống sẽ gửi đi nội dung trong cột Message ở file Excel. Nếu bạn nhập nội dung ở mục này, hệ thống sẽ bỏ qua nội dung tin nhắn trong file Excel.

Để có thể tùy biến nội dung tin nhắn, các bạn có thể thêm cú pháp %col-\<stt\_cột>% trong nội dung tin nhắn. Ví dụ như chúng ta có bảng Excel như sau:

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPmw4R0MUMI82yAwsq%2F-MjPv-fH_30yoqFEhXa9%2Fimage.png?alt=media\&token=9aa7370f-2a6b-47b8-b4b7-a738570aff49)

Chúng ta có thể tùy biến nội dung tin nhắn như sau:

> Xin chao %col-2%, cam on ban da mua hang voi so tien la %col-3% tai shop ABC, chung toi gui ban Coupon.

Khi đó, hệ thống sẽ lắp dữ liệu tương ứng vào tin nhắn được gửi đi, ví dụ:&#x20;

> **Xin chao Nam, cam on ban da mua hang voi so tien la 1000000 tại shop ABC, chung toi gui ban Coupon...**

Sau khi đã thiết lập chiến dịch gửi tin hàng loạt, các bạn chọn **Gửi** để tiến hành.


# Cách hạn chế bị chặn SIM gửi SMS

Chính phủ đưa ra nghị định 77, bắt buộc nhà mạng phải có biện pháp chặn tin nhắn rác tránh làm phiền thuê bao sử dụng mạng. Vì thế tối thiểu bạn cần phải vượt qua được cơ chế này.

Nếu sim bạn gửi quá nhiều tin giống nhau hoặc gửi quá liên tục, nhà mạng sẽ chặn tin nhắn gửi tin nhắn đi của SIM trong vòng 24h tiếp theo.

* Theo quy định, bạn không được gửi quá 2.000 tin nhắn mỗi giờ. Tuy nhiên đối với tin nhắn quảng cáo, mỗi ngày chỉ nên gửi dưới 50 tin nhắn/sim.
* Các nhà mạng sử dụng cơ chế đọc nội dung bằng AI để phát hiện tin nhắn quảng cáo.
* Khoảng cách thời gian giữa 2 tin nhắn bạn nên đặt cấu hình khoảng 30-40s, mỗi phút chỉ nên gửi 1 đến 2 tin nhắn
* Nội dung tin nhắn cần phải có sự khác biệt, sử dụng tính năng gửi theo mẫu file Excel để cá nhân hoá SMS, giúp thay đổi nội dung tin nhắn cho từng thuê bao.

Trong trường hợp bị chặn gửi tin nhắn đi, vui lòng chờ đợi sau 24h để thực hiện lại hoặc gọi tổng đài nhà mạng để nhờ tổng đài viên mở khóa chức năng gửi SMS.

{% hint style="success" %}
Nếu bạn muốn chạy các chiến dịch spam tin nhắn số lượng lớn, cần chuẩn bị nhiều thiết bị điện thoại (mỗi thiết bị có thể gắn vào 2 sim) và nhiều sim để gửi đi.
{% endhint %}

Trong phần gửi tin hàng loạt, bạn nên chọn phương án sử dụng tất cả các sim của tất cả thiết bị để gửi tránh bị spam. Việc kết hợp nhiều sim / thiết bị có thể giúp cho số lượng tin nhắn gửi đi mỗi ngày được nhiều hơn, hạn chế sim bị khóa.


# Các thuật ngữ trạng thái của tin nhắn

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPzMpoZVJGGFQYZD3c%2F-MjQ-ESkmfAqyEVJAQPg%2Fimage.png?alt=media\&token=2bd3a113-116a-4298-b97d-c0dce89152c1)

* Pending: Lệnh gửi tin nhắn đang chờ thực hiện.
* Scheduled: Lệnh gửi tin nhắn đã được lên lịch để thực hiện.
* Queued: Lệnh gửi tin nhắn đã được thêm vào hàng đợi để gửi đi. Trong những trường hợp như thiết bị chưa online (hết pin, không kết nối mạng), nếu tin nhắn được chuyển đến thiết bị di động để gửi thì sẽ ở tình trạng queued. Một trường hợp khác, tin nhắn được cấu hình gửi nhưng thiết bị đang triển khai gửi các tin nhắn khác, thì tin nhắn mới cũng sẽ có trạng thái Queued.
* Failed: Lỗi khi gửi tin do tài khoản SIM hết tiền, số bị chặn hoặc số người nhận bị sai.
* Received: Số tin nhắn đã nhận.
* Sent: Tin nhắn đã được gửi đi nhưng chưa rõ người nhận đã nhận được hay chưa.
* Delivered: Tin nhắn đã được gửi đi và chuyển thành công đến điện thoại người nhận.


# Bonus: Tổng hợp gói SMS giá rẻ cho các nhà mạng

Nội dung mang tính chất tham khảo, có thể thay đổi theo tình hình thực tế. Bạn nên liên hệ nhà mạng để tìm hiểu gói SMS tốt nhất.

## Nhà mạng Viettel

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPvMat_Fq69Weq3NBs%2F-MjPy0QnXBb4PpYJ_q_T%2Fimage.png?alt=media\&token=28cbfbcb-0038-4438-85f2-c94a18b8d328)

## Nhà mạng Mobifone

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPvMat_Fq69Weq3NBs%2F-MjPyH9lknHAOK7Az-p3%2Fimage.png?alt=media\&token=5f3bc35b-5d7d-4fd9-8bb0-b127130c9979)

## Nhà mạng Vinaphone

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjPvMat_Fq69Weq3NBs%2F-MjPyNUJHiiWRwol9j8o%2Fimage.png?alt=media\&token=7b4d1db4-6a23-4ab1-bda8-06927e68c9b8)


# Cài đặt Chatbot gửi tin SMS thông qua thẻ Xem.li SMS

Giả sử ta có kịch bản: Khách hàng vào chatbot → chatbot xin số điện thoại để gửi mã OTP → khách hàng nhận được tin nhắn sms từ sim của bạn có chứa OTP → xác thực OTP với chatbot.\
\
\*\*1️⃣Bước 1: Lấy thông tin API Key tài khoản của bạn tại <https://sms.xem.li**\\>
\- Bạn đăng nhập vào <https://sms.xem.li> ► bấm vào menu API-Smax.Bot ► tìm đến mục **API Key** ► Lưu lại API Key

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2F0mXnKFI6qjxUY81tISpe%2Fimage.png?alt=media\&token=8511a239-8509-43e0-a1ee-289bf29f26d9)

\
**2️⃣Bước 2: Cấu hình tích hợp Xem.li SMS trong Smax.bot** \
\- Bạn vào chatbot của bạn ► chọn **Integrations** ► **Thêm mới** ► chọn **Xem.li SMS** ► nhập tên ghi nhớ ► nhập API Key đã copy ở Bước 1 ► **Update**

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2F7DEn1i2jtOBBe308FjfQ%2Fimage.png?alt=media\&token=a0190db2-beb1-434c-bca4-8d7edebe312f)

**3️⃣Bước 3: Dùng thẻ Xem.li SMS để gửi**\
\- Tạo block kịch bản: khách hàng để lại số điện thoại ► chatbot gửi OTP qua SMS cho khách ► Khách nhập OTP để xác thực\
Dưới đây là minh hoạ 1 block sử dụng chatbot để xác minh OTP điện thoại khách hàng.

![Sau khi xin số điện thoại xong, sẽ chọn sim/thiết bị gửi sms cho khách.](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2Fcbv1S8rW1KWiwFfKGoHi%2Fimage.png?alt=media\&token=cefabce6-08af-4829-acbd-50e3060b9820)

![Sau khi gửi OTP xong, sẽ yêu cầu khách nhập OTP từ SMS nhận được và cho so sánh 2 attribute.](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2Fazrb7BKDt0Mau93yyG3p%2Fimage.png?alt=media\&token=414754c3-5774-49c5-9fe9-c2b0238b3837)

{% hint style="info" %}

* Có thể chọn nhiều sim/thiết bị trong danh sách dùng để gửi sms, hệ thống sẽ tự động random 1 trong số đó.
* Ngoài ra bạn có thể cấu hình gửi bằng sim nào theo đầu số nào để có thể tận dụng việc dùng sim cùng nhà mạng để gửi, việc này giúp tiết kiệm chi phí SMS.
  {% endhint %}

![Cấu hình chọn sim gửi dựa theo đầu số điện thoại của khách](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2FFQcRZNrTEz4ZkVvxmWZT%2Fimage.png?alt=media\&token=310fb3f1-813a-4822-8232-8cdde56e06a0)


# Cài đặt Chatbot gửi tin SMS thông qua API

Giả sử ta có kịch bản: Khách hàng đăng ký thông tin trong chatbot → chatbot gửi mã coupon đến số điện thoại bằng chính sim đang lắp trên điện thoại có cài ứng dụng SMS Gateway.

### Bước 1: Tạo link API mẫu gửi tin SMS

* Truy cập mục API - Smax.Bot → đến phần Tạo link mẫu

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjmI3R5lc3zqmpsLCVx%2F-MjmKN3EhA4qh__5btgJ%2Fimage.png?alt=media\&token=8e0154f7-fd11-43ab-a16d-9c21a3020f6c)

* Nếu bạn muốn hệ thống tự chọn ngẫu nhiên thiết bị và sim để gửi sms thì có thể copy link nhanh có sẵn.
* Nếu bạn cần chọn riêng thiết bị / sim sẽ gửi tin thì nhập các dữ liệu mẫu và bấm nút Tạo Link mẫu. Lúc này chú ý đoạn cuối cùng của link có tham số: **\&devices=XX**
* Như vậy link API mẫu của bạn sẽ có dạng: **<https://sms.quanchatbot.com/services/send.php?key=AAAA\\&number=BBBB\\&message=CCCC\\&devices=XX>**
  * **AAAA:** API Key
  * **BBBB:** Số điện thoại người nhận SMS
  * **CCCC:** Nội dung SMS sẽ gửi
  * **XX:** Mã thiết bị / sim sẽ được chọn để gửi SMS

### Bước 2: Xây dựng kịch bản chatbot xin điện thoại và gửi coupon qua SMS

{% content-ref url="/pages/-MjNVLfcmPL83am-SD6v" %}
[Phụ lục: Hướng dẫn tạo chatbot cơ bản](/ket-noi-sms-va-chatbot/phu-luc-huong-dan-tao-chatbot-co-ban)
{% endcontent-ref %}

* Tạo 1 block có sử dụng User Input để xin số điện thoại khách hàng lưu vào **{{phone}}**
* Thêm thẻ Set Attributes để tạo attribute **{{sms}}** là nội dung SMS sẽ gửi.
* Dùng JSON API đã chuẩn bị ở bước 1 để gửi SMS với:
  * BBBB sẽ là attribute **{{phone}}**
  * CCCC sẽ là attribute **{{sms}}**


# Cài đặt đẩy SMS nhận được từ điện thoại lên chatbot

Hướng dẫn này chỉ dành cho người đã có chatbot đang hoạt động bằng nền tảng Smax.Bot. Nếu bạn chưa biết chatbot là gì, hãy xem các bài hướng dẫn đầu tiên tại <https://bot.vn/hoc-chatbot/> hoặc 2 video ở phụ lục để tạo chatbot cho mình nhé!

{% content-ref url="/pages/-MjNVLfcmPL83am-SD6v" %}
[Phụ lục: Hướng dẫn tạo chatbot cơ bản](/ket-noi-sms-va-chatbot/phu-luc-huong-dan-tao-chatbot-co-ban)
{% endcontent-ref %}

Sau khi đã có chatbot, giờ mình sẽ tiến hành thao tác cài đặt để khi có tin nhắn SMS mới thì báo về Messenger theo các bước sau:

1\. **BƯỚC 1:** vào app đã cài trên điện thoại và bật mục **Read Received** lên.

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNOmIsweAVocoLkwKF%2F-MjNRwzN0eHX_uynlYKR%2Fimage.png?alt=media\&token=01c36dc0-2187-45e4-82fc-e27a8c123498)

2\. **BƯỚC 2:** Vào bot, tạo 1 block báo tin có SMS (ví dụ như bên dưới là thẻ Text).&#x20;

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNSG52z16z36T0bVXM%2F-MjNWZOcGFmXQPZFjzTP%2Fimage.png?alt=media\&token=3a9a825c-e682-4872-89fe-93952ed75710)

> * Số điện thoại người gửi sẽ được lưu trong attribute **{{number}}** và toàn bộ nội dung sms sẽ được lưu trong attribute **{{message}}**.
> * Bạn sẽ dựa vào 2 attribute này để phát triển luồng chatbot xử lý như: báo về Telegram, Email, bắt từ khoá trong sms...

3\. **BƯỚC 3:** Tạo Broadcast API mới cho block, copy link broadcast và điền vào ô Webhook Broadcast API SmaxBot bên dưới rồi Lưu lại. (chú ý chỗ Messenger User ID là mã số của người phụ trách nhận tin báo từ chatbot, có thể tìm mã số này ở mục Customers)

![Tạo Broadcast API và copy link này](https://i.imgur.com/rzJWuL0.png)

4\. **BƯỚC 4:** Dán link Broadcast API đã tạo ở bước 2 vào rồi bấm Lưu webhook.

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjNSG52z16z36T0bVXM%2F-MjNWErSJsgFnNFbHhJE%2Fimage.png?alt=media\&token=722119b0-2750-4418-a450-3f5de903c0f7)

Như vậy, mỗi khi điện thoại Android của bạn nhận được SMS, chatbot sẽ gửi tin nhắn Messenger theo Messenger User ID đã khai báo, với nội dung của tin nhắn đã thực hiện ở bước 2.


# Cài đặt đẩy SMS nhận được lên chatbot dựa theo từ khoá

Nếu trường hợp bạn cần chọn lọc lại SMS mà điện thoại nhận được, chỉ những SMS có từ khoá phù hợp trong nội dung mới được đẩy lên chatbot, thì bạn sử dụng tính năng SMS Automation và khai báo như ảnh bên dưới.

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjmbxgDGVtRUylQmEe4%2F-Mjmpb47iTtmqf7iiqqI%2Fimage.png?alt=media\&token=afd2b5af-3bb6-4166-accf-473a5808ba0d)

Như vậy theo ảnh minh hoạ, khi điện thoại nhận được SMS có chứa AAA trong nội dung thì {{number}} và {{message}} sẽ được gửi lên bot qua [Broadcast API](/ket-noi-sms-va-chatbot/cai-dat-day-sms-tu-dien-thoai-len-chatbot) bạn đã khai báo.

Với tính năng này, bạn hoàn toàn có thể chủ động tạo ra nhiều từ khoá cho về các block xử lý tương ứng các từ khoá này.

Vận dụng thêm thẻ Split của Smax.Bot, bạn có thể ứng dụng cho nhiều trường hợp như:

* Xác nhận đơn hàng tự động
* Xác thực điện thoại
* Đẩy API sang các hệ thống xử lý đơn hàng khác
* ....


# Phụ lục: Hướng dẫn tạo chatbot cơ bản

{% embed url="<https://www.youtube.com/watch?v=LYu8NWAeFAo>" %}
Bài 1.1: Giới thiệu về chatbot
{% endembed %}

{% embed url="<https://www.youtube.com/watch?v=fqOi3WEllcU>" %}
Bài 1.2: Xây dựng kịch bản chatbot cơ bản
{% endembed %}


# Plugin SMS thông báo đơn hàng, tài khoản...

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2FuvGUl21O7yDoHqu7bKw3%2Fimage.png?alt=media\&token=0f453706-722a-4383-bc08-697d4b08d312)

Plugin này hỗ trợ bạn có thể gửi tin nhắn đến khách hàng khi khách hàng tạo tài khoản, đặt hàng, đơn hàng thay đổi trạng thái: được xử lý, hủy đơn hàng, hoành thành đơn hàng hoặc gửi tin nhắn thông báo đơn hàng mới cho chủ shop / nhân viên.\
**Yêu cầu:** chỉ áp dụng đối với các website Wordpress đang sử dụng **Woocommerce**.

### Bước 1: Cài đặt Plugin

* Tải plugin tại: <https://xem.li/pluginsms1>
* Đăng nhập vào quản trị của Wordpress → chọn Plugin → bấm **Cài mới** (Add New)
* Tải Plugin lên và Kích hoạt

### Bước 2: Cấu hình Plugin

* Vào Woocommerce → chọn Cài đặt → chọn SMSChatbot
* Khai báo API Key được lấy từ mục API Key tại <https://sms.quanchatbot.com/api.php>
* Tuỳ chọn thiết bị gửi tin:
  * **Sử dụng tất cả thiết bị**: hệ thống sẽ dùng sim mặc định của các thiết bị bạn đã kết nối vào hệ thống để gửi tin nhắn.
  * **Sử dụng tất cả sim của tất cả thiết bị**: hệ thống sẽ sử dụng tất cả các sim đang hoạt động của tất cả các thiết bị bạn đã kết nối vào hệ thống để gửi tin nhắn.
  * **Sử dụng những thiết bị được lựa chọn**: chỉ sử dụng đúng thiết bị mà bạn chỉ định ở dưới.
  * Trong trường hợp bạn chọn phương án Sử dụng những thiết bị được lựa chọn, bạn phải nhập mã thiết bị và sim dùng để gửi tin nhắn theo cú pháp như mô tả.

### Bước 3: Kích hoạt gửi tin nhắn Woocommerce

* Check vào các ô bạn cần gửi tin.
* Chỉnh sửa nội dung tin nhắn sẽ gửi.
* Để tùy biến nội dung tin nhắn, bạn có thể sử dụng thêm các cú pháp sau:
  * Mã đơn hàng: **%%orderid%%**
  * Họ tên khách hàng: **%%firstName%% %%lastName%%**
  * Tổng tiền đơn hàng: **%%total%%**
  * Số điện thoại khách hàng: **%%phone%%**


# Plugin Xác nhận thanh toán dựa trên SMS

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjlvjjaNEc-99bkB-B0%2F-Mjlwe8B8sM6Qru2TLV9%2Fimage.png?alt=media\&token=a3acf986-d198-4726-8e69-5beaa9d7a430)

Plugin này hỗ trợ bạn xác nhận đơn hàng đã thanh toán tự động bằng cơ chế: nhận diện cú pháp thanh toán có trong nội dung SMS báo biến động số dư từ ngân hàng.\
**Yêu cầu:**&#x20;

1. Chỉ áp dụng đối với các website Wordpress đang sử dụng **Woocommerce**.
2. Đã cài app và bật chức năng đẩy SMS nhận được lên hệ thống.

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjvwIT7LbyCV1-N8N4L%2F-MjwEDhpAkPrfFdHShrd%2Fimage.png?alt=media\&token=e7c700a5-056d-4ef1-8d88-68cd30e5e312)

### Bước 1: Cài đặt Plugin

* Tải plugin tại: <https://xem.li/pluginsms2>
* Đăng nhập vào quản trị của Wordpress → chọn Plugin → bấm **Cài mới** (Add New)
* Tải Plugin lên và Kích hoạt

### Bước 2: Cấu hình Plugin

* Vào Woocommerce → chọn Thanh toán → bật hình thức thanh toán **Chuyển khoản ngân hàng SMS Gateway** → bấm **Cài đặt**

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjlxErbCeCQ4R4vVPll%2F-MjlxOrrPTcrrYNKzM0U%2Fimage.png?alt=media\&token=b124f891-49be-41eb-a96d-e70a4cff9e29)

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2F71uJQKitHX18lGNeQ4hX%2Fimage.png?alt=media\&token=32879faf-9aab-43e9-b6b9-d92dd58f5793)

* Chọn ngân hàng có hỗ trợ VietQR trong danh sách. Hỗ trợ tốt nhất với Vietcombank và MBBank.
* Nhập nội dung thông báo ở màn hình chọn hình thức thanh toán của Khách hàng.
* Khai báo API Key được lấy từ mục API Key tại <https://sms.quanchatbot.com/api.php>
* Nhập Brandname của SMS báo số dư từ ngân hàng.
* Nhập số tài khoản (có thể viết liền hoặc chỉ dùng dấu chấm để phân cách).
* Nhập tên chủ tài khoản: Viết hoa không dấu.
* Nhập cú pháp sẽ dùng kết hợp mã đơn hàng (nếu bạn dùng cùng 1 tài khoản api cho nhiều website thì mỗi website nên có 1 cú pháp khác nhau để tránh nhầm lẫn).
* Đặt Endpoint và cấu hình cronjob để hệ thống tự check đơn hàng sau những khoảng thời gian nhất định.
* **Chú ý:** Mặc định khi ở trang thanh toán thì hệ thống sẽ tự động quét mỗi 10 giây 1 lần để kiểm tra, nên  cần lưu ý khách hàng sau khi chuyển khoản thì để yên màn hình thanh toán cho hệ thống kiểm tra.

BONUS: CÁC SHORTCODE DÙNG VỚI THAM SỐ order\_*key=\<order\_*&#x6B;ey>

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjNMo72P3X4qvVabqa3%2Fuploads%2FLjh3lle2s4jBjZMKdgPb%2Fimage.png?alt=media\&token=566d6489-d17e-4969-b2b0-c8207326b6b9)


# Plugin Woocommerce: thông báo đơn hàng, tài khoản... qua Messenger

Plugin này hỗ trợ bạn có thể gửi tin nhắn Facebook Messenger đến khách hàng khi khách hàng tạo tài khoản, đặt hàng, đơn hàng thay đổi trạng thái: được xử lý, hủy đơn hàng, hoành thành đơn hàng hoặc gửi tin nhắn thông báo đơn hàng mới cho chủ shop / nhân viên.

### **Yêu cầu:**&#x20;

* Chỉ áp dụng đối với các website Wordpress đang sử dụng **Woocommerce**&#x20;
* Khách hàng đặt mua hàng trên web dùng số điện thoại / email khớp với tài khoản Facebook đã cung cấp số điện thoại / email trong chatbot. (xem thêm ở bài hướng dẫn Cài đặt Chatbot gửi tin SMS thông qua API).

{% content-ref url="/pages/-MjNYKjYR9ehKM7j2IDB" %}
[Cài đặt Chatbot gửi tin SMS thông qua API](/ket-noi-sms-va-chatbot/cai-dat-chatbot-gui-tin-sms-thong-qua-thiet-bi)
{% endcontent-ref %}

* Khách hàng vào web đặt hàng qua button chatbot có chứa messid trong link.
* Cần tạo 1 block gửi tin nhắn thông báo có attribute **{{message}}** trong SmaxBot và lấy link Broadcast API để cài đặt vào plugin.

![Tạo block chứa text có {{message}} để thông báo sau khi KH đặt hàng](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjqcLrBEk7u11pIk4Fx%2F-Mjr66GSTI6bgtcAeTU-%2Fimage.png?alt=media\&token=68061938-b8d2-4ae6-9810-003ab880c3dc)

![Tạo Broadcast API cho block này](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjqcLrBEk7u11pIk4Fx%2F-Mjr6CJfD29JR9mtMaQ7%2Fimage.png?alt=media\&token=abf62a29-5bf8-475e-8108-6aaa47639249)

![Copy link Post Broadcast API để cho vào Cấu hình của Plugin bên web](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjqcLrBEk7u11pIk4Fx%2F-Mjr6GKW0P9aErnZ0OFW%2Fimage.png?alt=media\&token=edc439a7-6623-4d98-bc0d-301fa8fe95af)

### Bước 1: Cài đặt Plugin

* Tải plugin tại: <https://xem.li/pluginsmaxbot>
* Đăng nhập vào quản trị của Wordpress → chọn Plugin → bấm **Cài mới** (Add New)
* Tải Plugin lên và Kích hoạt

### Bước 2: Cấu hình Plugin

* Vào Woocommerce → chọn Cài đặt → chọn SmaxBot.
* Khai báo Broadcast API Key đã lấy ở trên.

### Bước 3: Kích hoạt gửi tin nhắn Woocommerce

* Check vào các ô bạn cần gửi tin.
* Chỉnh sửa nội dung tin nhắn sẽ gửi.
* Để tùy biến nội dung tin nhắn, bạn có thể sử dụng thêm các cú pháp sau:
  * Mã đơn hàng: **%%orderid%%**
  * Họ tên khách hàng: **%%firstName%% %%lastName%%**
  * Tổng tiền đơn hàng: **%%total%%**
  * Số điện thoại khách hàng: **%%phone%%**

{% hint style="warning" %}
**Nếu bạn muốn tích hợp vào button mua hàng của chatbot như 1 webview, khi khách hàng bấm vào nút mua hàng trên web, chatbot sẽ gửi tin nhắn thông báo tình trạng đơn hàng, thì thêm tham số messid vào domain: ?messid={{messenger user id}}**&#x20;

Ví dụ:    <https://domain/?messid=\\{{messenger> user id}}
{% endhint %}

![](https://3803414830-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MjNMo72P3X4qvVabqa3%2F-MjnFpEt9ct1Q9keKKYl%2F-MjotcxNutDgKgaa1X_L%2Fimage.png?alt=media\&token=db1115ce-eda6-457c-b608-ca8346807af0)

Với cách áp dụng này, hệ thống sẽ tự động gắn số điện thoại và email khách hàng dùng mua trên web vào tài khoản Facebook đã bấm button mở web mua hàng.

{% hint style="info" %}
Ngoài attribute **{{message}}** là nội dung thông báo được cấu hình trong plugin, còn có những attribute sau để bạn có thể sử dụng:

* Mã đơn hàng: **{{order\_id}}**
* Order Key: **{{order\_key}}**
* Trạng thái đơn hàng: **{{order\_status}}** (pending | processing | canceled | completed)
* Họ tên KH: **{{first\_name}} {{last\_name}}**
* Thành tiền: **{{total}}**
* Số điện thoại đặt hàng: **{{order\_phone}}**
* Email đặt hàng: **{{order\_email}}**
  {% endhint %}


# Cách lưu trữ giao dịch Momo lên hệ thống SMS

Với tài khoản ngân hàng có dịch vụ SMS báo biến động số dư, nhưng với Momo thì chỉ có noti qua app điện thoại. Vì vậy, ở phần này, mình sẽ hướng dẫn bạn lưu các noti từ app Momo lên hệ thống SMS tương đương như là 1 SMS nhận được về máy.

Do đó, khi lưu các noti này lên hệ thống, bạn hoàn toàn có thể sử dụng API kiểm tra giao dịch ngân hàng tương đương SMS vậy.

(đang cập nhật...)


