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

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,24 @@
 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 readDepartmentScope(context: ILoadOptionsFunctions): string;
+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 +31,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,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZohoDesk = void 0;
+exports.readDepartmentScope = readDepartmentScope;
+exports.loadTaxonomyOptions = loadTaxonomyOptions;
 const n8n_workflow_1 = require("n8n-workflow");
 const GenericFunctions_1 = require("./GenericFunctions");
 function cleanCommaSeparated(value) {
@@ -13,6 +15,83 @@ 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.
+ */
+function readDepartmentScope(context) {
+    const ctx = context;
+    // Top level: the ticket create form carries departmentId directly.
+    try {
+        const current = ctx.getCurrentNodeParameter?.('departmentId');
+        if (current !== undefined && current !== null && current !== '') {
+            return String(current).trim();
+        }
+    }
+    catch {
+        // Not available in this context; fall through.
+    }
+    // Nested: on update, Department lives in the Additional Fields collection. Values inside
+    // a collection are invisible to getCurrentNodeParameter, so read the raw parameters.
+    try {
+        const nested = ctx.getCurrentNodeParameters?.()?.additionalFields
+            ?.departmentId;
+        if (nested !== undefined && nested !== null && nested !== '') {
+            return String(nested).trim();
+        }
+    }
+    catch {
+        // Treat as unscoped.
+    }
+    return '';
+}
+async function loadTaxonomyOptions(context, apiName) {
+    // Taxonomy is department-scoped: without a department the API returns the whole org,
+    // which offers values that the target department's layout may reject.
+    const departmentId = readDepartmentScope(context);
+    const qs = { module: 'tickets', apiNames: apiName };
+    if (departmentId) {
+        qs.departmentId = 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 = {
@@ -185,10 +264,57 @@ class ZohoDesk {
                             type: 'options',
                             typeOptions: {
                                 loadOptionsMethod: 'getChannels',
-                                loadOptionsDependsOn: ['organizationId'],
+                                loadOptionsDependsOn: ['organizationId', 'departmentId'],
                             },
                             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>.',
+                            description: 'Channel through which the ticket was received or created, scoped to the selected Department. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                        },
+                        {
+                            // Create already has a top-level required Department, so only offer this
+                            // here for Update - it both scopes the taxonomy values and moves the ticket.
+                            displayName: 'Department',
+                            name: 'departmentId',
+                            type: 'options',
+                            typeOptions: {
+                                loadOptionsMethod: 'getDepartments',
+                                loadOptionsDependsOn: ['organizationId'],
+                            },
+                            default: '',
+                            displayOptions: { show: { resource: ['ticket'], operation: ['update'] } },
+                            description: 'Department whose layout defines the values offered by the Classification, Category and Sub-Category fields below. Leave blank to list values from every department in the organization. Note: setting this also moves the ticket into that department, so set it to the ticket\'s current department unless you intend to move it.',
+                        },
+                        {
+                            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',
@@ -836,7 +962,13 @@ class ZohoDesk {
                     }
                     catch {
                         try {
-                            const fieldsResponse = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', '/organizationFields', {}, { module: 'tickets' }, 0);
+                            // Channel is department-scoped too, so honour the same scope as the taxonomy.
+                            const channelQs = { module: 'tickets', apiNames: 'channel' };
+                            const channelDepartmentId = readDepartmentScope(this);
+                            if (channelDepartmentId) {
+                                channelQs.departmentId = channelDepartmentId;
+                            }
+                            const fieldsResponse = await GenericFunctions_1.zohoDeskApiRequest.call(this, 'GET', '/organizationFields', {}, channelQs, 0);
                             const fields = Array.isArray(fieldsResponse.data)
                                 ? fieldsResponse.data
                                 : Array.isArray(fieldsResponse)
@@ -875,6 +1007,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.25",
   "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": [