@wesell/n8n-nodes-confirmx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ConfirmX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @wesell/n8n-nodes-confirmx
+
+n8n community nodes for the [ConfirmX](https://confirmx.app) WhatsApp Business Platform. Wraps the public REST API at `/api/v1/*` and exposes every 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 Trigger** | webhook receive (5 event types) | — |
+| **ConfirmX Account** | List | ✅ |
+| **ConfirmX Template** | List, Get, Create, Delete | List + Get |
+| **ConfirmX Conversation** | List, Get, Mark Read, Update Status, Assign | all 5 |
+| **ConfirmX Message** | Send Text, Send Media, Start Conversation, List Messages, Retry | all 5 |
+| **ConfirmX Webhook** | List, Create, Update, Delete | — (admin) |
+| **ConfirmX ShippingZone** | Match (Egyptian governorate + area fuzzy match), List Governorates | Match |
+
+## 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)
+
+```bash
+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
+```
+
+## How the trigger works
+
+The **ConfirmX Trigger** registers itself. When you add it to a flow and pick which events to subscribe to (default `message.received`), the trigger:
+
+1. Reads the per-flow webhook URL that n8n provides.
+2. `POST /api/v1/webhooks` with `{ url, events, description: "n8n integration" }`.
+3. Persists the returned `secret` in workflow staticData (this is required — `GET /webhooks/:id` does **not** return the secret).
+4. On every incoming delivery, verifies the `X-ConfirmX-Signature` HMAC against `${timestamp}.${body}`, rejects timestamps > 300s old, and emits the envelope's `data` field as the n8n item.
+5. On flow deletion/deactivation, `DELETE /webhooks/:id` cleans up.
+
+## 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."*
+- **Match (ShippingZone)**: *"Fuzzy-match an Egyptian governorate and (optionally) area from free-text customer input (Arabic or English, with typos / aliases tolerated). … On ambiguous area returns `options[]` — present those options to the user and call again with the chosen governorate."*
+
+## 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`, plus `*` (full org access). The shipping-zone matcher is gated by `shipping_zones:read` (included in `*` for backwards compatibility).
+
+## Billing
+
+The ConfirmX API metered every v1 call against the org's wallet:
+
+- Reads (GET): cheap (default $0.0001)
+- Writes (POST/PUT/PATCH/DELETE): metered (default $0.0005)
+- Webhook deliveries to your n8n instance: $0.0002 on 2xx
+
+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. Webhook CRUD endpoints are free.
+
+## What this package does NOT include
+
+- The ConfirmX internal `ai_agent` workflow node (separate runtime, internal billing model).
+- Outbound webhooks from the ConfirmX admin side.
+- Polling trigger mode (webhook-only).
+- E-commerce platform integrations — separate concern.
+
+## License
+
+MIT © ConfirmX

package/credentials/ConfirmXApi.credentials.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ConfirmX API credentials — a single API key + base URL is all that's
+ * needed to authenticate every ConfirmX node in this package.
+ *
+ * - `apiKey`: the plaintext key from Settings → API Keys. Format
+ *   `cfx_live_...` for production, `cfx_test_...` for local dev. The
+ *   server hashes with a pepper before lookup, so we never log or store
+ *   the plaintext ourselves.
+ * - `baseUrl`: full base URL of the v1 API including the `/api/v1` suffix.
+ *   Defaults are provided for hosted production and local dev.
+ */
+import type { ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ConfirmXApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/credentials/ConfirmXApi.credentials.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmXApi = void 0;
+class ConfirmXApi {
+    constructor() {
+        this.name = 'confirmXApi';
+        this.displayName = 'ConfirmX API';
+        this.documentationUrl = 'https://docs.confirmx.app/public-api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your ConfirmX API key. Create one in Settings → API Keys. Format: cfx_live_... (production) or cfx_test_... (local).',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://app.confirmx.com/api/v1',
+                required: true,
+                description: 'Base URL of the ConfirmX v1 API (including the /api/v1 suffix). For local dev: http://localhost:3001/api/v1.',
+            },
+        ];
+    }
+}
+exports.ConfirmXApi = ConfirmXApi;
+//# sourceMappingURL=ConfirmXApi.credentials.js.map

