n8n-nodes-noovichat

n8n community node for NooviChat — the most complete n8n integration for Chatwoot-based platforms, with exclusive CRM, sales pipeline, lead scoring and WhatsApp automation features.

Works with Chatwoot too. This node is fully compatible with standard Chatwoot installations. All base resources (Conversations, Contacts, Messages, Inboxes, Agents, Teams, Labels, etc.) work out of the box with any Chatwoot instance. NooviChat is an enhanced fork of Chatwoot — if you use Chatwoot, you get all the base features. If you use NooviChat, you also unlock the exclusive features below.

Why NooviChat instead of other Chatwoot nodes?

| Feature | Other Chatwoot nodes | This node | |---------|---------------------|-----------| | Conversations, Contacts, Messages | ✅ | ✅ | | Inboxes, Agents, Teams, Labels | ✅ | ✅ | | Canned Responses, Custom Attributes, Webhooks | ✅ | ✅ | | Sales Pipeline & Cards | ❌ | ✅ | | Follow-ups & Templates | ❌ | ✅ | | Lead Scoring | ❌ | ✅ | | Activities | ❌ | ✅ | | Campaigns (one-off & ongoing) | ❌ | ✅ | | SLA Policies & Metrics | ❌ | ✅ | | WhatsApp/WAHA Session Management | ❌ | ✅ | | 20 webhook trigger events | ❌ (4–6 events) | ✅ | | Pipeline & Card webhook events | ❌ | ✅ | | Bulk operations (update, move, delete) | ❌ | ✅ | | Pipeline analytics (win rate, velocity, conversion) | ❌ | ✅ |

Features

Base Resources (Chatwoot & NooviChat compatible)

| Resource | Operations | |----------|------------| | Conversation | Create, Get, Get Many, Update, Delete, Assign, Toggle Status, Add Label, Filter | | Message | Send (text / template / attachment), Get Many, Delete | | Contact | Create, Get, Get Many, Update, Delete, Search, Filter, Merge, Get Conversations | | Inbox | Create, Get, Get Many, Update, Delete, Get Agents, Update Agents | | Agent | Create, Get Many, Update, Delete | | Team | Create, Get Many, Update, Delete, Get Members, Add Members | | Label | Create, Get Many, Update, Delete | | Canned Response | Create, Get Many, Delete | | Custom Attribute | Create, Get Many, Update, Delete | | Webhook | Create, Get Many, Update, Delete |

⭐ Exclusive NooviChat Features

These resources are not available in Chatwoot and are unique to NooviChat. They power a full CRM and sales automation layer on top of the customer engagement platform.

🏆 Sales Pipeline & Cards

Full CRM pipeline management directly from n8n. Create pipelines, manage stages, move cards through the funnel and track every interaction.

| Resource | Operations | |----------|------------| | Pipeline | Create, Get, Get Many, Update, Delete · Stage CRUD · Stage Reorder · Analytics: dashboard, win rate, conversion rate, velocity, team performance, lost reasons | | Card | Create, Get, Get Many, Update, Delete · Move to Stage · Mark Won / Lost / Reopen · Get Timeline · Bulk Update · Bulk Move · Bulk Delete |

📅 Follow-ups & Activities

Never miss a follow-up again. Schedule tasks, track activities and automate reminders tied to cards and conversations.

| Resource | Operations | |----------|------------| | Follow-up | Create, Get, Get Many, Update, Delete, Cancel · Template CRUD · Template Preview | | Activity | Create, Get, Get Many, Update, Delete · Start · Complete · Cancel · Get Analytics |

🎯 Lead Scoring

Score contacts automatically based on rules and conditions. Build rule-based scoring engines and monitor results via dashboard.

| Resource | Operations | |----------|------------| | Lead Scoring | Create Rule · Get Many Rules · Update Rule · Delete Rule · Create Defaults · Get Dashboard |

📣 Campaigns

Send targeted messages at scale. Supports both one-off blasts and ongoing automated campaigns.

| Resource | Operations | |----------|------------| | Campaign | Create, Get, Get Many, Update, Delete, Pause, Resume (one_off and ongoing types) |

⏱ SLA Policies

Define, monitor and export SLA compliance metrics. Set resolution and first-response time targets per inbox.

| Resource | Operations | |----------|------------| | SLA | Create Policy · Get Policy · Get Many Policies · Update Policy · Delete Policy · Get Applied · Get Metrics · Export CSV |

💬 WhatsApp / WAHA Session Management

Manage WhatsApp sessions directly from your n8n workflows. Monitor connection status, reconnect automatically and configure Meta tracking.

| Resource | Operations | |----------|------------| | WAHA | Get Status · Refresh QR · Start · Stop · Reconnect · Disconnect · Update Config · Get Settings · Update Meta Tracking |

Trigger Node

Automatically registers and removes webhooks via the NooviChat API when you activate/deactivate a workflow. Supports 20 events — far more than any existing Chatwoot node.

