n8n-nodes-nqdev-aio

🚀 Custom n8n node package for seamless integration of Vietnamese SaaS services



🎯 What's Included

This package provides custom n8n nodes for integrating with popular Vietnamese SaaS services:

- eSMS.vn - SMS marketing automation platform
- Haravan - E-commerce platform integration
- Zalo - Social network messaging service

📦 Installation

$3

``bash
npm install n8n-nodes-nqdev-aio
`

$3

1. Download the latest release
2. Place in your n8n custom nodes directory
3. Restart n8n

$3

Add to your n8n Docker setup:

`dockerfile
RUN npm install n8n-nodes-nqdev-aio
`

🔧 Configuration

Quy tắc phát triển & tích hợp

- Mỗi dịch vụ có folder riêng trong nodes/ và credentials/, ví dụ: NqdevEsmsNode, NqdevHaravan, NqdevZalo. File node dạng .node.ts.
- Credential định nghĩa ở credentials/, dùng cho xác thực API.
- Logic dùng chung (API request, types, interfaces) ở nqdev/common/ và nqdev/utils/.
- Business logic từng dịch vụ ở nqdev/domains//.
- Icon UI ở assets/icons/.
- Output JS build ở dist-obf/ để deploy.
- TypeScript strict, interface ở nqdev/common/interfaces/ và domain.
- Đặt tên node: NqdevNode.
- Workflow mẫu: Mỗi file JSON trong examples/ đều có mô tả ở examples/README.md.
- Không log/lộ credentials, n8n tự mã hóa.
- Link tài liệu API ở README chính.

$3

- Cài đặt: npm install
- Build: npm run build
- Dev mode: npm run dev
- Test thủ công: Khởi động n8n, import workflow từ examples/, cấu hình credentials, chạy thử.
- Test API: Sử dụng endpoint test của từng dịch vụ (xem README).
- Obfuscation: Dùng transform-package.js và obfuscator-config.json trước khi publish.
- Publish: Dùng publish-npm.bat hoặc GitHub Actions.

$3

- nodes/ — Node implementation
- credentials/ — Credential types
- nqdev/common/ — Logic dùng chung, types, interfaces
- nqdev/domains/ — Logic từng dịch vụ
- assets/icons/ — UI assets
- examples/ — Workflow mẫu
- gulpfile.js, transform-package.js — Build/obfuscation
- README.md — Tài liệu chính

$3

- Node: nodes/NqdevZalo/NqdevZalo.node.ts
- Credential: credentials/NqdevZaloApi.credentials.ts
- API request: nqdev/common/index.ts
- Workflow: examples/sms-marketing-campaign.json

$3

- Luôn tham chiếu credential khi gọi API.
- Dùng tiện ích chung cho HTTP/API.
- Tuân thủ TypeScript strict.
- Thêm workflow mới phải cập nhật examples/README.md.
- Nếu thêm dịch vụ mới, mirror cấu trúc domain/node/credential hiện tại.

After installation, you'll need to set up credentials for each service:

$3

1. Go to n8n Settings > Credentials
2. Add new credential > eSMS.vn API
3. Enter your API Key and Secret Key from eSMS.vn dashboard
4. Test connection

$3

1. Go to n8n Settings > Credentials
2. Add new credential > Haravan API
3. Enter your shop name, access token, and API version
4. Test connection

$3

1. Go to n8n Settings > Credentials
2. Add new credential > Zalo API
3. Enter your access token, app ID, and app secret
4. Test connection

🚀 Features

$3

- ✅ Send individual SMS messages
- ✅ Send bulk SMS campaigns
- ✅ Check account balance
- ✅ Track message delivery status
- ✅ Support for Brandname & CSKH SMS types
- ✅ Multi-recipient support

$3

- ✅ Product management (CRUD operations)
- ✅ Order management and tracking
- ✅ Customer management
- ✅ Inventory operations
- ✅ Full REST API integration

$3

- ✅ Send text messages
- ✅ Send image messages
- ✅ Template message support
- ✅ User profile management
- ✅ Follower management
- ✅ Image upload capabilities

📖 Usage Examples

$3

`json
{
"resource": "sms",
"operation": "sendBulk",
"phones": "+84912345678,+84987654321",
"message": "🎉 Sale cuối năm - Giảm giá 50% tất cả sản phẩm! Mua ngay: shop.com",
"smsType": "1",
"brandname": "MYSHOP"
}
`

$3

`json
{
"resource": "product",
"operation": "create",
"title": "Áo thun nam basic",
"body_html": "

Áo thun chất liệu cotton cao cấp

",
"product_type": "Thời trang",
"vendor": "Fashion Brand"
}
`

$3

`json
{
"resource": "message",
"operation": "sendText",
"user_id": "user123456789",
"text": "Xin chào! Cảm ơn bạn đã quan tâm đến sản phẩm của chúng tôi."
}
`

🔄 Workflow Examples

$3

`
Webhook Trigger → eSMS.vn (Send Bulk) → Google Sheets (Log Results)
`

$3

`
Haravan (Get Orders) → Filter New Orders → Email Notification → Zalo Message
`

$3

`
Zalo (Get Messages) → Process Text → eSMS.vn (Send Response) → CRM Update
`

🛠️ Development

$3

- Node.js 18+
- n8n installed
- TypeScript knowledge

$3

`bash


Clone repository

git clone https://github.com/nqdev-group/n8n-nodes-nqdev-aio.git
cd n8n-nodes-nqdev-aio

Install dependencies

npm install

Build the project

npm run build

Development mode

npm run dev
`

$3

`
n8n-nodes-nqdev-aio/
├── credentials/ # API credential configurations
│ ├── EsmsVnApi.credentials.ts
│ ├── HaravanApi.credentials.ts
│ └── ZaloApi.credentials.ts
├── nodes/ # Node implementations
│ ├── EsmsVn/ # SMS marketing node
│ ├── Haravan/ # E-commerce node
│ └── Zalo/ # Social messaging node
├── assets/ # Icons and assets
├── examples/ # Workflow examples
├── dist/ # Built output
└── Documentation files
`

🧪 Testing

$3

1. Start n8n in development mode
2. Import example workflows from /examples` folder
3. Configure credentials with test accounts
4. Execute workflows to verify functionality

$3

Each service provides test endpoints:

- eSMS.vn: Balance check endpoint
- Haravan: Shop info endpoint
- Zalo: Profile endpoint

📚 API Documentation

$3

- API Documentation
- Developer Portal

$3

- API Documentation
- Developer Guide

$3

- API Documentation
- Official Account API

🔒 Security & Privacy

- All credentials are encrypted by n8n
- API keys are never logged or exposed
- HTTPS required for all API communications
- Regular security updates and vulnerability patches

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

$3

- GitHub Issues
- n8n Community Forum

$3

For enterprise support and custom integrations:

- Email: contact@nqdev.com
- Website: nqdev.com

🔄 Changelog

$3

- ✅ Initial release
- ✅ eSMS.vn node implementation
- ✅ Haravan node implementation
- ✅ Zalo node implementation
- ✅ Full TypeScript support
- ✅ Comprehensive documentation

🚀 Roadmap

- [ ] Advanced template management for Zalo
- [ ] Webhook support for real-time updates
- [ ] Advanced analytics and reporting
- [ ] Additional Vietnamese SaaS integrations
- [ ] Multi-language support

---

Made with ❤️ by nqdev-group for the Vietnamese developer community