Hướng dẫn sử dụng XGSMHub

Dành cho người mới bắt đầu: giải thích từng chức năng, từng nút bấm, kèm hình chụp từ chính phần mềm (dữ liệu mẫu). Bạn không cần biết lập trình. Làm theo đúng thứ tự các bước là dùng được.

Mục lục

1Hiểu nhanh các khái niệm

Đọc 1 phút phần này, các mục sau sẽ dễ hiểu hơn nhiều.

Hub GSM
Hộp chứa nhiều modem 4G nhỏ, mỗi modem gắn 1 SIM. Cắm hub vào máy tính bằng cáp USB.
Slot / Cổng
Mỗi modem trong hub là 1 slot (01, 02, 03…). Mỗi dòng trong bảng của phần mềm là 1 slot.
Cổng Com
Tên cổng máy tính gán cho modem (vd COM31 trên Windows, /dev/ttyUSB2 trên Raspberry Pi). Có thể đổi khi rút cắm lại.
Cổng Tự đặt
Tên riêng bạn đặt cho slot (vd "Kho A - 01") để dễ nhớ. Tên gắn theo số serial của module, cắm sang cổng USB khác vẫn giữ.
IMEI
Số định danh của modem (như số khung xe), không phải số của SIM.
Số Serial SIM (ICCID)
Mã in trên SIM, dùng để nhận ra đúng SIM.
USSD
Mã bấm dạng *101# để tra số dư, nạp thẻ… như trên điện thoại.
OTP
Mã xác thực dùng 1 lần (4–8 chữ số) ngân hàng, ứng dụng gửi về SIM. Phần mềm tự tách mã.
Gateway
Máy chủ trung gian gateway.xvooc.id.vn giúp bạn mở dashboard từ bất kỳ đâu, không cần IP tĩnh hay mở cổng router.
Dashboard web
Giao diện điều khiển mở bằng trình duyệt. Giống hệt giao diện trên máy tính, học 1 lần dùng được cả 2.
Ghi chú về hình ảnhHình trong hướng dẫn chụp từ dashboard web. Phần mềm trên máy tính Windows có cùng bố cục và tên nút. Chỗ nào khác nhau sẽ được ghi rõ.

2Bắt đầu nhanh

  1. Chuẩn bị SIM: SIM còn hạn sử dụng, có tiền hoặc gói cước nếu muốn nhắn tin, gọi đi. Gắn SIM vào các modem trong hub khi hub đã rút điện.
  2. Chọn máy chạy phần mềm: máy tính Windows (dùng tại chỗ) hoặc Raspberry Pi (chạy 24/7, quản lý qua trình duyệt). Xem Cài đặt và kích hoạt.
  3. Kích hoạt license: lần đầu mở, phần mềm hiện mã máy. Gửi mã này qua Zalo 0968 338 547 để nhận license, dán vào là xong. Máy Windows có thể bấm Dùng thử 3 ngày.
  4. Cắm hub vào máy bằng cáp USB và cấp nguồn cho hub. Phần mềm tự nhận từng modem, đọc nhà mạng, số điện thoại, số dư. Chờ cột Trạng thái chuyển sang Sẵn sàng (khoảng 1–2 phút).
  5. Bắt đầu dùng: chọn SIM trong bảng → bấm Gửi tin nhắn hoặc Cuộc gọi. Muốn dùng từ xa, xem Dùng từ xa qua Gateway.
Nguồn điện rất quan trọngHub nhiều cổng cần nguồn riêng đủ mạnh. Nguồn yếu làm modem tự khởi động lại, rớt mạng hàng loạt. Raspberry Pi dùng nguồn 5V/3A.

3Cài đặt và kích hoạt

Trên máy tính Windows

  1. Vào trang chủ, mục Tải về, bấm Tải cho Windows. Trang Google Drive mở ra, bấm biểu tượng tải xuống ở góc trên bên phải.
  2. Chạy file gsm4ghub-setup-….exe. Nếu Windows hiện "Windows protected your PC", bấm More info → Run anyway.
  3. Mở phần mềm. Đọc Chính sách sử dụng & Miễn trừ trách nhiệm, tick Tôi đã đọc và đồng ý với các điều khoản trên. rồi bấm Tôi đồng ý và tiếp tục.
  4. Cửa sổ Kích hoạt ứng dụng hiện mã máy. Bấm Copy mã máy, gửi qua Zalo để nhận license. Dán license vào ô Dán license key vào đây → Kích hoạt. Lần cài đầu tiên có thể bấm Dùng thử 3 ngày.
  5. Phần mềm hiện "Đang quét COM ban đầu, vui lòng chờ..." rồi mở màn hình chính. Cắm hub vào nếu chưa cắm.
Cập nhật phiên bản mớiBấm Kiểm tra cập nhật trong khung Điều khiển GSM. Nếu có bản mới, chọn Tải và cài đặt. Phần mềm cảnh báo nếu còn slot đang gửi tin/gọi dở. Cập nhật xong app tự mở lại, dữ liệu và cài đặt được giữ nguyên.

Trên Raspberry Pi

Pi chạy phần mềm ở chế độ nền (không có màn hình), bạn điều khiển hoàn toàn qua trình duyệt. Pi 3 trở lên, Raspberry Pi OS. Hướng dẫn từng bước có ảnh minh hoạ cho người mới (lắp đặt, nối mạng, liên kết Gateway, xử lý sự cố): Cài đặt thiết bị Pi. Thiết bị được VOOC TECH cài sẵn phần mềm; cần cài lại thì liên hệ để được hỗ trợ từ xa.

