@kichat/n8n-nodes-kirimchat 1.1.0 → 1.2.1

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
@@ -63,13 +65,30 @@ Send a message to a customer via WhatsApp, Instagram, or Messenger.
 
 #### WhatsApp Template Messages
 
+Templates can be selected from a dropdown (loaded from your KirimChat account) or entered manually.
+
+**Dropdown Mode (Recommended):**
+| Parameter | Description |
+|-----------|-------------|
+| Template | Select from your approved templates (auto-loads from API) |
+| Template Variables | Add values for {{1}}, {{2}}, etc. in order |
+
+**Manual Mode:**
 | Parameter | Description |
 |-----------|-------------|
 | Template Name | Name of the approved template |
 | Template Language | Language code (e.g., `en`, `id`) |
-| Template Components | JSON array for variables and buttons |
+| Template Components | JSON array for advanced use cases |
+
+**Simple Variables Example:**
 
-**Example Template Components:**
+If your template is: `Hello {{1}}, your order {{2}} is ready!`
+
+Just add two variables in order:
+1. `John` (replaces {{1}})
+2. `ORD-123` (replaces {{2}})
+
+**Advanced Template Components (Manual Mode):**
 ```json
 [
   {
@@ -133,6 +152,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 +304,16 @@ The node returns standard error responses:
 
 ## Changelog
 
-### v1.1.0 (Latest)
+### v1.2.0 (Latest)
+- ✅ Added **Template Dropdown** - Select templates from dropdown (auto-loaded from API)
+- ✅ Added **Simple Variables** - Add template variables without writing JSON
+- ✅ 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)
+- ✅ Improved template UX - No more manual JSON for simple use cases
+
+### 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.d.ts

@@ -1,5 +1,10 @@
-import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { IExecuteFunctions, ILoadOptionsFunctions, INodeExecutionData, INodePropertyOptions, INodeType, INodeTypeDescription } from 'n8n-workflow';
 export declare class KirimChat implements INodeType {
     description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getTemplates(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+        };
+    };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
 }

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',
@@ -374,6 +386,36 @@ class KirimChat {
                 // ============================================
                 // TEMPLATE FIELDS (WhatsApp only)
                 // ============================================
+                {
+                    displayName: 'Template',
+                    name: 'templateSelect',
+                    type: 'options',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            operation: ['sendMessage'],
+                            messageType: ['template'],
+                        },
+                    },
+                    typeOptions: {
+                        loadOptionsMethod: 'getTemplates',
+                    },
+                    default: '',
+                    description: 'Select an approved WhatsApp template. Templates are loaded from your KirimChat account.',
+                },
+                {
+                    displayName: 'Or Enter Template Name Manually',
+                    name: 'templateManualEntry',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['sendMessage'],
+                            messageType: ['template'],
+                        },
+                    },
+                    default: false,
+                    description: 'Enable to manually enter template name and language instead of selecting from dropdown',
+                },
                 {
                     displayName: 'Template Name',
                     name: 'templateName',
@@ -383,6 +425,7 @@ class KirimChat {
                         show: {
                             operation: ['sendMessage'],
                             messageType: ['template'],
+                            templateManualEntry: [true],
                         },
                     },
                     default: '',
@@ -398,12 +441,45 @@ class KirimChat {
                         show: {
                             operation: ['sendMessage'],
                             messageType: ['template'],
+                            templateManualEntry: [true],
                         },
                     },
                     default: 'en',
-                    description: 'Language code for the template',
+                    description: 'Language code for the template (e.g., en, id, es)',
                     placeholder: 'en',
                 },
+                {
+                    displayName: 'Template Variables',
+                    name: 'templateVariables',
+                    type: 'fixedCollection',
+                    displayOptions: {
+                        show: {
+                            operation: ['sendMessage'],
+                            messageType: ['template'],
+                        },
+                    },
+                    default: {},
+                    placeholder: 'Add Variable',
+                    description: 'Variables to replace {{1}}, {{2}}, etc. in your template. Add them in order.',
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    options: [
+                        {
+                            name: 'variables',
+                            displayName: 'Variables',
+                            values: [
+                                {
+                                    displayName: 'Value',
+                                    name: 'value',
+                                    type: 'string',
+                                    default: '',
+                                    description: 'Value for this variable (replaces {{1}}, {{2}}, etc. in order)',
+                                },
+                            ],
+                        },
+                    ],
+                },
                 {
                     displayName: 'Template Components (JSON)',
                     name: 'templateComponents',
@@ -412,10 +488,11 @@ class KirimChat {
                         show: {
                             operation: ['sendMessage'],
                             messageType: ['template'],
+                            templateManualEntry: [true],
                         },
                     },
                     default: '[]',
-                    description: 'Template components as JSON array (for variables, buttons, etc.)',
+                    description: 'Advanced: Full template components JSON (for header media, buttons, etc.). Leave empty to use simple variables above.',
                 },
                 // ============================================
                 // INTERACTIVE MESSAGE FIELDS (WhatsApp only)
@@ -556,6 +633,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
                 // ============================================
                 {
@@ -662,6 +843,48 @@ class KirimChat {
                 },
             ],
         };
+        this.methods = {
+            loadOptions: {
+                // Load templates from KirimChat API for dropdown
+                async getTemplates() {
+                    const credentials = await this.getCredentials('kirimChatApi');
+                    const baseUrl = credentials.baseUrl;
+                    try {
+                        const response = await this.helpers.httpRequest({
+                            method: 'GET',
+                            url: `${baseUrl}/templates?status=APPROVED&limit=500`,
+                            headers: {
+                                'X-API-Key': credentials.apiKey,
+                                'Content-Type': 'application/json',
+                            },
+                        });
+                        if (!response.success || !response.data) {
+                            return [{ name: 'No templates found', value: '' }];
+                        }
+                        const templates = response.data;
+                        if (templates.length === 0) {
+                            return [{ name: 'No approved templates', value: '' }];
+                        }
+                        return templates.map((t) => {
+                            var _a;
+                            return ({
+                                name: `${t.template_name} (${t.language}) - ${t.category}`,
+                                value: JSON.stringify({
+                                    name: t.template_name,
+                                    language: t.language,
+                                    has_variables: t.has_variables,
+                                    content: t.content,
+                                }),
+                                description: ((_a = t.content) === null || _a === void 0 ? void 0 : _a.substring(0, 100)) || '',
+                            });
+                        });
+                    }
+                    catch (error) {
+                        return [{ name: 'Error loading templates', value: '' }];
+                    }
+                },
+            },
+        };
     }
     async execute() {
         const items = this.getInputData();
@@ -699,19 +922,61 @@ class KirimChat {
                     }
                     else if (messageType === 'template') {
                         // WhatsApp template message
-                        const templateName = this.getNodeParameter('templateName', i);
-                        const templateLanguage = this.getNodeParameter('templateLanguage', i);
-                        const templateComponentsJson = this.getNodeParameter('templateComponents', i, '[]');
-                        let templateComponents;
-                        try {
-                            templateComponents = JSON.parse(templateComponentsJson);
+                        const manualEntry = this.getNodeParameter('templateManualEntry', i, false);
+                        let templateName;
+                        let templateLanguage;
+                        let templateComponents = [];
+                        if (manualEntry) {
+                            // Manual entry mode - user types name and language
+                            templateName = this.getNodeParameter('templateName', i);
+                            templateLanguage = this.getNodeParameter('templateLanguage', i);
+                            // Check for advanced JSON components
+                            const templateComponentsJson = this.getNodeParameter('templateComponents', i, '[]');
+                            if (templateComponentsJson && templateComponentsJson !== '[]') {
+                                try {
+                                    templateComponents = JSON.parse(templateComponentsJson);
+                                }
+                                catch (error) {
+                                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid JSON in Template Components: ${error instanceof Error ? error.message : 'Parse failed'}`, { itemIndex: i });
+                                }
+                                // Validate template components structure
+                                if (!validateTemplateComponents(templateComponents)) {
+                                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Template Components must be a JSON array of objects. Example: [{"type": "body", "parameters": [...]}]', { itemIndex: i });
+                                }
+                            }
                         }
