Cách tích hợp ALOHUB node trên N8N

Tổng quan

n8n-nodes-alohub là community node cho nền tảng n8n, cho phép tích hợp các dịch vụ CPaaS của Alohub vào workflow tự động hóa.

Node hỗ trợ 2 tính năng chính:

Tính năng	Operation	Mô tả
Voice	Make a Call (Click to Call)	Thực hiện cuộc gọi ra qua IP Phone
Zalo ZNS	Send	Gửi thông báo ZNS qua Zalo với template động

Lưu ý: Bạn cần có tài khoản Alohub và API Key để sử dụng node này. Liên hệ Alohub để được cấp thông tin.

Cài đặt

Cách 1 — Cài từ giao diện n8n (khuyên dùng)

Mở n8n, vào Settings → Community Nodes
Click Install a community node
Nhập n8n-nodes-alohub
Click Install → đợi cài xong

Cách 2 — Cài bằng npm (self-hosted)

Chạy lệnh sau trong thư mục cài đặt n8n:

npm install n8n-nodes-alohub

Sau đó restart n8n để load node mới.

Thiết lập Credential (API Key)

Trước khi sử dụng node, bạn cần tạo credential chứa API Key của Alohub.

Kéo node Alohub vào workflow
Click vào dropdown Credential → chọn Create new credential
Nhập API Key — lấy từ dashboard Alohub. Liên hệ Alohub nếu chưa có.
Click Save — hệ thống sẽ tự kiểm tra kết nối

Tham số	Kiểu	Bắt buộc	Mô tả
`API Key`	string	Có	API Key từ Alohub dashboard. Gửi qua header `X-Api-Key`.

Xử lý lỗi

Tất cả operation đều trả về thông tin lỗi chi tiết trong output:

Trường	Kiểu	Ví dụ	Mô tả
`success`	boolean	`false`	Kết quả API call
`httpStatus`	number	`200`	HTTP status code
`error_code`	string	`"0"`	Mã lỗi từ Alohub API
`error_message`	string	`"HỆ THỐNG..."`	Thông báo lỗi chi tiết
`transactionId`	string	`"ah_n8n_..."`	ID duy nhất để đối soát

Mẹo: Bật Continue On Error trong Settings của node Alohub để workflow tiếp tục chạy kể cả khi API lỗi — output sẽ chứa đầy đủ thông tin lỗi để xử lý ở các bước tiếp theo.

Yêu cầu hệ thống

Yêu cầu	Phiên bản	Ghi chú
n8n	>= 1.0.0	—
API Key	—	Liên hệ Alohub để nhận