Thông tin kỹ thuật

Cổng web mặc định8000 — mở http://<địa-chỉ-IP-của-Pi>:8000/ trên máy cùng mạng
Cập nhậtPi tự cập nhật bản mới, cấu hình, dữ liệu, ghi âm được giữ nguyên
Xem nhật kýsudo journalctl -u gsm4ghub -f
Khởi động lạisudo systemctl restart gsm4ghub

Thiết lập lần đầu qua trình duyệt

  1. Nếu Pi đã cắm dây mạng/WiFi: mở http://<IP-của-Pi>:8000/. Nếu Pi chưa có mạng: Pi tự phát WiFi tạm không mật khẩu tên XGSM-Setup-xxxx (xxxx là 4 ký tự riêng của từng máy, giúp phân biệt khi có nhiều Pi). Nối điện thoại vào WiFi này rồi mở http://10.42.0.1:8000/. Ở bước Mạng của trang thiết lập có thể đổi tên WiFi này cho dễ nhận (vd Pi-Kho-1).
  2. Bước 1/3 – Kết nối mạng: chọn WiFi nhà bạn, nhập mật khẩu, bấm Kết nối WiFi.
  3. Bước 2/3 – Kích hoạt bản quyền: bấm Sao chép mã máy, gửi qua Zalo, dán license key nhận được → Kích hoạt. Có thể tạo luôn tài khoản đăng nhập thiết bị (Người dùng / Quản trị).
  4. Bước 3/3 – Liên kết Gateway (để dùng từ xa): nhập tài khoản cổng quản lý → Gửi yêu cầu liên kết, hoặc Bỏ qua bước này.
  5. Màn hình hoàn tất hiện Token quản trị. Token chỉ hiện 1 lần duy nhất, hãy chép lại cẩn thận. Bấm Tắt WiFi thiết lập.
Bảo mậtĐổi mật khẩu mặc định của tài khoản đăng nhập Raspberry Pi (SSH) sau khi cài. Không chia sẻ token quản trị.

4Màn hình chính

Tab QUẢN LÝ GSM gồm khung Điều khiển GSM ở trên và bảng Danh sách module GSM bên dưới. Các tab khác: Lịch sử 60 ngày, Cài đặt (chỉ trên web mở tại chỗ), Chuyển văn bản → Âm thanh. Trên máy tính Windows có thêm tab Tài khoản từ xa.

Màn hình chính XGSMHub: khung Điều khiển GSM phía trên, bảng danh sách SIM với nhà mạng, số điện thoại, số dư, hạn dùng, sóng
Màn hình chính. Mỗi dòng là 1 SIM. Dòng tiêu đề bảng có tổng số: Online / Offline / Calling / TK=0 (số SIM hết tiền).

Góc trên bên phải: chọn ngôn ngữ (Tiếng Việt / English) và đăng nhập. Mở web tại chỗ thì nhập API key → Lưu; mở qua Gateway thì nhập Tài khoản / Mật khẩu → Đăng nhập. Chấm xanh Đã kết nối nghĩa là đang nhận dữ liệu trực tiếp từ máy.

Bảng danh sách SIM: ý nghĩa từng cột

CộtÝ nghĩa
SlotSố thứ tự cổng.
Cổng ComCổng máy tính đang nối modem.
Cổng Tự đặtTên riêng của bạn. Nhấp đúp vào ô để đổi tên, Enter để lưu, Esc để huỷ.
ModuleTrạng thái kết nối, tô màu cả ô: online sẵn sàng/đang làm việc, calling đang gọi, Trùng IMEI bị chặn vì trùng IMEI, Lỗi sim / Sóng yếu, offline / Lỗi IMEI.
Trạng tháiViệc slot đang làm: Sẵn sàng, Lấy data (đang đọc thông tin SIM), Không gắn SIM, Khóa Sim, Lỗi (Sóng yếu), "Đang gửi đến số…", "Gọi điện đến số…", "Cuộc gọi đến từ…"…
Tên nhà mạng, Số điện thoại, Số Serial SIMĐọc tự động từ SIM. Số điện thoại có thể mất vài phút mới hiện (lấy từ tin trả lời số dư).
IMEI deviceIMEI của modem. Hiện "Chưa có IMEI" nếu nhà máy chưa ghi IMEI cho module (vẫn dùng bình thường).
Số dư, Hạn sử dụngTự tra 1 lần khi SIM vừa vào mạng. Bấm Lấy số dư để tra lại.
Sóng5 vạch: đỏ = yếu (≤2 vạch), vàng = trung bình, xanh = tốt (≥4 vạch). Rê chuột để xem chỉ số dBm.
Âm thanh nhậnNút ▶ Nghe phát ghi âm cuộc gọi gần nhất của slot.
Tự động nhận cuộc gọi đếnTick để slot tự nghe máy, ghi âm, chuyển giọng nói thành chữ (dùng cho OTP gọi đến). Bỏ tick: cuộc gọi đến bị từ chối. Ô ở tiêu đề cột bật/tắt tất cả.
VoLTETick = ép dùng VoLTE (gọi qua 4G); bỏ tick = tự động. Modem sẽ khởi động lại khoảng 30 giây. Nếu ép không được, phần mềm tự trả về tự động.
Dòng tô màuViền xanh = slot đang tự nghe 1 cuộc gọi đến. Dòng vàng = slot bị chặn vì trùng IMEI với slot khác (xem Quản lý IMEI).

