Hướng dẫn sử dụng Bank Notify cho thiết bị Xiaozhi

1. Giới thiệu nhanh

Thiết bị Xiaozhi hỗ trợ tính năng Bank Notify – tự động đọc thông báo khi có tiền chuyển vào tài khoản ngân hàng, giúp bạn không bỏ lỡ giao dịch, đặc biệt phù hợp cho cửa hàng, bán hàng online và gia đình.

Dưới đây là hướng dẫn từng bước – ai cũng có thể tự làm.

2. BƯỚC 1: CHUẨN BỊ

Bạn cần chuẩn bị:

✅ 01 thiết bị Xiaozhi đã kết nối Wi‑Fi
✅ 01 tài khoản ngân hàng mà SePay hỗ trợ
✅ 01 điện thoại để đăng ký và quét mã

❗ Không cần cài app phức tạp, không cần kiến thức kỹ thuật.

3. BƯỚC 2: ĐĂNG KÝ TÀI KHOẢN SEPAY

SePay là nền tảng trung gian giúp nhận thông tin giao dịch ngân hàng theo thời gian thực.

1️⃣ Truy cập website: SEPAY.VN
2️⃣ Đăng ký tài khoản bằng SĐT hoặc Email
3️⃣ Đăng nhập vào trang quản lý SePay

👉 SePay không giữ tiền, chỉ nhận thông tin giao dịch → an toàn.

4. BƯỚC 3: LIÊN KẾT NGÂN HÀNG VỚI SEPAY

Sau khi đăng nhập SePay:

1️⃣ Vào mục Ngân hàng / Tài khoản
2️⃣ Chọn Thêm ngân hàng
3️⃣ Thực hiện xác thực theo hướng dẫn của SePay
4️⃣ Khi thấy trạng thái ĐÃ KẾT NỐI là hoàn tất

👉 Từ thời điểm này, mọi giao dịch tiền vào đều được SePay ghi nhận.

5. BƯỚC 4 (RẤT QUAN TRỌNG): TẠO WEBHOOK TRÊN SEPAY 🌐

Webhook là “địa chỉ nhận tin”. Khi có tiền vào tài khoản → SePay sẽ gửi dữ liệu giao dịch về Xiaozhi thông qua Webhook này.

5.1. Tạo Webhook mới

1️⃣ Vào mục Webhook / Tích hợp
2️⃣ Chọn Tạo Webhook mới

5.2. Cấu hình Webhook (điền đúng như sau)

Đặt tên: nhập tên bất kỳ (ví dụ: Xiaozhi Bank Notify)
Bắn Webhook khi: Có tiền vào
Khi tài khoản ngân hàng là: chọn ngân hàng đã đăng ký
Bỏ qua nếu nội dung giao dịch không có Code thanh toán?: Không
Gọi đến URL: https://n8n.xiaozhi.vn/webhook/zalo-oa-bank
Là Webhook xác thực thanh toán?: Không
Gọi lại Webhook khi?: không chọn (để mặc định)
Kiểu chứng thực: Không cần chứng thực
Request Content-Type: application/json
Trạng thái: Kích hoạt

👉 Nhấn Lưu (Save) để hoàn tất.
⚠️ Lưu ý: Chỉ cần 1 webhook duy nhất, không tạo trùng nhiều webhook cùng URL.

6. BƯỚC 5: QUÉT MÃ KẾT NỐI TRÊN THIẾT BỊ XIAOZHI 📲

Bước này giúp gắn đúng tài khoản SePay với đúng thiết bị Xiaozhi.

1️⃣ Trên thiết bị Xiaozhi, hãy nói: “Tôi muốn đăng ký thiết bị”
2️⃣ Màn hình sẽ hiển thị QR CODE đăng ký
3️⃣ Dùng điện thoại quét QR này
4️⃣ Nhập số tài khoản ngân hàng (đã đăng ký trên SePay)

🔹 Trường hợp màn hình nhỏ, không nhìn rõ QR:
Truy cập bằng điện thoại: https://zalo-bridge.xiaozhi.vn/zalo-login?dev=50787d171212f01

👉 Thay 50787d171212f01 bằng địa chỉ MAC của thiết bị Xiaozhi (cách lấy: bỏ dấu “:” và thêm chuỗi “f01” vào cuối).
👉 Nhấn nút Kết nối để hoàn tất.

7. BƯỚC 6: KIỂM TRA KẾT NỐI

Sau khi nhấn nút Kết nối, màn hình Xiaozhi sẽ tự thoát khỏi giao diện QR.

👉 Như vậy là đã kết nối thành công, không cần thao tác thêm.

8. BƯỚC 7: TEST THỰC TẾ – NGHE NGAY 🔊

Hãy thử chuyển 10.000 – 20.000đ vào tài khoản ngân hàng đã liên kết.

⏱ Sau khoảng 1–3 giây, Xiaozhi sẽ tự đọc:
🔔 “Thông báo chuyển khoản. Bạn vừa nhận 20.000 đồng từ Vietcombank…”

Tuỳ cấu hình, thiết bị có thể:
• đọc bằng giọng nói rõ ràng
• hiển thị thông tin giao dịch trên màn hình

9. CÂU HỎI THƯỜNG GẶP (FAQ)

❓ Có cần bật điện thoại 24/24 không?
👉 Không. Xiaozhi hoạt động độc lập hoàn toàn.
❓ Có bị đọc trùng không?
👉 Không. Hệ thống đã chống trùng giao dịch.
❓ Một tài khoản SePay dùng cho nhiều Xiaozhi được không?
👉 Có. Mỗi thiết bị quét 1 QR riêng.
❓ Có bị trễ không?
👉 Thông thường 1–3 giây sau khi tiền vào.

10. TỔNG KẾT

Chỉ với 5 bước đơn giản:

1️⃣ Đăng ký SePay
2️⃣ Liên kết ngân hàng
3️⃣ Tạo Webhook
4️⃣ Quét QR trong Bank Notify
5️⃣ Test giao dịch

➡️ Bạn đã có thiết bị Xiaozhi tự đọc thông báo chuyển khoản 24/7, cực kỳ tiện lợi cho bán hàng & gia đình.

11. Các hướng dẫn liên quan

Nếu bạn cần thêm tài liệu để bắt đầu nhanh với Xiaozhi, bạn có thể xem:

Trở lại trang Hướng dẫn Xiaozhi