n8n-nodes-cention

This is an n8n community node for integrating with Cention - a comprehensive customer service platform.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources

Installation

Follow the installation guide 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:

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. Instance URL - Your Cention API URL (default: https://apidqa.cention.com for QA)
2. Workspace - Your Cention workspace name
3. API Token - JWT token from Cention Admin

⚠️ Critical: JWT Token Channel Type

IMPORTANT: The channel type in your JWT token determines how errands are created.

• ✅ Use Email or Form channel - Recommended (errands stay open)
• ❌ Avoid WhatsApp channel - Causes nil pointer errors

See JWT_TOKEN_SETUP.md for detailed setup instructions.

How to get your credentials:

1. Log in to your Cention Admin panel
2. Go to Administration → API → Access Tokens
3. Create a new API Token (JWT)
   • Channel: Select Email or Form (NOT WhatsApp)
   • Area: Select your target area
   • Permissions: Enable "Create Errand" (EData, EStatus)
4. Copy the Token immediately
5. Note your Workspace name (visible in the URL: /s/{workspace}/)

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 - Compare with Zendesk and see 10+ real-world workflow patterns
• Ready-to-Use Templates - 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 - Detailed comparison with Zendesk n8n node (actual operations, not just marketing)
• Workflow Templates - Ready-to-use workflow configurations
• Use Cases & Patterns - 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
• Cention Documentation
• Cention API Documentation

📖 Additional Documentation

• JWT_TOKEN_SETUP.md - ⚠️ CRITICAL: JWT token setup guide (READ THIS FIRST!)
• KNOWN_ISSUES_AND_SOLUTIONS.md - All known issues and their solutions
• UPDATE_IN_N8N.md - How to update the node in n8n
• POLLING_OPTIMIZED.md - Polling trigger optimization details

License

MIT

Support

For issues or questions:

• GitHub Issues: https://github.com/cention/n8n-nodes-cention/issues
• Cention Support: [email protected]