How to use Zalo send zns in ALOHUB node on N8N

Zalo ZNS: Send notification

Send ZNS (Zalo Notification Service) notification to the phone number with a Zalo account via Alohub.

Requirements: Node has been installed n8n-nodes-alohuband API Key credential has been set up. See Installation guide if not done yet.

Configuration

Drag the node Alohub into the canvas
Select Credential : Created Alohub account
Select Resource : Zalo ZNS Notification
Select Operation : Send
Fill in the recipient phone number
Select Campaign from the dropdown
Fill in Template Parameters

Parameter

Parameter	Type	Required	Example	Description
`Phone`	string	Yes	`0912345678`	Recipient phone number (must have Zalo)
`Campaign`	dropdown	Yes	—	Select ZNS campaign from the list
`Template Parameters`	dynamic	Template dependent	—	The fields will automatically appear according to the template

Select Campaign

Dropdown Campaign supports:

Search — type the campaign name to search
Display — campaign name with ID, for example: THÔNG BÁO ĐĂNG KÝ (ID: 509)

Template Parameters

After selecting a campaign, the node automatically loads the fields to fill based on the corresponding ZNS template.

How it works

Each campaign has a znsTemplateIdlink to the template on Zalo
The node automatically retrieves the mapping information of that template
Fields with sourceColumn(user-entered data) will be displayed for you to fill in values
Fields staticValue(fixed values) are processed automatically on the server — not displayed on the interface

Example mapping

Display label	API send key	Type	Value
`customer_name`	`name`	User input	You fill in: `Nguyễn Văn A`
`phone_number`	`phones`	User input	You fill in: `0912345678`
`date_time`	—	Static (automatically)	Server fills in automatically, not shown in UI

Sample response

When successful:

{
  "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"
}

When error:

{
  "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"
}

Example Workflow

Simple workflow — Send ZNS manually

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

Advanced workflow — Send bulk ZNS from 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 }}

Automated workflow — Send ZNS when there is a new order

[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 }}

Tips: Use n8n expression {{ $json.fieldName }}to retrieve dynamic data from previous nodes in the workflow. For example: get name and phone number from Google Sheets, Webhook, or CRM.

Important note

The recipient phone number must have a registered Zalo account . Otherwise, ZNS will not send successfully.
Each time sent, the system automatically creates a transactionIdunique ID for tracking and reconciliation.
Template parameters automatically change when you select a different campaign — no manual configuration needed.
Enable Continue On Error if you want the workflow to continue running even if sending ZNS fails.