# Gửi ZNS cho một nhóm khách

Gửi một tin mẫu Zalo (ZNS) tới mọi khách có số điện thoại trong danh sách đang lọc, tự điền tên và thông tin riêng của từng người.

ZNS (Zalo Notification Service) gửi tin mẫu đã được Zalo duyệt tới số điện thoại của khách, kể cả khi khách chưa từng chat với Official Account của bạn. Từ danh sách khách hàng, bạn gửi được cho cả một nhóm cùng lúc: những ai mua tháng trước, mọi khách sỉ ở Hà Nội, mọi người có nhãn `qua-tet`.

ZNS hợp với những thông báo khách chờ nhận: cập nhật đơn hàng, nhắc lịch hẹn, lời cảm ơn sau khi mua. Zalo duyệt từng mẫu tin và chỉ chấp nhận những loại nội dung được phép.

## Trước khi bắt đầu

- Đã kết nối **Zalo Official Account** trong **Hỗ trợ khách hàng → Kênh**. Xem [Kết nối Zalo Official Account](https://hatang.dev/vi/help/channels/zalo-oa).
- OA có ít nhất một **mẫu ZNS đã được duyệt** trong trang quản lý ZNS của Zalo. Mẫu được tạo và duyệt bên Zalo; Hạ Tầng liệt kê những mẫu đã duyệt.
- Khách bạn muốn gửi có **số điện thoại** trên hồ sơ.
- Bạn có quyền **Quản lý** với module Khách hàng. Không cần quyền ở Hỗ trợ khách hàng để gửi; quyền đó chỉ cần để mở trang **Zalo ZNS** có nhật ký gửi.

> [!WARNING]
> Zalo tính phí cho mỗi tin ZNS, và OA có hạn mức gửi mỗi ngày. Hãy xem số lượng trên trang trước khi gửi.

## Gửi cho một nhóm

1. Mở **Khách hàng → Khách hàng**, lọc danh sách còn đúng những người cần gửi (giai đoạn, người phụ trách, kênh, nhãn hoặc tìm kiếm), rồi bấm **Lọc**.
2. Bấm **Gửi ZNS**. Trang giữ nguyên bộ lọc của bạn.
3. Chọn **Zalo OA** (nếu có nhiều OA) và **Mẫu tin**.
4. Điền **Tham số của mẫu**: nội dung đưa vào từng chỗ trống của mẫu, cho từng khách (xem bên dưới).
5. Đặt **Số tin tối đa** nếu muốn dừng sau một số tin nhất định.
6. Đọc dòng "… khách hàng khớp bộ lọc · … có số điện thoại và sẽ nhận được tin."
7. Bấm **Xếp hàng … tin ZNS**.

![Gửi ZNS cho các khách khớp bộ lọc hiện tại](https://hatang.dev/help/img/vi/customers/zns.webp)

Hạ Tầng xếp hàng một tin cho mỗi khách và trang tải lại, cho biết bao nhiêu tin đã xếp hàng và bao nhiêu khách bị bỏ qua. Từng tin sau đó hiện trong mục **Hoạt động** của khách, và trên trang **Zalo ZNS** của Hỗ trợ khách hàng (có link trong thông báo nếu bạn có quyền Quản lý ở Hỗ trợ khách hàng), là đã gửi hoặc thất bại.

Bạn cũng mở được trang này từ **Khách hàng → Gửi ZNS** trên thanh bên; khi đó trang nhắm tới mọi khách hàng, nên hãy đặt bộ lọc trên danh sách khách hàng trước.

## Điền tham số của mẫu

Mỗi tham số nhận một trong các giá trị sau:

| Giá trị | Mỗi khách nhận |
|---|---|
| `customer.name` | Tên của khách |
| `customer.phone` | Số điện thoại của khách |
| `customer.email` | Email của khách |
| `field:<khoá>` | Giá trị một trường tuỳ chỉnh, ví dụ `field:thanh_pho` |
| `text:` theo sau là chữ của bạn | Cùng một nội dung cố định cho mọi người, ví dụ `text:Tết 2027` |

Hạ Tầng tự gợi ý giá trị theo tên tham số (`customer_name` thành `customer.name`, `phone` thành `customer.phone`), và ô nhập liệt kê các trường tuỳ chỉnh khi bạn gõ. Hãy kiểm tra từng gợi ý: tham số để `text:` mà không có gì phía sau sẽ gửi giá trị trống, và Zalo từ chối tin có tham số bắt buộc bị trống.

## Ai nhận được tin

- Chỉ khách có số điện thoại. Những khách khác bị bỏ qua.
- Zalo gửi tin tới tài khoản Zalo đăng ký bằng số đó. Nếu số không có tài khoản Zalo, hoặc người đó chặn tin từ doanh nghiệp, Zalo báo tin thất bại.
- **Số tin tối đa** chỉ tính số tin được xếp hàng. Khách bị bỏ qua vì không có số điện thoại không bị tính vào.

## Nên làm

- Gửi thử trước: lọc danh sách còn hồ sơ của chính bạn (tìm theo số điện thoại của bạn) rồi gửi cho một mình hồ sơ đó.
- Chỉ dùng mẫu cho những thông báo khách mong nhận. Zalo có thể tạm khoá mẫu, hoặc ZNS của OA, khi bị khách phản ánh.
- Để gửi cho một khách, hoặc gửi khi có đơn hàng, dùng ZNS trên trang đơn hàng hoặc trong workflow. Xem [Zalo ZNS](https://hatang.dev/vi/help/automation/zns).

## Xử lý sự cố

| Vấn đề | Nguyên nhân | Cách xử lý |
|---|---|---|
| **Gửi ZNS cho khách hàng cần quyền Quản lý ở module Khách hàng** | Quyền của bạn ở module Khách hàng thấp hơn Quản lý | Nhờ chủ sở hữu hoặc quản trị viên nâng quyền ([Phân quyền module cho nhân viên](https://hatang.dev/vi/help/account/module-access)) |
| **Hãy kết nối Zalo Official Account trước** | Chưa có Zalo OA đang hoạt động | Kết nối trong **Hỗ trợ khách hàng → Kênh** |