package/credentials/ConfirmXApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmXApi.credentials.js","sourceRoot":"","sources":["ConfirmXApi.credentials.ts"],"names":[],"mappings":";;;AAaA,MAAa,WAAW;IAAxB;QACE,SAAI,GAAG,aAAa,CAAA;QACpB,gBAAW,GAAG,cAAc,CAAA;QAC5B,qBAAgB,GAAG,sCAAsC,CAAA;QAEzD,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EACT,sHAAsH;aACzH;YACD;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,iCAAiC;gBAC1C,QAAQ,EAAE,IAAI;gBACd,WAAW,EACT,8GAA8G;aACjH;SACF,CAAA;IACH,CAAC;CAAA;AA1BD,kCA0BC"}

package/credentials/ConfirmXApi.credentials.ts

@@ -0,0 +1,40 @@
+/**
+ * ConfirmX API credentials — a single API key + base URL is all that's
+ * needed to authenticate every ConfirmX node in this package.
+ *
+ * - `apiKey`: the plaintext key from Settings → API Keys. Format
+ *   `cfx_live_...` for production, `cfx_test_...` for local dev. The
+ *   server hashes with a pepper before lookup, so we never log or store
+ *   the plaintext ourselves.
+ * - `baseUrl`: full base URL of the v1 API including the `/api/v1` suffix.
+ *   Defaults are provided for hosted production and local dev.
+ */
+import type { ICredentialType, INodeProperties } from 'n8n-workflow'
+
+export class ConfirmXApi implements ICredentialType {
+  name = 'confirmXApi'
+  displayName = 'ConfirmX API'
+  documentationUrl = 'https://docs.confirmx.app/public-api'
+
+  properties: INodeProperties[] = [
+    {
+      displayName: 'API Key',
+      name: 'apiKey',
+      type: 'string',
+      typeOptions: { password: true },
+      default: '',
+      required: true,
+      description:
+        'Your ConfirmX API key. Create one in Settings → API Keys. Format: cfx_live_... (production) or cfx_test_... (local).',
+    },
+    {
+      displayName: 'Base URL',
+      name: 'baseUrl',
+      type: 'string',
+      default: 'https://app.confirmx.com/api/v1',
+      required: true,
+      description:
+        'Base URL of the ConfirmX v1 API (including the /api/v1 suffix). For local dev: http://localhost:3001/api/v1.',
+    },
+  ]
+}

package/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Package entry point — re-exports the 7 ConfirmX node classes and the
+ * ConfirmXApi credentials class for n8n's loader to discover.
+ *
+ * Built CJS output is emitted to ./index.js by `npm run build` (tsc).
+ */
+export { ConfirmXApi } from './credentials/ConfirmXApi.credentials';
+export { ConfirmXAccount } from './nodes/ConfirmX/ConfirmXAccount.node';
+export { ConfirmXTemplate } from './nodes/ConfirmX/ConfirmXTemplate.node';
+export { ConfirmXConversation } from './nodes/ConfirmX/ConfirmXConversation.node';
+export { ConfirmXMessage } from './nodes/ConfirmX/ConfirmXMessage.node';
+export { ConfirmXWebhook } from './nodes/ConfirmX/ConfirmXWebhook.node';
+export { ConfirmXShippingZone } from './nodes/ConfirmX/ConfirmXShippingZone.node';
+export { ConfirmXTrigger } from './nodes/ConfirmX/ConfirmXTrigger.node';

