Hướng dẫn sử dụng HabaChat Mobile Admin

Hướng dẫn này đi từ lúc chưa cài gì đến lúc bạn đăng được sản phẩm đầu tiên bằng điện thoại.

1. Cài module cầu nối

1. Tải file zip từ tài khoản HabaChat của bạn.
2. Back-office PrestaShop → Modules → Module Manager → Upload a module → chọn file zip.
3. Chờ PrestaShop cài xong, bấm Configure.

Cài qua FTP cũng được: chép thư mục habamobileadmin vào /modules/ rồi bấm Install trong Module Manager.

2. Kích hoạt giấy phép hoặc bắt đầu dùng thử

Ở khung Giấy phép & Dùng thử trên trang Configure:

1. Nếu đã mua: dán khóa dạng v2... vào ô rồi bấm Kích hoạt. Khóa gắn với đúng tên miền hiển thị ngay bên dưới.
2. Nếu chưa mua: bấm Bắt đầu dùng thử 90 ngày. Nút này chỉ hiện một lần cho mỗi cửa hàng.

Chưa có giấy phép cũng chưa có dùng thử thì app sẽ không ghép được — cửa hàng và back-office của bạn hoàn toàn không bị ảnh hưởng, chỉ app là ngừng.

3. Lấy mã ghép

Khung Kết nối app ở đầu trang Configure hiện một mã QR, một mã ghép 8 ký tự để nhập tay khi camera khó quét, cùng địa chỉ API và địa chỉ cửa hàng để đối chiếu.

Mã có hiệu lực 15 phút và dùng một lần. Hết hạn thì tải lại trang, mã mới sinh tự động. Mã cấp cho tài khoản nhân viên đang đăng nhập, nên hãy để mỗi người tự lấy mã từ tài khoản của họ.

4. Cài app và ghép máy

1. Trên điện thoại, tải HabaChat Admin từ App Store hoặc Google Play.
2. Mở app → bấm Quét mã QR → cho phép dùng camera → hướng vào màn hình máy tính.
3. Vài giây sau app vào thẳng màn hình chính. Xong.

Không quét được thì nhập tay: gõ địa chỉ cửa hàng (ví dụ shop.tencuahang.com) và mã 8 ký tự, rồi bấm Kết nối. Cách này chạy được kể cả khi cửa hàng chưa bật friendly URL.

5. Đi một vòng các tab

• Trang chủ — doanh thu hôm nay và tháng này, đơn hôm nay, đơn cần xử lý, khách mới, hàng tồn ≤ 5, biểu đồ 7 ngày, 5 đơn gần nhất. Chạm ô "Cần xử lý" để sang danh sách đơn; vuốt xuống để làm mới.
• Sản phẩm — tìm kiếm, dải danh mục cuộn ngang, danh sách kèm ảnh, giá, tồn kho. Chạm một sản phẩm để sửa tên, giá, tồn, cân nặng, danh mục, tags và bật/tắt hiển thị.
• Đơn hàng — lọc theo trạng thái, tìm kiếm, tự tải thêm khi cuộn xuống.
• Tin nhắn — hộp thư CSKH, mỗi dòng một khách kèm tin nhắn cuối.
• Thêm — thông tin cửa hàng, quản lý đánh giá, trợ giúp, liên hệ, chính sách, chuyển Việt/Anh và đăng xuất.

6. Đăng sản phẩm bằng ảnh và AI

Trước tiên nạp khóa AI một lần ở trang Configure: khung AI viết nội dung sản phẩm → dán khóa API Claude → Lưu cấu hình AI. Khóa nằm trên máy chủ, app không bao giờ thấy. Muốn tiết kiệm, đổi model sang bản rẻ hơn ở ô ngay bên dưới.

Trên điện thoại:

