@kichat/n8n-nodes-kirimchat 1.2.0 → 1.2.1

package/README.md

@@ -65,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:**
+
+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}})
 
-**Example Template Components:**
+**Advanced Template Components (Manual Mode):**
 ```json
 [
   {
@@ -288,10 +305,13 @@ The node returns standard error responses:
 ## Changelog
 
 ### 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

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

@@ -386,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',
@@ -395,6 +425,7 @@ class KirimChat {
                         show: {
                             operation: ['sendMessage'],
                             messageType: ['template'],
+                            templateManualEntry: [true],
                         },
                     },
                     default: '',
@@ -410,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',
@@ -424,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)
@@ -778,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();
@@ -815,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,

package/package.json

@@ -1,19 +1,19 @@
-{
-  "name": "@kichat/n8n-nodes-kirimchat",
-  "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",
-    "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": {