TELEGRAM COMMERCE / LIVE Operations control center

Dữ liệu thời gian thực

Doanh thu hôm nay

—

Tuần này

—

Tháng này

—

Tổng doanh thu

—

Lũy kế toàn bộ thời gian

Sản phẩm—

Tồn kho chờ bán—

Đã bán—

Tổng đơn—

Người dùng bot—

Số dư của khách —

Revenue intelligence

Biểu đồ doanh thu

30 ngày gần nhất

Tổng trong kỳ 0 đ

Mức cao nhất 0 đ

Phát sinh doanh thu 0/0 ngày

VNĐ

Top Users (Doanh thu cao nhất)

#	User	Đơn	Tổng chi

Promo Analytics

User	Mã	Lần dùng

Đơn hàng gần nhất

Thời gian	Mã đơn	User	Sản phẩm	Giá	Promo

QR Realtime Monitor

Tự động làm mới 15s

Đang chờ thanh toán

Mã QR	User	Sản phẩm	Số tiền	Mở lúc	Còn lại
Không có QR nào đang mở

Đã thanh toán hôm nay

Thời gian	User	Sản phẩm	Nhận	Giao	Trạng thái
Chưa có giao dịch nào hôm nay

Quản lý Danh Mục

Danh mục hiển thị trên Bot khi user bấm Xem Shop. Kéo thả để sắp xếp thứ tự.

Danh sách sản phẩm đang bán

Bật/Tắt	ID sản phẩm	Tên hiển thị	Danh mục	Giá gốc	Giá KM lần đầu	Tồn kho	Đã bán	Bảo hành	Giá sỉ	Ảnh	Thao tác

QUẢN LÝ TỒN KHO

Kho hàng

Nắm tồn kho, tìm sản phẩm và nhập hàng ngay tại một nơi.

Danh mục đang xem

Theo tìm kiếm và bộ lọc hiện tại

DANH MỤC SẢN PHẨM

Sẵn sàng cho đơn tiếp theo.

Chọn sản phẩm để thao tác

SỔ KHO

Chi tiết tồn kho

Dữ liệu tài khoản, trạng thái bán và lịch sử nhập.

Hiện đã bán

ID	Dữ liệu tài khoản	Trạng thái	Ngày nhập	Bán cho	Thao tác

Tất cả đơn hàng

Thời gian	Mã đơn	User ID	Sản phẩm	Giá	Dữ liệu giao

Chờ duyệt —

Đang hoạt động —

Bị khoá —

Tổng số dư đại lý —

Thông tin kết nối gửi cho đại lý

Mở tài liệu

Base URL

chưa đặt — vào Cài đặt để điền

Auth header

X-API-Key

GET/api/v2/catalog?available_only=trueLấy hàng

POST/api/v2/ordersĐặt hàng

GET/api/v2/meXem số dư

GET/api/v2/orders/{order_code}Tra cứu đơn

Đại lý dùng đúng bot này: Kết Nối API → Thêm kết nối → dán Base URL + key → Auth Type API Key (Header) → Test.

Danh sách đại lý

Shop	Telegram	Trạng thái	Số dư	Đơn / Đã chi	API Key	Thao tác
Đang tải...

Chờ bạn xử lý—

Chờ khách nhập mail—

Đã hoàn tất—

Đã huỷ—

Danh sách đơn

Chỉ hiện đơn chưa xong

Khách	Sản phẩm	Email khách gửi	Trạng thái	Thao tác
Đang tải...

Tổng đơn BH —

Còn hạn —

Sắp hết hạn — trong 3 ngày

Đã hết hạn —

Tạo bảo hành thủ công

Nhập tài khoản đã bán và Telegram ID của khách. Bot sẽ gửi thông báo ngay, rồi tự nhắc khách trước 3 ngày khi sắp hết hạn.

Telegram ID của khách *

Email / tài khoản được bảo hành

Ngày mua (dd/mm/yyyy — để trống = hôm nay)

Thời hạn bảo hành

Sản phẩm (tuỳ chọn)

Mã đơn hàng (tuỳ chọn)

Số tiền khách đã trả (VND) — để trống là tự lấy Có mã đơn thì bot tự lấy giá đã thanh toán. Chỉ nhập tay khi đơn nằm ngoài hệ thống.

Ghi chú nội bộ (khách không thấy)

Gửi thông báo cho khách ngay

Danh sách bảo hành

Chỉ hiện còn hạn

Khách	Tài khoản	Sản phẩm	Thời gian	Còn lại	Tiền mua / Còn lại	Thao tác
Đang tải...

Tin chưa đọc —

Đang mở —

Tổng cuộc chat —

Đã đóng —

Chọn một cuộc chat bên trái để bắt đầu trả lời

