Description

n8n-nodes-noovichat


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

> Works with supported Chatwoot-compatible APIs too. Base operations (Conversations, Contacts, Messages, Inboxes, Agents, Teams, Labels, etc.) target the Chatwoot API shape. NooviChat-only resources require NooviChat.

—

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 | ❌ | ✅ |
| Expanded 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 (oneoff 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 base Chatwoot events plus NooviChat pipeline, follow-up, broadcast, appointment, SLA and WAHA events.

Standard events (Chatwoot compatible):
conversationcreated, conversationstatuschanged, conversationupdated, conversationtypingon, conversationtypingoff, messagecreated, messageupdated, contactcreated, contactupdated, webwidget_triggered

⭐ Exclusive NooviChat events:
pipelinecardcreated, pipelinecardupdated, pipelinecardstagechanged, pipelinecardwon, pipelinecardlost, followupdue, followupoverdue, activitydue, slabreach, wahastatus_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  npm install @nooviai/n8n-nodes-noovichat
docker restart 

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

environment:
  - N8NCUSTOMEXTENSIONS=/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  | 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 "followup24h")
    → 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: contato@nooviai.com
• Website: noovichat.com