# Cài đặt Zalo (Proxy, Thẻ & Mẫu tin nhắn)

Bên cạnh danh sách tài khoản, OmnyBot cung cấp ba công cụ hỗ trợ vận hành Zalo và hộp thư gồm **Proxy**, **Thẻ phân loại** và **Mẫu tin nhắn**.

## 1. Quản lý Proxy (`/{slug}/channels/zalo?tab=proxies`)

Proxy giúp tách biệt địa chỉ IP khi vận hành nhiều tài khoản Zalo cùng lúc. Bạn có thể truy cập mục này qua tab **Proxy** trong trang **Kênh kết nối → Zalo** (hoặc đường dẫn trực tiếp `/{slug}/proxies`; đường dẫn cũ `/{slug}/zalo-settings/proxies` tự động chuyển hướng sang `/{slug}/proxies`).

:::note[Quyền truy cập Proxy]
Toàn bộ thao tác xem, thêm, kiểm tra và xóa Proxy yêu cầu quyền **`nick:operate`**.
:::

### Thêm Proxy hàng loạt

1. Nhấn **Thêm proxy** và chọn một trong hai cách nhập:
   - **Dán danh sách**: Mỗi dòng một proxy theo định dạng `host:port` (không xác thực) hoặc `host:port:user:pass` (có xác thực).
   - **Tải tệp**: Chọn tệp `.txt` hoặc `.csv` có cùng định dạng mỗi dòng một proxy.
2. Ở cột cài đặt bên phải, chọn:
   - **Giao thức (Scheme)**: `HTTP`, `HTTPS` hoặc `SOCKS5` (áp dụng chung cho toàn bộ lô nhập).
   - **Số tài khoản tối đa mỗi proxy**: Chọn một trong các mức `1`, `2`, `3` (mặc định), `4`, `5` hoặc `10`.
3. Nhấn xác nhận để nhập. Hệ thống hỗ trợ tối đa **500 proxy** mỗi lần nhập; các dòng sai định dạng hoặc trùng `host:port` sẽ tự động được bỏ qua.

### Kiểm tra sức khỏe và quản lý Proxy

- **Lọc & Sắp xếp**: Tìm kiếm theo địa chỉ, lọc theo trạng thái (`HEALTHY` — Khỏe, `DEAD` — Chết, `UNKNOWN` — Chưa kiểm tra) và sắp xếp theo địa chỉ, độ trễ (`latencyMs`) hoặc thời gian kiểm tra gần nhất.
- **Kiểm tra Proxy**: Chạy kiểm tra đơn lẻ hoặc hàng loạt để đo độ trễ và cập nhật trạng thái (giới hạn tốc độ **20 lần/phút**).
- **Xóa Proxy**: Xóa từng proxy hoặc chọn nhiều dòng để xóa hàng loạt.

## 2. Thẻ phân loại (`/{slug}/tags`)

Thẻ phân loại giúp gắn nhãn và lọc khách hàng trong hộp thư. Bạn có thể truy cập qua thanh bên **Xây dựng → Thẻ phân loại** (đường dẫn cũ `/{slug}/zalo-settings/tags` tự động chuyển hướng sang `/{slug}/tags`).

:::note[Quyền truy cập Thẻ phân loại]
- **Xem danh sách thẻ**: Cần quyền **`inbox:read:all`**.
- **Tạo, sửa, xóa thẻ**: Cần quyền **`inbox:reply`** hoặc **`workspace:manage`**.
:::

- **Tạo thẻ mới**: Nhấn **Thêm thẻ**, nhập tên thẻ (tối đa **20 ký tự**, không trùng tên) và chọn màu hiển thị.
- **Tìm kiếm & Sắp xếp**: Tìm theo tên thẻ và sắp xếp theo số lượng liên hệ đang gắn thẻ, tên thẻ hoặc ngày tạo.
- **Chỉnh sửa & Xóa**:
  - Đổi tên hoặc đổi màu thẻ sẽ tự động cập nhật đồng bộ trên toàn bộ liên hệ đang gắn thẻ đó.
  - Xóa thẻ sẽ gỡ thẻ khỏi tất cả liên hệ liên quan.

## 3. Mẫu tin nhắn (`/{slug}/zalo-settings/templates`)

Thư viện **Mẫu tin nhắn** (canned replies / snippets) lưu sẵn các câu trả lời thường dùng để nhân viên chèn nhanh khi trò chuyện trong hộp thư (đường dẫn `/{slug}/message-templates` và `/{slug}/zalo-settings` tự động chuyển hướng về trang này).

:::note[Quyền truy cập Mẫu tin nhắn]
Toàn bộ thao tác xem, tạo, sửa và xóa mẫu tin nhắn yêu cầu quyền **`inbox:reply`**.
:::

- **Tạo / Sửa mẫu**: Nhấn **Thêm mẫu** (hoặc nhấn vào mẫu có sẵn) và điền:
  - **Tiêu đề**: Tên gợi nhớ (tối đa **120 ký tự**).
  - **Phím tắt (Shortcut)**: Tùy chọn, tối đa **50 ký tự** (ví dụ: `/chao`, `/stk`) để gọi nhanh trong khung chat.
  - **Nội dung**: Nội dung tin nhắn mẫu (tối đa **20.000 ký tự**).
- **Tìm kiếm & Xóa**: Lọc nhanh theo tiêu đề hoặc nội dung mẫu, và xóa các mẫu không còn sử dụng qua menu **`⋮`**.

## Tài liệu liên quan

- [Kết nối Zalo](/vi/channels/zalo/)
- [Tổng quan kênh kết nối](/vi/channels/overview/)