n8n-nodes-apivault-whatsapp-validator 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+MIT License
+
+Copyright (c) 2026 Apivault
+
+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... THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

package/README.md

@@ -0,0 +1,14 @@
+# n8n-nodes-apivault-whatsapp-validator
+
+n8n community node for **Fast WhatsApp Number Validator**.
+
+Fast, 100% offline bulk phone validator. Clean phone lists before WhatsApp/SMS outreach: validity, E.164 format, country, region, carrier, line type (mobile/landline) and WhatsApp-ready flag. No login, no keys, no bans — thousands of numbers in seconds.
+
+## Install
+n8n: Settings → Community Nodes → Install → `n8n-nodes-apivault-whatsapp-validator`
+
+## Credential
+Add an **Apify API** credential with your Apify token (Apify Console → Settings → Integrations). Free account includes monthly credits.
+
+---
+Backed by the Apify Actor [`apivault_labs/whatsapp-number-validator`](https://apify.com/apivault_labs/whatsapp-number-validator).

package/dist/credentials/ApifyApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ApifyApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ApifyApi.credentials.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApifyApi = void 0;
+class ApifyApi {
+    constructor() {
+        this.name = 'apifyApi';
+        this.displayName = 'Apify API';
+        this.documentationUrl = 'https://docs.apify.com/platform/integrations/api';
+        this.properties = [
+            {
+                displayName: 'API Token',
+                name: 'apiToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your personal Apify API token (Apify Console -> Settings -> Integrations).',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: { headers: { Authorization: '=Bearer {{$credentials.apiToken}}' } },
+        };
+        this.test = { request: { baseURL: 'https://api.apify.com/v2', url: '/users/me' } };
+    }
+}
+exports.ApifyApi = ApifyApi;
+//# sourceMappingURL=ApifyApi.credentials.js.map

package/dist/credentials/ApifyApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApifyApi.credentials.js","sourceRoot":"","sources":["../../credentials/ApifyApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,QAAQ;IAArB;QACC,SAAI,GAAG,UAAU,CAAC;QAClB,gBAAW,GAAG,WAAW,CAAC;QAC1B,qBAAgB,GAAG,kDAAkD,CAAC;QACtE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,WAAW;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4EAA4E;aACzF;SACD,CAAC;QACF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,mCAAmC,EAAE,EAAE;SAC/E,CAAC;QACF,SAAI,GAA2B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;IACvG,CAAC;CAAA;AApBD,4BAoBC"}

package/dist/nodes/WhatsappValidator/WhatsappValidator.node.d.ts

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

package/dist/nodes/WhatsappValidator/WhatsappValidator.node.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsappValidator = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const ACTOR_ID = 'apivault_labs~whatsapp-number-validator';
+class WhatsappValidator {
+    constructor() {
+        this.description = {
+            displayName: 'Fast WhatsApp Number Validator',
+            name: 'whatsappValidator',
+            icon: 'file:whatsappvalidator.svg',
+            group: ['transform'],
+            version: 1,
+            description: 'Fast, 100% offline bulk phone validator. Clean phone lists before WhatsApp/SMS outreach: validity, E.164 format, country, region, carrier, line type (mobile/landline) and WhatsApp-ready flag. No login, no keys, no bans — thousands of numbers in seconds.',
+            defaults: { name: 'Fast WhatsApp Number Validator' },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [{ name: 'apifyApi', required: true }],
+            properties: [
+                {
+                    "displayName": "Phone numbers",
+                    "name": "phoneNumbers",
+                    "description": "Phone numbers to validate (one per line). Include the country code with a leading + when possible, e.g. +14155552671. Numbers without a + are parsed using the Default country below. (comma or new-line separated)",
+                    "type": "string",
+                    "default": "",
+                    "required": true
+                },
+                {
+                    "displayName": "…or paste a list / CSV column",
+                    "name": "numbersText",
+                    "description": "Optional. Paste many numbers at once (one per line, or comma/semicolon separated — e.g. a copied spreadsheet column). They are merged with the list above and de-duplicated.",
+                    "type": "string",
+                    "default": ""
+                },
+                {
+                    "displayName": "Default country (for numbers without +)",
+                    "name": "defaultCountry",
+                    "description": "ISO 3166 alpha-2 region code (US, GB, BR, IN, DE, ...) used to interpret numbers that don't start with +. Leave empty to require + on every number.",
+                    "type": "string",
+                    "default": "US"
+                },
+                {
+                    "displayName": "Return only valid numbers",
+                    "name": "onlyValid",
+                    "description": "If on, drop numbers that fail validation from the output (cleaned list only).",
+                    "type": "boolean",
+                    "default": false
+                },
+                {
+                    "displayName": "Return only WhatsApp-capable numbers",
+                    "name": "onlyWhatsappCapable",
+                    "description": "If on, keep only valid mobile (WhatsApp-capable) numbers — ideal right before a WhatsApp campaign.",
+                    "type": "boolean",
+                    "default": false
+                },
+                {
+                    "displayName": "Export format",
+                    "name": "exportFormat",
+                    "description": "default = full JSON. csv = flat CSV-friendly columns. both = JSON + nested _csv.",
+                    "type": "options",
+                    "options": [
+                        {
+                            "name": "Default (full JSON)",
+                            "value": "default"
+                        },
+                        {
+                            "name": "CSV-friendly columns",
+                            "value": "csv"
+                        },
+                        {
+                            "name": "Both",
+                            "value": "both"
+                        }
+                    ],
+                    "default": "default"
+                }
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const body = {};
+                {
+                    const _v = this.getNodeParameter("phoneNumbers", i, '');
+                    const _a = _v.split(/[,\n]/).map(s => s.trim()).filter(s => s.length > 0);
+                    if (_a.length)
+                        body["phoneNumbers"] = _a;
+                }
+                body["numbersText"] = this.getNodeParameter("numbersText", i);
+                body["defaultCountry"] = this.getNodeParameter("defaultCountry", i);
+                body["onlyValid"] = this.getNodeParameter("onlyValid", i);
+                body["onlyWhatsappCapable"] = this.getNodeParameter("onlyWhatsappCapable", i);
+                body["exportFormat"] = this.getNodeParameter("exportFormat", i);
+                const options = {
+                    method: 'POST',
+                    url: `https://api.apify.com/v2/acts/${ACTOR_ID}/run-sync-get-dataset-items`,
+                    body,
+                    json: true,
+                };
+                const response = await this.helpers.requestWithAuthentication.call(this, 'apifyApi', options);
+                const results = Array.isArray(response) ? response : [response];
+                for (const result of results)
+                    returnData.push({ json: result, pairedItem: { item: i } });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.WhatsappValidator = WhatsappValidator;
+//# sourceMappingURL=WhatsappValidator.node.js.map

package/dist/nodes/WhatsappValidator/WhatsappValidator.node.js.map

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

package/dist/nodes/WhatsappValidator/whatsappvalidator.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64"><rect width="64" height="64" rx="12" fill="#4f46e5"/><text x="32" y="40" font-family="Arial" font-size="28" font-weight="700" fill="#fff" text-anchor="middle">F</text></svg>

package/index.js

@@ -0,0 +1 @@
+module.exports = {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "n8n-nodes-apivault-whatsapp-validator",
+  "version": "0.1.0",
+  "description": "n8n community node for Fast WhatsApp Number Validator — backed by the Apify Actor apivault_labs/whatsapp-number-validator. No login. Pay-as-you-go via Apify.",
+  "license": "MIT",
+  "homepage": "https://apify.com/apivault_labs/whatsapp-number-validator",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "whatsapp-validator",
+    "apify",
+    "no-code",
+    "automation"
+  ],
+  "author": {
+    "name": "apivault_labs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/apivault-labs/n8n-nodes-apivault-whatsapp-validator.git"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && copyfiles \"nodes/**/*.svg\" dist",
+    "dev": "tsc --watch"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/ApifyApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/WhatsappValidator/WhatsappValidator.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "copyfiles": "^2.4.1",
+    "n8n-workflow": "*",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}