Gửi trực tiếp ZNS từ ZCA

Zalo đang là ứng dụng nhắn tin được sử dụng rộng rãi tại Việt Nam. Đối với những doanh nghiệp đã có Zalo Official Account lại càng là một lợi thế Marketing đến với khách hàng. Zalo Notification Service (ZNS) là dịch vụ gửi thông báo chăm sóc khách hàng tới các số điện thoại đang sử dụng ZALO. Thông qua tính năng gửi ZNS, doanh nghiệp có thể gửi thông tin xác nhận đơn hàng, nhắc nhở, thông báo, cảm ơn đến khách hàng,.. một cách nhanh chóng và hiệu quả.

Để có thể gửi tin Zalo ZNS bạn cần:

• Có tài khoản Zalo OA đã được xác thực và đã có tích vàng của Zalo (Hướng dẫn đăng ký tại đây)
• Nội dung tin nhắn ZNS gửi đi đã được đăng ký và phê duyệt bởi Zalo

Các bước thực hiện tích hợp và gửi tin nhắn Zalo ZNS trên AhaChat

• Tạo App ID và liên kết với tài khoản ZCA (Zalo Cloud Account)
• Liên kết tài khoản ZCA vào Zalo OA (Zalo Official Account)
• Xác thực domain zalo-zns.ahachat.com vào App ID
• Thêm Official Account Callback Url vào App ID
• Tích hợp Zalo ZNS vào AhaChat

Để đạt được các yêu cầu trên bạn làm theo từng bước hướng dẫn tại đây:

1. Tạo App ID và liên kết với tài khoản ZCA

Trường hợp bạn chưa có tài khoản ZCA, vui lòng tham khảo bài viết tại đây để đăng ký tài khoản.

Bước 1: Truy cập trang developers.zalo.me (Zalo for Developers) và vào trang Tạo ID ứng dụng mới -> Điền đầy đủ các thông tin: Tên hiển thị, Danh mục, Mô tả -> Tick “Tôi không phải là người máy” -> “Tạo ID ứng dụng”

Bước 2: Sau khi Tạo ứng dụng thành công. Bạn tiếp tục điền các thông tin theo yêu cầu như: số điện thoại, email, biểu tượng (icon ứng dụng) và miền ứng dụng (tùy chọn) để kích hoạt ứng dụng.

Bước 3: Tiến hành kích hoạt ứng dụng để có thể thực hiện các API với mọi người dùng.

Chú ý: Ứng dụng đã được kích hoạt chỉ có thể sử dụng những API đã được xét duyệt.

Bước 4: Liên kết ứng dụng với tài khoản ZCA

Để liên kết ứng dụng với tài khoản ZCA, khách hàng cần phải là Quản trị viên/Quản trị viên cao cấpcủa ZCA và đồng thời là Quản trị viên của ứng dụng.

Các bước liên kết quý khách vui lòng tham khảo tài liệu hướng dẫn tại đây.

2. Liên kết tài khoản ZCA vào Zalo OA (Zalo Official Account)

Bước 1: Truy cập trang “Quản lý liên kết”

👉 Tại trang quản lý OA, vào mục Quản lý → Chọn Quản lý tài khoản → Chọn tiếp Quản lý liên kết

👉 Hoặc truy cập trực tiếp bằng đường dẫn sau: https://oa.zalo.me/manage/apphavepermission

Bước 2: Chọn “Thêm tài khoản ZCA muốn liên kết”

Bước 3: Thực hiện liên kết

Trường hợp 1: Người dùng chưa là "Quản trị viên cao cấp" hoặc "Quản trị viên" của bất kỳ tài khoản ZCA nào, hệ thống sẽ hiển thị biểu mẫu đăng ký tài khoản ZCA.

Người dùng cung cấp đầy đủ thông tin bắt buộc → Chọn Tạo và liên kết → Hệ thống thực hiện tạo và liên kết ZCA với OA.

Trường hợp 2: Người dùng đang là "Quản trị viên cao cấp" hoặc "Quản trị viên" ít nhất 1 tài khoản ZCA, hệ thống sẽ hiển thị các tài khoản ZCA này.

Người dùng chọn ZCA muốn liên kết → Chọn Liên kết → Hệ thống thực hiện liên kết ZCA với OA.

