# Hướng dẫn tạo mẫu thông báo ZBS

ZBS Template cho phép doanh nghiệp gửi thông báo chăm sóc khách hàng thông qua API hoặc Hành động Gửi tin nhắn ZBS trong chiến dịch Automation của CNV CDP đến khách hàng của Doanh nghiệp đang sử dụng Zalo trong điều kiện đáp ứng đủ các tiêu chuẩn về [chính sách dịch vụ](https://zalo.cloud/terms) được quy định. Để gửi được ZBS Template, quý khách cần tạo và gửi duyệt Mẫu ZBS trước.

{% hint style="info" %}
Lưu ý: Đảm bảo tài khoản đăng nhập có quyền admin hoặc đủ quyền hạn để thao tác với Template ZBS
{% endhint %}

## Hướng dẫn tạo và gửi Template ZBS

#### Bước 1: Truy cập vào trang [Ứng dụng Zalo OA](https://hub.cnvcdp.com/application/zalo-oa-management)

<figure><img src="/files/iWzOQc9sWsqQQB0udC3C" alt=""><figcaption></figcaption></figure>

#### Bước 2: Tạo mới Template ZBS, vào mục Mẫu tin ZBS → chọn Tạo mới

<figure><img src="/files/UxjExiWrhqB9kIiflE8L" alt=""><figcaption></figcaption></figure>

#### Bước 3: Thiết lập các thông tin cơ bản

{% hint style="info" %}
Mỗi OA sẽ được phép gửi các mục đích ZBS khác nhau. Phân loại mục đích gửi ZBS được chia thành các cấp độ sau, tăng dần theo tính phức tạp và mức độ ảnh hưởng đến trải nghiệm người nhận

Zalo sẽ tự động điều chỉnh loại nội dung OA được phép gửi dựa trên chất lượng gửi ZNS của OA. Xem thêm về [Cơ chế đánh giá chất lượng và quyền lợi gửi ZBS](https://stc-developers.zdn.vn/docs/v2/zalo-notification-service/phu-luc/co-che-danh-gia-chat-luong-va-quyen-loi-gui-zns)
{% endhint %}

| Cấp độ | Loại mục đích ZNS   | Code           |
| ------ | ------------------- | -------------- |
| 1      | Giao dịch           | TRANSACTION    |
| 2      | Chăm sóc khách hàng | CUSTOMER\_CARE |
| 3      | Hậu mãi             | PROMOTION      |

{% hint style="info" %}
Mỗi loại ZBS chỉ tương thích với một số mục đích gửi ZBS nhất định
{% endhint %}

| Loại ZNS                   | Mục đích gửi ZNS (cấp độ) |
| -------------------------- | ------------------------- |
| 1 - ZNS tùy chỉnh          | 1, 2, 3                   |
| 2 - ZNS xác thực           | 1                         |
| 3 - ZNS yêu cầu thanh toán | 1                         |
| 4 - ZNS voucher            | 1, 2, 3                   |
| 5 - ZNS đánh giá dịch vụ   | 2                         |

Nhập **Tên mẫu ZBS** → chọn **OA** sẽ gửi tin → chọn **loại ZBS** → chọn **mục đích gửi ZBS**

<figure><img src="/files/mF0Tws9OOLOnUR8kxd26" alt=""><figcaption></figcaption></figure>

Hoặc sử dụng các mẫu tin đã được thiết kế sẵn từ **Thư viện mẫu**:

<figure><img src="/files/Pxqv2S9ePrZ0K9CLUYcz" alt=""><figcaption></figcaption></figure>

#### Bước 4: Thiết kế mẫu tin

Tải logo/hình ảnh ***→*** Điền nội dung ZBS ***→*** Tiếp tục

<figure><img src="/files/UJMlWWSJziyvdJEArBdk" alt=""><figcaption></figcaption></figure>

Doanh nghiệp có thể tùy chỉnh các tham số và có thể thêm “**Nút thao tác**” (Call To Action). Nút thao tác sẽ được duyệt bởi Zalo Business Solutiontrước khi được sử dụng. Doanh nghiệp có thể thêm tối đa 2 nút thao tác CTA.

<figure><img src="/files/LbKGC5X5TInzAYI8Usc4" alt=""><figcaption></figcaption></figure>

Hiện tại, Zalo chỉ hỗ trợ nút thao tác CTA dẫn đến các nội dung sau:

| Nút CTA                                     | Mô tả                                                                          | Giá tham khảo |
| ------------------------------------------- | ------------------------------------------------------------------------------ | ------------- |
| Đến trang thông tin OA                      | Xem trang thông tin OA trên Zalo                                               | 0/100đ (\*)   |
| Đến ứng dụng Zalo Mini App của doanh nghiệp | Truy cập Mini App của doanh nghiệp trên Zalo                                   | 0/100đ (\*)   |
| Đến bài viết của OA                         | Truy cập bài viết của doanh nghiệp trên Zalo                                   | 0/100đ (\*)   |
| Đến trang của doanh nghiệp                  | Truy cập trang web của doanh nghiệp (có tên miền giống tên OA)                 | 100đ          |
| Gọi điện                                    | Gọi đến số điện thoại được cung cấp                                            | 100đ          |
| Đến trang web/Zalo Mini App khác            | Truy cập trang web khác (có tên miền khác tên OA)                              | 400đ          |
| Đến trang tải ứng dụng                      | Truy cập trang tải ứng dụng (tên ứng dụng giống tên OA)                        | 500đ          |
| Đến trang phân phối sản phẩm                | Truy cập trang của kênh phân phối (MXH, sàn TMĐT, trang của nhà phân phối,...) | 500đ          |
| Đến ứng dụng khác                           | Truy cập trang tải ứng dụng (tên ứng dụng khác tên OA)                         | 700đ          |

> (\*) : Nút đầu tiên thuộc hạng mục “Đến tài sản của doanh nghiệp trên hệ sinh thái Zalo” : 0 VNĐ.

Doanh nghiệp có thể tạo mới các liên kết hoặc số điện thoại dùng cho CTA. Đối với nút CTA “Đến trang thông tin OA”, đường dẫn sẽ được thiết lập mặc định đến trang OA doanh nghiệp đã chọn ở bước “Thông tin cơ bản”.

<figure><img src="/files/CSyNgf8cQ6YSYFkzPma9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/QAUUTafehgkpbyD4A6vO" alt=""><figcaption></figcaption></figure>

#### Bước 5: Gửi duyệt

Sau khi điền xong nội dung mẫu tin và nhấn **“Tiếp tục”**, doanh nghiệp tiến hành thao tác cài đặt kỹ thuật cho tham số trong mẫu tin.

***→*** Nhập ví dụ nội dung cho từng tham số - Ví dụ tham số giúp đội ngũ kiểm duyệt hiểu rõ hơn bối cảnh và nhu cầu sử dụng của mẫu template.

→ Nhập ghi chú cho kiểm duyệt

***→*** Tick vào ô *“Tôi đã đọc và đồng ý với* [*Điều khoản và Chính sách sử dụng*](https://zalo.cloud/terms) *của Zalo Cloud”.*

***→*** Gửi duyệt

<figure><img src="/files/ntnDuS49Abw5zBUaQf2F" alt=""><figcaption></figcaption></figure>

#### Những lưu ý khi tạo và gửi mẫu thông báo ZBS:

* Để đảm bảo trải nghiệm của người dùng cuối, đội ngũ phụ trách tại Zalo Business Solutions sẽ tiến hành kiểm duyệt mọi mẫu thông báo mới được đăng ký.
* Mẫu thông báo ZBS sẽ được xử lý trong từ 2 ngày làm việc.
* Mẫu thông báo sau khi được duyệt sẽ được cập nhật trạng thái **Đã duyệt**. Lúc này quý khách có thể dùng để gửi ZBS bằng mẫu tin này.
* Trong trường hợp mẫu ZBS bị từ chối, trạng thái và lí do bị từ chối sẽ được cập nhật trên trang chi tiết mẫu tin. Quý khách có thể điều chỉnh theo hướng dẫn và gửi duyệt lại.
* Quý khách có thể tiếp tục tạo thêm những mẫu ZNS khác trong khi mẫu hiện tại đang được chờ duyệt.

<figure><img src="/files/0FiUIE5AbJVPyyXywsBJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/epx9Z3o5PFTIXqhBnsSK" alt=""><figcaption></figcaption></figure>

## Hướng dẫn tải logo khi tạo mẫu tin ZBS

Tạo mẫu tin → Điền thông tin cơ bản → Thiết kế mẫu tin.

Kéo và thả ảnh vào khung xanh nhẹ hoặc chọn **“Tải ảnh lên”** để đăng tải logo.

<figure><img src="/files/5yeSAWnGaWEnm0UrkPTY" alt=""><figcaption></figcaption></figure>

Khi đăng tải logo, hệ thống sẽ cho phép khách hàng cắt hình ảnh để đúng với tỉ lệ định dạng **.PNG** và kích thước **400x96px** theo yêu cầu của hệ thống. Khi hài lòng với vùng chọn, chọn “**Hoàn tất**”.

<figure><img src="/files/UOpcHf9zUl0PeVUSsY7R" alt=""><figcaption></figcaption></figure>

Sau khi đã hoàn tất cắt hình ảnh, để chỉnh sửa hình ảnh vui lòng chọn nút “**Xem chi tiết**” để mở lại popup cắt cảnh hoặc “**Xóa**” tương ứng với nhu cầu.

<figure><img src="/files/M4ce93QRtRunF89dlAlb" alt=""><figcaption></figcaption></figure>

#### Lưu ý:

* Thiết kế logo theo tiêu chuẩn của Zalo sẽ giúp mẫu ZBS hiển thị đẹp hơn. Chi tiết [ở đây](https://zalo.cloud/blog/nhung-luu-y-ve-logo-khi-tao-mau-thong-bao-zns-/e0pyiy0f87qm90g0488yjj09).
* Cần upload cả phiên bản logo dùng cho Giao diện sáng và Giao diện tối để nâng cao trải nghiệm cho người dùng
* Logo nên được canh lề trái.
* Logo phải phù hợp với OA đã chọn.

<figure><img src="/files/gw2sy7WwBZyELAukoVq0" alt=""><figcaption></figcaption></figure>

Doanh nghiệp có thể xem trước Preview logo giao diện sáng tối

<figure><img src="/files/apGjgd0Th7TXzZqazWtF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2ok2UvPXQCHSCcxykJVd" alt=""><figcaption></figcaption></figure>

## Hướng dẫn sử dụng hình ảnh trong template

{% hint style="info" %}
Hình ảnh chỉ áp dụng với loại ZBS Tuỳ chỉnh và ZBS Voucher.
{% endhint %}

Tạo mẫu tin → Điền thông tin cơ bản → Thiết kế mẫu tin.

Kéo và thả ảnh vào khung xanh nhẹ hoặc chọn **“Tải ảnh lên”** để đăng tải logo.

<figure><img src="/files/yM8Cyvt2V1Px2nWYiewY" alt=""><figcaption></figcaption></figure>

Khi đăng tải hình ảnh, hệ thống sẽ cho phép khách hàng cắt hình ảnh để đúng với tỉ lệ (16:9) theo yêu cầu của hệ thống. Khi hài lòng với vùng chọn, chọn “**Hoàn tất**”.

<figure><img src="/files/1TOm3jw9korHFehmlOZH" alt=""><figcaption></figcaption></figure>

Sau khi đã hoàn tất cắt hình ảnh, để chỉnh sửa hình ảnh vui lòng chọn “**Xem chi tiết**” hoặc “**Xóa**” tương ứng với nhu cầu.

<figure><img src="/files/Aua24iZv0crH7W6k5Ky0" alt=""><figcaption></figcaption></figure>

## Các lỗi thường gặp & Cách xử lý

1. **Lỗi gửi duyệt không thành công**
   1. **Nguyên nhân:**
      * Lỗi từ phía Zalo.
      * Tài khoản không có quyền gửi duyệt mẫu tin ZBS.
      * Lỗi hệ thống CNV CDP.
   2. **Xử lý: Dựa theo thông tin lỗi trả về**
      * Kiểm tra lại form nhập thông tin (tên template, loại ZBS, mục đích, CTA, logo, tham số…).
      * Thử gửi lại sau vài phút (nếu nghi ngờ lỗi hệ thống).
      * Nếu vẫn lỗi → liên hệ **CNV CDP Support** kèm screenshot + timestamp → để bên kỹ thuật kiểm tra lại.
2. **Template bị từ chối**
   1. **Nguyên nhân:** Nội dung sai mục đích ZBS, chứa quảng cáo trá hình, link CTA không hợp lệ, logo/hình ảnh sai chuẩn,…
   2. **Xử lý:** Chỉnh nội dung theo đúng hướng dẫn từ lí do từ chối, thay link/ảnh đúng chuẩn, bổ sung ví dụ tham số → Gửi duyệt lại.
3. **Template đã duyệt nhưng không hiển thị trong CNV CDP**
   1. **Nguyên nhân**: OA chưa kết nối CDP, đồng bộ chậm, tài khoản không có quyền.
   2. **Xử lý**: Kiểm tra kết nối OA, đăng nhập lại CDP, đảm bảo tài khoản có đủ các quyền cần thiết → Nhấn nút Đồng bộ mẫu tin để đồng bộ thủ công.
4. **Logo/Hình ảnh hiển thị sai**
   1. **Nguyên nhân**: Không đúng tỷ lệ (logo 400x96 px, hình 16:9), thiếu phiên bản sáng/tối.
   2. **Xử lý**: Upload lại đúng chuẩn, bổ sung đủ 2 phiên bản logo.
5. **Không gửi được tin ZBS**
   1. **Nguyên nhân**: OA chưa được cấp quyền, vượt quota, OA bị hạn chế.
   2. **Xử lý**: Kiểm tra quyền OA, quota/ngân sách, tình trạng OA.
6. **Duyệt template chậm**
   1. **Nguyên nhân**: Cao điểm hoặc nội dung chưa rõ ràng.
   2. **Xử lý**: Theo dõi trong trang quản lý, nếu >3 ngày làm việc → liên hệ Zalo Business Solutions hoặc CNV CDP Support.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://huongdan.cnvcdp.com/tinh-nang/ung-dung/zalo-oa/tin-nhan-zbs/huong-dan-tao-mau-thong-bao-zbs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.