n8n-nodes-wasenderapi 0.1.1

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright 2026 Abdellatif
+
+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,93 @@
+# n8n-nodes-wasenderapi
+
+This is an n8n community node package for [WasenderAPI](https://wasenderapi.com/).
+
+It lets you manage Whatsapp sessions, send messages, work with contacts and groups, and trigger workflows from WasenderAPI webhooks.
+
+[Installation](#installation)  
+[Nodes](#nodes)  
+[Credentials](#credentials)  
+[Usage Notes](#usage-notes)  
+[Compatibility](#compatibility)  
+[Resources](#resources)
+
+## Installation
+
+Follow the [n8n community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/), then install:
+
+```bash
+npm install n8n-nodes-wasenderapi
+```
+
+Package name: `n8n-nodes-wasenderapi`
+
+## Nodes
+
+This package includes two nodes.
+
+### WasenderAPI
+
+Use this node for direct WasenderAPI actions.
+
+Supported resource groups:
+
+- `Account`: list, create, update, connect, disconnect, restart, get QR code, regenerate API key, read session logs, read message logs
+- `Session`: get status, get current user, send presence updates
+- `Message`: send text, image, video, document, audio, sticker, contact, location, and poll messages; upload media; decrypt webhook media straight from the incoming item into n8n binary data; edit, delete, resend, inspect, and mark messages as read
+- `Contact`: list contacts, get contact info, get profile picture, create/update contacts, block/unblock contacts, resolve Whatsapp/LID lookups
+- `Group`: list groups, create groups, inspect metadata and participants, manage participants, update settings, retrieve invite data, and leave groups
+
+### WasenderAPI Trigger
+
+Use this trigger to start workflows from WasenderAPI webhook events.
+
+Supported event subscriptions include:
+
+- message events like `messages.received`, `messages.upsert`, `messages.update`, `messages.delete`, `message.sent`
+- chat, group, and contact events
+- session and QR events like `session.status` and `qrcode.updated`
+- call and poll events like `call` and `poll.results`
+
+## Credentials
+
+This package provides one credential type.
+
+### WasenderAPI Account API
+
+Use a personal access token for account-level endpoints such as:
+
+- listing or updating Whatsapp sessions
+- generating session QR codes
+- configuring webhook settings for the trigger node
+
+## Usage Notes
+
+- Session-scoped actions use the selected session automatically, so you only need to connect the account credential and choose a session in the node
+- The trigger node configures the selected WasenderAPI session webhook URL automatically during activation and validates incoming signatures with that session's stored webhook secret
+- WasenderAPI uses one webhook URL per session, so activating a trigger can overwrite webhook settings previously configured elsewhere for that same session
+- Trigger output includes `selectedSessionId`, so downstream WasenderAPI nodes can prefill the same session while still letting you change it
+- The action node supports resource locators for sessions, contacts, and groups so you can select items from live dropdowns instead of pasting IDs manually
+
+## Compatibility
+
+- Built as an n8n community node package using the current `n8nNodesApiVersion: 1`
+- Verified in this repository with `npm run lint` and `npm run build`
+
+## Releases
+
+- `npm run release` creates the version bump, changelog, git tag, and GitHub release
+- npm publishing is handled by GitHub Actions in `.github/workflows/publish.yml`
+- The publish workflow runs automatically when a GitHub release is published and can also be triggered manually from the Actions tab for the current version
+- For a first-time publish where the package does not exist yet on npm, add a temporary `NPM_TOKEN` GitHub Actions secret with publish permission so the workflow can bootstrap the initial release
+- After the package exists on npm, configure npm Trusted Publishing for this repository and `publish.yml`, then remove the `NPM_TOKEN` secret if you want tokenless publishing
+
+## Resources
+
+- [WasenderAPI documentation](https://wasenderapi.com/api-docs)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)
+
+## Version History
+
+### 0.1.0
+
+- Initial release with WasenderAPI action node and webhook trigger node

package/dist/credentials/WasenderAccountApi.credentials.d.ts

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

package/dist/credentials/WasenderAccountApi.credentials.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WasenderAccountApi = void 0;
+class WasenderAccountApi {
+    constructor() {
+        this.name = 'wasenderAccountApi';
+        this.displayName = 'WasenderAPI Account API';
+        this.icon = {
+            light: 'file:../icons/wasenderapi.svg',
+            dark: 'file:../icons/wasenderapi.dark.svg',
+        };
+        this.documentationUrl = 'https://wasenderapi.com/api-docs/authentication/how-to-authenticate-api-requests-using-personal-access-token';
+        this.properties = [
+            {
+                displayName: 'Personal Access Token',
+                name: 'personalAccessToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://www.wasenderapi.com/api',
+                placeholder: 'https://www.wasenderapi.com/api',
+                description: 'Override only for self-hosted or proxy deployments',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.personalAccessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/auth-check',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.WasenderAccountApi = WasenderAccountApi;
+//# sourceMappingURL=WasenderAccountApi.credentials.js.map

package/dist/credentials/WasenderAccountApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WasenderAccountApi.credentials.js","sourceRoot":"","sources":["../../credentials/WasenderAccountApi.credentials.ts"],"names":[],"mappings":";;;AAQA,MAAa,kBAAkB;IAA/B;QACC,SAAI,GAAG,oBAAoB,CAAC;QAE5B,gBAAW,GAAG,yBAAyB,CAAC;QAExC,SAAI,GAAS;YACZ,KAAK,EAAE,+BAA+B;YACtC,IAAI,EAAE,oCAAoC;SAC1C,CAAC;QAEF,qBAAgB,GACf,8GAA8G,CAAC;QAEhH,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,uBAAuB;gBACpC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;aACX;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,iCAAiC;gBAC1C,WAAW,EAAE,iCAAiC;gBAC9C,WAAW,EAAE,oDAAoD;aACjE;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,8CAA8C;iBAC7D;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,2BAA2B;gBACpC,GAAG,EAAE,aAAa;gBAClB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA/CD,gDA+CC"}

package/dist/icons/wasenderapi.dark.svg

@@ -0,0 +1,68 @@
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="100%" viewBox="0 0 496 496" enable-background="new 0 0 496 496" xml:space="preserve">
+<path fill="#FFFFFF" opacity="1.000000" stroke="none"
+	d="
+M199.015091,328.175354
+	C191.936722,309.246124 185.043518,290.693207 178.150330,272.140289
+	C177.780182,272.262909 177.410049,272.385529 177.039917,272.508118
+	C179.023773,278.256165 180.909515,284.040863 183.036804,289.735352
+	C183.968475,292.229309 183.983200,294.492920 183.090988,296.977295
+	C179.659775,306.531433 176.248062,316.094940 173.033340,325.723206
+	C171.933273,329.017853 170.304718,330.478455 166.602783,330.446503
+	C146.946228,330.277069 127.286812,330.294739 107.629852,330.442596
+	C104.001419,330.469879 102.358124,329.140472 101.243744,325.739960
+	C88.497177,286.844177 75.605545,247.995956 62.792866,209.121780
+	C62.343102,207.757141 61.490089,206.353485 62.263611,204.724457
+	C63.543011,203.344818 65.300934,203.749725 66.899673,203.746414
+	C83.225769,203.712646 99.552757,203.811005 115.877563,203.661606
+	C119.690582,203.626709 121.491882,204.950775 122.499359,208.702805
+	C126.896255,225.077728 131.573929,241.377289 136.160263,257.701233
+	C136.637726,259.400635 136.835663,261.234192 138.667770,263.111603
+	C140.750183,255.859177 142.730164,249.048462 144.659897,242.223526
+	C147.871567,230.864883 151.148560,219.523087 154.183502,208.117096
+	C155.072418,204.776337 156.727814,203.631226 160.153320,203.660873
+	C176.644836,203.803619 193.139420,203.825195 209.630280,203.646515
+	C213.649597,203.602966 215.501022,204.924072 216.551895,208.907562
+	C220.663971,224.495087 225.110641,239.994766 229.495621,255.509399
+	C230.150482,257.826385 230.513565,260.343109 232.900055,262.489960
+	C236.548752,249.562637 240.105301,236.944260 243.673157,224.329086
+	C245.256760,218.729767 246.946411,213.158691 248.420120,207.530853
+	C249.048279,205.132050 250.085266,203.708038 252.785614,203.717911
+	C270.610168,203.783127 288.434937,203.781525 306.259552,203.831619
+	C306.886627,203.833374 307.512817,204.149185 308.059296,204.296951
+	C309.129333,206.347427 308.059235,208.005096 307.507690,209.685547
+	C294.847137,248.257309 282.112457,286.804932 269.581665,325.418732
+	C268.320923,329.303802 266.466339,330.500427 262.476746,330.459717
+	C243.320496,330.264252 224.161072,330.395264 205.002869,330.356293
+	C202.936447,330.352081 200.554245,331.001465 199.015091,328.175354
+	z"/>
+<path fill="#FFFFFF" opacity="1.000000" stroke="none"
+	d="
+M368.084106,203.694122
+	C390.391998,203.687317 412.212891,203.795837 434.030762,203.589966
+	C438.729736,203.545639 440.467621,204.845856 440.359741,209.759003
+	C440.067383,223.077652 440.108612,236.409561 440.343231,249.730484
+	C440.421661,254.181076 438.832520,255.442535 434.538300,255.402832
+	C415.385345,255.225739 396.229706,255.298767 377.075226,255.351501
+	C370.423798,255.369812 365.996063,258.361908 364.312775,263.691650
+	C362.685699,268.843475 365.249146,274.883423 370.235535,277.646820
+	C375.178864,280.386353 381.354919,279.476318 384.881226,275.488739
+	C388.589630,271.295380 388.524536,265.960175 384.692230,260.899719
+	C384.102722,260.121307 383.472534,259.373627 382.858002,258.607819
+	C384.006897,256.634064 385.841309,257.133209 387.372803,257.124756
+	C399.031830,257.060516 410.693451,257.205963 422.349518,257.007843
+	C426.256256,256.941467 428.442261,258.955902 430.517609,261.738525
+	C449.885773,287.707703 435.946533,321.899597 403.350220,328.289673
+	C396.482361,329.636017 389.572784,330.414886 382.538910,330.383270
+	C360.886169,330.285858 339.231689,330.262238 317.580231,330.465393
+	C313.050293,330.507904 311.504395,329.158966 311.590057,324.531281
+	C311.849030,310.544769 311.821930,296.548126 311.597565,282.560364
+	C311.529968,278.347687 313.077393,276.947784 317.076996,277.063263
+	C323.111145,277.237457 329.154083,277.108673 335.193268,277.108673
+	C335.197693,276.509949 335.202118,275.911224 335.206573,275.312500
+	C331.977661,275.312500 328.741333,275.176575 325.522095,275.353180
+	C322.667114,275.509796 320.917786,274.354431 319.476257,271.929077
+	C304.791748,247.222672 316.249023,215.538818 343.543976,207.598969
+	C351.428772,205.305359 359.450226,204.204254 368.084106,203.694122
+	z"/>
+</svg>

package/dist/icons/wasenderapi.svg

@@ -0,0 +1,68 @@
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 width="100%" viewBox="0 0 496 496" enable-background="new 0 0 496 496" xml:space="preserve">
+<path fill="#000000" opacity="1.000000" stroke="none" 
+	d="
+M199.015091,328.175354 
+	C191.936722,309.246124 185.043518,290.693207 178.150330,272.140289 
+	C177.780182,272.262909 177.410049,272.385529 177.039917,272.508118 
+	C179.023773,278.256165 180.909515,284.040863 183.036804,289.735352 
+	C183.968475,292.229309 183.983200,294.492920 183.090988,296.977295 
+	C179.659775,306.531433 176.248062,316.094940 173.033340,325.723206 
+	C171.933273,329.017853 170.304718,330.478455 166.602783,330.446503 
+	C146.946228,330.277069 127.286812,330.294739 107.629852,330.442596 
+	C104.001419,330.469879 102.358124,329.140472 101.243744,325.739960 
+	C88.497177,286.844177 75.605545,247.995956 62.792866,209.121780 
+	C62.343102,207.757141 61.490089,206.353485 62.263611,204.724457 
+	C63.543011,203.344818 65.300934,203.749725 66.899673,203.746414 
+	C83.225769,203.712646 99.552757,203.811005 115.877563,203.661606 
+	C119.690582,203.626709 121.491882,204.950775 122.499359,208.702805 
+	C126.896255,225.077728 131.573929,241.377289 136.160263,257.701233 
+	C136.637726,259.400635 136.835663,261.234192 138.667770,263.111603 
+	C140.750183,255.859177 142.730164,249.048462 144.659897,242.223526 
+	C147.871567,230.864883 151.148560,219.523087 154.183502,208.117096 
+	C155.072418,204.776337 156.727814,203.631226 160.153320,203.660873 
+	C176.644836,203.803619 193.139420,203.825195 209.630280,203.646515 
+	C213.649597,203.602966 215.501022,204.924072 216.551895,208.907562 
+	C220.663971,224.495087 225.110641,239.994766 229.495621,255.509399 
+	C230.150482,257.826385 230.513565,260.343109 232.900055,262.489960 
+	C236.548752,249.562637 240.105301,236.944260 243.673157,224.329086 
+	C245.256760,218.729767 246.946411,213.158691 248.420120,207.530853 
+	C249.048279,205.132050 250.085266,203.708038 252.785614,203.717911 
+	C270.610168,203.783127 288.434937,203.781525 306.259552,203.831619 
+	C306.886627,203.833374 307.512817,204.149185 308.059296,204.296951 
+	C309.129333,206.347427 308.059235,208.005096 307.507690,209.685547 
+	C294.847137,248.257309 282.112457,286.804932 269.581665,325.418732 
+	C268.320923,329.303802 266.466339,330.500427 262.476746,330.459717 
+	C243.320496,330.264252 224.161072,330.395264 205.002869,330.356293 
+	C202.936447,330.352081 200.554245,331.001465 199.015091,328.175354 
+z"/>
+<path fill="#000000" opacity="1.000000" stroke="none" 
+	d="
+M368.084106,203.694122 
+	C390.391998,203.687317 412.212891,203.795837 434.030762,203.589966 
+	C438.729736,203.545639 440.467621,204.845856 440.359741,209.759003 
+	C440.067383,223.077652 440.108612,236.409561 440.343231,249.730484 
+	C440.421661,254.181076 438.832520,255.442535 434.538300,255.402832 
+	C415.385345,255.225739 396.229706,255.298767 377.075226,255.351501 
+	C370.423798,255.369812 365.996063,258.361908 364.312775,263.691650 
+	C362.685699,268.843475 365.249146,274.883423 370.235535,277.646820 
+	C375.178864,280.386353 381.354919,279.476318 384.881226,275.488739 
+	C388.589630,271.295380 388.524536,265.960175 384.692230,260.899719 
+	C384.102722,260.121307 383.472534,259.373627 382.858002,258.607819 
+	C384.006897,256.634064 385.841309,257.133209 387.372803,257.124756 
+	C399.031830,257.060516 410.693451,257.205963 422.349518,257.007843 
+	C426.256256,256.941467 428.442261,258.955902 430.517609,261.738525 
+	C449.885773,287.707703 435.946533,321.899597 403.350220,328.289673 
+	C396.482361,329.636017 389.572784,330.414886 382.538910,330.383270 
+	C360.886169,330.285858 339.231689,330.262238 317.580231,330.465393 
+	C313.050293,330.507904 311.504395,329.158966 311.590057,324.531281 
+	C311.849030,310.544769 311.821930,296.548126 311.597565,282.560364 
+	C311.529968,278.347687 313.077393,276.947784 317.076996,277.063263 
+	C323.111145,277.237457 329.154083,277.108673 335.193268,277.108673 
+	C335.197693,276.509949 335.202118,275.911224 335.206573,275.312500 
+	C331.977661,275.312500 328.741333,275.176575 325.522095,275.353180 
+	C322.667114,275.509796 320.917786,274.354431 319.476257,271.929077 
+	C304.791748,247.222672 316.249023,215.538818 343.543976,207.598969 
+	C351.428772,205.305359 359.450226,204.204254 368.084106,203.694122 
+z"/>
+</svg>

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

@@ -0,0 +1,15 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { getContacts } from './listSearch/getContacts';
+import { getGroups } from './listSearch/getGroups';
+import { getSessions } from './listSearch/getSessions';
+export declare class WasenderApi implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: {
+            getSessions: typeof getSessions;
+            getContacts: typeof getContacts;
+            getGroups: typeof getGroups;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}