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?

Features

Base Resources (Chatwoot & NooviChat compatible)

⭐ 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.

📅 Follow-ups & Activities

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

🎯 Lead Scoring

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

📣 Campaigns

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

⏱ SLA Policies

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

💬 WhatsApp / WAHA Session Management

Manage WhatsApp sessions directly from your n8n workflows. Monitor connection status, reconnect automatically and configure 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

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

Resources

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

License

MIT — see LICENSE for details.

Support

• Issues: GitHub Issues
• Email: contato@nooviai.com
• Website: nooviai.com