1. Tab Sản phẩm → nút + (hoặc lối tắt "Thêm sản phẩm" ở trang chủ).
2. Chụp ảnh hoặc chọn ảnh từ thư viện.
3. Chọn giọng văn: Chuyên nghiệp, Thân thiện hoặc Ngắn gọn. Có thể thêm từ khóa gợi ý và yêu cầu riêng, ví dụ "nhấn mạnh bảo hành 12 tháng".
4. Bấm Viết nội dung bằng AI và chờ vài giây.
5. Kiểm tra tên và tags đã điền sẵn — mô tả, mô tả ngắn và SEO đã được viết cho mọi ngôn ngữ ở nền.
6. Điền giá, tồn kho, cân nặng; chọn danh mục và đơn vị vận chuyển.
7. Bật Hiển thị trên cửa hàng nếu muốn bán ngay, rồi bấm Lưu & đăng bán. Ảnh vừa chụp thành ảnh đại diện sản phẩm.

7. Đổi trạng thái đơn và báo cho khách

1. Tab Đơn hàng → chạm vào đơn cần xử lý.
2. Xem khách, email, từng dòng hàng và tổng tiền.
3. Bấm Đổi trạng thái → chọn trạng thái mới.
4. Đơn cập nhật ngay và PrestaShop gửi đúng email thông báo nó vẫn gửi cho trạng thái đó.

8. Trả lời khách trong hộp thư

1. Tab Tin nhắn → chạm một hội thoại.
2. Đọc lịch sử dạng bong bóng chat, tin của shop nằm bên phải.
3. Gõ câu trả lời → bấm gửi. Tin lưu vào hội thoại và gửi email cho khách, ghi tên nhân viên đã ghép máy.

9. Bật thông báo đẩy

App tự xin quyền thông báo ngay sau khi ghép và đăng ký thiết bị về cửa hàng; chỉ cần bấm Cho phép. Từ đó mỗi đơn mới và mỗi tin nhắn khách gửi sẽ rung máy. Lỡ bấm Từ chối thì bật lại thông báo cho app trong Cài đặt hệ điều hành, rồi đăng xuất và ghép lại.

10. Quản lý thiết bị đã ghép

Mỗi lần ghép tạo một bản ghi thiết bị trên cửa hàng, giữ token gia hạn và token đẩy; ghép lại cùng một máy sẽ ghi đè bản ghi cũ. Muốn cắt một máy: bấm Đăng xuất trong tab Thêm, hoặc đặt thiết bị đó về trạng thái không hoạt động — phiên chết ngay và máy thôi nhận thông báo. Gỡ module thì mọi thiết bị mất kết nối.

Xử lý sự cố

App báo không kết nối được cửa hàng. Kiểm tra địa chỉ có gõ nhầm không và cửa hàng có mở được bằng trình duyệt trên chính điện thoại đó không. Chứng chỉ tự ký sẽ bị thiết bị từ chối — hãy dùng chứng chỉ thật. Nếu có tường lửa hoặc WAF, cho phép đường dẫn /module/habamobileadmin/.

Nhập đúng mã mà vẫn báo sai hoặc hết hạn. Mã sống 15 phút và dùng một lần: tải lại trang Configure để lấy mã mới. Mã không bao giờ chứa ký tự 0, O, 1 hay I.

Ghép được nhưng mọi màn hình đều báo phiên hết hạn. Một số cấu hình Apache lọc mất header Authorization. Thêm vào file .htaccess ở gốc cửa hàng: RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] rồi thử lại.

Nút AI báo lỗi. Kiểm tra mục AI trên trang Configure đã hiện "Đã cấu hình" chưa, tài khoản AI còn hạn mức không, và máy chủ có gọi ra ngoài qua HTTPS được không. Ảnh quá lớn cũng có thể vượt thời gian chờ.

Không nhận được thông báo đẩy. Kiểm tra quyền thông báo của app, rồi đăng xuất và ghép lại một lần để thiết bị đăng ký token mới. Thông báo chạy kiểu tốt-nhất-có-thể: máy chủ không gọi ra ngoài được thì đơn hàng vẫn xử lý bình thường, chỉ là không có rung.

App báo cửa hàng chưa kích hoạt. Dùng thử hoặc giấy phép đã hết hạn. Vào trang Configure nhập khóa mới; cửa hàng và back-office không hề bị ảnh hưởng.