Hướng dẫn cài đặt n8n-nodes-zalo-nnt chi tiết

Yêu cầu Hệ thống

Trước khi cài đặt, đảm bảo môi trường của bạn đáp ứng các yêu cầu sau:

Phiên bản yêu cầu

• ✅ n8n: v0.187+ (hỗ trợ Community Nodes)
• ✅ Node.js: v18.10+
• ✅ pnpm: v9.1+ (nếu build from source)

Kiểm tra phiên bản hiện tại

# Kiểm tra n8n version
n8n --version

# Kiểm tra Node.js version
node --version

# Kiểm tra pnpm version (nếu cần)
pnpm --version

---

Phương pháp 1: Community Nodes (Khuyến nghị)

Đây là cách dễ nhất và nhanh nhất cho người dùng n8n v0.187+.

Bước 1: Mở n8n Editor

1. Truy cập n8n instance của bạn (thường là http://localhost:5678)
2. Đăng nhập vào editor

Bước 2: Vào Settings

1. Click vào Settings (icon ⚙️ ở góc trái)
2. Chọn Community Nodes

Bước 3: Tìm kiếm Package

1. Trong ô tìm kiếm, nhập: n8n-nodes-zalo-nnt
2. Nhấn Enter

Bước 4: Install

1. Nhấn nút Install
2. Đợi quá trình cài đặt (1-2 phút)

Bước 5: Reload Editor

1. Sau khi cài đặt thành công, reload trang n8n
2. Hoặc nhấn Ctrl + R / Cmd + R

Bước 6: Xác nhận Cài đặt

1. Tạo workflow mới
2. Click Add Node
3. Tìm kiếm "Zalo"
4. Bạn sẽ thấy 9 nodes mới:
   • ZaloSendMessage
   • ZaloGroup
   • ZaloChatHistory
   • ZaloUser
   • ZaloMessageTrigger
   • ZaloPoll
   • ZaloTag
   • ZaloReminder
   • ZaloLoginByQr

✅ Hoàn tất! Bạn đã cài đặt thành công.

---

Phương pháp 2: Manual Installation (Self-hosted)

Nếu bạn chạy n8n self-hosted hoặc muốn cài đặt manual.

Với npm

# Di chuyển vào thư mục n8n
cd ~/.n8n/nodes

# Cài đặt package
npm install n8n-nodes-zalo-nnt

Với pnpm

cd ~/.n8n/nodes
pnpm add n8n-nodes-zalo-nnt

Restart n8n

# Stop n8n
pkill n8n

# Start lại
n8n start

---

Phương pháp 3: Docker

Nếu bạn chạy n8n trong Docker container.

Dockerfile

Tạo file Dockerfile:

FROM n8nio/n8n:latest

# Cài đặt custom node
RUN npm install -g n8n-nodes-zalo-nnt

# Expose port
EXPOSE 5678

# Run n8n
CMD ["n8n", "start"]

Build và Run

# Build image
docker build -t n8n-with-zalo .

# Run container
docker run -d \
  --name n8n-zalo \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8n-with-zalo

Docker Compose

Hoặc sử dụng docker-compose.yml:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n-zalo
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=yourpassword
    command: >
      sh -c "npm install -g n8n-nodes-zalo-nnt && n8n start"

# Chạy
docker-compose up -d

---

Verify Installation

Sau khi cài đặt bằng bất kỳ phương pháp nào, kiểm tra lại:

1. Check nodes trong Editor

1. Mở n8n editor
2. Tạo workflow mới
3. Click Add Node hoặc nhấn Tab
4. Tìm kiếm "Zalo"

Kết quả mong đợi: Thấy 9 nodes Zalo

2. Check package version

# Kiểm tra version đã cài
npm list n8n-nodes-zalo-nnt

Output mong đợi:

n8n-nodes-zalo-nnt@1.0.0

3. Test node đơn giản

Thử add node ZaloLoginByQr vào workflow:

1. Drag node vào canvas
2. Nếu hiển thị parameter panel → Success ✅

---

Troubleshooting

❌ Lỗi: "Package not found"

Nguyên nhân: npm registry không tìm thấy package

Giải pháp:

# Update npm cache
npm cache clean --force

# Cài lại
npm install n8n-nodes-zalo-nnt

❌ Lỗi: "Version conflict"

Nguyên nhân: n8n version quá cũ

Giải pháp:

# Update n8n lên latest
npm update -g n8n

# Hoặc
npm install -g n8n@latest

❌ Nodes không hiển thị sau khi cài

Giải pháp:

1. Hard reload trình duyệt: Ctrl + Shift + R (Windows/Linux) hoặc Cmd + Shift + R (Mac)
2. Xóa cache trình duyệt
3. Restart n8n:

   pkill n8n
   n8n start
   

4. Kiểm tra logs:

   n8n start --log-level debug
   

❌ Docker: Nodes bị mất sau khi restart

Nguyên nhân: Không mount volume đúng

Giải pháp: Đảm bảo mount /home/node/.n8n:

docker run -v ~/.n8n:/home/node/.n8n ...

---

Update Package

Community Nodes

1. Settings > Community Nodes
2. Tìm n8n-nodes-zalo-nnt
3. Nhấn Update (nếu có version mới)

Manual

# Với npm
npm update n8n-nodes-zalo-nnt

# Với pnpm
pnpm update n8n-nodes-zalo-nnt

# Restart n8n
n8n start

Docker

Rebuild image:

docker build --no-cache -t n8n-with-zalo .
docker-compose up -d --force-recreate

---

Tips

---

Bước tiếp theo

Sau khi cài đặt thành công, bước tiếp theo là xác thực và đăng nhập Zalo để bắt đầu sử dụng các nodes.

Xem bài tiếp theo trong series để tìm hiểu cách đăng nhập QR code và tạo credential tự động!