Chọn dòng, sắp xếp, tìm kiếm

  • Chọn 1 dòng: bấm vào dòng. Chọn nhiều: kéo chuột qua nhiều dòng, hoặc giữ Shift (chọn liền dải), Ctrl (thêm/bớt từng dòng). Ctrl+A chọn tất cả. Trên điện thoại: chạm để chọn/bỏ chọn.
  • Sắp xếp: bấm vào tiêu đề cột, bấm lần nữa để đảo chiều. Mặc định xếp theo "Cổng Tự đặt", ô trống luôn ở cuối.
  • Đổi bố cục cột: kéo tiêu đề để đổi vị trí, kéo mép để đổi độ rộng, nhấp đúp mép để vừa nội dung. Trình duyệt tự nhớ.
  • Tìm theo số điện thoại: gõ vào ô Tìm theo số điện thoại... → Tìm kiếm (hoặc Enter). Phần mềm chọn và cuộn tới slot có số đó.
  • Cho phép trùng IMEI: mặc định không tick, tức mỗi IMEI chỉ được phát sóng trên 1 slot. Tick nếu bạn cố ý dùng nhiều SIM cùng IMEI cùng lúc.
Menu chuột phải trên bảng SIM: Sao chép, Copy số điện thoại, Copy IMEI, Copy thông tin SIM, Xuất Excel
Bấm chuột phải lên bảng. Áp dụng cho các dòng đang chọn (không chọn dòng nào = tất cả).
  • Sao chép: chép toàn bộ thông tin dòng. Copy số điện thoại, Copy IMEI, Copy thông tin SIM (serial, số, số dư, hạn dùng).
  • Xuất Excel thông tin SIM (sim_info.xlsx) và Xuất tất cả thông tin ra Excel (slot_info.xlsx).

5Các nút Điều khiển GSM

Khung Điều khiển GSM với các nút Ngắt kết nối, Kết nối lại, Cuộc gọi, Gửi tin nhắn, Quản lý IMEI, File Mẫu, Thông tin phần mềm, Reset nguồn hub
NútTác dụng
Ngắt kết nốiNgắt các slot đang chọn (không chọn = tất cả). Dùng trước khi rút hub hay thay SIM.
Kết nối lạiKết nối lại các slot đang chọn (không chọn = tất cả). Dùng khi slot báo lỗi hoặc vừa thay SIM.
Cuộc gọiMở cửa sổ gọi điện. Xem Cuộc gọi và ghi âm.
Gửi tin nhắnMở cửa sổ gửi SMS. Xem Gửi tin nhắn.
Quản lý IMEIĐổi IMEI, quản lý bộ IMEI theo SIM. Xem Quản lý IMEI.
File MẫuTải file Excel mẫu: File mẫu Excel nhắn tin (cột "Số điện thoại", "Nội dung") và File mẫu Excel gọi điện (cột "Số điện thoại").
Thông tin phần mềmXem phiên bản, hạn license, gia hạn license. Xem Bản quyền.
Reset nguồn hubChỉ có trên Raspberry Pi: ngắt điện hub vài giây rồi cấp lại (cần relay nối GPIO). Xem Raspberry Pi.
Kiểm tra cập nhậtChỉ có trên máy tính Windows: tìm và cài phiên bản mới.

Bên dưới các nút là hàng Kích hoạt hàng loạt (xem mục 8) và ô Đường dẫn lưu data: thư mục lưu ghi âm, file âm thanh, file Excel xuất ra, trên máy đang chạy phần mềm (mặc định audio_out). Sửa xong rời khỏi ô là tự lưu.

6Gửi tin nhắn SMS

Quy trình chung: chọn các SIM sẽ gửi trong bảng chính → bấm Gửi tin nhắn → chọn chế độ → Load data → kiểm tra bảng → Bắt đầu gửi.

Phải chọn SIM trướcNếu chưa chọn dòng nào trong bảng chính, bấm Load data sẽ báo "Vui lòng chọn ít nhất 1 slot". Chỉ SIM đang online mới gửi được.

Chế độ Thủ công

Cửa sổ Gửi tin nhắn, chế độ Thủ công: ô danh sách số, ô nội dung, các ô giãn cách, nút Load data và Bắt đầu gửi
Chế độ Thủ công: dán danh sách số và gõ nội dung dùng chung.
  1. Ô Nhập danh sách số: các số cách nhau bằng dấu phẩy hoặc xuống dòng.
  2. Ô Nội dung: tin nhắn dùng chung cho mọi số (tối đa 2000 ký tự; tin dài tự chia trang).
  3. Bấm Load data. Bảng bên dưới hiện từng dòng: Slot gửi, số SIM gửi, số nhận, nội dung, trạng thái Sẵn sàng.
  4. Bấm Bắt đầu gửi. Trạng thái đổi: Đang gửi... → Thành công (xanh) hoặc Lỗi: … (đỏ).
Số được chia cho SIM thế nào?
  • 1 số nhận + nhiều SIM chọn: mọi SIM đều gửi tới số đó (dùng để kích hoạt, test).
  • Nhiều số: ghép lần lượt số thứ 1 với SIM thứ 1, số 2 với SIM 2… Số dư thừa (nhiều hơn số SIM) bị bỏ, trừ khi bật Ưu tiên SIM cùng nhà mạng. Muốn gửi danh sách dài, dùng chế độ Excel.

Chế độ Tự động (Excel)

