n8n-nodes-sendzen 1.0.0

package/nodes/SendZen/SendZen.node.json

@@ -0,0 +1,20 @@
+{
+	"node": "n8n-nodes-base.SendZen",
+	"nodeVersion": "1.0",
+	"codexVersion": "1.0",
+	"categories": [
+		"Miscellaneous"
+	],
+	"resources": {
+		"credentialDocumentation": [
+			{
+				"url": "https://sendzen.io/docs"
+			}
+		],
+		"primaryDocumentation": [
+			{
+				"url": "https://sendzen.io/docs"
+			}
+		]
+	}
+}

package/nodes/SendZen/sendzen.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 24 24" fill="none" stroke="#10b981" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-zap-icon lucide-zap"><path d="M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z"/></svg>

package/package.json

@@ -0,0 +1,76 @@
+{
+	"name": "n8n-nodes-sendzen",
+	"version": "1.0.0",
+	"description": "SendZen is a platform for automating SMS and WhatsApp messages. This node package allows you to use SendZen in n8n.",
+	"main": "index.js",
+	"keywords": [
+		"n8n-community-node-package",
+		"sendzen",
+		"automation",
+		"WhatsApp",
+		"WhatsApp API",
+		"WhatsApp Cloud API",
+		"WhatsApp Cloud API Integration",
+		"WhatsApp Cloud API Integration for n8n",
+		"WhatsApp Cloud API Integration for n8n workflows",
+		"WhatsApp Business API",
+		"WhatsApp Business API Integration",
+		"WhatsApp Business API Integration for n8n",
+		"WhatsApp Business API Integration for n8n workflows",
+		"WhatsApp Business API for n8n",
+		"WhatsApp Business API for n8n workflows",
+		"WhastApp Messaging API",
+		"WhastApp Messaging API Integration",
+		"WhastApp Messaging API Integration for n8n",
+		"WhastApp Messaging API Integration for n8n workflows",
+		"WhastApp Messaging API for n8n",
+		"WhastApp Messaging API for n8n workflows"
+	],
+	"license": "MIT",
+	"homepage": "https://www.sendzen.io/",
+	"author": {
+		"name": "SendZen",
+		"email": "milan@sendzen.io"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/sendzen-io/n8n-nodes-sendzen.git"
+	},
+	"engines": {
+		"node": ">=18.10"
+	},
+	"packageManager": "pnpm@10.15.0",
+	"scripts": {
+		"build": "tsc && gulp build:icons",
+		"dev": "nodemon -w nodes -w credentials --ext ts --exec \"tsc && n8n\"",
+		"format": "prettier nodes credentials --write",
+		"lint": "eslint nodes credentials package.json",
+		"test": "jest"
+	},
+	"n8n": {
+		"n8nNodesApiVersion": 1,
+		"credentials": [
+			"dist/credentials/SendZenApi.credentials.js"
+		],
+		"nodes": [
+			"dist/nodes/SendZen/SendZen.node.js",
+			"dist/nodes/SendZen/SendZenTrigger.node.js"
+		]
+	},
+	"devDependencies": {
+		"@typescript-eslint/parser": "^7.15.0",
+		"eslint": "^9.39.0",
+		"eslint-plugin-n8n-nodes-base": "^1.16.1",
+		"gulp": "^4.0.2",
+		"n8n": "^1.89.2",
+		"nodemon": "^3.1.10",
+		"prettier": "^3.3.2",
+		"typescript": "^5.5.3",
+		"@types/jest": "^29.5.12",
+		"jest": "^29.7.0",
+		"ts-jest": "^29.1.2"
+	},
+	"peerDependencies": {
+		"n8n-workflow": "*"
+	}
+}

package/shared/constants.ts

@@ -0,0 +1 @@
+export const BASE_DOMAIN = 'https://api.sendzen.io';

package/shared/nodeProperties.ts

