> For the complete documentation index, see [llms.txt](https://docs.pos.pages.fm/pos/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pos.pages.fm/pos/ung-dung-mo-rong/ket-noi-zalo-cloud.md).

# Kết nối Zalo Cloud

Website: https\://zalo.cloud/zns

## 1. Khớp tham số trên ZNS và POS <a href="#a.-khop-tham-so-tren-zns-va-pancake-pos" id="a.-khop-tham-so-tren-zns-va-pancake-pos"></a>

### **Bước 1:  Đăng nhập/ đăng ký tài khoản ZNS Cloud**&#x20;

[***https://zalo.cloud/zns***](https://zalo.cloud/zns)

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2F5NMLQCjWgr84vBK50hN7%2Fimage.png?alt=media&amp;token=ad5b2b8c-f244-4960-be6d-81aa9bc6f434" alt=""><figcaption><p>Đăng nhập hoặc đăng ký tài khoản Zalo Cloud</p></figcaption></figure>

### **Bước 2: Khớp tham số trên ZNS và POS**

#### Truy cập **Dịch vụ ZNS** tại mục **Công cụ**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FcgmfM4ggd4mm0b0qDvG3%2Fimage.png?alt=media&amp;token=a8829656-bb4a-4def-b869-1a11cf7de233" alt=""><figcaption><p>Dịch vụ ZNS</p></figcaption></figure>

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FENdry3YUuPjoTzCd8rvY%2Fimage.png?alt=media&amp;token=ba6e0649-28d4-4f91-8b81-22a6049c59f0" alt=""><figcaption><p>Tạo mẫu ZNS</p></figcaption></figure>

#### Tạo nội dung và thêm Nội dung bảng (Lưu ý tham số phần này lấy từ tham số trên POS)

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FHayD102wwZmwXEAUFkFN%2Fimage.png?alt=media&amp;token=0ca753ac-c231-472b-ab56-b6400baff4e4" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Gợi ý: Tham số** của Mẫu ZNS Cloud tạo mới ở phần này lấy từ **Tham số** trên [**POS**](https://pos.pancake.vn/)
{% endhint %}

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FqaFiJstdJzzvddC1k7yq%2Fimage.png?alt=media&amp;token=3fd13f1a-d130-48f0-9aba-511e45149145" alt=""><figcaption><p>Tham số trên POS</p></figcaption></figure>

{% hint style="info" %}
**Lưu ý:**

* Cài đặt tham số Zalo ZNS template tương ứng với từ khóa của Pancake POS để đồng bộ dữ liệu.&#x20;
* Các giá trị **liên quan đến tiền** thì để giá trị **Nhãn tùy chỉnh**&#x20;
  {% endhint %}

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FhaeWDBHSP6PEIpDXNQQA%2Fimage.png?alt=media&amp;token=c7a03726-c4e4-40f6-8a10-0ef35acd49f4" alt=""><figcaption><p>Cài đặt kỹ thuật khi tạo mẫu ZNS mới</p></figcaption></figure>

## 2.  Kết nối tài khoản Zalo Cloud trên POS  <a href="#b.-ket-noi-tai-khoan-zalo-cloud-tren-pos" id="b.-ket-noi-tai-khoan-zalo-cloud-tren-pos"></a>

#### **Truy cập vào Pancake POS -> Chọn cấu hình -> Cấu hình ứng dụng -> Kết nối** [**Zalo ZNS&#x20;*****Cloud***](https://zalo.cloud/zns?fbclid=IwAR1RlLuRDI8sUyGxdmgs2k8HLiub_9Q4zSMRlnfiI3G4qQHMluxwTezfD_w)***​***

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FpTgQyliCLWfW09VrN2Xm%2FScreenshot%202024-05-15%20at%2014.18.29.png?alt=media&amp;token=7d990387-38d5-40f7-97e1-83bb56b28c65" alt=""><figcaption></figcaption></figure>

#### **Đăng nhập liên kết bằng ID và Khóa bí mật**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FflApk7Nza5ycO0ZhGHKb%2FScreenshot%202024-05-15%20at%2014.20.48.png?alt=media&amp;token=12189109-d7c1-402a-902f-e6b4d9890c8d" alt=""><figcaption><p>Đăng nhập Kết nối Zalo ZNS Cloud</p></figcaption></figure>

## 3. Kết nối tài khoản Zalo Cloud  <a href="#d.-ket-noi-tai-khoan-zalo-cloud" id="d.-ket-noi-tai-khoan-zalo-cloud"></a>

### **Bước 1**: Đăng nhập [Zalo for developers](https://developers.zalo.me/)

Nếu chưa có bạn vui lòng đăng ký Zalo Cloud.&#x20;

### **Bước 2:** Truy cập vào ứng dụng để lấy ID Cloud

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FSIqX66Bfy9JQrGi7tVtk%2Fimage.png?alt=media&amp;token=3c8f8a72-fed5-43bf-800e-bdaf8f88a1be" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Chú ý**: Nếu chưa có ứng dụng liên kết, chọn **Thêm ứng dụng mới**
{% endhint %}

#### Thêm ứng dụng mới

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FRrTRxzZqixljAJKOc61o%2Fimage.png?alt=media&amp;token=1ca1eb80-33a8-440c-96e5-d4a4cde5710c" alt=""><figcaption><p>Tạo ứng dụng mới</p></figcaption></figure>

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FyiL0Wo9jfyVPw7SjISQV%2Fimage.png?alt=media&amp;token=bbac8951-0be4-49eb-958e-36af2392b8ef" alt=""><figcaption><p>Kích hoạt ứng dụng vừa tạo</p></figcaption></figure>

### **Bước 3:** **Xác thực domain**&#x20;

Chọn **Xác thực Domain**-> Điền **<https://pos.pages.fm/>**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FL47dx8djtdanLXAmxc9e%2Fimage.png?alt=media&amp;token=d4658631-e5ba-4bbc-8783-09ae858294c8" alt=""><figcaption></figcaption></figure>

### **Bước 4: Điền call back URL**

Chọn **Official Account** -> chọn **Thiết lập chung** -> Điền call back URL&#x20;

**<https://pos.pages.fm/api/v1/zalov4/callback>**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FT3cl5IFG8GieaZGIS6gp%2Fimage.png?alt=media&amp;token=b0b1a1d2-a3bd-4cd3-881c-8aa33a7c3ab1" alt=""><figcaption><p>Điền call bank URL</p></figcaption></figure>

### **Bước 5:** Cấu hình Official Account API

Chọn Đăng ký **API Official Account** => chọn [**Official Account API**](https://developers.zalo.me/app/3563284482047234730/permissions?type=2), cài đặt theo nhu cầu sử dụng của bạn.&#x20;

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FHvksv8cafBJ8hjsSiezR%2Fimage.png?alt=media&amp;token=b0817bf4-f7f7-46f1-9409-9f101a88df28" alt=""><figcaption></figcaption></figure>

### **Bước 6:** Liên kết với POS

Lấy **Mã ID và Mã bảo mật** ở mục **Cài đặt** -> Copy hai mã này để nhập vào **POS**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2F3H44FN3xHHAHSQDOmR47%2Fimage.png?alt=media&amp;token=f0d41663-de90-45ed-ae09-5fd74e6b14cd" alt=""><figcaption><p>Copy ID ứng dụng và Khoá bí mật</p></figcaption></figure>

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FarCxg5WGfepA19p7Lz5X%2FScreenshot%202024-05-15%20at%2014.20.48.png?alt=media&amp;token=99cbae64-feb4-4853-b2be-8b019c0310cc" alt=""><figcaption><p>Liên kết tại POS</p></figcaption></figure>

### **Bước 7:** Kết nối thành công

Trạng thái của ứng dụng phải là **Đã xác thực.**

Nếu đã xác thực tài khoản Zalo OA trước đó rồi thì trạng thái sẽ auto chuyển thành đã xác thực khi điền xong **ID ứng dụng** và **khóa bí mật**

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FguZ4UKUzXH0ChVcMHi7v%2Fimage.png?alt=media&amp;token=0a6712a8-3309-4f76-b6b0-3e1ff6297821" alt=""><figcaption></figcaption></figure>

Để kết nối Zalo Cloud, bạn cần được xác thực **Zalo OA** (Tài khoản Official Account) phải được xác thực mới có thể sử dụng tính năng này. [**Xem hướng dẫn tại đây**](https://oa.zalo.me/home/resources/guides/lam-the-nao-de-xac-thuc-tai-khoan-oa-thanh-cong_74).

<figure><img src="https://922161841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbSqXsV7bK8xLDX1Kg7J5%2Fuploads%2FgyQLcxkW9IjE4xvVeu38%2Fimage.png?alt=media&amp;token=a3f3b214-4dfb-4a0a-99d9-635c245a5a70" alt=""><figcaption><p>Hướng dẫn xác thực tài khoản OA</p></figcaption></figure>

## **4. Cấu hình thông báo Zalo ZNS** <a href="#e.-cau-hinh-thong-bao-zalo-zns" id="e.-cau-hinh-thong-bao-zalo-zns"></a>

Tại mục **Cấu hình** trên POS -> chọn **Cấu hình thông báo** -> chọn **Zalo ZNS/ SMS**

Sau khi liên kết tích hợp ứng dụng **Zalo ZNS Cloud***,* ta cấu hình mẫu tin nhắn ở cấu hình tin nhắn. Truy cập [Cấu hình tin nhắn Pancake](https://docs.pos.pages.fm/pos/ung-dung-mo-rong/pages/5HLZbLDpUOcGnpcCJI61#id-1.2-cau-hinh-thong-bao) để tham khảo cách cấu hình mẫu tin nhắn gửi qua Zalo OA.