n8n-nodes-watzap

Community node untuk integrasi WatZap API di n8n. Mendukung pengiriman pesan WhatsApp dan menerima webhook secara langsung.

🚀 Fitur

WatZap Node Actions (Send Messages)

• ✅ WatZap Node Actions - Node group dengan 4 sub-operations:
  • Send Text Message - Kirim pesan teks
  • Send Image Message - Kirim gambar dengan caption
  • Send File Message - Kirim file via URL
  • Send Voice Notes - Kirim voice note (format OGG)
• ✅ Dynamic parameters - Parameter yang ditampilkan sesuai operation
• ✅ Single node - Semua operation dalam satu node group
• ✅ Error handling - Response error yang konsisten

WatZap Trigger Node (Receive Webhooks)

• ✅ Built-in webhook - tidak perlu webhook node terpisah
• ✅ Smart filtering - filter berdasarkan message type dan status
• ✅ Authentication - API key validation
• ✅ Data normalization - format data WatZap otomatis
• ✅ Custom responses - konfigurasi response webhook

WatZap Node (Legacy)

• ✅ Kirim Text Messages
• ✅ Kirim Image via URL
• ✅ Kirim Document via URL
• ✅ Mark as Read messages
• ✅ Health Check endpoint
• ✅ Konfigurasi endpoint path yang fleksibel

📦 Installation

Via n8n Community Nodes (Recommended)

1. Go to Settings → Community Nodes
2. Click Install a community node
3. Enter: n8n-nodes-watzap
4. Click Install
5. Restart n8n to ensure new nodes are detected

Manual Installation

# For Docker n8n
docker exec -it n8n_container npm install n8n-nodes-watzap
docker restart n8n_container

# For local n8n
cd ~/.n8n/custom
npm install n8n-nodes-watzap
# Restart n8n

⚠️ Important Notes

• Restart n8n after installation to detect new nodes
• Package version 1.1.58+ includes all 5 nodes
• If nodes don't appear, try reinstalling the package

🔧 Setup

1. WatZap API Credentials

Buat credentials baru di n8n:

• Name: WatZap API
• Base URL: Your WatZap API endpoint
• API Key: Dari Integrations → API Key & Apps
• Number Key: Dari WhatsApp → API tab

2. WatZap Trigger API Credentials (Optional)

Untuk webhook authentication:

• Name: WatZap Trigger API
• API Key: Secret key untuk validasi webhook

🎯 Quick Start

WatZap Node Actions Example

1. Add "WatZap Node Actions" node to workflow
2. Select credentials
3. Choose operation:
   - Send Text Message
   - Send Image Message
   - Send File Message
   - Send Voice Notes
4. Configure parameters sesuai operation yang dipilih

Webhook Trigger Example

1. Add WatZap Trigger node
2. Configure:
   - Authentication: API Key
   - Filter Message Types: ["text", "image"]
3. Set webhook URL di WatZap dashboard:
   https://your-n8n.com/webhook/watzap

📚 Documentation

• WatZap Actions Guide: docs/watzap-actions-guide.md
• Trigger Usage: docs/watzap-trigger-usage.md
• Installation Guide: INSTALLATION.md
• Example Workflows: n8n-workflows/

🔗 Links

• WatZap API Docs: api-docs.watzap.id
• n8n Community: community.n8n.io

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

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

Version: 1.1.2 | Compatibility: n8n v1.0.0+