@@ -0,0 +1,197 @@
+import { INodeProperties } from 'n8n-workflow';
+
+export const OperationProperties: INodeProperties = {
+	displayName: 'Operation',
+	name: 'operation',
+	type: 'options',
+	noDataExpression: true,
+	options: [
+		{
+			name: 'Send Session Message',
+			value: 'sendSessionMessage',
+			description: 'Send a free-form message within an active 24-hour WhatsApp conversation window',
+			action: 'Send session message',
+			hint: 'Use this option to reply to a user within an active conversation without using a template.',
+		},
+		{
+			name: 'Send Template Message',
+			value: 'sendTemplateMessage',
+			description: 'Send a pre-approved WhatsApp template message to a recipient',
+			action: 'Send template message',
+			hint: 'Use this option when replying outside the 24-hour session window or when a template is required by WhatsApp.',
+		},
+		{
+			name: 'Mark as Read',
+			value: 'markAsRead',
+			description:
+				'Mark the incoming message as read.',
+			action: 'Mark as read',
+			hint: 'Use this option to mark the incoming message as read.',
+		},
+		{
+			name: 'Show Typing Indicator',
+			value: 'showTyping',
+			description:
+				'Display a typing indicator while the workflow continues.',
+			action: 'Show typing indicator',
+			hint: 'Use this option to show a typing indicator while the workflow continues.',
+		},
+	],
+	default: 'sendSessionMessage',
+	required: true,
+	description: 'Choose how you want to interact with the recipient using SendZen.',
+};
+
+export const WabaAccountProperties: INodeProperties = {
+	displayName: 'WABA Account',
+	name: 'wabaAccount',
+	type: 'options',
+	noDataExpression: true,
+	hint: 'Select the WhatsApp Business Account that will be used to send messages.',
+	default: '',
+	required: true,
+	description: 'Select the WhatsApp Business Account (WABA)',
+	typeOptions: {
+		loadOptionsMethod: 'getWabaAccounts',
+	},
+	displayOptions: {
+		show: {
+			operation: ['sendSessionMessage', 'sendTemplateMessage'],
+		},
+	},
+};
+
+export const PhoneNumberIdProperties: INodeProperties = {
+	displayName: 'Phone Number ID',
+	name: 'phoneNumberId',
+	type: 'string',
+	hint: 'Enter the Phone Number ID associated with your WhatsApp Business account.',
+	default: '',
+	required: false,
+	description:
+		'The Phone Number ID used to mark the message as read and show the typing indicator.. If left empty, the node will try to find it automatically from the incoming data.',
+	displayOptions: {
+		show: {
+			operation: ['markAsRead', 'showTyping'],
+		},
+	},
+};
+
+export const MessageIdProperties: INodeProperties = {
+	displayName: 'Message ID (Optional)',
+	name: 'messageId',
+	type: 'string',
+	required: false,
+	default: '',
+	description:
+		'Optionally override the message ID. Leave empty to automatically use the incoming message ID from the previous node.',
+	hint: 'Only use this if you need to manually specify a message ID. In most cases, this is resolved automatically.',
+	displayOptions: {
+		show: {
+			operation: ['markAsRead', 'showTyping'],
+		},
+	},
+};
+
+export const RecipientPhoneNumberProperties: INodeProperties = {
+	displayName: 'Recipient Phone Number',
+	name: 'recipient',
+	type: 'string',
+	required: true,
+	placeholder: '+1234567890',
+	displayOptions: {
+		show: {
+			operation: ['sendSessionMessage', 'sendTemplateMessage'],
+		},
+	},
+	default: '',
+	description: 'The recipient’s phone number in international (E.164) format.',
+	hint: 'Enter the phone number including country code, for example: +1234567890.',
+};
+
+export const TemplateProperties: INodeProperties = {
+	displayName: 'Template',
+	name: 'template',
+	type: 'options',
+	noDataExpression: true,
+	typeOptions: {
+		loadOptionsMethod: 'getTemplates',
+		loadOptionsDependsOn: ['wabaAccount'],
+	},
+	required: true,
+	displayOptions: {
+		show: {
+			operation: ['sendTemplateMessage'],
+		},
+	},
+	default: '',
+	description: 'Select a WhatsApp message template to send.',
+	hint: 'Templates are pre-approved message formats that can include variables and media.',
+};
+
+export const ReplyMessageProperties: INodeProperties = {
+	displayName: 'Message Text',
+	name: 'replyMessage',
+	type: 'string',
+	required: true,
+	placeholder: 'Type your message here…',
+	displayOptions: {
+		show: {
+			operation: ['sendSessionMessage'],
+		},
+	},
+	default: '',
+	description: 'The text message that will be sent to the recipient.',
+	typeOptions: {
+		rows: 4,
+	},
+	hint: 'This message is sent immediately within an active WhatsApp session.',
+};
+
+export const EnableUrlPreviewProperties: INodeProperties = {
+	displayName: 'Enable URL Preview',
+	name: 'enableUrlPreview',
+	type: 'boolean',
+	default: false,
+	description: 'Show a preview for URLs included in the message.',
+	hint: 'Enable this to display link previews such as images and titles.',
+	displayOptions: {
+		show: {
+			operation: ['sendSessionMessage'],
+		},
+	},
+};
+
+export const TemplateNameOrIdProperties: INodeProperties = {
+	displayName: 'Template Variables',
+	name: 'templateVariables',
+	type: 'resourceMapper',
+	noDataExpression: true,
+	default: {
+		mappingMode: 'defineBelow',
+		value: null,
+	},
+	required: true,
+	placeholder: 'Add template variables',
+	description: 'Provide values for all variables required by the selected template.',
+	hint: 'Variable names and requirements are automatically derived from the selected template.',
+	displayOptions: {
+		show: {
+			operation: ['sendTemplateMessage'],
+		},
+	},
+	typeOptions: {
+		loadOptionsDependsOn: ['template'],
+		resourceMapper: {
+			resourceMapperMethod: 'getTemplateVariables',
+			mode: 'add',
+			fieldWords: {
+				singular: 'variable',
+				plural: 'variables',
+			},
+			addAllFields: true,
+			multiKeyMatch: false,
+			supportAutoMap: false,
+		},
+	},
+};