n8n-nodes-waops

Native n8n community nodes for WA Ops – the WhatsApp automation API.

Send messages, manage chats, contacts, groups, and more directly from your n8n workflows without configuring HTTP Request nodes manually.

Prerequisites

1. WA Ops account – Sign up at https://waops.app
2. Connected WhatsApp – Scan the QR code once at Connect page
3. API Key – Generate from API Keys page

⚠️ Important: QR scanning is done on the web platform, NOT inside n8n. Your API key automatically routes to your connected WhatsApp session.

Installation

Community Nodes (Recommended)

1. Go to Settings → Community Nodes in your n8n instance
2. Select Install a community node
3. Enter n8n-nodes-waops
4. Agree to the risks and click Install

Manual Installation

cd ~/.n8n/custom
npm install n8n-nodes-waops

Restart n8n after installation.

Setup

1. Open any WA Ops node in n8n
2. Click the Credential dropdown → Create New
3. Paste your API key (starts with wa_)
4. Click Save – the credential test will verify your connection

Available Operations

📨 Message

• Send Text – Send a plain text message
• Send Image – Send an image with optional caption
• Send Video – Send a video with optional caption
• Send Document – Send a file/document
• Send Audio – Send a voice/audio message
• Send Location – Send a GPS location pin
• Send Contact Card – Share a contact's vCard
• Send Poll – Create a poll with options
• React – React to a message with an emoji
• Mark as Read – Mark messages as read
• Delete – Delete a message
• Edit – Edit a sent message
• Forward – Forward a message to another chat
• Star – Star/unstar a message
• Get Messages – Retrieve message history

💬 Chat

• List All – Get all chats
• Archive – Archive/unarchive a chat
• Pin – Pin/unpin a chat
• Mute – Mute/unmute a chat
• Clear – Clear chat messages
• Set Disappearing Timer – Set message auto-delete timer

👤 Contact

• List All – Get all contacts
• Check Number – Verify if a number is on WhatsApp
• Block – Block a contact
• Unblock – Unblock a contact
• Get Blocked List – List all blocked contacts
• Get Profile Picture – Get a contact's profile picture URL

👥 Group

• List All – Get all groups
• Create – Create a new group
• Get Metadata – Get group details and participants
• Update Info – Update group name/description
• Manage Participants – Add, remove, promote, or demote members
• Get Invite Link – Get the group invite link
• Revoke Invite – Revoke and regenerate invite link
• Join via Code – Join a group using invite code
• Leave – Leave a group
• Set Picture – Set group profile picture
• Update Settings – Change who can edit info or send messages

🙍 Profile

• Get Profile – Get your WhatsApp profile
• Update Name – Change your display name
• Update Status – Change your about/status text
• Update Picture – Change your profile picture

📤 Bulk

• Send Bulk Messages – Send to multiple recipients with spintax support

🖼️ Media

• Upload Image – Send an image to a chat (from URL or base64)
• Upload Video – Send a video to a chat (from URL or base64)
• Upload Audio – Send an audio file or voice note
• Upload Document – Send a document/file
• Upload Sticker – Send a sticker
• Download – Download media from a received message
• Send Voice (TTS) – Send a pre-encoded voice message from a URL

🔌 Session

• Get Health – Check that the WaOps bridge is reachable
• Get Status – Get current session connection state
• Get QR Code – Get the latest QR code for connecting WhatsApp
• Register Webhook – Set the webhook URL for incoming events
• Get Webhook – Read the currently registered webhook
• Delete Webhook – Remove the registered webhook

🏷️ Label

• List Labels – List all WhatsApp Business labels
• Get Chats By Label – List chats tagged with a specific label

⚙️ Misc

• Reject Call – Reject an incoming WhatsApp call
• Set Default Disappearing – Set default disappearing duration for new chats
• List Bots – List WhatsApp AI/bot accounts linked to your number
• Set Global Presence – Set your global online/offline presence

Trigger Node: WA Ops Trigger

Receive real-time WhatsApp events in your workflows:

1. Add the WA Ops Trigger node to your workflow
2. Activate the workflow
3. Copy the webhook URL shown in the node
4. Go to API Keys page → Webhooks section
5. Paste the URL and select events (message.received, message.sent)
6. Send a test message to verify

Supported Events

• message.received – Incoming messages
• message.sent – Outgoing messages

Your First Workflow

Auto-Reply Bot

1. Add WA Ops Trigger node (receives messages)
2. Add IF node (check if message contains "hello")
3. Add WA Ops node → Message → Send Text
4. Set To = {{ $json.data.key.remoteJid }}
5. Set Text = Hi! Thanks for reaching out 👋
6. Activate the workflow

Troubleshooting

"Invalid API key or WhatsApp not connected"

• Verify your API key at API Keys page
• Check your WhatsApp is connected at Connect page

Duplicate messages in workflows

• If using a Trigger → HTTP Request pattern, enable Execute Once in the HTTP Request node's Settings tab
• n8n HTTP Request nodes fire once per input item – if your trigger outputs multiple items, each will trigger a separate API call

Rate limit errors (429)

• The API allows 60 requests per minute
• For bulk operations, use the dedicated Bulk → Send Bulk Messages operation which handles delays automatically
• Add a Wait node between API calls if needed

Messages not arriving

• Check the session is connected: add a WA Ops node with Chat → List All to verify connectivity
• Ensure the recipient number includes the country code (e.g., 447700900000 not 07700900000)

API Documentation

Full API documentation: https://waops.app/docs

Support

• Documentation: https://waops.app/docs
• Email: support@waops.app