n8n-nodes-zalo-custom

Custom Zalo nodes for n8n - No license key required, fully open source!

🎯 Features

• ✅ 100% Free - No license key, no premium tiers
• ✅ Open Source - Full source code available
• ✅ Official API - Uses Zalo Official Account API (safe and legal)
• ✅ Easy to Use - Simple setup and configuration
• ✅ Customizable - Fork and modify as you need

📦 Installation

In n8n

1. Go to Settings → Community Nodes
2. Click Install
3. Enter: n8n-nodes-zalo-custom
4. Click Install

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-zalo-custom
# Restart n8n

🚀 Quick Start

1. Get Zalo OA Credentials

1. Register Zalo Official Account: https://oa.zalo.me
2. Create app at: https://developers.zalo.me
3. Get your credentials:
   • OA ID
   • App ID
   • App Secret
   • Access Token (from: https://developers.zalo.me/tools/explorer)

2. Setup in n8n

1. Create new credential: Zalo Official Account API
2. Fill in your credentials
3. Test connection
4. Start building workflows!

📝 Available Operations

Message Operations

• Send Text - Send text message to user
• Send Image - Send image to user
• Send File - Send file to user
• Send List - Send list template
• Send Request Info - Request user information

User Operations

• Get Info - Get user profile information
• Get Followers - Get list of followers

OA Operations

• Get OA Info - Get Official Account information
• Get Conversation - Get conversation with user

💡 Example Workflows

Auto Reply Bot

Webhook Trigger
  ↓
Zalo OA (Get User Info)
  ↓
IF (check condition)
  ↓
Zalo OA (Send Text)

Daily Notification

Schedule Trigger (9:00 AM)
  ↓
HTTP Request (get data)
  ↓
Zalo OA (Send Text to followers)

🔧 Development

Setup

# Clone repository
git clone https://github.com/yourusername/n8n-nodes-zalo-custom.git
cd n8n-nodes-zalo-custom

# Install dependencies
npm install

# Build
npm run build

# Link locally
npm link

# Link in n8n
cd ~/.n8n/nodes
npm link n8n-nodes-zalo-custom

Project Structure

n8n-nodes-zalo-custom/
├── credentials/
│   └── ZaloOfficialAccountApi.credentials.ts
├── nodes/
│   └── ZaloOA/
│       ├── ZaloOA.node.ts
│       ├── GenericFunctions.ts
│       └── descriptions/
│           ├── MessageDescription.ts
│           └── UserDescription.ts
├── package.json
├── tsconfig.json
└── README.md

📚 Documentation

Zalo Official API

• Developers Portal: https://developers.zalo.me
• API Documentation: https://developers.zalo.me/docs
• API Explorer: https://developers.zalo.me/tools/explorer

n8n

• Creating Nodes: https://docs.n8n.io/integrations/creating-nodes/
• Community Nodes: https://docs.n8n.io/integrations/community-nodes/

⚠️ Important Notes

vs n8n-nodes-zalo-user-v3

Limitations

• ✅ Safe to use - Official API, no risk of account ban
• ❌ OA only - Requires Official Account (not personal account)
• ❌ Limited features - Only features provided by Official API
• ✅ Stable - Won't break when Zalo updates

When to Use

Use n8n-nodes-zalo-custom if:

• ✅ You want a safe, legal solution
• ✅ You're okay with OA-level access
• ✅ You need stability for production
• ✅ You want to avoid license fees

Use n8n-nodes-zalo-user-v3 if:

• ⚠️ You need user-level access
• ⚠️ You need advanced features (group management, etc.)
• ⚠️ You're okay with the risks
• ⚠️ Personal/testing use only

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

• n8n - Workflow automation platform
• Zalo - Vietnamese messaging platform
• Community contributors

📞 Support

• Issues: https://github.com/yourusername/n8n-nodes-zalo-custom/issues
• Discussions: https://github.com/yourusername/n8n-nodes-zalo-custom/discussions
• n8n Community: https://community.n8n.io

Made with ❤️ for the n8n community

No license keys, no premium tiers, just open source! 🚀