@trg-admin/n8n-nodes-zoho-desk 0.1.23 → 0.1.24

package/README.md

@@ -33,15 +33,19 @@ When you create the credential in n8n, the default scope is:
 
 ```
 ZohoCRM.modules.ALL Desk.tickets.ALL Desk.contacts.ALL Desk.search.READ
+Desk.tasks.ALL Desk.basic.READ Desk.fields.READ Desk.settings.READ
+Desk.webhooks.CREATE Desk.webhooks.READ Desk.webhooks.UPDATE Desk.webhooks.DELETE
 ```
 
 **Available Zoho Desk Scopes:**
 - `Desk.tickets.ALL` - Full access to tickets
 - `Desk.contacts.ALL` - Full access to contacts  
 - `Desk.search.READ` - Search across modules
+- `Desk.fields.READ` - Read field definitions (required for the Classification / Category / Sub-Category and Channel dropdowns)
 - `Desk.settings.ALL` - Access to settings and configurations
 - `Desk.tasks.ALL` - Task management
 - `Desk.basic.READ` - Read-only access to basic information
+- `Desk.webhooks.*` - Webhook subscription management (required by the Zoho Desk Trigger node)
 
 You can customize the scope field in the credential to add or remove permissions as needed.
 

package/dist/credentials/ZohoCRMDeskOAuth2Api.credentials.js

@@ -110,7 +110,7 @@ class ZohoCRMDeskOAuth2Api {
                 displayName: 'Scope',
                 name: 'scope',
                 type: 'string',
-                default: 'ZohoCRM.modules.ALL Desk.tickets.ALL Desk.contacts.ALL Desk.search.READ Desk.tasks.ALL Desk.basic.READ Desk.settings.READ Desk.webhooks.CREATE Desk.webhooks.READ Desk.webhooks.UPDATE Desk.webhooks.DELETE',
+                default: 'ZohoCRM.modules.ALL Desk.tickets.ALL Desk.contacts.ALL Desk.search.READ Desk.tasks.ALL Desk.basic.READ Desk.fields.READ Desk.settings.READ Desk.webhooks.CREATE Desk.webhooks.READ Desk.webhooks.UPDATE Desk.webhooks.DELETE',
                 required: true,
                 description: 'Space-separated OAuth scopes. Default includes both CRM and Desk permissions. Add or remove scopes as needed (e.g., Desk.settings.ALL, Desk.tasks.ALL).',
             },

package/dist/nodes/ZohoDesk/ZohoDesk.node.d.ts

@@ -1,4 +1,23 @@
 import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, ILoadOptionsFunctions } from 'n8n-workflow';