Chế độ Tự động (Excel) của cửa sổ Gửi tin nhắn: chọn file Excel
  1. Tải file mẫu: File Mẫu → File mẫu Excel nhắn tin.
  2. Điền cột A = số điện thoại, cột B = nội dung, mỗi dòng 1 tin. Dòng tiêu đề được tự bỏ qua. Chỉ đọc sheet đầu tiên, file .xlsx.
  3. Chọn file → Load data. Các số được chia đều xoay vòng cho các SIM đã chọn. Số sai định dạng tự bỏ qua và báo số lượng.
  4. Bắt đầu gửi.

Chế độ Tự động nâng cao (Excel mẫu) — tin nhắn cá nhân hoá

Chế độ Tự động nâng cao: chọn file Excel mẫu, nút Lấy file mẫu

Mỗi người nhận một tin riêng có tên, số tiền… của họ. Bấm Lấy file mẫu để có file đúng cấu trúc:

  • Sheet1: bắt buộc có cột tên Mobile hoặc Phone. Các cột khác (vd Info1, Name) là dữ liệu chèn vào tin.
  • Sheet2: cột A, mỗi dòng 1 mẫu tin. Mỗi người nhận được chọn ngẫu nhiên 1 mẫu.
  • Chèn dữ liệu: viết [Name] hoặc {Name}. Ví dụ Chào [Name], tài khoản còn [Info1]đ.
  • Nội dung ngẫu nhiên: {Chào|Xin chào|Kính gửi} — phần mềm tự chọn 1, các tin không giống hệt nhau, giảm bị coi là spam.

Giãn cách, giới hạn và các nút điều khiển

MụcÝ nghĩa
Giãn cách tối thiểu / tối đa (giây)Nghỉ ngẫu nhiên giữa 2 tin của cùng SIM. Nên để vài giây trở lên để SIM không bị nhà mạng khoá vì spam.
Giới hạn/ngày mỗi slotMỗi SIM gửi tối đa bao nhiêu tin thành công trong ngày. 0 = không giới hạn.
Ưu tiên SIM cùng nhà mạngSố Viettel giao cho SIM Viettel, Vina cho Vina… (theo đầu số), hết hạn mức thì chia sang SIM khác. Thường rẻ hơn và tỉ lệ thành công cao hơn.
Trễ giữa các trangTin dài bị chia nhiều trang: nghỉ bao lâu giữa các trang.
Chế độ gửiĐồng thời: mọi SIM gửi cùng lúc (nhanh). Tuần tự: lần lượt từng tin (an toàn).
Bắt đầu gửi / Dừng hẳnĐang chạy, nút đổi thành Dừng hẳn để huỷ toàn bộ.
Tạm dừng / Tiếp tụcDừng tạm giữa chừng, bấm Tiếp tục để chạy nốt.
Load data trước đóNạp lại các tin chưa gửi thành công của lượt trước để gửi lại.
Xuất file (Excel), Xóa bảng, Lưu cấu hìnhLưu kết quả ra Excel, xoá bảng, lưu các thông số để lần sau dùng lại.

Dòng Thành công: x/y kèm ước tính "Còn lại ~… (xong khoảng HH:MM)". Đang gửi mà tải lại trang (F5) vẫn thấy đúng tiến độ, cửa sổ tự mở lại.

7Cuộc gọi và ghi âm

Chọn SIM trong bảng chính → Cuộc gọi. Cửa sổ có 3 tab: Tự động (Excel), Thủ công, Chuyển tiếp.

Cửa sổ Cuộc gọi: chọn file Excel, chế độ gọi, thời gian nghe máy, ghi âm, phát audio, bảng kết quả
Cửa sổ Cuộc gọi, tab Tự động (Excel).

Gọi tự động từ Excel

  1. Tải File Mẫu → File mẫu Excel gọi điện, điền cột A = số điện thoại.
  2. Chọn file Excel, chọn Chế độ gọi: Tuần tự hoặc Đồng loạt.
  3. Đặt thời gian:
    • Nghe máy (giây): cúp máy sau bao nhiêu giây kể từ khi người kia nghe.
    • Thời gian gọi (giây): đổ chuông bao lâu không nghe thì cúp.
    • Giãn cách (giây): nghỉ giữa 2 cuộc. Giới hạn/slot/ngày: tính mọi lần quay số, kể cả không ai nghe. 0 = không giới hạn.
  4. Tuỳ chọn: Ghi âm đầu bên kia, Chuyển giọng nói thành văn bản (offline), Phát audio từ máy (chọn file âm thanh để phát khi người kia nghe máy, vd lời chào, thông báo).
  5. Load data → Bắt đầu gọi. Có Tạm dừng / Dừng hẳn, Xuất file (Excel), Transcribe hàng loạt.

Bảng kết quả có cột File ghi âm (▶ Nghe) và Speech to text (lời nói đã chuyển thành chữ).

File âm thanh để phátModem phát file .amr. Trên web có thể chọn .amr/.wav/.mp3. Tạo file .amr từ chữ ở tab Chuyển văn bản → Âm thanh. Nút 🔍 Kiểm tra audio kiểm tra modem có phát/ghi âm được không (chọn đúng 1 slot).

Gọi thủ công

Nhập Số điện thoại vào ô, các tuỳ chọn giống chế độ tự động. Cách ghép số với SIM giống gửi tin thủ công.