Chưa chọn cuộc chat nào

Danh sách thành viên

Telegram ID	Username / Tên	Số dư (VND)	Giá riêng / KM	Thao tác

Telegram broadcast

Soạn thông báo mới

Định dạng nội dung bằng HTML tương thích với Telegram.

HTML mode

Tiêu đề Tùy chọn · tối đa 200 ký tự

Để trống thì thông báo sẽ không có dòng tiêu đề.

Nội dung HTML * Telegram hỗ trợ HTML giới hạn

Chọn đoạn chữ rồi bấm định dạng, hoặc bấm trước để chèn mẫu HTML và thay nội dung bên trong.

Nội dung được gửi qua Telegram API với parse_mode=HTML.

Lịch sử gửi thông báo

Chưa có lịch sử.

Gửi nhanh ngay trong Telegram

Ngoài cách trên, Admin có thể gửi thẳng vào bot Telegram:
1. Gửi một ảnh vào chat với bot
2. Nhập caption bắt đầu bằng /bc rồi nội dung
Ví dụ caption: /bc 🎉 Shop vừa nhập hàng mới! Mua ngay /shop
Bot sẽ tự động gửi ảnh đó đến tất cả người dùng.

Mã code	Giảm (VND)	Sản phẩm	Đã dùng / Giới hạn	Còn lại	Mô tả	Trạng thái	Thao tác

BOT CONTENT STUDIO

Button ID và toàn bộ nội dung trả về

Button chỉ nhập custom emoji ID. Nội dung text giữ nguyên HTML Telegram và các biến động.

Custom Emoji cho Button

Mỗi button chỉ có một ô ID. Để trống sẽ tự dùng emoji thường đang hiển thị.

Đang tải danh sách button...

Custom Emoji và Full Text

Toàn bộ text bot đang trả đều nằm ở đây, bao gồm lỗi, mua hàng, QR, promo và admin.

0 nội dung

Custom emoji text<tg-emoji emoji-id="ID">🔥</tg-emoji>

HTML hỗ trợ<b><i><u><s><code>

Thu gọn nội dung dài<blockquote expandable>…</blockquote>

Không xóa các biến dạng {product_name} hoặc {price} nếu nội dung vẫn cần hiển thị dữ liệu đó.

Đang tải toàn bộ nội dung bot...

Dữ liệu lưu tự động trong thư mục data/

Danh sách API đã kết nối

Thêm API nhà cung cấp để tự động nhận hàng khi user thanh toán. Bot sẽ gọi API để lấy account/key và giao ngay cho user.

Đang tải...

Trang công khai cho đại lý

Tài liệu API nằm ở trang riêng, không nằm trong panel quản trị. Đại lý đọc được mà không cần tài khoản admin, và trang đó không mô tả bất kỳ endpoint quản trị nào.

Gửi link này cho đại lý. Họ dán API key vào trang đó là thử API được ngay.

Vì sao tách riêng