+/**
+ * Load a ticket taxonomy picklist (classification / category / subCategory) for a dropdown.
+ *
+ * Zoho Desk has no /classifications, /categories or /subcategories endpoints — ticket
+ * taxonomy is exposed through the ticket module's organization field definitions.
+ *
+ * The ticket payload takes the taxonomy *name string* (there is no classificationId /
+ * categoryId / subCategoryId on a ticket), so the option value is the value itself.
+ *
+ * ponytail: the three levels are listed independently rather than cascaded. Whether a
+ * subCategory must be mapped under the chosen category is configured per-tenant (field
+ * dependencies) and is not documented as an API rule, so we list all values and let the
+ * API answer. Upgrade to GET /layouts/{layoutId}/fields/{fieldId}/dependentValues if users
+ * hit rejections in tenants that do enforce the mapping.
+ */
+export declare function loadTaxonomyOptions(context: ILoadOptionsFunctions, apiName: string): Promise<Array<{
+    name: string;
+    value: string;
+}>>;
 export declare class ZohoDesk implements INodeType {
     description: INodeTypeDescription;
     methods: {
@@ -11,6 +30,18 @@ export declare class ZohoDesk implements INodeType {
                 name: string;
                 value: string;
             }[]>;
+            getClassifications(this: ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            getCategories(this: ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+            getSubCategories(this: ILoadOptionsFunctions): Promise<{
+                name: string;
+                value: string;
+            }[]>;
         };
     };
     execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;

package/dist/nodes/ZohoDesk/ZohoDesk.node.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZohoDesk = void 0;
+exports.loadTaxonomyOptions = loadTaxonomyOptions;
 const n8n_workflow_1 = require("n8n-workflow");
 const GenericFunctions_1 = require("./GenericFunctions");
 function cleanCommaSeparated(value) {
@@ -13,6 +14,56 @@ function cleanCommaSeparated(value) {
         .filter(Boolean)
         .join(',');
 }
+/**
+ * Load a ticket taxonomy picklist (classification / category / subCategory) for a dropdown.
+ *
+ * Zoho Desk has no /classifications, /categories or /subcategories endpoints — ticket
+ * taxonomy is exposed through the ticket module's organization field definitions.
+ *
+ * The ticket payload takes the taxonomy *name string* (there is no classificationId /
+ * categoryId / subCategoryId on a ticket), so the option value is the value itself.
+ *
+ * ponytail: the three levels are listed independently rather than cascaded. Whether a
+ * subCategory must be mapped under the chosen category is configured per-tenant (field
+ * dependencies) and is not documented as an API rule, so we list all values and let the
+ * API answer. Upgrade to GET /layouts/{layoutId}/fields/{fieldId}/dependentValues if users
+ * hit rejections in tenants that do enforce the mapping.
+ */
+async function loadTaxonomyOptions(context, apiName) {
+    // Taxonomy is department-scoped; only top-level ticket parameters carry a department.
+    const departmentId = context.getCurrentNodeParameter('departmentId');
+    const qs = { module: 'tickets', apiNames: apiName };
+    if (departmentId) {
+        qs.departmentId = String(departmentId);
+    }
+    try {
+        const responseData = await GenericFunctions_1.zohoDeskApiRequest.call(context, 'GET', '/organizationFields', {}, qs, 0);
+        const fields = Array.isArray(responseData?.data)
+            ? responseData.data
+            : Array.isArray(responseData)
+                ? responseData
+                : [];
+        const field = fields.find((f) => String(f.apiName || '').toLowerCase() === apiName.toLowerCase());
+        // Field definitions carry picklist values under either key depending on tenant.
+        const rawValues = (field?.pickListValues ?? field?.allowedValues ?? []);
+        const seen = new Set();
+        const options = [];
+        for (const entry of rawValues) {
+            const value = typeof entry === 'string'
+                ? entry
+                : (entry.value || entry.displayValue || '');
+            if (!value || seen.has(value)) {
+                continue;
+            }
+            seen.add(value);
+            options.push({ name: value, value });
+        }
+        return options.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    catch (error) {
+        throw new Error(`Failed to load "${apiName}" values from the ticket layout. Error: ${error.message}`);
+    }
+}
 class ZohoDesk {
     constructor() {
         this.description = {
@@ -190,6 +241,39 @@ class ZohoDesk {
                             default: 'Email',
                             description: 'Channel through which the ticket was received or created. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
                         },
+                        {
+                            displayName: 'Classification',
+                            name: 'classification',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getClassifications',
+                                loadOptionsDependsOn: ['organizationId', 'departmentId'],
+                            },
+                            default: '',
+                            description: 'Top-level ticket classification, as configured on the department\'s ticket layout. Choose from the list, or specify a value using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                        },
+                        {
+                            displayName: 'Category',
+                            name: 'category',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getCategories',
+                                loadOptionsDependsOn: ['organizationId', 'departmentId'],
+                            },
+                            default: '',
+                            description: 'Ticket category, as configured on the department\'s ticket layout. Choose from the list, or specify a value using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                        },
+                        {
+                            displayName: 'Sub-Category',
+                            name: 'subCategory',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getSubCategories',
+                                loadOptionsDependsOn: ['organizationId', 'departmentId'],
+                            },
+                            default: '',
+                            description: 'Ticket sub-category, as configured on the department\'s ticket layout. Choose from the list, or specify a value using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                        },
                         {
                             displayName: 'Contact ID',
                             name: 'contactId',
@@ -875,6 +959,15 @@ class ZohoDesk {
                     }
                     return fallbackChannels;
                 },
+                async getClassifications() {
+                    return loadTaxonomyOptions(this, 'classification');
+                },
+                async getCategories() {
+                    return loadTaxonomyOptions(this, 'category');
+                },
+                async getSubCategories() {
+                    return loadTaxonomyOptions(this, 'subCategory');
+                },
             },
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trg-admin/n8n-nodes-zoho-desk",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Community n8n node starter for Zoho Desk using built-in Zoho OAuth2 auth behavior",
   "license": "MIT",
   "type": "commonjs",
@@ -10,7 +10,7 @@
     "copy-assets": "cp nodes/ZohoDesk/zohodesk.png dist/nodes/ZohoDesk/",
     "lint": "echo 'No linter configured'",
     "typecheck": "tsc --noEmit",
-    "test": "node scripts.validate.js",
+    "test": "node scripts.validate.js && node test/Taxonomy.test.js",
     "prepublishOnly": "npm run typecheck && npm run build"
   },
   "files": [