Hoàn Tiền/docs
VI

Zalo & Telegram Bot

Phân hệ quản lý Bot tự động giúp chủ shop thiết lập các tài khoản Zalo Bot (thông qua Zalo Bot Platform) và Telegram Bot để tự động tương tác với người dùng. Khi người dùng dán link sản phẩm Shopee trực tiếp vào ô chat của Bot, hệ thống sẽ tự động chuyển đổi thành link tiếp thị liên kết chứa mã số định danh của họ để ghi nhận hoa hồng hoàn tiền khi họ mua sắm thành công.

1. Cấu Hình & Kết Nối Zalo Bot

Bạn lưu ý: Zalo Bot hoàn toàn độc lập và không phải là Zalo Official Account (Zalo OA). Phân hệ này sử dụng nền tảng Zalo Bot Platform giúp tạo chatbot Zalo cá nhân tương tự như Telegram Bot một cách nhanh chóng và hoàn toàn miễn phí.

Các bước tạo Zalo Bot và kết nối hệ thống:

  1. Truy cập trang web chính thức của Zalo Bot Platform tại đường dẫn: https://bot.zapps.me (hoặc https://zapps.me).
  2. Đăng nhập tài khoản bằng quét mã QR ứng dụng Zalo cá nhân của bạn.
  3. Tại trang quản lý Zapps, chọn nút Tạo Bot Mới (Create Bot). Điền đầy đủ thông tin (Tên hiển thị của Bot, hình đại diện, mô tả ngắn gọn).
  4. Sau khi tạo thành công, hệ thống Zapps sẽ cung cấp cho bạn một chuỗi Bot Token (Access Token). Bạn hãy sao chép chuỗi mã này lại.
  5. Quay lại Admin Panel trang hoàn tiền của bạn, chọn mục Quản Lý Zalo & Telegram Bot (đường dẫn trực tiếp: /admin/bots?tab=zalo).
  6. Dán Token vừa sao chép vào ô Bot Token, điền liên kết dẫn tới Bot vào ô Tên tài khoản Bot (ví dụ: link có dạng https://zalo.me/s/xxxxxxxxxx được cung cấp trên Zapps).
  7. Chọn nút Lưu cấu hình để lưu lại các cài đặt.
  8. Sau cùng, chọn nút Thiết lập Webhook để hệ thống tự động đăng ký đường dẫn callback với server Zapps. Kể từ lúc này, Bot sẽ chính thức hoạt động và tự động trả lời tin nhắn của khách hàng.
Giao diện cấu hình Zalo Bot Hình 1: Biểu mẫu cấu hình kết nối và các mẫu phản hồi của Zalo Bot

Các tham số cấu hình Zalo Bot:

  • Trạng thái Bot: Gạt bật để kích hoạt Bot hoạt động tự động.
  • Bot Token: Dán Access Token được cấp từ trang quản lý Zalo Bot Platform (bot.zapps.me).
  • Tên tài khoản Bot: Điền link dẫn tới Bot (dạng https://zalo.me/s/...) hoặc username nhận diện của Bot.
  • Tin nhắn chào mừng: Nội dung Bot sẽ gửi phản hồi ngay khi khách hàng bắt đầu nhắn tin hoặc gửi lệnh /start lần đầu.
  • Mẫu tin nhắn hoàn tiền: Mẫu phản hồi thông tin sản phẩm khi khách hàng gửi link mua hàng Shopee hoặc TikTok Shop. Bạn có thể sử dụng các từ khóa động để hệ thống tự điền thông tin:
    • {product_name}: Tên sản phẩm cào được từ sàn thương mại điện tử.
    • {product_price}: Giá bán hiện hành của sản phẩm.
    • {cashback_amount}: Số tiền dự kiến hoàn trả cho khách mua hàng.
    • {cashback_rate}: Tỷ lệ hoàn tiền (%) của sản phẩm.
    • {affiliate_link}: Đường dẫn liên kết tiếp thị đã được chuyển đổi để ghi nhận hoàn tiền.
  • Tin nhắn không tìm thấy: Phản hồi khi khách hàng dán link không hợp lệ hoặc link sản phẩm không được hệ thống hỗ trợ.
  • Tin nhắn yêu cầu liên kết: Gửi khi khách hàng dán link nhưng chưa liên kết tài khoản Zalo với tài khoản trên website, yêu cầu họ sử dụng cú pháp liên kết.

Các nút thao tác nhanh:

  • Lưu cấu hình: Chọn nút để hệ thống cập nhật các tùy chọn và tin nhắn mẫu.
  • Thiết lập Webhook: Chọn nút để hệ thống tự động đăng ký đường dẫn callback với Zapps, giúp Bot nhận tin nhắn và trả lời thời gian thực.
  • Kiểm tra kết nối: Test nhanh xem Token đã chính xác chưa, hệ thống sẽ gọi thử API Zapps và báo kết quả (thành công kèm tên Bot hoặc thất bại kèm chi tiết lỗi).

2. Cấu Hình & Kết Nối Telegram Bot

Bạn chọn tab Telegram Bot ở đầu trang quản lý (hoặc truy cập trực tiếp đường dẫn: /admin/bots?tab=telegram).

Giao diện cấu hình Telegram Bot Hình 2: Biểu mẫu cấu hình kết nối và các mẫu phản hồi của Telegram Bot

Các bước lấy Token và kết nối Telegram Bot:

  1. Mở ứng dụng Telegram, tìm kiếm tài khoản @BotFather (Bot chính thức của Telegram dùng để tạo bot mới).
  2. Gửi lệnh /newbot, nhập tên hiển thị cho Bot và nhập Username cho Bot (kết thúc bằng từ bot hoặc _bot).
  3. @BotFather sẽ gửi cho bạn một chuỗi HTTP API Token (Ví dụ: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ). Hãy sao chép chuỗi này dán vào mục Bot Token trong trang quản trị.
  4. Gửi lệnh /setuserpic đến @BotFather để cài đặt ảnh đại diện cho Bot nếu cần thiết.
  5. Trong trang quản trị, gạt nút Kích hoạt, nhập tên tài khoản Bot, nhập nội dung các mẫu tin nhắn phản hồi tự động rồi nhấn Lưu cấu hình.
  6. Nhấn Thiết lập Webhook để bắt đầu nhận tin nhắn và nhấn Kiểm tra kết nối để đảm bảo trạng thái kết nối hiển thị thông báo thành công.

3. Nhật Ký Lịch Sử Tin Nhắn Bot

Bạn chọn tab Lịch sử tin nhắn ở đầu trang quản lý (hoặc truy cập trực tiếp đường dẫn: /admin/bots?tab=messages) để kiểm tra:

Nhật ký lịch sử tin nhắn của Bot Hình 3: Nhật ký tương tác của các thành viên gửi link mua hàng qua Bot

Tại đây hiển thị chi tiết: Họ tên tài khoản gửi tin, loại Bot nhận tin (Zalo/Telegram), nội dung tin nhắn khách hàng gửi (Ví dụ: link sản phẩm Shopee), phản hồi của Bot và thời gian giao dịch diễn ra. Bạn có thể lọc danh sách tin nhắn theo từng loại Bot hoặc chọn nút Xóa tất cả lịch sử để dọn dẹp cơ sở dữ liệu khi dữ liệu nhật ký quá lớn.

Cơ Chế Liên Kết Tài Khoản Khách Hàng

Để hệ thống ghi nhận hoa hồng hoàn tiền chính xác về ví cho người dùng khi họ chat qua Bot, tài khoản Chat của họ bắt buộc phải liên kết với tài khoản trên website. Khi người dùng chưa liên kết dán link sản phẩm, Bot sẽ tự động trả về tin nhắn yêu cầu liên kết kèm đường dẫn đăng nhập đặc biệt. Sau khi người dùng đăng nhập qua đường dẫn này, hệ thống sẽ tự động ghép nối ID chat Zalo/Telegram với tài khoản website của họ để các lần chat mua hàng tiếp theo được ghi nhận hoàn tiền tự động 100%.

Zalo & Telegram BotVề đầu trang
© 2026 Hoàn Tiền DocsPowered by CMSNT LTDTài liệu hướng dẫn sử dụng.
Giới thiệu hệ thốngĐây là trang tổng hợp hướng dẫn sử dụng chi tiết dành cho Quản trị viên (Admin) của hệ thống Platform Hoàn Tiền Mua Sắm Shopee (Cashback Platform).Quản lý menuChức năng này giúp Quản trị viên (Admin) tự do cấu hình, chỉnh sửa, gạt bật/tắt hiển thị và sắp xếp các liên kết điều hướng ở các vị trí khác nhau trên giao diện website Storefront một cách nhanh chóng và tự động.Bài viết BlogPhân hệ Blog cung cấp các công cụ thiết lập chuyên mục bài viết và soạn thảo bài viết. Giúp bạn đăng tải các chia sẻ kiến thức, tin khuyến mãi, mẹo mua sắm, tối ưu hóa nội dung chuẩn SEO để tăng lưu lượng truy cập tự nhiên.Vai trò & phân quyềnPhân hệ Quản lý vai trò và phân quyền (Role-Based Access Control - RBAC) giúp Quản trị viên (Admin) thiết lập, phân cấp và quản lý chi tiết các nhóm vai trò quản trị (như Super Admin, Nhân viên duyệt đơn, Kế toán, Hỗ trợ kỹ thuật...). Cơ chế này giúp bảo vệ thông tin tài chính nhạy cảm và kiểm soát chặt chẽ các hành động của từng tài khoản nhân viên.Đa ngôn ngữChức năng quản lý ngôn ngữ giúp bạn dịch thuật, chỉnh sửa câu chữ hiển thị và cấu hình hiển thị đa ngôn ngữ trên website storefront để tiếp cận nhiều đối tượng khách hàng ở các quốc gia khác nhau.Đa tiền tệChức năng quản lý tiền tệ giúp bạn thiết lập và kiểm soát các đơn vị tiền tệ giao dịch, định dạng hiển thị ký hiệu và cấu hình tỷ giá quy đổi tự động trên website.Quản lý thành viênChức năng quản lý thành viên giúp bạn theo dõi danh sách thành viên đăng ký, kiểm soát số dư ví khả dụng, điều chỉnh tiền thưởng/phạt và tra cứu lịch sử giao dịch/hoạt động của từng người dùng trên hệ thống.Trang tĩnhChức năng quản lý trang giúp bạn soạn thảo và xuất bản các trang thông tin độc lập trên website storefront (Ví dụ: Trang giới thiệu, Điều khoản dịch vụ, Chính sách bảo mật...).Hoa hồng giới thiệuHệ thống tiếp thị liên kết đa cấp giúp bạn thiết lập cơ chế chia sẻ hoa hồng giới thiệu 2 tầng (F1 và F2). Khi thành viên cấp dưới (F0) mua hàng và được duyệt hoàn tiền, người giới thiệu trực tiếp và gián tiếp sẽ nhận được thưởng.Thưởng điểm danhTính năng điểm danh giúp thu hút và giữ chân người dùng quay lại website hàng ngày bằng cách tặng thưởng tiền mặt khi điểm danh và cộng thêm quà tặng khi duy trì chuỗi ngày liên tiếp.Yêu cầu rút tiềnChức năng rút tiền giúp bạn thiết lập hạn mức tối thiểu, các loại phí giao dịch và hướng dẫn chi tiết hiển thị cho người dùng khi họ gửi yêu cầu rút số dư ví về tài khoản ngân hàng.Bảo mật hệ thốngThiết lập bảo mật hệ thống giúp ngăn chặn bot tự động đăng ký spam tài khoản ảo, bảo vệ thông tin cá nhân của người dùng và chống các cuộc tấn công rò rỉ dữ liệu.Voucher ShopeeHệ thống tự động cào và cập nhật các mã giảm giá, voucher khuyến mãi mới nhất từ Shopee về hiển thị ngoài trang chủ để tăng tỷ lệ người dùng nhấp mua hàng qua link affiliate của bạn.Hoàn tiền ShopeeTrang này hướng dẫn bạn cách kết nối hệ thống với Shopee Affiliate API để lấy dữ liệu sản phẩm tự động, thiết lập tỷ lệ hoàn tiền cho thành viên, tỷ lệ khấu trừ và quản lý thông báo cashback.Hoàn tiền TikTok ShopPhân hệ cấu hình TikTok Shop giúp bạn kết nối hệ thống với cổng API trung gian của đối tác RioHub. Cho phép người dùng dán liên kết sản phẩm TikTok Shop ngoài trang chủ để tự động phân tích thông tin sản phẩm, tính toán tỷ lệ cashback hoàn trả khách hàng, cấu hình thời gian xóa cache sản phẩm và tùy biến định dạng mã đơn hàng đối soát.Dọn dẹp & sao lưuChức năng dọn dẹp hệ thống giúp bạn tối ưu hóa cơ sở dữ liệu, giải phóng bộ nhớ cache ứng dụng, dọn các tệp ghi nhật ký lỗi lỗi và giải phóng dung lượng lưu trữ của máy chủ, giúp website hoạt động với hiệu năng mượt mà nhất.Quà tặng & đổi thưởngChức năng quản lý quà tặng cho phép bạn tạo ra các chương trình đổi quà (thẻ cào điện thoại, thẻ Garena, quà vật lý) cho các thành viên sử dụng số dư ví cashback hoặc coins tích lũy để quy đổi trực tiếp.Nhiệm vụ nhận thưởngTính năng Nhiệm vụ nhận thưởng giúp bạn tạo ra các nhiệm vụ khác nhau để khuyến khích thành viên thực hiện các hành động trên website (hoàn thiện hồ sơ, mời bạn bè, mua đơn hoàn tiền, điểm danh, rút tiền, lưu sản phẩm, hoặc thực hiện một hành động tùy chỉnh thủ công). Khi hoàn thành nhiệm vụ, thành viên sẽ nhận được số tiền thưởng (VNĐ) tương ứng cộng trực tiếp vào ví.Đối soát đơn hàngMục công cụ hệ thống giúp bạn kết nối Cookie Shopee để đồng bộ đơn hàng hoàn tiền tự động.Zalo & Telegram BotPhân hệ quản lý Bot tự động giúp chủ shop thiết lập các tài khoản Zalo Bot (thông qua Zalo Bot Platform) và Telegram Bot để tự động tương tác với người dùng. Khi người dùng dán link sản phẩm Shopee trực tiếp vào ô chat của Bot, hệ thống sẽ tự động chuyển đổi thành link tiếp thị liên kết chứa mã số định danh của họ để ghi nhận hoa hồng hoàn tiền khi họ mua sắm thành công.Trình dựng giao diệnHệ thống cung cấp một Trình dựng trang trực quan (Page Builder) giúp bạn tự do quản lý cấu trúc, thêm bớt, kéo thả thay đổi thứ tự và tùy chỉnh chi tiết nội dung các khối (block) hiển thị trên trang chủ Storefront. Bạn có thể dễ dàng theo dõi trực tiếp các thay đổi qua khung xem trước trước khi quyết định xuất bản chính thức.Cấu hình SMTP gửi emailHướng dẫn tạo mật khẩu ứng dụng Gmail và khai báo máy chủ SMTP để hệ thống gửi được email xác minh tài khoản, quên mật khẩu và thông báo hoàn tiền.