-                        catch (error) {
-                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Invalid JSON in Template Components: ${error instanceof Error ? error.message : 'Parse failed'}`, { itemIndex: i });
+                        else {
+                            // Dropdown selection mode - parse from selected value
+                            const templateSelectValue = this.getNodeParameter('templateSelect', i);
+                            if (!templateSelectValue) {
+                                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Please select a template or enable manual entry', { itemIndex: i });
+                            }
+                            try {
+                                const templateData = JSON.parse(templateSelectValue);
+                                templateName = templateData.name;
+                                templateLanguage = templateData.language;
+                            }
+                            catch (error) {
+                                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Invalid template selection. Please re-select the template.', { itemIndex: i });
+                            }
                         }
-                        // Validate template components structure
-                        if (!validateTemplateComponents(templateComponents)) {
-                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Template Components must be a JSON array of objects. Example: [{"type": "body", "parameters": [...]}]', { itemIndex: i });
+                        // Handle simple variables (from fixedCollection)
+                        const templateVariablesData = this.getNodeParameter('templateVariables', i, {});
+                        if (templateVariablesData.variables && templateVariablesData.variables.length > 0) {
+                            // Build body component with parameters
+                            const bodyParameters = templateVariablesData.variables.map((v) => ({
+                                type: 'text',
+                                text: v.value,
+                            }));
+                            // If no components provided, create body component with variables
+                            if (!Array.isArray(templateComponents) || templateComponents.length === 0) {
+                                templateComponents = [
+                                    {
+                                        type: 'body',
+                                        parameters: bodyParameters,
+                                    },
+                                ];
+                            }
                         }
                         body.template = {
                             name: templateName,
@@ -827,6 +1092,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,19 +1,19 @@
-{
-  "name": "@kichat/n8n-nodes-kirimchat",
-  "version": "1.1.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",
-    "n8n",
-    "kirimchat",
-    "whatsapp",
-    "instagram",
-    "messenger",
-    "facebook",
-    "messaging",
-    "chat",
-    "automation"
-  ],
+{
+  "name": "@kichat/n8n-nodes-kirimchat",
+  "version": "1.2.1",
+  "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",
+    "n8n",
+    "kirimchat",
+    "whatsapp",
+    "instagram",
+    "messenger",
+    "facebook",
+    "messaging",
+    "chat",
+    "automation"
+  ],
   "license": "MIT",
   "homepage": "https://kirim.chat",
   "author": {