n8n-nodes-wuzapi

library1.6.0jsnpmunverified

n8n community node providing 11 specialized nodes for integrating Wuzapi (multi-user, multi-device WhatsApp REST API) into n8n workflows. Current stable version 1.6.0 (released 2025), requires n8n-workflow as peer dependency and Node.js >=20.15. Supports sending/receiving messages, group management, webhooks, media handling, and admin operations. Key differentiator: native n8n integration for Wuzapi with extensive node coverage (session, message, chat, user, group, webhook, admin) via a simple REST interface, enabling complex WhatsApp automations without coding.

messaging

npm install n8n-nodes-wuzapi

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · N8N-NODES-WUZAPI

n8n-nodes-wuzapi

messagingjavascriptv1.6.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Wuzapi

✓ import { Wuzapi } from 'n8n-nodes-wuzapi'

✗ const Wuzapi = require('n8n-nodes-wuzapi').Wuzapi

ESM-only; named export. Use in n8n node environment.

WuzapiTrigger

✓ import { WuzapiTrigger } from 'n8n-nodes-wuzapi'

✗ import { WuzapiTrigger } from 'n8n-nodes-wuzapi/triggers'

Trigger node for webhook events; also ESM import from package root.

WuzapiCredentials

✓ import { WuzapiCredentials } from 'n8n-nodes-wuzapi'

✗ import WuzapiCredentials from 'n8n-nodes-wuzapi'

Named import; credentials class used in node credentials.

Shows how to import and use the Wuzapi node to send a text message in an n8n workflow. Requires Wuzapi credentials setup.

import { Wuzapi, WuzapiTrigger } from 'n8n-nodes-wuzapi'; // n8n workflow setup (pseudocode) const workflow = { nodes: [ { name: 'Wuzapi Message', type: 'n8n-nodes-wuzapi.Wuzapi', typeVersion: 1, position: [250, 300], parameters: { resource: 'message', operation: 'sendText', to: '5511999999999', message: 'Hello from n8n!' }, credentials: { wuzapiApi: 'Wuzapi Credentials' } } ] };

Debug

Known issues

breakingVersion 1.0.0 changed the credential import path from 'n8n-nodes-base' to package-specific credentials.

fix

Update credential references: use 'Wuzapi Credentials' credential type instead of generic 'HTTP Request' credentials.

affects: >=1.0.0

gotchaAll node names are prefixed with 'Wuzapi' (e.g., 'Wuzapi Message', 'Wuzapi Group'). Use the exact name in n8n workflow JSON.

fix

In workflow JSON, set 'type' to 'n8n-nodes-wuzapi.Wuzapi' (the class name, not the display name).

affects: >=0.1.0

gotchaThe 'WuzapiTrigger' node requires a webhook endpoint configured in Wuzapi; misconfiguration may cause no events to fire.

fix

Ensure Wuzapi webhook URL is set to your n8n webhook URL (including the unique ID) and events are enabled.

affects: >=0.1.0

deprecatedOld node names without prefix (e.g., 'Send Message') were deprecated in v0.5.0.

fix

Migrate to prefixed node names: 'Wuzapi Message', 'Wuzapi Group', etc.

affects: <1.0.0

gotchaThe 'node' engine requirement is >=20.15; older Node.js versions will cause runtime errors.

fix

Upgrade Node.js to version 20.15 or later.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'n8n-nodes-wuzapi'

Package not installed correctly or missing from node_modules.

fix

Install the package: `npm install n8n-nodes-wuzapi` in your n8n root, or use the community nodes UI in n8n settings.

TypeError: Cannot read properties of undefined (reading 'sendText')

Using the node without proper resource/operation parameters.

fix

Ensure the node parameters include 'resource' (e.g., 'message') and 'operation' (e.g., 'sendText').

ERR_PEER_DEP_MISSING: n8n-workflow@*

n8n-workflow peer dependency not installed.

fix

Install n8n-workflow: `npm install n8n-workflow`.

Upgrade

Version history

1.6.0latest on npm

Audit

Dependencies

n8n-workflowrequiredpeer dependency required by all n8n community nodes

Agent activity

18 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/guilhermejansen/n8n-nodes-wuzapi ↗

packagen8n-nodes-wuzapi ↗

homepagehttps://github.com/guilhermejansen/n8n-nodes-wuzapi ↗