n8n-nodes-agilepulse

Custom n8n community node for AgilePulse — multi-tenant WhatsApp gateway with built-in anti-ban (rate limits, warm-up curves, replyOnly, auto-pause), HMAC-signed webhooks, and S3/local media storage.

What it gives you in n8n

Two nodes:

• AgilePulse WhatsApp (action) — send messages, manage groups, configure webhooks, query session info.
• AgilePulse Trigger — receive WhatsApp events (incoming messages, connection updates, QR refreshes, etc.) and start workflows automatically. The trigger registers its webhook URL against AgilePulse on activation and clears it on deactivation.

Action node — 4 resources and 22 operations:

• Message: sendText (with quote), sendMedia (img/video/doc/audio), sendAudio (PTT voice), sendReaction, sendLocation, sendContact, markAsRead, edit, delete, presence
• Group: list joined, get info, create, add/remove participants, get invite link, leave
• Webhook: set / find / getSecret / rotateSecret
• Session: connectionInfo, status, contacts, reconnect

Plus reusable AgilePulse API credentials (base URL + apikey, with /api/health connection test).

Install

From n8n UI (once published to npm)

1. Settings → Community Nodes → Install
2. Type n8n-nodes-agilepulse
3. Click Install. Restart n8n.

Locally for development

cd n8n-nodes-agilepulse
npm install
npm run build
# In your n8n install, link or copy the dist/ output into custom nodes folder.
# See https://docs.n8n.io/integrations/creating-nodes/test/run-node-locally/

Configure credentials

In n8n: Credentials → Add → AgilePulse API:

• Base URL: http://localhost:4000 (or your production URL, no trailing slash)
• API Key: paste either your master key or a session-scoped key (find session keys in AgilePulse dashboard → session → Integration tab → "API Key")

n8n will auto-test by calling GET /api/health.

Use the node

1. Add the AgilePulse WhatsApp node to your workflow
2. Pick a Resource (Message / Group / Webhook / Session)
3. Pick an Operation
4. Set Session to either the slug (agile) or UUID — both resolve correctly
5. Fill the operation-specific fields (To, Text, Media URL, etc.)

Receiving messages (incoming flow)

This node only handles outbound calls. To receive WhatsApp events in n8n:

1. Use the built-in Webhook trigger node, copy its production URL
2. Use this node with Webhook → Set operation to register that URL in AgilePulse
3. Trigger on every inbound WhatsApp message

A ready-to-import workflow is in examples/n8n/agilepulse-echo-bot.json.

Publish to npm (when ready)

npm version 0.1.0
npm publish --access public

The package name n8n-nodes-agilepulse matches the n8n community node convention so it auto-shows in the registry.