zalo-bot

Community node for n8n to integrate with Zalo Bot Platform (send messages, get profiles, webhooks)

Package Information

Downloads: 358 weekly / 358 monthly
Latest Version: 1.0.2
Author: baoplh

Available Nodes

Zalo Bot icon
Zalo Bot
Interact with Zalo Bot Platform
Zalo Bot Trigger icon
Zalo Bot Trigger
Starts the workflow on incoming Zalo webhook events
Zalo Polling Bot Trigger icon
Zalo Polling Bot Trigger
Starts the workflow when receiving Zalo messages via polling

Documentation

n8n-nodes-zalo-bot

Community node for n8n to integrate with Zalo Bot Platform.

Installation

Community Node (Recommended)

In n8n, go to Settings > Community Nodes and install:

@baoplh/n8n-nodes-zalo-bot

Manual Install

cd ~/.n8n/nodes
npm install @baoplh/n8n-nodes-zalo-bot

Then restart n8n.

Features

Zalo Bot Node

  • Bot Operations:

    • getMe - Get bot information
    • getUpdates - Get updates from bot
    • setWebhook - Configure webhook
    • deleteWebhook - Delete webhook
    • getWebhookInfo - Get webhook information

  • Message Operations:

    • sendMessage - Send text message
    • sendPhoto - Send photo
    • sendSticker - Send sticker
    • sendChatAction - Show typing status

Zalo Bot Trigger (Webhook)

Webhook trigger to receive events from Zalo Bot:

  • Auto-register webhook on activation
  • Validate requests with secret token
  • Support all event types
  • Requires public URL (for production)

Zalo Polling Bot Trigger ⭐

Polling trigger to receive messages from Zalo Bot without public URL:

  • ✅ No public domain required - Perfect for local development and testing
  • ✅ Works behind firewall/NAT
  • ✅ Easy setup - Just activate and start receiving messages
  • Configurable polling interval (default: 3000ms)
  • Support multiple event types (message, text, photo, sticker)
  • Auto-start/stop with workflow activation

Use Cases:

  • 🔧 Local development and testing
  • 🏠 Self-hosted n8n without public domain
  • 🔒 Secure environments with restricted network access
  • 💡 Quick prototyping without webhook setup

Configuration

Credentials

Create a new credential with type Zalo Bot API:

  1. Access Token: Your bot token (format: BOT_ID:SECRET_TOKEN)
  2. Secret Key: (Optional) Key for webhook signature verification

Get Bot Token

  1. Visit Zalo Bot Platform
  2. Create a new bot or select an existing one
  3. Copy the Bot Token from dashboard

Usage Examples

Send Message

  1. Add Zalo Bot node
  2. Select Resource: Message
  3. Select Operation: sendMessage
  4. Enter Chat ID and Text

Receive Webhook

  1. Add Zalo Bot Trigger node
  2. Configure Secret Token (auto-generated if left empty)
  3. Activate workflow
  4. Webhook will be automatically registered
  5. Note: Requires n8n with public HTTPS URL

Polling Mode - No Public URL Required! 🚀

Perfect for local development and self-hosted instances:

  1. Add Zalo Polling Bot Trigger node
  2. Configure Polling Interval (default: 3000ms)
    • Shorter interval = faster response, more API calls
    • Longer interval = slower response, fewer API calls
  3. Select event types to listen for:
    • message - All messages
    • text - Text messages only
    • photo - Messages with photos
    • sticker - Sticker messages
  4. Activate workflow - That's it! No webhook configuration needed

Comparison:

Feature Webhook Trigger Polling Trigger
Public URL ✅ Required ❌ Not Required
Real-time ✅ Instant ⚠️ Near real-time
Setup Complex Simple
Firewall Must allow inbound Works anywhere
Best for Production Development/Testing

Development

Build

pnpm run build

Development mode

pnpm run dev

Publish

# Patch version
pnpm run release:patch

# Minor version
pnpm run release:minor

# Major version
pnpm run release:major

License

MIT

Links

Discussion