# Tích hợp gửi tin nhắn ZNS từ nhà cung cấp ESMS

Tích hợp Zalo ZNS từ nhà cung cấp ESMS

Để gửi ZNS chăm sóc khách hàng trên nền tảng NEXTfunnel bạn cần đáp ứng các yêu cầu sau:

1. Zalo OA của bạn đã được xác minh và đã nâng cấp gói trả phí của Zalo.
2. Đã hoàn tất kết nối với Esms tại Esms.vn
3. Đã đăng ký ZNS Template với Zalo thông qua đơn vị Esms.vn
4. Phải còn số dư trên tài khoản Esms.vn
5. Bạn phải có quyền truy cập Admin trên Esms.vn để lấy thông tin API.

Sau khi bạn đã có đủ các thông tin, bạn có thể gửi ZNS chăm sóc khách hàng trên nền tảng NEXTfunnel. Lưu ý, tin nhắn ZNS hiện tại chỉ sử dụng trong Workflow.

**Bước 1:** Truy cập **Esms.vn**, đăng nhập và vào phần quản lý tài khoản để nhận mã **ApiKey** và **SecretKey**

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

**Bước 2:** Copy đường link dưới đây và sửa lại các giá trị của các thông số **ApiKey**, **SecretKey**, **OAID**.

{% code overflow="wrap" %}

```
https://public-api.nextfunnel.vn/webhook/esms-zns-brandname?ApiKey=Mã-ApiKey-Của-Bạn&SecretKey=Mã-SecretKey-của-bạn&OAID=Mã-OAID-của-bạn
```

{% endcode %}

**Ví dụ sau khi điền thông tin link đầy đủ sẽ là:**&#x20;

<https://public-api.nextfunnel.vn/webhook/esms-zns-brandnam&#x65;_?ApiKey=**ABCDGEHD567FGH**\\&SecretKey=**HRGDTGRTJDJJ**&_&#x4F;AI&#x44;_=**12345678987654>\*\*\_

**Bước 3:** [Tạo 1 Custom Value](/crm/cai-dat-cho-crm-nextfunnel/custom-value-la-gi-cach-su-dung-custom-value-tren-nextfunnel.md) trên tài khoản **NEXTfunnel** của bạn tên **ZNS LINK** và dán link trên của bạn mới thêm các thông số vào ô Value.

Bạn cũng có thể sử dụng link đã thêm các keys ở trên trực tiếp trong Workflow. Tuy nhiên, mục đích của việc sử **Custom value** là nếu bạn thay đổi **ApiKey** và **SecretKey** thì bạn chỉ cần thay đổi tại 1 nơi duy nhất.

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

**Bước 4:** Gửi tin nhắn ZNS cho khách hàng trên Workflow.

Ví dụ, bạn muốn gửi 1 tin nhắn ZNS chúc mừng sinh nhật tới khách hàng:

1. Tại Workflow chúc mừng sinh nhật bạn sẽ thêm 1 action tên Webhook

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

2. Gán giá trị **Custom Value vào ô URL**

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

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

3. Thêm nội dung **ZNS** và **Template ZNS ID**

Bạn click nút **Add Item, bấm 2 lần để thêm 2 trường dữ liệu.**

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

Tại ô đầu tiên của dòng 1 bạn nhập chữ "**TempID**", ô thứ 2 bạn nhập ID bạn đã đăng ký

Tại ô thứ 1 của dòng 2 bạn nhập "**Params**", ô thứ 2 bạn nhập các biến dữ liệu mà Template ZNS bạn đã đăng ký, mỗi biến nằm trong dấu ngoặc kép và cách nhau bằng dấu phẩy.

```
"dữ liệu 1","dữ liệu 2","dữ liệu 3"
```

Ví dụ hình dưới đây là một mẫu ZNS mà NEXTfunnel đã đăng ký thành công, và có các thông số sau:

* Template ID là: 288047
* Params gồm có: name, money, order\_id

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

Như vậy, khi gửi trên NEXTfunnel sẽ là:

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

**Quang trọng:** Trong 1 template ZNS có 2 hoặc 3 biến trùng nhau, bạn chỉ cần nhập 1 biến đầu tiên, các biến trùng ở sau sẽ bỏ qua.

Ví dụ hình dưới dây có 2 biến **{{program\_name}}** trùng nhau.

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

Vậy khi nhập Params, bạn chỉ cần nhập **"program\_name","registration\_date"**

Sau khi hoàn thành cài đặt ID, Params bạn bấm **Save Action**

Sau khi lưu, hãy test lại workflow để đảm bảo nội dung ZNS của bạn được gửi chính xác.

**NEXTfunnel Team**


---

# 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://docs.nextfunnel.vn/tich-hop/sms-zns/tich-hop-gui-tin-nhan-zns-tu-nha-cung-cap-esms.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.