Bước 4: Liên kết thành công

Trang Quản lý liên kết tài khoản ZCA sẽ hiện thông tin ZCA đã liên kết bao gồm:

• Tên tài khoản ZCA → Bấm vào sẽ mở trang quản lý tài khoản ZCA
• Mã tài khoản ZCA
• Tên Zalo người thực hiện thao tác liên kết OA và ZCA
• Ngày thực hiện liên kết

Liên kết với tài khoản ZCA khác:

Trong trường hợp doanh nghiệp có nhu cầu liên kết với tài khoản ZCA khác, nhấn vào ⚫⚫⚫ ở góc phải của ZCA đang liên kết, thực hiện Hủy liên kết với tài khoản này → Và thực hiện lại bước liên kết với tài khoản ZCA khác.

3. Xác thực domain vào App ID

Bạn truy cập vào trang quản lý ứng dụng App ID → chọn Xác thực domain → nhập zalo-zns.ahachat.com và bấm nút Xác thực

Thông báo xác thực thành công

4. Thêm Official Account Callback Url vào App ID

Bạn truy cập vào trang quản lý ứng dụng App ID → Official Account → Thiết lập chung

Bấm chọn Cập nhật để nhập URL

Nhập liên kết https://zalo-zns.ahachat.com/zalo-zns/callback → Bấm Lưu

5. Tích hợp Zalo ZNS vào AhaChat

Sau khi hoàn thành đăng ký OA và liên kết với ứng dụng trên tài khoản ZCA , các bạn thao tác theo các bước sau để tích hợp Zalo ZNS vào AhaChat

Bước 1: Đăng nhập vào AhaChat → vào Bot cần tích hợp Zalo ZNS

Bước 2: Vào Menu Cài đặt → Tích hợp → kéo xuống dưới các bạn sẽ thấy phần tích hợp Zalo ZNS → Bấm Tích hợp Zalo ZNS

Bước 3: Nhập App ID và App Secret Key lấy từ App ID vào → Bấm Lưu

App ID và App Secret Key bạn có thể tìm thấy trong phần Cài đặt trên trang developers.zalo.me (Zalo for Developers)

Bước 4: Hiện lên giao diện cấp quyền cho OA, bạn tích vào đồng ý sau đó bấm CHO PHÉP

Như vậy là bạn đã tích hợp thành công Zalo ZNS vào AhaChat.

Tiếp theo, là các bước để gửi tin nhắn ZNS cho khách hàng

6. Hướng dẫn gửi Zalo ZNS cho khách hàng bằng Chatbot

Để cài đặt hành động gửi ZNS cho khách hàng bạn thực hiện theo các bước như sau:

Bước 1: Vào Menu trả lời tự động --> Tạo mới --> nhập từ khóa để tạo kịch bản

Bước 2: Chọn tạo mới block → GỬI EMAIL/SMS/ZNS → GỬI ZNS (ZALO)

Bước 3: Cửa sổ block ZNS sẽ có các trường thông tin, bạn vui lòng nhập đầy đủ thông tin sau:

• Zalo OA: Chọn Zalo OA mà bạn muốn gửi tin nhắn ZNS.
• Mẫu ID: Chọn mẫu ZNS đã được đăng ký trước với Zalo
• Mã số đánh dấu lần gọi API: Copy ID của template từ tài khoản ZCA và dán vào đây
• Số điện thoại: Nhập thuộc tính số điện thoại của khách hàng để nhập tin ZNS
• Nội dung ZNS gửi đi: Bạn bấm vào biểu tượng tải xuống để hiện thị các tham số, dùng thuộc tính AhaChat để truyền tham số vào phần JSON

Cuối cùng bấm "Lưu thay đổi" để hoàn tất cài đặt.

Lưu ý: Sau khi cài đặt xong, bạn gửi kịch bản cho khách hàng hoặc khách hàng đi vào kịch bản này thì Bot sẽ tự gửi tin nhắn ZNS.

Khách hàng sẽ nhận được mẫu tin nhắn như sau (Ví dụ cho mẫu tin nhắn Xác nhận đơn hàng):

Chúc quý khách ứng dụng thành công.