confirmx

n8n community nodes for the ConfirmX WhatsApp Business Platform Public REST API. Ships a Message node (start conversation with a template, send text/media) and a ConfirmX AI Agent node, both eligible as AI Agent tools via n8n's usableAsTool.

Package Information

Released: 3 mo ago
Downloads: 434 weekly / 5,060 monthly
Latest Version: 0.2.1
Author: wesell

Available Nodes

ConfirmX Message icon
ConfirmX Message
Send a WhatsApp message: start a new conversation with an approved template, or send free-form text / media inside an open conversation.
ConfirmX AI Agent icon
ConfirmX AI Agent
Delegate a task to ConfirmX's server-side AI agent. Give it a system prompt (its instructions) and an input payload; it runs a tool-enabled reasoning loop on ConfirmX and returns `output` (its final answer — a JSON object when an Output Schema is given, otherwise text), plus `toolCalls`, `iterations`, and token `usage`. Use for order-confirmation reasoning, extracting/normalising fields from a customer message, or fuzzy-matching values against a known list.

Documentation

@wesell/n8n-nodes-confirmx

n8n community nodes for the ConfirmX WhatsApp Business Platform. Wraps the public REST API at /api/v1/* and exposes each operation as both a regular n8n action and an AI-callable tool for n8n's AI Agent node.

What's included

Node Operations AI tool?
ConfirmX Message Start Conversation (send template), Send Text, Send Media all 3
ConfirmX AI Agent Run ConfirmX's server-side AI agent over a payload ✅

The ConfirmX AI Agent node has usableAsTool: true, so n8n's native AI Agent node can attach it as a tool and delegate subtasks (order-confirmation reasoning, field extraction, fuzzy matching) to ConfirmX's own agent runtime. It calls POST /api/v1/ai-agent/run, uses the org's default LLM provider unless you pin one, and is metered by token usage against the org wallet.

Setup

  1. In ConfirmX: Settings → API Keys → Create. Copy the key (cfx_live_… for production, cfx_test_… for local).
  2. In n8n: Settings → Community Nodes → Install → pick @confirmx/n8n-nodes-confirmx.
  3. Add the ConfirmX API credential: paste your key + the base URL (https://app.confirmx.com/api/v1 or http://localhost:3001/api/v1).
  4. Drop any ConfirmX node into your flow.

Local install (for development)

git clone https://github.com/ConfirmX/n8n-nodes-confirmx
cd n8n-nodes-confirmx
npm install
npm run build
npm link
# in your n8n home:
npm link @wesell/n8n-nodes-confirmx
# restart n8n

Using as AI Agent tools

Every node with usableAsTool: true shows up in n8n's AI Agent "Tools" picker. The descriptions are written in-house to be LLM-friendly — they tell the model when to use the tool, what params it needs, and what it returns. Examples:

  • Send Text: "Send a free-form text message in an existing conversation. Use ONLY when the conversation is open (within 24h of the customer's last inbound message); otherwise use startConversation with a template."
  • ConfirmX AI Agent: "Delegate a task to ConfirmX's server-side AI agent. Give it a system prompt and an input payload; it runs a tool-enabled reasoning loop and returns output (JSON when an Output Schema is given, else text) plus token usage."

Scopes

The ConfirmX API key you paste must have the appropriate scope(s). The scope picker in ConfirmX exposes templates:read|write, conversations:read|write, messages:read|write, webhooks:read|write, shipping_zones:read, ai_agent:run, plus * (full org access). The Message node needs messages:write; the AI Agent node needs ai_agent:run (both included in *).

Billing

The ConfirmX API metered every v1 call against the org's wallet:

  • Writes (POST/PUT/PATCH/DELETE): metered (default $0.0005) — e.g. sending a message.
  • AI Agent runs: metered by token usage (prompt + completion) against the provider's price catalog, not the flat write price.

When the wallet runs low, the API returns 402 Payment Required. The n8n node surfaces this as a NodeOperationError with the balance figures and the topup URL inline.

What this package does NOT include

  • Template / conversation / account / webhook CRUD nodes (use the REST API directly).
  • A ConfirmX webhook trigger (inbound events) — this build is send + AI-agent only.
  • E-commerce platform integrations — separate concern.

License

MIT © ConfirmX

Discussion