Chuyển tiếp cuộc gọi

  1. Chọn các SIM trong bảng chính, mở tab Chuyển tiếp, bấm Load data.
  2. Nhập Số nhận cuộc gọi chuyển tiếp.
  3. Bấm Chuyển tiếp để bật (mọi cuộc gọi tới SIM sẽ chuyển sang số kia) hoặc Hủy chuyển tiếp. Cột Kết quả báo từng SIM. SIM Viettel tự dùng cách dự phòng qua tin nhắn 1322.

Tự động nghe máy cuộc gọi đến (OTP bằng giọng nói)

Một số dịch vụ đọc mã OTP qua cuộc gọi. Tick ô Tự động nhận cuộc gọi đến ở dòng SIM tương ứng trong bảng chính: SIM tự nghe máy, ghi âm, chuyển lời thành chữ; kết quả hiện trong Lịch sử. Bỏ tick thì cuộc gọi đến bị từ chối tự động. Cài đặt được nhớ theo từng SIM/module.

8Kích hoạt hàng loạt và nạp tiền

Hàng Kích hoạt hàng loạt ngay dưới các nút điều khiển: làm cùng một việc trên nhiều SIM một lúc.

Hàng Kích hoạt hàng loạt: ô tick, chọn chế độ, ô Số đích, nút Chạy kích hoạt
  1. Tick Kích hoạt hàng loạt.
  2. Ở ô Qua chọn chế độ: SMS, Cuộc gọi, Gọi 900 (Kích hoạt SIM), Nạp tiền.
  3. Nhập Số đích (và Nội dung nếu là SMS, Thời lượng gọi nếu là Cuộc gọi).
  4. Chọn các SIM trong bảng chính (trừ chế độ Nạp tiền), bấm Chạy kích hoạt. Kết quả hiện ở Nhật ký trực tiếp.
Chế độLàm gì
SMSMọi SIM đã chọn gửi cùng nội dung tới Số đích.
Cuộc gọiMọi SIM đã chọn gọi tới Số đích trong thời lượng đặt sẵn.
Gọi 900 (Kích hoạt SIM)Số đích cố định 900. Mỗi SIM gọi 900, chờ tổng đài trả lời rồi tự bấm phím 1, lại bấm 1 theo kịch bản kích hoạt SIM mới. Khoảng 15 giây sau tự tra lại số điện thoại và số dư. Chế độ này không đòi SIM phải "khoẻ", vì SIM chưa kích hoạt thường chưa vào mạng đầy đủ.
Mã USSDGõ mã có * hoặc # vào Số đích (vd *101#) thì chạy mã USSD đó trên mọi SIM chọn, dù đang chọn chế độ nào. Nhiều mã cách nhau dấu phẩy: *101#,*102#.
Nạp tiềnNạp thẻ cào cho từng số, xem ngay bên dưới.

Nạp tiền bằng thẻ cào