package/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmXTrigger = exports.ConfirmXShippingZone = exports.ConfirmXWebhook = exports.ConfirmXMessage = exports.ConfirmXConversation = exports.ConfirmXTemplate = exports.ConfirmXAccount = exports.ConfirmXApi = void 0;
+/**
+ * Package entry point — re-exports the 7 ConfirmX node classes and the
+ * ConfirmXApi credentials class for n8n's loader to discover.
+ *
+ * Built CJS output is emitted to ./index.js by `npm run build` (tsc).
+ */
+var ConfirmXApi_credentials_1 = require("./credentials/ConfirmXApi.credentials");
+Object.defineProperty(exports, "ConfirmXApi", { enumerable: true, get: function () { return ConfirmXApi_credentials_1.ConfirmXApi; } });
+var ConfirmXAccount_node_1 = require("./nodes/ConfirmX/ConfirmXAccount.node");
+Object.defineProperty(exports, "ConfirmXAccount", { enumerable: true, get: function () { return ConfirmXAccount_node_1.ConfirmXAccount; } });
+var ConfirmXTemplate_node_1 = require("./nodes/ConfirmX/ConfirmXTemplate.node");
+Object.defineProperty(exports, "ConfirmXTemplate", { enumerable: true, get: function () { return ConfirmXTemplate_node_1.ConfirmXTemplate; } });
+var ConfirmXConversation_node_1 = require("./nodes/ConfirmX/ConfirmXConversation.node");
+Object.defineProperty(exports, "ConfirmXConversation", { enumerable: true, get: function () { return ConfirmXConversation_node_1.ConfirmXConversation; } });
+var ConfirmXMessage_node_1 = require("./nodes/ConfirmX/ConfirmXMessage.node");
+Object.defineProperty(exports, "ConfirmXMessage", { enumerable: true, get: function () { return ConfirmXMessage_node_1.ConfirmXMessage; } });
+var ConfirmXWebhook_node_1 = require("./nodes/ConfirmX/ConfirmXWebhook.node");
+Object.defineProperty(exports, "ConfirmXWebhook", { enumerable: true, get: function () { return ConfirmXWebhook_node_1.ConfirmXWebhook; } });
+var ConfirmXShippingZone_node_1 = require("./nodes/ConfirmX/ConfirmXShippingZone.node");
+Object.defineProperty(exports, "ConfirmXShippingZone", { enumerable: true, get: function () { return ConfirmXShippingZone_node_1.ConfirmXShippingZone; } });
+var ConfirmXTrigger_node_1 = require("./nodes/ConfirmX/ConfirmXTrigger.node");
+Object.defineProperty(exports, "ConfirmXTrigger", { enumerable: true, get: function () { return ConfirmXTrigger_node_1.ConfirmXTrigger; } });
+//# sourceMappingURL=index.js.map

package/nodes/ConfirmX/ConfirmXAccount.node.d.ts

@@ -0,0 +1,5 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ConfirmXAccount implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: any): Promise<any[][]>;
+}

package/nodes/ConfirmX/ConfirmXAccount.node.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmXAccount = void 0;
+const http_1 = require("../../transports/http");
+class ConfirmXAccount {
+    constructor() {
+        this.description = {
+            displayName: 'ConfirmX Account',
+            name: 'confirmXAccount',
+            icon: 'file:confirmx.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Discover WhatsApp Business accounts linked to your ConfirmX organization. Use to look up an accountId for sending messages or managing templates.',
+            defaults: { name: 'ConfirmX Account' },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'confirmXApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'List',
+                            value: 'list',
+                            action: 'List WhatsApp accounts',
+                            description: 'List WhatsApp Business accounts linked to the current ConfirmX organization. Use when you need an `accountId` to send a template, start a conversation, or list templates — returns `id`, `label`, `phoneNumberId`, `businessAccountId`, and `isActive` for each. No required parameters.',
+                        },
+                    ],
+                    default: 'list',
+                },
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    default: false,
+                    displayOptions: { show: { operation: ['list'] } },
+                    description: 'Whether to return all results or limit the page size',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 50,
+                    typeOptions: { minValue: 1, maxValue: 200 },
+                    displayOptions: {
+                        show: { operation: ['list'], returnAll: [false] },
+                    },
+                    description: 'Maximum number of accounts to return',
+                },
+            ],
+            // Eligible as a tool for n8n AI Agent — single operation.
+            usableAsTool: true,
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            const operation = this.getNodeParameter('operation', i);
+            if (operation === 'list') {
+                const returnAll = this.getNodeParameter('returnAll', i);
+                const limit = this.getNodeParameter('limit', i) || 50;
+                const res = await (0, http_1.confirmxApiRequest)(this, {
+                    method: 'GET',
+                    endpoint: '/accounts',
+                });
+                const accounts = res.accounts || [];
+                const sliced = returnAll ? accounts : accounts.slice(0, limit);
+                const data = sliced.map((a) => ({ json: a }));
+                returnData.push(...data);
+            }
+        }
+        return [returnData];
+    }
+}
+exports.ConfirmXAccount = ConfirmXAccount;
+//# sourceMappingURL=ConfirmXAccount.node.js.map

