n8n-nodes-cention 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cention AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,165 @@
+# n8n-nodes-cention
+
+This is an n8n community node for integrating with [Cention](https://cention.com) - a comprehensive customer service platform.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+[Installation](#installation)  
+[Operations](#operations)  
+[Credentials](#credentials)  
+[Compatibility](#compatibility)  
+[Usage](#usage)  
+[Resources](#resources)  
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+### Community Node Installation
+
+1. Go to **Settings > Community Nodes** in your n8n instance
+2. Click **Install**
+3. Enter `n8n-nodes-cention`
+4. Click **Install**
+
+### Manual Installation
+
+To install manually, run this in your n8n root directory:
+
+```bash
+npm install n8n-nodes-cention
+```
+
+## Operations
+
+The Cention node supports the following resources and operations:
+
+### 🎫 Errand (Support Tickets)
+- **Create** - Create a new errand/ticket
+- **Get** - Retrieve a specific errand by ID
+- **Get Many** - List all changed errands
+- **Update** - Update an existing errand
+- **Close** - Close an errand
+- **Send Message** - Send a message to an errand
+
+### 👤 Contact Card
+- **Get** - Retrieve a specific contact
+- **Get Many** - List contacts with filters (email, name)
+
+### 📚 Library Question (Knowledge Base)
+- **Get** - Retrieve a specific knowledge base article
+- **Get Many** - List all articles
+- **Search** - Search articles by question/answer
+
+### 💬 Chat Message
+- **Get Many** - Retrieve chat messages with filters (email, date range)
+
+### 🟢 Agent Presence
+- **Set** - Set agent status (available, busy, away, offline)
+
+### 📊 Statistics
+- **Get** - Retrieve reports (Errand Summary, Agent Performance, Response Time, SLA Compliance, Channel Distribution)
+
+### 📡 Channel
+- **Get** - Retrieve a specific channel
+- **Get Many** - List all channels with filters
+
+### 🔔 Cention Trigger
+- **New Errand** - Triggers when a new or changed errand is detected (polling)
+
+## Credentials
+
+To use this node, you need to set up Cention API credentials:
+
+1. **Workspace** - Your Cention workspace name
+2. **API Token** - JWT token from Cention Admin
+
+### How to get your credentials:
+
+1. Log in to your Cention Admin panel
+2. Go to **API Management** or **Integrations**
+3. Create a new **API Token** (JWT)
+4. Copy the **Token**
+5. Note your **Workspace** name (visible in the URL: `/s/{workspace}/`)
+
+**Note:** The API URL is pre-configured to `https://apid.cention.com`.
+
+## Compatibility
+
+- Minimum n8n version: **1.0.0**
+- Tested with n8n version: **1.70.0**
+
+## Usage
+
+### Example: Get New Errands
+
+1. Add **Cention Trigger** node
+2. Select **New Errand** operation
+3. Connect your credentials
+4. Set polling interval
+5. Process new errands in your workflow
+
+### Example: Create Errand from Email
+
+1. **Email Trigger** → Receives email
+2. **Cention Node** → Create Errand
+   - Resource: `Errand`
+   - Operation: `Create`
+   - From Email: `{{$json.from}}`
+   - From Name: `{{$json.fromName}}`
+   - Body: `{{$json.text}}`
+
+### Example: Update Contact Card
+
+1. **Webhook** → Receives contact data
+2. **Cention Node** → Get Contact Card
+   - Resource: `Contact Card`
+   - Operation: `Get Many`
+   - Filter By: `Email`
+   - Email: `{{$json.email}}`
+
+## 📚 Workflow Documentation
+
+We've created comprehensive guides to help you get started:
+
+- **[Workflow Comparison & Use Cases](./WORKFLOWS_COMPARISON.md)** - Compare with Zendesk and see 10+ real-world workflow patterns
+- **[Ready-to-Use Templates](./WORKFLOW_TEMPLATES.md)** - Copy-paste workflow configurations for common scenarios
+
+### Popular Workflows:
+- ✉️ Email/Social Media → Cention Errand Creation
+- 🎯 Auto-assignment based on keywords
+- ⏰ SLA monitoring & escalation
+- 🤖 AI-powered response suggestions
+- 📊 Daily performance reports
+- 😊 Automated CSAT surveys
+- 🔄 CRM synchronization
+- 📢 Proactive customer notifications
+
+## 📚 Documentation & Comparisons
+
+- **[Zendesk Comparison](./ZENDESK_COMPARISON.md)** - Detailed comparison with Zendesk n8n node (actual operations, not just marketing)
+- **[Workflow Templates](./WORKFLOW_TEMPLATES.md)** - Ready-to-use workflow configurations  
+- **[Use Cases & Patterns](./WORKFLOWS_COMPARISON.md)** - Real-world workflow examples
+
+### Key Differentiators vs Zendesk:
+- ✅ **Knowledge Base Integration** (Library Questions)
+- ✅ **Real-Time Chat** (Chat Messages API)
+- ✅ **Agent Presence Management** (Set status, track availability)
+- ✅ **Advanced Reporting** (Statistics, SLA tracking, performance metrics)
+- ✅ **Multi-Channel Management** (Unified channel API)
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Cention Documentation](https://cention.com/docs/)
+- [Cention API Documentation](https://cention.com/docs/api/)
+
+## License
+
+[MIT](LICENSE.md)
+
+## Support
+
+For issues or questions:
+- GitHub Issues: [https://github.com/cention/n8n-nodes-cention/issues](https://github.com/cention/n8n-nodes-cention/issues)
+- Cention Support: [support@cention.com](mailto:support@cention.com)

package/dist/credentials/CentionApi.credentials.d.ts

@@ -0,0 +1,11 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class CentionApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}
+export default CentionApi;
+//# sourceMappingURL=CentionApi.credentials.d.ts.map

package/dist/credentials/CentionApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CentionApi.credentials.d.ts","sourceRoot":"","sources":["../../credentials/CentionApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,qBAAa,UAAW,YAAW,eAAe;IACjD,IAAI,SAAgB;IAEpB,WAAW,SAAiB;IAE5B,gBAAgB,SAAa;IAE7B,UAAU,EAAE,eAAe,EAAE,CA6B3B;IAEF,YAAY,EAAE,oBAAoB,CAShC;IAEF,IAAI,EAAE,sBAAsB,CAS1B;CACF;AAED,eAAe,UAAU,CAAC"}

package/dist/credentials/CentionApi.credentials.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CentionApi = void 0;
+class CentionApi {
+    constructor() {
+        this.name = 'centionApi';
+        this.displayName = 'Cention API';
+        this.documentationUrl = 'cention';
+        this.properties = [
+            {
+                displayName: 'Instance URL',
+                name: 'instanceUrl',
+                type: 'string',
+                description: 'The URL of your Cention API',
+                default: 'https://apid.cention.com',
+                required: true,
+            },
+            {
+                displayName: 'Workspace',
+                name: 'workspace',
+                type: 'string',
+                description: 'Your Cention workspace name (found in your Cention URL)',
+                placeholder: 'demo',
+                default: '',
+                required: true,
+            },
+            {
+                displayName: 'API Token (JWT)',
+                name: 'apiToken',
+                type: 'string',
+                description: 'The JWT token created in Cention Admin > API Settings',
+                default: '',
+                typeOptions: {
+                    password: true,
+                },
+                required: true,
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiToken}}',
+                    'Content-Type': 'application/vnd.api+json',
+                    'Accept': 'application/vnd.api+json',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.instanceUrl}}',
+                url: '=/s/{{$credentials.workspace}}/capi/json/c3_errand_reports',
+                method: 'GET',
+                qs: {
+                    'page[limit]': 1,
+                },
+            },
+        };
+    }
+}
+exports.CentionApi = CentionApi;
+exports.default = CentionApi;
+//# sourceMappingURL=CentionApi.credentials.js.map

package/dist/credentials/CentionApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CentionApi.credentials.js","sourceRoot":"","sources":["../../credentials/CentionApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,UAAU;IAAvB;QACC,SAAI,GAAG,YAAY,CAAC;QAEpB,gBAAW,GAAG,aAAa,CAAC;QAE5B,qBAAgB,GAAG,SAAS,CAAC;QAE7B,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;gBAC1C,OAAO,EAAE,0BAA0B;gBACnC,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,iBAAiB;gBAC9B,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;gBACpE,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,mCAAmC;oBAClD,cAAc,EAAE,0BAA0B;oBAC1C,QAAQ,EAAE,0BAA0B;iBACpC;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,+BAA+B;gBACxC,GAAG,EAAE,4DAA4D;gBACjE,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE;oBACH,aAAa,EAAE,CAAC;iBAChB;aACD;SACD,CAAC;IACH,CAAC;CAAA;AA3DD,gCA2DC;AAED,kBAAe,UAAU,CAAC"}

package/dist/nodes/Cention/AgentPresenceDescription.d.ts

@@ -0,0 +1,4 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const agentPresenceOperations: INodeProperties[];
+export declare const agentPresenceFields: INodeProperties[];
+//# sourceMappingURL=AgentPresenceDescription.d.ts.map

package/dist/nodes/Cention/AgentPresenceDescription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPresenceDescription.d.ts","sourceRoot":"","sources":["../../../nodes/Cention/AgentPresenceDescription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,uBAAuB,EAAE,eAAe,EAqBpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,eAAe,EA+DhD,CAAC"}

package/dist/nodes/Cention/AgentPresenceDescription.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentPresenceFields = exports.agentPresenceOperations = void 0;
+exports.agentPresenceOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['agentPresence'],
+            },
+        },
+        options: [
+            {
+                name: 'Set',
+                value: 'set',
+                description: 'Set agent presence status',
+                action: 'Set agent presence status',
+            },
+        ],
+        default: 'set',
+    },
+];
+exports.agentPresenceFields = [
+    /* -------------------------------------------------------------------------- */
+    /*                          agentPresence:set                                 */
+    /* -------------------------------------------------------------------------- */
+    {
+        displayName: 'Status',
+        name: 'status',
+        type: 'options',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['agentPresence'],
+                operation: ['set'],
+            },
+        },
+        options: [
+            {
+                name: 'Available',
+                value: 'available',
+                description: 'Agent is available to take errands',
+            },
+            {
+                name: 'Busy',
+                value: 'busy',
+                description: 'Agent is busy',
+            },
+            {
+                name: 'Away',
+                value: 'away',
+                description: 'Agent is away',
+            },
+            {
+                name: 'Offline',
+                value: 'offline',
+                description: 'Agent is offline',
+            },
+        ],
+        default: 'available',
+        description: 'The presence status to set for the agent',
+    },
+    {
+        displayName: 'Additional Fields',
+        name: 'additionalFields',
+        type: 'collection',
+        placeholder: 'Add Field',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['agentPresence'],
+                operation: ['set'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Message',
+                name: 'message',
+                type: 'string',
+                default: '',
+                description: 'Optional status message',
+                placeholder: 'In a meeting',
+            },
+        ],
+    },
+];
+//# sourceMappingURL=AgentPresenceDescription.js.map