Đại lý không cần mật khẩu quản trị để đọc tài liệu.
Trang công khai chỉ mô tả /api/v2/* — endpoint quản trị không bị lộ.
Key đại lý không bao giờ mở được /api/* của admin (hai lớp xác thực tách hẳn).

Trước khi mở server ra internet

Đặt Base URL cho đại lý trong tab Cài đặt, nếu không tin nhắn gửi đại lý sẽ thiếu địa chỉ.
Đổi mật khẩu quản trị thành chuỗi dài — trang admin cũng phơi ra internet theo.
Chỉ bật Giá sỉ cho những sản phẩm bạn thực sự muốn bán buôn.

Thương hiệu Shop (Hiển thị trong /start của bot)

Tên shop (Shop Name) — Hỗ trợ emoji

Custom Emoji ID thay cho tên shop (tuỳ chọn) Điền ID vào đây thì /start sẽ hiện custom emoji thay cho dòng tên shop, không in chữ nữa.

🛒 Web bán hàng (khách mua ngoài Telegram)

Tên miền Chỉ dùng để in ra lúc khởi động. Chạy thử ở máy thì bỏ trống cũng được.

Cổng riêng Tách khỏi panel admin. 0 = tắt. Đổi xong phải khởi động lại bot.

Web dùng chung kho hàng với bot — sản phẩm, ảnh, mô tả, giá lấy y hệt, không phải nhập lại.

💬 Chat Mini App (Báo lỗi → Chat với admin)

Tên miền HTTPS Telegram bắt buộc HTTPS — để trống hoặc dùng http:// thì nút Chat bị ẩn.

Cổng riêng Cổng cho Mini App, tách khỏi panel admin. 0 = tắt.

Chưa có

Ảnh shop hiện trên đầu Mini App Chưa up thì lấy ảnh đại diện của bot, không có nữa thì dùng emoji custom.

Xem từng icon đang lấy emoji nào và emoji đó có chạy được không.

Lấy ID: gửi emoji đó cho @JsonDumpBot rồi tìm custom_emoji_id. Emoji tĩnh thì Telegram không có bản động — phải chọn emoji khác.

Mô tả shop (1–2 dòng, hiển thị trong /start)

Username hỗ trợ Telegram (không có @ — hiện nút Hỗ trợ trong /start)

HIT Emoji ID — Custom emoji hiện trong thông báo đơn hàng gửi Admin Lấy emoji-id từ @JsonDumpBot hoặc @getidsbot. Để trống nếu không dùng custom emoji.

HIT Bot Token — Bot gửi thông báo HIT (trống = dùng shop bot)

HIT Chat ID — Chat/Group nhận HIT (trống = gửi tới ADMIN_IDS)

Base URL cho đại lý — địa chỉ công khai của server này Bot gửi địa chỉ này kèm API key cho đại lý. Để trống thì tin nhắn sẽ hiện chỗ trống khó hiểu.

Domain riêng cho API đại lý (tuỳ chọn — bảo mật) Điền tên miền (không có https://). Domain này sẽ chỉ phục vụ API đại lý và trang tài liệu — mọi đường dẫn khác trả 404, đại lý không thấy được trang quản trị. Domain admin không bị ảnh hưởng. Để trống = tắt.

Cổng riêng cho API đại lý (khuyên dùng — an toàn nhất) Mở API đại lý ở cổng riêng (ví dụ 8001). Cổng đó chỉ có API + trang tài liệu, không có gì của admin. Bạn chặn cổng 8000 ở tường lửa là đại lý không đụng tới trang quản trị được. Để 0 hoặc trống = tắt (dùng chung cổng 8000 như hiện tại).
Đổi cổng phải khởi động lại bot mới có hiệu lực.

Telegram Bot

BOT_TOKEN

Admin Telegram IDs (phân cách bằng dấu phẩy)

Banned IDs (phân cách bằng dấu phẩy)

Khóa Bot (Chỉ Admin dùng được)

Yêu cầu tham gia nhóm Telegram

Group ID kiểm tra thành viên

Link mời tham gia nhóm

Cổng xác nhận thanh toán — SePay API

Bot đọc giao dịch từ SePay để khớp theo nội dung chuyển khoản. Các mã QR đang chờ dùng chung một lượt lấy giao dịch, không gọi API riêng cho từng QR.

SePay API Token * Lấy ở my.sepay.vn → Cấu hình công ty → API Access.

STK check giao dịch * Tiền chuyển vào STK ảo sẽ về STK này — bot đọc giao dịch theo STK này.

Thông tin tài khoản nhận tiền (sinh QR SePay)

STK ảo tạo QR (VA)

Mã ngân hàng

Tên chủ tài khoản (Viết hoa không dấu)

Bảo mật Web Admin

Tên đăng nhập Web

Mật khẩu đăng nhập Web

Đăng nhập hệ thống

Tổng quan hệ thống

Biểu đồ doanh thu

Top Users (Doanh thu cao nhất)

Promo Analytics

Đơn hàng gần nhất

QR Realtime Monitor

Quản lý sản phẩm

Quản lý Danh Mục

Danh sách sản phẩm đang bán

Thêm danh mục

Kho hàng /

Sẵn sàng cho đơn tiếp theo.

Chi tiết tồn kho

Lịch sử đơn hàng

Tất cả đơn hàng

Đại lý bán sỉ

Thông tin kết nối gửi cho đại lý

Danh sách đại lý

Đơn cần xử lý tay

Danh sách đơn

Bảo hành đơn hàng

Tạo bảo hành thủ công

Danh sách bảo hành

Chat Báo Lỗi SOS

Người dùng Telegram

Danh sách thành viên

Gửi thông báo

Soạn thông báo mới

Đang gửi thông báo...

Lịch sử gửi thông báo

Gửi nhanh ngay trong Telegram

Quản lý mã giảm giá

Tùy chỉnh Bot

Button ID và toàn bộ nội dung trả về

Custom Emoji cho Button

Custom Emoji và Full Text

🔗 Kết Nối API Ngoài

Danh sách API đã kết nối

Import hàng vào Shop

Thêm kết nối API

📐 Field Mapping — Response của API

Tài liệu API đại lý

Trang công khai cho đại lý

Vì sao tách riêng

Trước khi mở server ra internet

Cài đặt hệ thống

Chi tiết đơn hàng

Sửa số dư

Thêm sản phẩm mới

Sửa đơn bảo hành

Bảo hành sản phẩm

Giá sỉ cho đại lý

Xuất TXT bảo hành

Giá Riêng Cố Định

Kho hàng