cention

n8n node for Cention - Customer Service Platform Integration

Package Information

Downloads: 1,249 weekly / 1,249 monthly
Latest Version: 1.3.0
Author: Cention

Documentation

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 AdministrationAPIAccess 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:

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

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

📖 Additional Documentation

License

MIT

Support

For issues or questions:

Discussion