Standard events (Chatwoot compatible): conversation_created, conversation_status_changed, conversation_updated, conversation_typing_on, conversation_typing_off, message_created, message_updated, contact_created, contact_updated, webwidget_triggered

⭐ Exclusive NooviChat events: pipeline_card_created, pipeline_card_updated, pipeline_card_stage_changed, pipeline_card_won, pipeline_card_lost, follow_up_due, follow_up_overdue, activity_due, sla_breach, waha_status_changed

Optional filters by Inbox ID, Team ID, and Pipeline ID. Optional webhook signature validation via shared secret.

Installation

Via n8n Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Click Install
3. Enter @nooviai/n8n-nodes-noovichat
4. Click Install

Via npm (self-hosted n8n)

npm install @nooviai/n8n-nodes-noovichat

Restart n8n after installing for the node to appear.

Docker self-hosted

Install inside the running container:

docker exec -it <n8n_container> npm install @nooviai/n8n-nodes-noovichat
docker restart <n8n_container>

Or add to your docker-compose.yml with a custom extensions volume:

environment:
  - N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
volumes:
  - n8n_custom:/home/node/.n8n/custom

Verifying the installation

After restarting n8n, search for "NooviChat" in the node selector. If it doesn't appear, check the n8n logs:

docker logs <n8n_container> | grep -i noovichat

Troubleshooting

See TROUBLESHOOTING.md for a full guide covering:

• Field mapping reference (camelCase UI → snake_case API)
• API compatibility matrix (NooviChat version vs node version)
• Common errors and solutions (401, 404, 422, webhook issues)

Configuration

Credentials — NooviChat API

1. Go to Credentials > Add Credential > search NooviChat API
2. Fill in:
   • Base URL — Your NooviChat instance (e.g. https://chat.yourdomain.com)
   • API Access Token — Found in NooviChat under Settings > Account Settings

Note: Account ID is configured per node instance (not in credentials), which allows you to use expressions for multi-account workflows.

Credentials — NooviChat Webhook API (optional)

Used only with the NooviChat Trigger node to validate incoming webhook signatures.

1. Add Credential > search NooviChat Webhook API
2. Fill in Webhook Secret — The same secret you configure in NooviChat webhooks settings

Workflow Examples

1. Lead Qualification Automation

Trigger: NooviChat Trigger — Contact Created
  → NooviChat — Card: Create (in "Leads" pipeline)
  → NooviChat — Follow-up: Create (due in 3 days)
  → NooviChat — Card: Get Lead Score
  → IF score >= 70
    → NooviChat — Card: Move to Stage ("Qualified")
    → NooviChat — Conversation: Assign (to Sales team)
  → ELSE
    → NooviChat — Conversation: Add Label ("nurturing")

2. Automatic Follow-up

Trigger: NooviChat Trigger — Follow-up Due
  → NooviChat — Conversation: Get
  → IF last message older than 24h
    → NooviChat — Message: Send (template "follow_up_24h")
    → NooviChat — Follow-up: Create (due in 48h)
  → ELSE
    → NooviChat — Follow-up: Cancel

3. Pipeline + WhatsApp (Card Won)

Trigger: NooviChat Trigger — Card Won
  → NooviChat — Contact: Get (contact linked to card)
  → NooviChat — Message: Send ("Congratulations! Your order was confirmed.")
  → NooviChat — Conversation: Add Label ("active-client")
  → NooviChat — Conversation: Toggle Status (resolved)

4. WAHA Session Monitoring

Schedule Trigger: Every 5 minutes
  → NooviChat — WAHA: Get Status (your WhatsApp inbox)
  → IF status != "WORKING"
    → NooviChat — WAHA: Reconnect
    → Wait: 30 seconds
    → NooviChat — WAHA: Get Status again
    → IF still != "WORKING"
      → Slack — Send message to #alerts: "WAHA disconnected on inbox X"

5. Weekly SLA Report

Schedule Trigger: Every Monday at 9am
  → NooviChat — SLA: Get Metrics (last 7 days)
  → IF hit_rate < 80%
    → Email — Send report to manager
    → NooviChat — Activity: Create ("Review SLA compliance")

Development

# Clone
git clone https://github.com/Noovi-AI/n8n-nodes-noovichat.git
cd n8n-nodes-noovichat

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Lint
npm run lint

# Tests
npm test
npm test -- --coverage

Local Testing with n8n

# Build
npm run build

# Link package globally
npm link

# In your n8n directory
npm link @nooviai/n8n-nodes-noovichat

Compatibility

| Requirement | Version | |-------------|---------| | n8n | >= 1.0.0 | | Node.js | >= 18.0.0 | | NooviChat API | >= v4.10.0 |

Resources

• NooviChat Documentation
• NooviChat API Reference
• n8n Community Nodes Guide
• n8n Documentation

License

MIT — see LICENSE for details.

Support

• Issues: GitHub Issues
• Email: [email protected]
• Website: nooviai.com