Kết nối Zalo
Xem dạng Markdown
Trang **Kênh kết nối → Zalo** (`/{slug}/channels/zalo`) cho phép bạn kết nối nhiều tài khoản Zalo cá nhân vào Workspace thông qua mã QR và quản lý cả danh sách **Tài khoản** lẫn **Proxy** trong cùng một màn hình.
:::note[Quyền truy cập]
- **Xem kênh Zalo**: Cần **`nick:read:all`**, **`nick:connect`** hoặc **`nick:operate`**.
- **Kết nối mới / Đăng nhập lại bằng QR**: Cần **`nick:connect`**.
- **Kết nối lại / Ngắt kết nối / Quản lý Proxy**: Cần **`nick:operate`**.
- **Gỡ tài khoản**: Cần **`nick:delete`**.
:::
## Kết nối tài khoản Zalo bằng mã QR
1. Truy cập **Kênh kết nối → Zalo** (hoặc **Tất cả kênh**), nhấn **Thêm kênh** và chọn **Zalo**.
2. **Bước 1 — Chọn Proxy**:
- Chọn một Proxy có sẵn trong danh sách của Workspace, hoặc chọn **Kết nối trực tiếp**.
- Nếu chưa có Proxy, bạn có thể nhấn **Thêm proxy** để thêm nhanh ngay trong hộp thoại mà không cần rời luồng kết nối.
3. **Bước 2 — Tạo & Quét mã QR**:
- Nhấn **Tạo mã QR**. Hệ thống sẽ khởi tạo phiên đăng nhập QR (giới hạn tối đa **10 lần/phút** mỗi người dùng).
- Mở ứng dụng **Zalo** trên điện thoại, quét mã QR hiển thị trên màn hình và xác nhận đăng nhập.
4. Khi đăng nhập thành công, hộp thoại tự động đóng và tài khoản xuất hiện trong danh sách kênh. Nếu bạn đóng hộp thoại khi chưa quét xong, hệ thống sẽ tự động hủy phiên QR đang chờ.
:::tip[Hạn mức gói dịch vụ]
Hệ thống kiểm tra giới hạn số lượng kênh (`maxNicks`) khi kết nối tài khoản Zalo mới hoặc kích hoạt lại tài khoản đang bị khóa/ở thùng rác. Nếu đã đạt trần gói, bạn cần nâng cấp gói hoặc gỡ bớt kênh không dùng.
:::
## Trạng thái tài khoản Zalo
| Trạng thái | Ý nghĩa | Cách xử lý |
| :--- | :--- | :--- |
| **`CONNECTED`** | Phiên Zalo đang hoạt động bình thường, nhận và gửi tin nhắn theo thời gian thực. | Không cần thao tác. |
| **`DISCONNECTED`** | Phiên bị ngắt kết nối tạm thời nhưng vẫn giữ thông tin đăng nhập. | Chọn **Kết nối lại** trong menu `⋮`. |
| **`DIED`** | Phiên đăng nhập đã hết hạn hoặc bị vô hiệu hóa phía Zalo. | Kiểm tra trên ứng dụng Zalo, sau đó chọn **Đăng nhập lại bằng QR** trong menu `⋮`. |
| **`LOGGED_IN_ELSEWHERE`** | Phiên bị đẩy ra do tài khoản Zalo được đăng nhập trên thiết bị hoặc trình duyệt khác. | Thống nhất thiết bị sử dụng trong nhóm, sau đó chọn **Đăng nhập lại bằng QR** trong menu `⋮`. |
| **`LOCKED`** | Tài khoản bị tạm khóa thanh toán (`billingLocked`) do gói dịch vụ hết hạn hoặc vượt hạn mức kênh. | Gia hạn/nâng cấp gói rồi mở khóa tài khoản. |
## Các thao tác quản lý tài khoản
Nhấn biểu tượng menu **`⋮`** ở cuối mỗi dòng tài khoản Zalo để thực hiện:
- **Kết nối lại** (`nick:operate`): Khởi động lại phiên cho tài khoản đang ở trạng thái `DISCONNECTED`.
- **Đăng nhập lại bằng QR** (`nick:connect`): Quét lại mã QR để khôi phục phiên cho tài khoản đã hết hạn (`DIED`). Việc đăng nhập lại một tài khoản đang hoạt động không tính thêm vào hạn mức gói.
- **Ngắt kết nối** (`nick:operate`): Tạm ngắt phiên đang chạy (`CONNECTED`) và chuyển sang `DISCONNECTED` mà không xóa tài khoản hay dữ liệu hội thoại.
- **Gỡ tài khoản** (`nick:delete`): Đăng xuất và ẩn tài khoản khỏi danh sách kênh.
:::caution[Gỡ tài khoản không xóa vĩnh viễn dữ liệu]
Khi bạn chọn **Gỡ tài khoản**, toàn bộ lịch sử hội thoại, tin nhắn và danh bạ liên hệ vẫn được giữ nguyên. Tài khoản sẽ được chuyển vào **Cài đặt → Thùng rác** (`/{slug}/settings/trash`), nơi bạn có thể **khôi phục** hoặc **xóa vĩnh viễn**, hoặc quét lại QR bằng chính tài khoản Zalo đó trong cùng Workspace để khôi phục.
:::
## Tài liệu liên quan
- [Cài đặt Zalo: Proxy, Thẻ phân loại & Mẫu tin nhắn](/vi/channels/zalo-settings/)
- [Tổng quan kênh kết nối](/vi/channels/overview/)
Trang Kênh kết nối → Zalo (/{slug}/channels/zalo) cho phép bạn kết nối nhiều tài khoản Zalo cá nhân vào Workspace thông qua mã QR và quản lý cả danh sách Tài khoản lẫn Proxy trong cùng một màn hình.
Kết nối tài khoản Zalo bằng mã QR
Phần tiêu đề “Kết nối tài khoản Zalo bằng mã QR”- Truy cập Kênh kết nối → Zalo (hoặc Tất cả kênh), nhấn Thêm kênh và chọn Zalo.
- Bước 1 — Chọn Proxy:
- Chọn một Proxy có sẵn trong danh sách của Workspace, hoặc chọn Kết nối trực tiếp.
- Nếu chưa có Proxy, bạn có thể nhấn Thêm proxy để thêm nhanh ngay trong hộp thoại mà không cần rời luồng kết nối.
- Bước 2 — Tạo & Quét mã QR:
- Nhấn Tạo mã QR. Hệ thống sẽ khởi tạo phiên đăng nhập QR (giới hạn tối đa 10 lần/phút mỗi người dùng).
- Mở ứng dụng Zalo trên điện thoại, quét mã QR hiển thị trên màn hình và xác nhận đăng nhập.
- Khi đăng nhập thành công, hộp thoại tự động đóng và tài khoản xuất hiện trong danh sách kênh. Nếu bạn đóng hộp thoại khi chưa quét xong, hệ thống sẽ tự động hủy phiên QR đang chờ.
Trạng thái tài khoản Zalo
Phần tiêu đề “Trạng thái tài khoản Zalo”| Trạng thái | Ý nghĩa | Cách xử lý |
|---|---|---|
CONNECTED | Phiên Zalo đang hoạt động bình thường, nhận và gửi tin nhắn theo thời gian thực. | Không cần thao tác. |
DISCONNECTED | Phiên bị ngắt kết nối tạm thời nhưng vẫn giữ thông tin đăng nhập. | Chọn Kết nối lại trong menu ⋮. |
DIED | Phiên đăng nhập đã hết hạn hoặc bị vô hiệu hóa phía Zalo. | Kiểm tra trên ứng dụng Zalo, sau đó chọn Đăng nhập lại bằng QR trong menu ⋮. |
LOGGED_IN_ELSEWHERE | Phiên bị đẩy ra do tài khoản Zalo được đăng nhập trên thiết bị hoặc trình duyệt khác. | Thống nhất thiết bị sử dụng trong nhóm, sau đó chọn Đăng nhập lại bằng QR trong menu ⋮. |
LOCKED | Tài khoản bị tạm khóa thanh toán (billingLocked) do gói dịch vụ hết hạn hoặc vượt hạn mức kênh. | Gia hạn/nâng cấp gói rồi mở khóa tài khoản. |
Các thao tác quản lý tài khoản
Phần tiêu đề “Các thao tác quản lý tài khoản”Nhấn biểu tượng menu ⋮ ở cuối mỗi dòng tài khoản Zalo để thực hiện:
- Kết nối lại (
nick:operate): Khởi động lại phiên cho tài khoản đang ở trạng tháiDISCONNECTED. - Đăng nhập lại bằng QR (
nick:connect): Quét lại mã QR để khôi phục phiên cho tài khoản đã hết hạn (DIED). Việc đăng nhập lại một tài khoản đang hoạt động không tính thêm vào hạn mức gói. - Ngắt kết nối (
nick:operate): Tạm ngắt phiên đang chạy (CONNECTED) và chuyển sangDISCONNECTEDmà không xóa tài khoản hay dữ liệu hội thoại. - Gỡ tài khoản (
nick:delete): Đăng xuất và ẩn tài khoản khỏi danh sách kênh.