Chế độ Nạp tiền: ô Số đích *100*, bảng các số đang online với số dư và ô Mã thẻ, cột Kết quả
Chọn "Nạp tiền": hiện bảng các số đang online, mỗi số một ô Mã thẻ.
  1. Tick Kích hoạt hàng loạt, ô Qua chọn Nạp tiền. Ô Số đích tự điền *100* — cú pháp nạp thẻ chung của Viettel, MobiFone, Vinaphone. Có thể sửa nếu nhà mạng dùng mã khác.
  2. Bảng bên dưới liệt kê các số đang online kèm số dư. Nhập mã thẻ cào vào ô Mã thẻ của số cần nạp (có thể gõ cả dấu cách, gạch ngang). Số nào để trống thì không nạp. Bấm Làm mới danh sách nếu vừa có SIM mới online; mã đã nhập được giữ.
  3. Bấm Chạy kích hoạt. Phần mềm hiện danh sách xác nhận với mã thẻ đã che (vd *100*********9012#). Bấm OK.
  4. Mỗi SIM tự bấm *100*<mã thẻ>#. Cột Kết quả hiện câu trả lời của nhà mạng: xanh = thành công, đỏ = lỗi. Thẻ nạp thành công được xoá khỏi ô; khoảng 5 giây sau số dư tự cập nhật.
Phần mềm chặn trước khi nạp nếu:
  • mã thẻ không phải 8–20 chữ số;
  • cùng 1 mã thẻ nhập cho 2 số (thẻ chỉ dùng được 1 lần);
  • SIM đã rớt mạng;
  • ô Số đích sai dạng.
Khi có lỗi, không số nào bị nạp để tránh nạp dở dang. Lịch sử chỉ lưu 4 số cuối của mã thẻ.
Nhập sai mã nhiều lầnNhà mạng có thể tạm khoá chức năng nạp thẻ của thuê bao nếu nhập sai mã liên tục (thường 5 lần). Kiểm tra kỹ mã trước khi nạp.

9Số dư và hạn dùng

  • Tự động: khi SIM vừa vào mạng, phần mềm tự tra số dư, hạn dùng và số điện thoại 1 lần bằng mã của từng nhà mạng (vd Viettel nhắn "TK" tới 191, nhà mạng khác dùng *101#).
  • Tra lại cả loạt: bấm Lấy số dư cạnh ô tìm kiếm.
  • Dòng tiêu đề bảng có TK=0: số SIM đang hết tiền.
  • Nạp tiền: xem Nạp tiền bằng thẻ cào.
Vì sao số điện thoại chưa hiện?Nhiều SIM không lưu số của chính nó. Phần mềm đọc số từ tin trả lời tra số dư, nên số chỉ hiện sau khi tra số dư thành công. SIM mới chưa kích hoạt: dùng Gọi 900 trước.

10Quản lý IMEI

Bấm Quản lý IMEI (chỉ tài khoản quản trị).

Hộp thoại Quản lý IMEI theo SIM: tick tự động đổi IMEI, khung Đổi IMEI thủ công, bảng IMEI, Serial SIM, IMSI, số điện thoại, đang cắm ở

Đổi IMEI thủ công cho 1 slot

  1. Khung Đổi IMEI thủ công chỉ hiện khi không bật tự động đổi.
  2. Chọn Slot, nhập IMEI mới (15 số) hoặc bấm Tạo IMEI để phần mềm tạo 1 IMEI hợp lệ, cùng dòng với các module khác và chưa ai dùng.
  3. Bấm Đổi IMEI → xác nhận. Modem khởi động lại với IMEI mới.

Tự động đổi IMEI theo SIM

Tick Tự động đổi IMEI theo file khi cắm SIM: khi cắm SIM, modem vào chế độ máy bay, đọc Serial SIM (hoặc IMSI), tìm trong bảng. Nếu SIM có trong bảng thì đổi đúng IMEI đó trước khi bật sóng. Đổi không được 3 lần thì slot bị chặn. SIM mới chưa có trong bảng được tự thêm khi biết số điện thoại.

  • Nạp Excel...: thay toàn bộ bảng bằng file. Cột: IMEI | Serial SIM | IMSI | Số điện thoại. Mỗi dòng cần IMEI và Serial SIM hoặc IMSI. Bấm Tải file mẫu để có file đúng mẫu.
  • Xuất Excel..., Thêm dòng, sửa trực tiếp trong ô, Xoá dòng. Cột Đang cắm ở cho biết SIM đang ở slot nào.
Trùng IMEIMặc định mỗi IMEI chỉ được phát sóng ở 1 slot: slot cắm sau bị chặn (chế độ máy bay) và tô vàng. Nếu bạn cố ý cho nhiều SIM dùng chung IMEI, tick Cho phép trùng IMEI cạnh ô tìm số điện thoại.

11Lịch sử 60 ngày

Tab Lịch sử 60 ngày lưu mọi tin nhắn, OTP, cuộc gọi, thao tác SIM (số dư, nạp tiền, USSD) trong 60 ngày. Dữ liệu cũ hơn tự xoá.

Tab Lịch sử 60 ngày: bộ lọc Kết quả, Loại, Từ ngày, Đến ngày, bảng lịch sử với ô Tìm dưới mỗi cột
  • Bộ lọc: Kết quả (Tất cả / thành công / lỗi), Loại (SMS / Cuộc gọi / SIM/USSD), Từ ngày, Đến ngày. Ô Ẩn tin nhắn/cuộc gọi gửi đi tick sẵn để chỉ thấy tin đến (OTP); bỏ tick để thấy cả tin gửi đi.
  • Ô "Tìm..." dưới mỗi cột: lọc nhanh theo số, nội dung, cổng…
  • Chuột phải lên dòng: Đã đọc, Chưa đọc, Đã đọc hết. Dòng đã đọc mờ đi.
  • Bấm vào ô nội dung để chép toàn bộ nội dung. Cột Audio có ▶ Nghe ghi âm.
  • Xuất Excel (tối đa 1000 dòng), Xóa hết lịch sử (không hoàn tác được).
  • Lọc theo danh sách: dán danh sách số hoặc chọn file Excel (cột A) để xem toàn bộ tin nhắn/cuộc gọi với các số đó. Lọc thêm Tin nhắn / Cuộc gọi / chiều đến / chiều đi, rồi xuất Excel.

Nhật ký trực tiếp

Khung Nhật ký trực tiếp hiện tin OTP đến và kết quả gửi

Bên dưới bảng SIM, khung Nhật ký trực tiếp hiện ngay tin nhắn/OTP vừa đến (mã OTP được tách sẵn) và kết quả gửi, dòng mới nhất ở trên.

12Chuyển văn bản thành giọng nói

Tab Chuyển văn bản → Âm thanh tạo file .amr (định dạng modem phát khi gọi) từ chữ bạn gõ.

Tab Chuyển văn bản thành âm thanh: ô nội dung, chọn giọng đọc, nút Tạo file .amr, phần Batch TTS từ Excel
  1. Gõ Nội dung, chọn Giọng đọc: Nữ (HoaiMy) hoặc Nam (NamMinh). Tick Đọc chậm nếu cần.
  2. Đặt Tên file (tuỳ chọn) → Tạo file .amr. File tải về máy bạn, có trình phát để nghe thử.
  3. Tạo hàng loạt: Excel cột A = nội dung, cột B = tên file (trống = tự đặt), cột C = giọng (1/nam = nam, khác = nữ), dữ liệu từ dòng 2. Bấm Chạy Batch TTS, nhận 1 file .zip.

Trên máy tính Windows có thêm: chuyển file âm thanh bất kỳ sang .amr và thử nhận diện giọng nói offline.

13Dùng từ xa qua Gateway

Mở dashboard từ bất kỳ đâu (điện thoại, máy khác) qua gateway.xvooc.id.vn. Không cần IP tĩnh, không phải cài router. Tin nhắn, ghi âm vẫn lưu trên máy của bạn.

Lần đầu: đăng ký và liên kết thiết bị

  1. Vào gateway.xvooc.id.vn → Đăng ký ngay để tạo tài khoản cổng (mật khẩu ít nhất 6 ký tự).
  2. Trên máy tính Windows: tab Tài khoản từ xa → Kết nối tới Gateway.... Nhập tài khoản cổng → Đăng nhập & Gửi yêu cầu. Trên Raspberry Pi: làm ở bước 3 của trang thiết lập lần đầu.
    Cách khác: trên trang Gateway, mục Thêm thiết bị mới, dán Mã máy (copy từ tab Tài khoản từ xa hoặc hộp thoại license), đặt Nhãn (vd "Máy văn phòng A") → Gửi yêu cầu.
  3. Chờ quản trị viên XGSMHub duyệt. Phần mềm tự kiểm tra mỗi vài giây và tự kết nối khi được duyệt, không cần làm gì thêm.
  4. Tạo tài khoản đăng nhập thiết bị (xem mục 14). Đây là tài khoản dùng để vào dashboard, khác tài khoản cổng.

Hằng ngày

  1. Đăng nhập gateway.xvooc.id.vn bằng tài khoản cổng. Mục Thiết bị đã được cấp quyền cho biết thiết bị nào đang online.
  2. Bấm Mở quản lý ở thiết bị cần dùng → dashboard mở ra, đăng nhập bằng tài khoản đăng nhập thiết bị.
Nhiều người cùng mởNgười mở trước giữ quyền điều khiển; người mở sau thấy thông báo "đang ở chế độ chỉ xem". Trên máy tính đặt hub, khi có người điều khiển từ xa sẽ hiện "Đang được điều khiển từ xa" với nút Giành lại quyền điều khiển. Tài khoản phụ thuộc luôn có phiên riêng.
Mất kết nốiNếu máy đặt hub mất mạng, dashboard hiện "Máy đang mất kết nối — số liệu bên dưới có thể đã cũ" và tự nối lại khi có mạng. Lệnh đang gửi dở sẽ được gửi lại đúng 1 lần, không bị gửi trùng.

14Tài khoản nhân viên và chia port

Tài khoản truy cập từ xa

Tạo cho từng nhân viên một tài khoản để đăng nhập dashboard qua Gateway, tắt khi họ nghỉ việc.

  • Trên máy tính Windows: tab Tài khoản từ xa → Thêm tài khoản..., Bật/Tắt truy cập, Đổi mật khẩu..., Xoá. Nút Đi tới trang quản lý mở trang Gateway.
  • Trên web / Raspberry Pi (mở tại chỗ hoặc qua Gateway, tài khoản quản trị): tab Tài khoản từ xa → Tài khoản truy cập từ xa: nhập tên, mật khẩu (ít nhất 6 ký tự), chọn vai trò → Thêm tài khoản.
Vai tròĐược làm
Quản trịMọi thứ, kể cả Quản lý IMEI, gia hạn license, cài đặt.
Người dùngGửi tin, gọi điện, xem lịch sử. Không thấy Quản lý IMEI, không đổi VoLTE, không gia hạn license.
Tài khoản phụ thuộcChỉ thấy và dùng các port được giao. Không ngắt/kết nối lại, không reset hub, không đổi tên cổng.

Tài khoản phụ thuộc (chia port cho khách/nhân viên)

  1. Mở dashboard bằng tài khoản quản trị (tại chỗ hoặc qua Gateway) → tab Tài khoản từ xa → Tài khoản phụ thuộc (chia port) → tạo tài khoản.
  2. Bảng Phân quyền port: ở cột Giao cho, chọn tài khoản cho từng slot → Lưu phân quyền. Port được gán theo cổng USB vật lý.
  3. Người được giao đăng nhập qua Gateway bằng tài khoản này, chỉ thấy đúng các port của họ. Xoá tài khoản thì port trả lại cho quản trị.

15Tab Cài đặt

Chỉ hiện với tài khoản quản trị khi mở dashboard tại chỗ (cùng mạng LAN, hoặc trên chính Raspberry Pi). Qua Gateway tab này bị ẩn để an toàn.

Tab Cài đặt: giới hạn tần suất gửi, tự động trả lời cuộc gọi, đường dẫn lưu, kết nối Gateway, tài khoản truy cập từ xa
NhómNội dung
Giới hạn tần suất gửi SMSSố lần gửi tối đa trong 1 khoảng thời gian (chống gửi dồn qua API).
Tự động trả lời cuộc gọi đếnBật/tắt, thời lượng ghi âm, nhận dạng giọng nói (Whisper) và chọn model.
Đường dẫn lưu file audioThư mục lưu ghi âm trên máy.
Kết nối GatewayXem trạng thái kết nối, địa chỉ Gateway, mã thiết bị (chỉ xem).
Reset nguồn hub (GPIO)Chỉ trên Raspberry Pi. Xem mục 16.
Cập nhật phần mềmChỉ trên Raspberry Pi: tự động cập nhật, Kiểm tra ngay, Cập nhật ngay.
File cấu hìnhTải về các file cấu hình để sao lưu.

16Raspberry Pi: giám sát và tự vận hành

Pi được thiết kế để đặt ở xa (kho, quê nhà…) và chạy nhiều tháng không cần người trông.

Khung Thông tin Raspberry Pi

Khung Thông tin Raspberry Pi: CPU, nhiệt độ, RAM, bộ nhớ, nguồn điện, thời gian chạy

Hiện dưới Nhật ký trực tiếp, cập nhật mỗi 30 giây: CPU, Nhiệt độ CPU (vàng từ 70 °C, đỏ từ 80 °C), Bộ nhớ RAM, Bộ nhớ lưu trữ, Nguồn điện, Thời gian chạy.

"Đang thiếu điện!"Nguồn của Pi quá yếu, dễ gây treo, hỏng thẻ nhớ. Dùng nguồn 5V/3A cho Pi và nguồn riêng cho hub.

Reset nguồn hub tự động

Cần 1 module relay nối chân GPIO của Pi để ngắt điện hub. Vào Cài đặt → Reset nguồn hub (GPIO):

  • Chân GPIO (BCM): chân nối relay (vd 17). Mức tín hiệu khi NGẮT nguồn: LOW (đa số relay) hoặc HIGH. Thời gian ngắt: mặc định 5 giây.
  • Tự động reset khi modem rớt hàng loạt (bật sẵn): nếu số modem trả lời tụt dưới 50% bình thường liên tục 5 phút, Pi tự ngắt điện hub rồi cấp lại. Cách nhau ít nhất 15 phút, tối đa 4 lần/24 giờ.
  • Reset bằng tay: nút Reset nguồn hub trong Điều khiển GSM.

Tự bảo vệ khi treo, tự cập nhật

  • Watchdog: Pi treo quá 14 giây thì tự khởi động lại; phần mềm treo quá 3 phút thì tự chạy lại.
  • Tự động cập nhật: kiểm tra khoảng 6 giờ/lần, chỉ cài bản có chữ ký hợp lệ và khi không có việc gửi/gọi đang chạy. Bản mới lỗi thì tự quay về bản cũ.
  • Dọn dữ liệu: ghi âm, lịch sử cũ hơn 60 ngày tự xoá. Bộ nhớ sắp đầy thì xoá ghi âm cũ nhất trước.

17Bản quyền và gia hạn

Hộp thoại Thông tin phần mềm: phiên bản, hạn sử dụng, ô nhập license key mới, mã máy
  • Bấm Thông tin phần mềm để xem phiên bản và hạn sử dụng.
  • Còn ≤14 ngày, dashboard hiện thanh nhắc gia hạn ở cuối trang. Bấm Gia hạn.
  • Gia hạn: gửi Mã máy qua Zalo để nhận license mới → dán vào ô Nhập license key mới → Kích hoạt. Có thể làm từ xa qua Gateway; thiết bị tự khởi động lại khoảng 1 phút.
  • Hết hạn: modem tạm dừng ở lần khởi động tiếp theo, dashboard vẫn mở được để nhập key mới.

18Xử lý sự cố thường gặp

Slot báo "offline" hoặc không hiện trong bảng
Kiểm tra hub đã cấp nguồn, cáp USB chắc chắn. Bấm Kết nối lại. Nếu nhiều slot cùng rớt, thường do nguồn hub yếu. Trên Pi có thể dùng Reset nguồn hub.
Trạng thái "Không gắn SIM" hoặc "Khóa Sim"
Rút điện hub, lắp lại SIM đúng chiều, cắm lại. "Khóa Sim" là SIM đang có mã PIN hoặc bị nhà mạng chặn: thử SIM trên điện thoại.
Cột Module màu vàng "Lỗi sim / Sóng yếu"
Kiểm tra anten đã gắn vào cổng MAIN của modem, đặt hub gần cửa sổ, tránh hộp kim loại. Cột Sóng đỏ (≤2 vạch) là sóng yếu.
Không thấy số điện thoại / số dư
Chờ vài phút sau khi SIM vào mạng, hoặc bấm Lấy số dư. SIM mới chưa kích hoạt thì dùng Gọi 900.
Gửi tin báo lỗi hàng loạt
Kiểm tra SIM còn tiền/gói cước và còn hạn. Tăng Giãn cách, giảm Giới hạn/ngày: nhà mạng có thể chặn SIM gửi quá nhanh. Kiểm tra số nhận đúng định dạng (0xxxxxxxxx hoặc +84…).
Slot tô vàng, báo "Trùng IMEI"
Hai modem đang có cùng IMEI. Đổi IMEI cho 1 slot (Quản lý IMEI), hoặc tick Cho phép trùng IMEI nếu bạn cố ý dùng chung.
Nạp thẻ báo thất bại
Đọc câu trả lời ở cột Kết quả: thẻ sai mã, thẻ đã dùng, hoặc thuê bao bị khoá nạp. Thẻ lỗi vẫn giữ trong ô để bạn kiểm tra. Đừng thử lại nhiều lần với mã sai.
Cuộc gọi không có ghi âm
Không phải firmware modem nào cũng hỗ trợ ghi âm/thoại. Chọn 1 slot, bấm 🔍 Kiểm tra audio trong cửa sổ Cuộc gọi để kiểm tra. Một số firmware chỉ hỗ trợ SMS/dữ liệu.
Không vào được dashboard từ xa
Kiểm tra máy đặt hub còn bật và có Internet. Trên trang Gateway, cột Đang online phải là "Có". Đăng nhập dashboard bằng tài khoản đăng nhập thiết bị, không phải tài khoản cổng.
Raspberry Pi báo "Đang thiếu điện!"
Thay nguồn 5V/3A chính hãng, dây nguồn ngắn và tốt. Không cấp điện hub từ cổng USB của Pi.

19Liên hệ hỗ trợ

Cần license, hỗ trợ cài đặt từ xa, hay gặp lỗi chưa có trong hướng dẫn: nhắn Zalo 0968 338 547, gọi 0968 338 547, hoặc email boolbits@gmail.com. Gửi kèm ảnh chụp màn hình lỗi sẽ được hỗ trợ nhanh hơn.

↑