package/dist/nodes/Cention/AgentPresenceDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPresenceDescription.js","sourceRoot":"","sources":["../../../nodes/Cention/AgentPresenceDescription.ts"],"names":[],"mappings":";;;AAEa,QAAA,uBAAuB,GAAsB;IACzD;QACC,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,SAAS;QACf,gBAAgB,EAAE,IAAI;QACtB,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,eAAe,CAAC;aAC3B;SACD;QACD,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,2BAA2B;gBACxC,MAAM,EAAE,2BAA2B;aACnC;SACD;QACD,OAAO,EAAE,KAAK;KACd;CACD,CAAC;AAEW,QAAA,mBAAmB,GAAsB;IACrD,gFAAgF;IAChF,gFAAgF;IAChF,gFAAgF;IAChF;QACC,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,eAAe,CAAC;gBAC3B,SAAS,EAAE,CAAC,KAAK,CAAC;aAClB;SACD;QACD,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,WAAW;gBAClB,WAAW,EAAE,oCAAoC;aACjD;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,eAAe;aAC5B;YACD;gBACC,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,eAAe;aAC5B;YACD;gBACC,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,kBAAkB;aAC/B;SACD;QACD,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,0CAA0C;KACvD;IACD;QACC,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,EAAE;QACX,cAAc,EAAE;YACf,IAAI,EAAE;gBACL,QAAQ,EAAE,CAAC,eAAe,CAAC;gBAC3B,SAAS,EAAE,CAAC,KAAK,CAAC;aAClB;SACD;QACD,OAAO,EAAE;YACR;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,yBAAyB;gBACtC,WAAW,EAAE,cAAc;aAC3B;SACD;KACD;CACD,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Cention implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+export default Cention;
+//# sourceMappingURL=Cention.node.d.ts.map

package/dist/nodes/Cention/Cention.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cention.node.d.ts","sourceRoot":"","sources":["../../../nodes/Cention/Cention.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EAEjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAYtB,qBAAa,OAAQ,YAAW,SAAS;IACxC,WAAW,EAAE,oBAAoB,CA+E/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CA+xBvE;AAED,eAAe,OAAO,CAAC"}