zalo-bot

Node cộng đồng cho n8n tích hợp Zalo Bot (gửi tin nhắn, lấy profile, webhook)

Package Information

Released: 9/7/2025
Downloads: 23 weekly / 91 monthly
Latest Version: 0.3.13

Documentation

n8n-nodes-zalo-bot

Gói tích hợp n8n chuyên nghiệp cho nền tảng Zalo Bot, cung cấp hệ thống webhook automation và khả năng messaging hoàn chỉnh. Thiết kế tối ưu cho developer experience với cơ chế tự động đăng ký webhook và quản lý token an toàn.

Hướng Dẫn Triển Khai

1) Cài Đặt Package

  • Settings → Community Nodes → Install → @hienhoceo/n8n-nodes-zalo-bot

2) Cấu Hình Bot

  • Khởi Tạo Bot: truy cập Zalo Bot Creator tại https://zalo.me/s/botcreator/ (tham khảo: https://bot.zapps.me/docs/create-bot/)
    • Xác thực QR code
    • Thiết lập tên bot (bắt buộc prefix “Bot …”)
  • Trích Xuất Token:
    • Nhận bot token từ thông báo Zalo (định dạng: {bot_id}:{access_token})
    • Sao chép toàn bộ chuỗi token bao gồm dấu “:”

3) Cấu Hình Credential

  • Tạo credential “Zalo Bot API” trong n8n
  • Access Token: dán complete bot token
  • Secret Key: tùy chọn (hệ thống tự sinh nếu để trống)

4) Khởi Động Workflow

  • Tạo workflow với “Zalo Bot Trigger” và nhấn Active
  • Auto Webhook Registration: hệ thống tự động gọi setWebhook khi workflow được kích hoạt
  • Security Validation: trigger tự sinh secret token (≥ 8 ký tự) cho header X-Bot-Api-Secret-Token

5) Sử Dụng Actions

  • Workflow sẵn sàng xử lý messaging:
    • sendMessage: gửi văn bản
    • sendSticker: vào https://stickers.zaloapp.com/ lấy Sticker ID và dán vào node
    • sendPhoto: gửi ảnh qua URL/file_id

Ghi Chú

  • Active = tự động đăng ký webhook. Nếu dùng deleteWebhook, hãy Active lại workflow hoặc gọi setWebhook để đăng ký lại.
  • Chat/User ID có thể lấy từ payload webhook: result.message.chat.id.

Hỗ Trợ Phát Triển

QR donate

  • MoMo:

    MoMo

  • TPBank/VietQR:

    TPBank VietQR

Discussion