Cách sử dụng Zalo send zns trong ALOHUB node trên N8N

Zalo ZNS: Gửi thông báo

Gửi thông báo ZNS (Zalo Notification Service) tới số điện thoại có tài khoản Zalo thông qua Alohub.

Yêu cầu: Đã cài đặt node n8n-nodes-alohub và thiết lập API Key credential. Xem Hướng dẫn cài đặt nếu chưa thực hiện.

Cấu hình

Kéo node Alohub vào canvas
Chọn Credential: Alohub account đã tạo
Chọn Resource: Zalo ZNS Notification
Chọn Operation: Send
Điền số điện thoại nhận
Chọn Campaign từ dropdown
Điền Template Parameters

Tham số

Tham số	Kiểu	Bắt buộc	Ví dụ	Mô tả
`Phone`	string	Có	`0912345678`	Số điện thoại nhận (phải có Zalo)
`Campaign`	dropdown	Có	—	Chọn campaign ZNS từ danh sách
`Template Parameters`	dynamic	Tùy template	—	Các trường tự động hiện theo template

Chọn Campaign

Dropdown Campaign hỗ trợ:

Tìm kiếm — gõ tên campaign để tìm kiếm
Hiển thị — tên campaign kèm ID, ví dụ: THÔNG BÁO ĐĂNG KÝ (ID: 509)

Template Parameters

Sau khi chọn campaign, node tự động load các trường cần điền dựa theo template ZNS tương ứng.

Cách hoạt động

Mỗi campaign có một znsTemplateId liên kết với template trên Zalo
Node tự động lấy thông tin mapping của template đó
Các trường có sourceColumn (dữ liệu người dùng nhập) sẽ hiển thị để bạn điền giá trị
Các trường staticValue (giá trị cố định) được xử lý tự động phía server — không hiển thị trên giao diện

Ví dụ mapping

Label hiển thị	Key gửi API	Loại	Giá trị
`customer_name`	`name`	Người dùng nhập	Bạn điền: `Nguyễn Văn A`
`phone_number`	`phones`	Người dùng nhập	Bạn điền: `0912345678`
`date_time`	—	Static (tự động)	Server tự điền, không hiện UI

Response mẫu

Khi thành công:

{
  "success": true,
  "httpStatus": 200,
  "transactionId": "ah_n8n_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "resource": "zns",
  "operation": "send",
  "timestamp": "2026-04-15T09:00:00.000Z",
  "error_code": "SUCCESS",
  "error_message": "SUCCESS"
}

Khi lỗi:

{
  "success": false,
  "httpStatus": 200,
  "transactionId": "ah_n8n_...",
  "error_code": "5",
  "error_message": "CAMPAIGN KHÔNG TỒN TẠI",
  "errorCode": "5",
  "errorMessage": "CAMPAIGN KHÔNG TỒN TẠI"
}

Ví dụ Workflow

Workflow đơn giản — Gửi ZNS thủ công

[Manual Trigger] → [Alohub: ZNS > Send]
                     Phone: 0912345678
                     Campaign: chọn từ dropdown
                     customer_name: Nguyễn Văn A
                     phone_number: 0912345678

Workflow nâng cao — Gửi ZNS hàng loạt từ Google Sheets

[Schedule Trigger] → [Google Sheets: Get Rows] → [Alohub: ZNS > Send]
                                                    Phone: {{ $json.phone }}
                                                    Campaign: chọn template cố định
                                                    customer_name: {{ $json.name }}
                                                    phone_number: {{ $json.phone }}

Workflow tự động — Gửi ZNS khi có đơn hàng mới

[Webhook Trigger] → [Alohub: ZNS > Send]
                      Phone: {{ $json.customer_phone }}
                      Campaign: "Thông báo đơn hàng"
                      customer_name: {{ $json.customer_name }}
                      phone_number: {{ $json.customer_phone }}

Mẹo: Sử dụng n8n expression {{ $json.fieldName }} để lấy dữ liệu động từ các node trước đó trong workflow. Ví dụ: lấy tên và số điện thoại từ Google Sheets, Webhook, hoặc CRM.

Lưu ý quan trọng

Số điện thoại nhận phải có đăng ký tài khoản Zalo. Nếu không, ZNS sẽ gửi không thành công.
Mỗi lần gửi, hệ thống tự động tạo transactionId duy nhất để theo dõi và đối soát.
Template parameters tự động thay đổi khi bạn chọn campaign khác — không cần cấu hình thủ công.
Bật Continue On Error nếu muốn workflow tiếp tục chạy kể cả khi gửi ZNS thất bại.