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.

$3

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-cention
4. Click Install

$3

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:

$3

- 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

$3

- Get - Retrieve a specific contact
- Get Many - List contacts with filters (email, name)

$3

- Get - Retrieve a specific knowledge base article
- Get Many - List all articles
- Search - Search articles by question/answer

$3

- Get Many - Retrieve chat messages with filters (email, date range)

$3

- Set - Set agent status (available, busy, away, offline)

$3

- Get - Retrieve reports (Errand Summary, Agent Performance, Response Time, SLA Compliance, Channel Distribution)

$3

- Get - Retrieve a specific channel
- Get Many - List all channels with filters

$3

- 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

$3

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.

$3

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

$3

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

$3

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}}

$3

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

$3

- ✉️ 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

$3

- ✅ 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: support@cention.com