@kichat/n8n-nodes-kirimchat 1.1.0 → 1.2.0

package/README.md

@@ -5,6 +5,8 @@ This is an n8n community node for [KirimChat](https://kirim.chat) - a messaging
 ## Features
 
 - **Send Message** - Send text, image, document, audio, video, template, or interactive messages via WhatsApp, Instagram, or Messenger
+- **List Templates** - List all WhatsApp message templates with filtering
+- **Get Template** - Get a specific template by ID
 - **Mark as Read** - Mark messages as read and send read receipts
 - **Send Typing Indicator** - Show typing indicator to customers
 - **Flexible Customer Lookup** - Find customers by ID, phone number, or Instagram username
@@ -133,6 +135,73 @@ Mark a message as read and send read receipt to the customer.
 |-----------|-------------|
 | Message ID | The ID of the message to mark as read (e.g., `msg_xyz789`) |
 
+### List Templates
+
+List all WhatsApp message templates with optional filtering.
+
+| Parameter | Description |
+|-----------|-------------|
+| Filter by Status | `All`, `APPROVED`, `PENDING`, or `REJECTED` |
+| Filter by Category | `All`, `MARKETING`, `UTILITY`, or `AUTHENTICATION` |
+| Limit | Maximum templates to return (1-500, default 100) |
+
+**Example Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "templates": [
+      {
+        "id": "tpl_abc123",
+        "templateName": "order_confirmation",
+        "language": "en",
+        "status": "APPROVED",
+        "category": "UTILITY",
+        "content": "Your order {{1}} has been confirmed.",
+        "headerType": "TEXT",
+        "headerContent": "Order Update",
+        "footerContent": "Thank you for shopping!",
+        "variables": ["order_number"],
+        "createdAt": "2025-01-15T10:00:00.000Z"
+      }
+    ],
+    "total": 1
+  }
+}
+```
+
+### Get Template
+
+Get a specific WhatsApp message template by ID.
+
+| Parameter | Description |
+|-----------|-------------|
+| Template ID | The ID of the template (e.g., `tpl_abc123`) |
+
+**Example Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "id": "tpl_abc123",
+    "templateName": "order_confirmation",
+    "language": "en",
+    "status": "APPROVED",
+    "category": "UTILITY",
+    "content": "Your order {{1}} has been confirmed.",
+    "headerType": "TEXT",
+    "headerContent": "Order Update",
+    "footerContent": "Thank you for shopping!",
+    "buttons": [
+      { "type": "URL", "text": "Track Order", "url": "https://..." }
+    ],
+    "variables": ["order_number"],
+    "createdAt": "2025-01-15T10:00:00.000Z",
+    "updatedAt": "2025-01-15T10:00:00.000Z"
+  }
+}
+```
+
 ### Send Typing Indicator
 
 Show typing indicator to a customer before sending a message.
@@ -218,7 +287,13 @@ The node returns standard error responses:
 
 ## Changelog
 
-### v1.1.0 (Latest)
+### v1.2.0 (Latest)
+- ✅ Added **List Templates** operation - List all WhatsApp templates with filtering
+- ✅ Added **Get Template** operation - Get template details by ID
+- ✅ Filter templates by status (Approved, Pending, Rejected)
+- ✅ Filter templates by category (Marketing, Utility, Authentication)
+
+### v1.1.0
 - ✅ Added Messenger channel support
 - ✅ Added customer lookup by phone number and Instagram username
 - ✅ Added WhatsApp Interactive messages (CTA URL buttons, Reply buttons)

package/dist/nodes/KirimChat/KirimChat.node.js

@@ -75,6 +75,18 @@ class KirimChat {
                             description: 'Send a message to a customer via WhatsApp, Instagram, or Messenger',
                             action: 'Send a message',
                         },
