n8n-nodes-kirimi

This is an n8n community node for integrating with the Kirimi WhatsApp Unofficial API.

Features

The Kirimi node provides comprehensive integration with Kirimi's WhatsApp API, including:

OTP Management

• OTP V2 (Recommended): Dual method support (WABA Central or Device)
  • WABA Method: High reliability, Rp 400/OTP
  • Device Method: Free, customizable messages
• OTP V1: Legacy generate and validate OTP
• Customizable OTP length, type, and custom message

Message Sending

• Send individual WhatsApp messages (send-message)
• Send messages in fast mode — no typing effect (send-message-fast)
• Send file via multipart upload, max 50MB (send-message-file)
• Broadcast messages to multiple recipients (broadcast-message)

WABA (WhatsApp Business API)

• Send messages via Meta Cloud API (waba/send-message)

Device Management

• Check device connection status (device-status)
• Get full device details (device-status-enhanced)
• List all devices (list-devices)

Contact Management

• Save a single contact (save-contact)

Package & Billing

• List available packages (list-packages)
• List deposit history with optional status filter (list-deposits)

User Information

• Get user account information (user-info)

Webhook Trigger (NEW!)

• Receive webhook events from Kirimi
• Filter events by type (message, connection, QR, etc)
• Filter messages by sender, type, and group status
• Auto-process incoming WhatsApp messages
• Real-time notifications for device status changes

Installation

1. Install in n8n community nodes:

   npm install n8n-nodes-kirimi
   

2. Restart n8n to load the node

Configuration

1. Create Kirimi API credentials in n8n:

   • User Code: Your Kirimi API user code
   • Secret: Your Kirimi API secret key
   • Base URL: https://api.kirimi.id (default, no version prefix)

2. Get your credentials from Kirimi Documentation

Usage

Regular Actions (Kirimi Node)

1. Add the Kirimi node to your workflow
2. Select the appropriate resource and operation
3. Configure the required parameters
4. Execute the workflow

Webhook Trigger (Kirimi Trigger Node)

1. Add the "Kirimi Trigger" node to your workflow
2. Select the events you want to receive (e.g., "Message", "Connection Connected")
3. Configure optional filters (device ID, message type, etc)
4. Activate the workflow to get your webhook URL
5. Copy the webhook URL and configure it in your Kirimi Dashboard

For detailed webhook trigger usage, see KIRIMI_TRIGGER_README.md

API Documentation

For detailed API documentation, visit: https://kirimi.id/docs

Support

For issues and feature requests, please visit: https://github.com/kiriminow/n8n-kirimi-nodes/issues

License

MIT# n8n-nodes-kirimi