n8n-nodes-kouventa-ai

Official n8n community nodes for integrating with Kouventa.ai messaging platform.

Send messages and receive webhooks from Kouventa.ai directly in your n8n workflows.

Channel Progress :
[v] WhatasApp
[-] Facebook
[-] Instagram
[-] TikTok
[-] Kouventa Livechat
[-] Shopee
[-] Tokopedia

---

🚀 Features

🔔 Kouventa Webhook Trigger

• Receive inbound messages & events from Kouventa.ai
• Webhook signature verification for security
• Real-time message notifications

✉️ Kouventa Send Message

Send various message types through WhatsApp:

• Text messages - Simple text communication
• Media messages - Images, audio, video, and documents
• Interactive buttons - Quick reply buttons for user interaction
• Interactive lists - Structured list menus
• Template messages - Pre-approved message templates

---

📦 Installation

Option 1: Install via n8n Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install and search for n8n-nodes-kouventa-ai
3. Click Install to add the nodes to your n8n instance

Option 2: Install via npm

For self-hosted n8n installations:

npm install n8n-nodes-kouventa-ai

Then restart your n8n instance.

---

⚙️ Configuration

1. Create Kouventa API Credentials

Before using the nodes, you need to set up credentials:

1. In n8n, go to Credentials > New

2. Search for Kouventa API

3. Fill in the required fields:

   • Base URL: Your Kouventa API endpoint (e.g., https://api.kouventa.ai)
   • Username: Your Kouventa API username
   • Password: Your Kouventa API password
   • Webhook Secret (optional): Secret key for webhook signature verification

4. Click Save

2. Configure Webhook (Optional)

If you're using the Kouventa Webhook trigger node:

1. Add the Kouventa Webhook node to your workflow
2. Copy the webhook URL from the node
3. Configure this URL in your Kouventa.ai dashboard
4. Enable Verify Signature in the node settings for security

---

🎯 Usage Examples

Example 1: Send a Text Message

1. Add Kouventa Send node to your workflow
2. Select Send Text Message action
3. Configure:
   • Source: Your business phone number (e.g., 6281234567890)
   • Client Phone Number: Recipient's phone number (e.g., 6289876543210)
   • Message Text: Your message content
4. Execute the workflow

Example 2: Send Interactive Buttons

1. Add Kouventa Send node
2. Select Send Interactive Button action
3. Configure:
   • Source: Your business phone number
   • Client Phone Number: Recipient's phone number
   • Header Text: Optional header
   • Body: Main message text
   • Footer: Optional footer text
   • Reply Buttons: Add buttons with ID and Title

Example 3: Receive Webhook Messages

1. Add Kouventa Webhook trigger node
2. Enable Verify Signature for security
3. Copy the webhook URL
4. Configure the URL in your Kouventa.ai dashboard
5. Activate the workflow
6. Incoming messages will trigger the workflow automatically

Example 4: Send Template Message

1. Add Kouventa Send node
2. Select Send Template Message action
3. Configure:
   • Source: Your business phone number
   • Client Phone Number: Recipient's phone number
   • Template UID: Your approved template ID
   • Body Parameters: Dynamic values for template variables

---

📚 Available Nodes

Kouventa Send Node

Supported Actions:

• Send Text Message
• Send Image
• Send Audio
• Send Video
• Send Document
• Send Interactive Button
• Send Interactive List
• Send Template Message

Common Parameters:

• source - Business phone number (required)
• phone_number - Client/recipient phone number (required)

Action-Specific Parameters:

• Text: text
• Media: media_url, caption, file_name (for documents)
• Interactive: header_text, body, footer, reply_buttons or list_sections
• Template: template_uid, body_parameter

Kouventa Webhook Node

Settings:

• verifySignature - Enable/disable webhook signature verification (default: enabled)

Output:
Returns the complete webhook payload as JSON, including:

• Message content
• Sender information
• Message type
• Timestamp
• Other metadata from Kouventa.ai

---

💬 Support

Documentation

• Kouventa.ai Documentation
• n8n Documentation
• n8n Community Nodes Guide

Need Help?

If you encounter any issues or have questions:

1. Check the existing issues
2. Create a new issue with:
   • Clear description of the problem
   • Steps to reproduce
   • Expected vs actual behavior
   • n8n version and environment details

Community

• n8n Community Forum
• Kouventa.ai Support

---

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

---

📄 License

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

---

📊 Changelog

See CHANGELOG.md for version history and updates.

---

Made with ❤️ for the n8n community