+                        {
+                            name: 'List Templates',
+                            value: 'listTemplates',
+                            description: 'List WhatsApp message templates',
+                            action: 'List templates',
+                        },
+                        {
+                            name: 'Get Template',
+                            value: 'getTemplate',
+                            description: 'Get a specific WhatsApp message template by ID',
+                            action: 'Get template',
+                        },
                         {
                             name: 'Mark as Read',
                             value: 'markAsRead',
@@ -556,6 +568,110 @@ class KirimChat {
                     placeholder: 'msg_xyz789',
                 },
                 // ============================================
+                // LIST TEMPLATES FIELDS
+                // ============================================
+                {
+                    displayName: 'Filter by Status',
+                    name: 'templateStatus',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['listTemplates'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'All',
+                            value: '',
+                            description: 'Return all templates',
+                        },
+                        {
+                            name: 'Approved',
+                            value: 'APPROVED',
+                            description: 'Only approved templates (ready to use)',
+                        },
+                        {
+                            name: 'Pending',
+                            value: 'PENDING',
+                            description: 'Templates pending approval',
+                        },
+                        {
+                            name: 'Rejected',
+                            value: 'REJECTED',
+                            description: 'Rejected templates',
+                        },
+                    ],
+                    default: '',
+                    description: 'Filter templates by approval status',
+                },
+                {
+                    displayName: 'Filter by Category',
+                    name: 'templateCategory',
+                    type: 'options',
+                    displayOptions: {
+                        show: {
+                            operation: ['listTemplates'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'All',
+                            value: '',
+                            description: 'Return all categories',
+                        },
+                        {
+                            name: 'Marketing',
+                            value: 'MARKETING',
+                            description: 'Marketing templates',
+                        },
+                        {
+                            name: 'Utility',
+                            value: 'UTILITY',
+                            description: 'Utility templates (order updates, etc.)',
+                        },
+                        {
+                            name: 'Authentication',
+                            value: 'AUTHENTICATION',
+                            description: 'Authentication templates (OTP, etc.)',
+                        },
+                    ],
+                    default: '',
+                    description: 'Filter templates by category',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'templateLimit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            operation: ['listTemplates'],
+                        },
+                    },
+                    default: 100,
+                    description: 'Maximum number of templates to return (max 500)',
+                    typeOptions: {
+                        minValue: 1,
+                        maxValue: 500,
+                    },
+                },
+                // ============================================
+                // GET TEMPLATE FIELDS
+                // ============================================
+                {
+                    displayName: 'Template ID',
+                    name: 'templateId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['getTemplate'],
+                        },
+                    },
+                    default: '',
+                    description: 'The ID of the template to retrieve',
+                    placeholder: 'tpl_abc123',
+                },
+                // ============================================
                 // SEND TYPING FIELDS
                 // ============================================
                 {
@@ -827,6 +943,42 @@ class KirimChat {
                         json: true,
                     });
                 }
+                else if (operation === 'listTemplates') {
+                    // ============================================
+                    // LIST TEMPLATES OPERATION
+                    // ============================================
+                    const templateStatus = this.getNodeParameter('templateStatus', i, '');
+                    const templateCategory = this.getNodeParameter('templateCategory', i, '');
+                    const templateLimit = this.getNodeParameter('templateLimit', i, 100);
+                    // Build query string
+                    const queryParams = [];
+                    if (templateStatus) {
+                        queryParams.push(`status=${templateStatus}`);
+                    }
+                    if (templateCategory) {
+                        queryParams.push(`category=${templateCategory}`);
+                    }
+                    if (templateLimit) {
+                        queryParams.push(`limit=${templateLimit}`);
+                    }
+                    const queryString = queryParams.length > 0 ? `?${queryParams.join('&')}` : '';
+                    responseData = await this.helpers.httpRequestWithAuthentication.call(this, 'kirimChatApi', {
+                        method: 'GET',
+                        url: `${baseUrl}/templates${queryString}`,
+                        json: true,
+                    });
+                }
+                else if (operation === 'getTemplate') {
+                    // ============================================
+                    // GET TEMPLATE OPERATION
+                    // ============================================
+                    const templateId = this.getNodeParameter('templateId', i);
+                    responseData = await this.helpers.httpRequestWithAuthentication.call(this, 'kirimChatApi', {
+                        method: 'GET',
+                        url: `${baseUrl}/templates/${templateId}`,
+                        json: true,
+                    });
+                }
                 else if (operation === 'sendTyping') {
                     // ============================================
                     // SEND TYPING INDICATOR OPERATION

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kichat/n8n-nodes-kirimchat",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "n8n community node for KirimChat - Send WhatsApp, Instagram & Messenger messages with interactive buttons, flexible customer lookup, and typing indicators",
   "keywords": [
     "n8n-community-node-package",