Hướng dẫn sử dụng hệ thống

1. Tổng quan

ZCA (Zalo Cloud Automation) là nền tảng tự động hóa Zalo OA: gửi tin ZNS, quản lý OA, ví tiền và tích hợp API. Hệ thống gồm:

• zca.vn — Trang landing, đăng ký/đăng nhập Zalo OA.
• app.zca.vn — Portal chính: User quản lý OA, gửi tin; Agency quản lý User con, ví, cấu hình thanh toán.
• agency.zca.vn — Trang giới thiệu cơ hội kinh doanh cho Agency.
• api.zca.vn — API backend (JSON). Dùng khi tích hợp từ app khác hoặc automation.

2. Luồng User (khách hàng dùng Zalo OA)

User đăng nhập qua Zalo OA hoặc email → vào app.zca.vn/user. Tại đây có:

• Ví — Số dư Cash (main) và Credit; nạp tiền (topup) để trả phí gửi tin.
• Quản lý OA — Cấp quyền Zalo OA một lần; hệ thống lưu token và dùng để gửi ZNS.
• ZBS (Zalo Broadcast Studio) — Tạo chiến dịch gửi tin, bulk-send, template.
• Giới thiệu — Chia sẻ link ref để nhận thưởng khi người được giới thiệu đăng ký và kích hoạt.

3. Luồng Agency

Agency đăng nhập → vào app.zca.vn/agency. Quyền lợi và chức năng:

• Tổng quan — Số dư ví, thống kê tier, doanh thu.
• Quản lý OA — Danh sách User con (OA) thuộc Agency; link mời ref; điều chỉnh Credit/Cash cho User.
• Cài đặt — Cấu hình tài khoản nhận tiền (ngân hàng), mã chuyển khoản, ủy thác thanh toán, tham gia chương trình giới thiệu.
• Developer — Webhook URL, API Key để tích hợp nạp tiền (Sepay) và gọi API.
• Rút tiền — Tạo yêu cầu rút tiền; Admin duyệt và chuyển khoản.

4. Ví (Wallet)

Mỗi User/Agency có một ví với hai loại số dư:

• Cash (main_balance) — Tiền nạp thật, dùng để trả phí gửi tin hoặc rút về ngân hàng.
• Credit (credit_balance) — Tiền khuyến mãi/chiết khấu; khi trừ phí ZNS sẽ ưu tiên trừ Credit trước, sau đó mới trừ Cash.