package/nodes/ConfirmX/ConfirmXAccount.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmXAccount.node.js","sourceRoot":"","sources":["ConfirmXAccount.node.ts"],"names":[],"mappings":"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"}

package/nodes/ConfirmX/ConfirmXAccount.node.ts

@@ -0,0 +1,81 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow'
+import { confirmxApiRequest } from '../../transports/http'
+
+export class ConfirmXAccount implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: 'ConfirmX Account',
+    name: 'confirmXAccount',
+    icon: 'file:confirmx.svg',
+    group: ['transform'],
+    version: 1,
+    subtitle: '={{$parameter["operation"]}}',
+    description:
+      'Discover WhatsApp Business accounts linked to your ConfirmX organization. Use to look up an accountId for sending messages or managing templates.',
+    defaults: { name: 'ConfirmX Account' },
+    inputs: ['main'],
+    outputs: ['main'],
+    credentials: [{ name: 'confirmXApi', required: true }],
+    properties: [
+      {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        options: [
+          {
+            name: 'List',
+            value: 'list',
+            action: 'List WhatsApp accounts',
+            description:
+              'List WhatsApp Business accounts linked to the current ConfirmX organization. Use when you need an `accountId` to send a template, start a conversation, or list templates — returns `id`, `label`, `phoneNumberId`, `businessAccountId`, and `isActive` for each. No required parameters.',
+          },
+        ],
+        default: 'list',
+      },
+      {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        default: false,
+        displayOptions: { show: { operation: ['list'] } },
+        description: 'Whether to return all results or limit the page size',
+      },
+      {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        default: 50,
+        typeOptions: { minValue: 1, maxValue: 200 },
+        displayOptions: {
+          show: { operation: ['list'], returnAll: [false] },
+        },
+        description: 'Maximum number of accounts to return',
+      },
+    ],
+    // Eligible as a tool for n8n AI Agent — single operation.
+    usableAsTool: true,
+  }
+
+  async execute(this: any) {
+    const items = this.getInputData()
+    const returnData: any[] = []
+
+    for (let i = 0; i < items.length; i++) {
+      const operation = this.getNodeParameter('operation', i) as string
+      if (operation === 'list') {
+        const returnAll = this.getNodeParameter('returnAll', i) as boolean
+        const limit = (this.getNodeParameter('limit', i) as number) || 50
+        const res = await confirmxApiRequest<{ accounts: any[] }>(this, {
+          method: 'GET',
+          endpoint: '/accounts',
+        })
+        const accounts = res.accounts || []
+        const sliced = returnAll ? accounts : accounts.slice(0, limit)
+        const data = sliced.map((a) => ({ json: a }))
+        returnData.push(...data)
+      }
+    }
+
+    return [returnData]
+  }
+}

package/nodes/ConfirmX/ConfirmXConversation.node.d.ts

@@ -0,0 +1,13 @@
+import type { INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class ConfirmXConversation implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        loadOptions: {
+            getAccounts(this: any): Promise<{
+                name: string;
+                value: string;
+            }[]>;
+        };
+    };
+    execute(this: any): Promise<any[][]>;
+}