n8n-nodes-warecover-v1 2.8.0

package/README.md

@@ -0,0 +1,65 @@
+# Warecover — WhatsApp Node for n8n
+
+Send WhatsApp messages from your n8n workflows using your Warecover account.
+
+---
+
+## Install
+
+1. Open n8n → **Settings → Community Nodes**
+2. Click **Install**
+3. Enter: `n8n-nodes-warecover-v2`
+4. Restart n8n
+
+---
+
+## Connect Your Account
+
+1. Go to **Credentials → New → Warecover API**
+2. Enter your:
+   - **Access Token** — from Warecover → Channel → API Details
+   - **Phone Number ID** — from same page
+3. Save
+
+> Your Access Token is shown **only once** in Warecover. Save it immediately!
+
+---
+
+## Available Actions
+
+| Action | Notes |
+|---|---|
+| Send Text Message | ⚠️ 24-hour session required |
+| Send Template Message | ✅ Works anytime |
+| Send Image | ⚠️ 24-hour session required |
+| Send Document | ⚠️ 24-hour session required |
+| Send Audio | ⚠️ 24-hour session required |
+| Send Video | ⚠️ 24-hour session required |
+| Send Location | ⚠️ 24-hour session required |
+| Send Buttons | ⚠️ 24-hour session required |
+| Send List Menu | ⚠️ 24-hour session required |
+| Mark as Read | — |
+
+---
+
+## 24-Hour Session Rule
+
+WhatsApp only allows sending messages **if the recipient messaged you in the last 24 hours** — except for Template Messages which work anytime.
+
+**Tip:** Start with a Template Message. Once they reply, you can send any message type.
+
+---
+
+## Phone Number Format
+
+Use international format without `+`:
+
+| Country | Example |
+|---|---|
+| India | `919209576337` |
+| USA | `14155552671` |
+| UAE | `971501234567` |
+
+---
+
+Visit **warecover.com** for more info.

package/dist/credentials/WarecoverApi.credentials.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WarecoverApi = void 0;
+
+class WarecoverApi {
+    constructor() {
+        this.name = 'warecoverApi';
+        this.displayName = 'Warecover';
+        this.documentationUrl = 'https://webhook.warecover.com/docs';
+        this.properties = [
+            // ── Welcome notice ──────────────────────────────────
+            {
+                displayName: 'New to Warecover? Create your account at webhook.warecover.com',
+                name: 'warecoverNotice',
+                type: 'notice',
+                default: '',
+            },
+
+            // ── API Key ─────────────────────────────────────────
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                placeholder: 'wc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
+                description: 'Your Warecover API Key. Go to <a href="https://webhook.warecover.com/api-keys" target="_blank">webhook.warecover.com → API Keys</a> → click <strong>Generate Key</strong>. The key is shown only once — copy it immediately.',
+            },
+
+            // ── Access Token ─────────────────────────────────────
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                placeholder: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+                description: 'Your WhatsApp channel access token. Go to <a href="https://webhook.warecover.com" target="_blank">Warecover Dashboard</a> → Channel → API Details → copy <strong>Access Token</strong>.',
+            },
+
+            // ── Phone Number ID ──────────────────────────────────
+            {
+                displayName: 'Phone Number ID',
+                name: 'phoneNumberId',
+                type: 'string',
+                default: '',
+                required: true,
+                placeholder: '935752596280211',
+                description: 'Your WhatsApp Phone Number ID. Go to <a href="https://webhook.warecover.com" target="_blank">Warecover Dashboard</a> → Channel → API Details → copy <strong>Phone Number ID</strong>.',
+            },
+        ];
+
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                    'X-Warecover-Key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+
+        this.test = {
+            request: {
+                baseURL: 'https://crm.warecover.com/api/meta/v19.0',
+                url: '/{{$credentials.phoneNumberId}}',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.WarecoverApi = WarecoverApi;

package/dist/nodes/Warecover/Warecover.node.js

@@ -0,0 +1,762 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Warecover = void 0;
+
+class Warecover {
+    constructor() {
+        this.description = {
+            displayName: 'Warecover',
+            name: 'warecover',
+            icon: 'file:warecover.svg',
+            group: ['output'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Send WhatsApp messages via Warecover',
+            defaults: { name: 'Warecover' },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'warecoverApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        // ─────────────────────────────────────────
+                        // n8n renders section headers when:
+                        //   action is omitted OR empty string
+                        //   name is the header text
+                        //   value starts with _ (makes it non-selectable)
+                        // ─────────────────────────────────────────
+
+                        // MESSAGING
+                        {
+                            name: 'Messaging',
+                            value: '_sep_messaging',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Send Text Message',
+                            value: 'sendText',
+                            action: 'Send a text message',
+                            description: 'Send a plain text message. Requires active 24-hour session.',
+                        },
+                        {
+                            name: 'Send Template Message',
+                            value: 'sendTemplate',
+                            action: 'Send a pre-approved template message',
+                            description: 'Works outside 24-hour window. No active session needed.',
+                        },
+                        {
+                            name: 'Send Image',
+                            value: 'sendImage',
+                            action: 'Send an image',
+                            description: 'Send a JPG, PNG or WebP image with optional caption.',
+                        },
+                        {
+                            name: 'Send Document / PDF',
+                            value: 'sendDocument',
+                            action: 'Send a file or PDF',
+                            description: 'Send any document — PDF, DOCX, XLSX, etc.',
+                        },
+                        {
+                            name: 'Send Audio',
+                            value: 'sendAudio',
+                            action: 'Send an audio file',
+                            description: 'Send an MP3 or OGG audio message.',
+                        },
+                        {
+                            name: 'Send Video',
+                            value: 'sendVideo',
+                            action: 'Send a video',
+                            description: 'Send an MP4 video with optional caption.',
+                        },
+                        {
+                            name: 'Send Reply Buttons',
+                            value: 'sendButtons',
+                            action: 'Send up to 3 interactive reply buttons',
+                            description: 'Customer taps a button — use in Switch node to route the flow.',
+                        },
+                        {
+                            name: 'Send CTA URL Button',
+                            value: 'sendCtaButton',
+                            action: 'Send a message with a URL button',
+                            description: 'Button opens a URL — ideal for payment links, forms, or websites.',
+                        },
+                        {
+                            name: 'Send List Menu',
+                            value: 'sendList',
+                            action: 'Send a scrollable list of options',
+                            description: 'Scrollable menu — up to 10 options. Good for product menus or service selection.',
+                        },
+                        {
+                            name: 'Mark Message as Read',
+                            value: 'markRead',
+                            action: 'Mark an incoming message as read',
+                            description: 'Sends a read receipt — customer sees double blue ticks.',
+                        },
+
+                        // ORDER HANDLING
+                        {
+                            name: 'Order Handling',
+                            value: '_sep_order',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Read Incoming Order',
+                            value: 'parseOrder',
+                            action: 'Extract products, totals and customer from a catalog order',
+                            description: 'Parses a WhatsApp catalog order webhook — outputs product list, totals, and customer info.',
+                        },
+                        {
+                            name: 'Send Order Confirmation',
+                            value: 'sendOrderConfirmation',
+                            action: 'Send an order confirmation message to the customer',
+                            description: 'Send a customizable confirmation message after receiving an order.',
+                        },
+
+                        // ADDRESS COLLECTION
+                        {
+                            name: 'Address Collection',
+                            value: '_sep_address',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Ask for Address (Native Form)',
+                            value: 'requestAddressForm',
+                            action: 'Send a native WhatsApp address form',
+                            description: 'Customer sees a "Provide address" button — fills structured form. India & Singapore only.',
+                        },
+                        {
+                            name: 'Read Address Form Reply',
+                            value: 'parseAddressForm',
+                            action: 'Extract address from a native form submission',
+                            description: 'Parses name, phone, address, city, state, pincode from the form webhook.',
+                        },
+                        {
+                            name: 'Ask for Address (Text)',
+                            value: 'requestAddressText',
+                            action: 'Ask customer to type their address',
+                            description: 'Send a message asking the customer to type their address manually.',
+                        },
+                        {
+                            name: 'Read Address from Chat Reply',
+                            value: 'parseAddressText',
+                            action: 'Extract address from a plain text reply',
+                            description: 'Reads the address the customer typed in chat.',
+                        },
+
+                        // LOCATION
+                        {
+                            name: 'Location',
+                            value: '_sep_location',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Ask for Live Location',
+                            value: 'requestLocation',
+                            action: 'Ask customer to share their live location',
+                            description: 'Sends a "Share Location" prompt — customer taps to share GPS coordinates.',
+                        },
+                        {
+                            name: 'Send Location Pin',
+                            value: 'sendLocation',
+                            action: 'Send a map location pin to the customer',
+                            description: 'Send latitude/longitude — customer sees it as a map pin in WhatsApp.',
+                        },
+                        {
+                            name: 'Read Incoming Location',
+                            value: 'parseLocation',
+                            action: 'Extract location coordinates from a location message',
+                            description: 'Parses latitude, longitude, and address from a location webhook.',
+                        },
+
+                        // CHAT MANAGEMENT
+                        {
+                            name: 'Chat Management',
+                            value: '_sep_chat',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Close Chat (Mark as Done)',
+                            value: 'closeChatDone',
+                            action: 'Mark the chat as done to allow the next flow to trigger',
+                            description: 'Use after completing an order, booking, or after no-response timeout.',
+                        },
+
+                        // DETECT & ROUTE
+                        {
+                            name: 'Detect & Route',
+                            value: '_sep_route',
+                            action: '',
+                            description: '',
+                        },
+                        {
+                            name: 'Detect Button or List Click',
+                            value: 'detectButton',
+                            action: 'Detect which button or list item the customer clicked',
+                            description: 'Returns button_id — connect to a Switch node to route the flow based on customer choice.',
+                        },
+                        {
+                            name: 'Read Incoming Message',
+                            value: 'parseContact',
+                            action: 'Extract phone, name and message type from any incoming webhook',
+                            description: 'Outputs customer_phone, customer_name, message_type, and routing flags (is_order, is_button_reply, is_address_form, etc.).',
+                        },
+                    ],
+                    default: 'sendText',
+                },
+
+                // Section selected notice
+                {
+                    displayName: 'Please select an operation from the list above.',
+                    name: 'sepNotice',
+                    type: 'notice',
+                    default: '',
+                    displayOptions: {
+                        show: {
+                            operation: [
+                                '_sep_messaging','_sep_order','_sep_address',
+                                '_sep_location','_sep_chat','_sep_route'
+                            ]
+                        }
+                    },
+                },
+
+                // 24-HOUR NOTICE
+                {
+                    displayName: '⚠️ 24-Hour Session Required',
+                    name: 'sessionWindowNotice',
+                    type: 'notice',
+                    default: 'This message can only be sent within 24 hours after the recipient last messaged you. Use "Send Template Message" to reach users outside this window.',
+                    displayOptions: { show: { operation: ['sendText','sendImage','sendDocument','sendAudio','sendVideo','sendButtons','sendCtaButton','sendList','requestLocation','requestAddressForm','requestAddressText'] } },
+                },
+
+                // CLOSE CHAT
+                {
+                    displayName: 'Customer Phone',
+                    name: 'closeChatPhone',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: '={{$json.customer_phone}}',
+                    description: 'Phone number of the customer whose chat should be marked as done',
+                    displayOptions: { show: { operation: ['closeChatDone'] } },
+                },
+
+                // TO
+                {
+                    displayName: 'To (Phone Number)',
+                    name: 'to',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: '919209576337',
+                    description: 'Phone in international format without + sign. India example: 919209576337',
+                    displayOptions: { show: { operation: ['sendText','sendTemplate','sendImage','sendDocument','sendAudio','sendVideo','sendButtons','sendCtaButton','sendList','requestLocation','sendLocation','requestAddressForm','requestAddressText','sendOrderConfirmation'] } },
+                },
+
+                // SEND TEXT
+                { displayName: 'Message', name: 'text', type: 'string', typeOptions: { rows: 5 }, required: true, default: '', description: 'Supports WhatsApp formatting: *bold* _italic_ ~strikethrough~', displayOptions: { show: { operation: ['sendText'] } } },
+                { displayName: 'Show URL Preview', name: 'previewUrl', type: 'boolean', default: false, displayOptions: { show: { operation: ['sendText'] } } },
+
+                // SEND TEMPLATE
+                { displayName: 'Template Name', name: 'templateName', type: 'string', required: true, default: '', placeholder: 'order_confirmation', description: 'Exact name of the approved template in Meta Business Manager', displayOptions: { show: { operation: ['sendTemplate'] } } },
+                {
+                    displayName: 'Language',
+                    name: 'languageCode',
+                    type: 'options',
+                    options: [
+                        { name: 'English (en)', value: 'en' },
+                        { name: 'English US (en_US)', value: 'en_US' },
+                        { name: 'Hindi (hi)', value: 'hi' },
+                        { name: 'Marathi (mr)', value: 'mr' },
+                        { name: 'Gujarati (gu)', value: 'gu' },
+                        { name: 'Tamil (ta)', value: 'ta' },
+                        { name: 'Telugu (te)', value: 'te' },
+                        { name: 'Kannada (kn)', value: 'kn' },
+                    ],
+                    default: 'en',
+                    displayOptions: { show: { operation: ['sendTemplate'] } },
+                },
+                { displayName: 'Template Variables (JSON)', name: 'templateComponents', type: 'json', default: '[]', description: 'Leave [] for templates with no variables.', displayOptions: { show: { operation: ['sendTemplate'] } } },
+
+                // SEND IMAGE
+                { displayName: 'Image URL', name: 'imageUrl', type: 'string', required: true, default: '', placeholder: 'https://example.com/photo.jpg', displayOptions: { show: { operation: ['sendImage'] } } },
+                { displayName: 'Caption', name: 'imageCaption', type: 'string', default: '', displayOptions: { show: { operation: ['sendImage'] } } },
+
+                // SEND DOCUMENT
+                { displayName: 'Document URL', name: 'documentUrl', type: 'string', required: true, default: '', placeholder: 'https://example.com/file.pdf', displayOptions: { show: { operation: ['sendDocument'] } } },
+                { displayName: 'File Name (shown to user)', name: 'documentFilename', type: 'string', default: 'document.pdf', displayOptions: { show: { operation: ['sendDocument'] } } },
+                { displayName: 'Caption', name: 'documentCaption', type: 'string', default: '', displayOptions: { show: { operation: ['sendDocument'] } } },
+
+                // SEND AUDIO
+                { displayName: 'Audio URL', name: 'audioUrl', type: 'string', required: true, default: '', placeholder: 'https://example.com/audio.mp3', displayOptions: { show: { operation: ['sendAudio'] } } },
+
+                // SEND VIDEO
+                { displayName: 'Video URL', name: 'videoUrl', type: 'string', required: true, default: '', placeholder: 'https://example.com/video.mp4', displayOptions: { show: { operation: ['sendVideo'] } } },
+                { displayName: 'Caption', name: 'videoCaption', type: 'string', default: '', displayOptions: { show: { operation: ['sendVideo'] } } },
+
+                // SEND BUTTONS
+                { displayName: 'Message Body', name: 'btnBodyText', type: 'string', typeOptions: { rows: 4 }, required: true, default: '', description: 'Main message text shown above the buttons', displayOptions: { show: { operation: ['sendButtons'] } } },
+                { displayName: 'Header Text', name: 'btnHeaderText', type: 'string', default: '', displayOptions: { show: { operation: ['sendButtons'] } } },
+                { displayName: 'Footer Text', name: 'btnFooterText', type: 'string', default: '', displayOptions: { show: { operation: ['sendButtons'] } } },
+                {
+                    displayName: 'Buttons',
+                    name: 'buttons',
+                    type: 'fixedCollection',
+                    typeOptions: { multipleValues: true, maxValue: 3 },
+                    default: { button: [{ id: 'btn_1', title: 'Option 1' }] },
+                    description: 'Max 3 buttons. Button ID is returned when user clicks — use in Switch node to route.',
+                    options: [{
+                        name: 'button', displayName: 'Button',
+                        values: [
+                            { displayName: 'Button ID', name: 'id', type: 'string', default: '', placeholder: 'btn_cod', description: 'Unique ID returned in webhook when user clicks' },
+                            { displayName: 'Button Label', name: 'title', type: 'string', default: '', placeholder: 'Cash on Delivery', description: 'Max 20 characters' },
+                        ],
+                    }],
+                    displayOptions: { show: { operation: ['sendButtons'] } },
+                },
+
+                // SEND CTA URL BUTTON
+                { displayName: 'Header Text', name: 'ctaHeaderText', type: 'string', default: '', description: 'Bold title above the message body', displayOptions: { show: { operation: ['sendCtaButton'] } } },
+                { displayName: 'Message Body', name: 'ctaBodyText', type: 'string', typeOptions: { rows: 5 }, required: true, default: '', description: 'Main message content', displayOptions: { show: { operation: ['sendCtaButton'] } } },
+                { displayName: 'Footer Text', name: 'ctaFooterText', type: 'string', default: '', displayOptions: { show: { operation: ['sendCtaButton'] } } },
+                { displayName: 'Button Label', name: 'ctaDisplayText', type: 'string', required: true, default: '', placeholder: 'Pay Now', description: 'Text shown on the URL button (max 20 chars)', displayOptions: { show: { operation: ['sendCtaButton'] } } },
+                { displayName: 'Button URL', name: 'ctaUrl', type: 'string', required: true, default: '', placeholder: 'https://rzp.io/l/abc123', description: 'URL that opens when user taps the button', displayOptions: { show: { operation: ['sendCtaButton'] } } },
+
+                // SEND LIST
+                { displayName: 'Message Body', name: 'listBodyText', type: 'string', typeOptions: { rows: 4 }, required: true, default: '', displayOptions: { show: { operation: ['sendList'] } } },
+                { displayName: 'List Button Label', name: 'listButtonLabel', type: 'string', required: true, default: 'Select Option', displayOptions: { show: { operation: ['sendList'] } } },
+                { displayName: 'Header Text', name: 'listHeaderText', type: 'string', default: '', displayOptions: { show: { operation: ['sendList'] } } },
+                { displayName: 'Footer Text', name: 'listFooterText', type: 'string', default: '', displayOptions: { show: { operation: ['sendList'] } } },
+                { displayName: 'List Sections (JSON)', name: 'listSections', type: 'json', required: true, default: '[{"title":"Options","rows":[{"id":"opt_1","title":"Option 1","description":"Description here"}]}]', displayOptions: { show: { operation: ['sendList'] } } },
+
+                // MARK AS READ
+                { displayName: 'Message ID', name: 'messageId', type: 'string', required: true, default: '', placeholder: 'wamid.HBgM...', displayOptions: { show: { operation: ['markRead'] } } },
+
+                // READ INCOMING ORDER
+                { displayName: 'Webhook Body', name: 'webhookBody', type: 'json', required: true, default: '={{$json.body}}', description: 'Full webhook body. Outputs: customer_phone, customer_name, products[], total_items, total_amount, order_summary.', displayOptions: { show: { operation: ['parseOrder'] } } },
+
+                // SEND ORDER CONFIRMATION
+                { displayName: 'Customer Phone', name: 'confirmTo', type: 'string', required: true, default: '', placeholder: '={{$json.customer_phone}}', displayOptions: { show: { operation: ['sendOrderConfirmation'] } } },
+                { displayName: 'Confirmation Message', name: 'orderConfirmText', type: 'string', typeOptions: { rows: 6 }, required: true, default: 'Order received. Our team will confirm it shortly.', displayOptions: { show: { operation: ['sendOrderConfirmation'] } } },
+
+                // ASK FOR ADDRESS — NATIVE FORM
+                {
+                    displayName: '✅ India & Singapore Only',
+                    name: 'addressFormNotice',
+                    type: 'notice',
+                    default: 'Sends WhatsApp native address form — customer sees a "Provide address" button. Only works for Indian & Singapore phone numbers.',
+                    displayOptions: { show: { operation: ['requestAddressForm'] } },
+                },
+                { displayName: 'Message Body', name: 'addressFormBody', type: 'string', typeOptions: { rows: 3 }, required: true, default: 'Please provide your delivery address to complete your order.', displayOptions: { show: { operation: ['requestAddressForm'] } } },
+                {
+                    displayName: 'Country',
+                    name: 'addressCountry',
+                    type: 'options',
+                    options: [
+                        { name: 'India (IN)', value: 'IN' },
+                        { name: 'Singapore (SG)', value: 'SG' },
+                    ],
+                    default: 'IN',
+                    required: true,
+                    displayOptions: { show: { operation: ['requestAddressForm'] } },
+                },
+                { displayName: 'Pre-fill Customer Name', name: 'prefillName', type: 'string', default: '', placeholder: '={{$json.customer_name}}', displayOptions: { show: { operation: ['requestAddressForm'] } } },
+                { displayName: 'Pre-fill Phone Number', name: 'prefillPhone', type: 'string', default: '', placeholder: '+917558510593', displayOptions: { show: { operation: ['requestAddressForm'] } } },
+
+                // READ ADDRESS FORM SUBMISSION
+                { displayName: 'Webhook Body', name: 'addressFormWebhookBody', type: 'json', required: true, default: '={{$json.body}}', description: 'Outputs: name, phone, address, city, state, pincode, floor, landmark, full_address.', displayOptions: { show: { operation: ['parseAddressForm'] } } },
+
+                // ASK FOR ADDRESS — TEXT
+                { displayName: 'Message Body', name: 'addressTextBody', type: 'string', typeOptions: { rows: 5 }, required: true, default: 'Please type your complete delivery address including House No, Street, City and Pincode.', displayOptions: { show: { operation: ['requestAddressText'] } } },
+
+                // READ ADDRESS FROM CHAT REPLY
+                { displayName: 'Webhook Body', name: 'addressTextWebhookBody', type: 'json', required: true, default: '={{$json.body}}', displayOptions: { show: { operation: ['parseAddressText'] } } },
+
+                // ASK FOR LOCATION
+                { displayName: 'Message Body', name: 'locationRequestBody', type: 'string', typeOptions: { rows: 3 }, required: true, default: 'Please share your live location so we can deliver to you.', displayOptions: { show: { operation: ['requestLocation'] } } },
+
+                // SEND LOCATION PIN
+                { displayName: 'Latitude', name: 'latitude', type: 'number', required: true, default: 0, displayOptions: { show: { operation: ['sendLocation'] } } },
+                { displayName: 'Longitude', name: 'longitude', type: 'number', required: true, default: 0, displayOptions: { show: { operation: ['sendLocation'] } } },
+                { displayName: 'Location Name', name: 'locationName', type: 'string', default: '', displayOptions: { show: { operation: ['sendLocation'] } } },
+                { displayName: 'Address', name: 'locationAddress', type: 'string', default: '', displayOptions: { show: { operation: ['sendLocation'] } } },
+
+                // READ INCOMING LOCATION
+                { displayName: 'Webhook Body', name: 'locationWebhookBody', type: 'json', required: true, default: '={{$json.body}}', displayOptions: { show: { operation: ['parseLocation'] } } },
+
+                // DETECT BUTTON / LIST CLICK
+                { displayName: 'Webhook Body', name: 'buttonWebhookBody', type: 'json', required: true, default: '={{$json.body}}', description: 'Outputs: button_id, button_text, customer_phone. Use button_id in Switch node to route.', displayOptions: { show: { operation: ['detectButton'] } } },
+
+                // READ INCOMING MESSAGE INFO
+                { displayName: 'Webhook Body', name: 'contactWebhookBody', type: 'json', required: true, default: '={{$json.body}}', description: 'Outputs: customer_phone, customer_name, message_type, is_order, is_button_reply, is_address_form, is_location, is_text.', displayOptions: { show: { operation: ['parseContact'] } } },
+            ],
+        };
+    }
+
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('warecoverApi');
+        const accessToken = credentials.accessToken;
+        const phoneNumberId = credentials.phoneNumberId;
+        const apiKey = credentials.apiKey;
+        const baseURL = `https://crm.warecover.com/api/meta/v19.0`;
+
+        // ── API Key Validation ──────────────────────────────────────────
+        // Validate key against Warecover before any API call
+        try {
+            const keyCheck = await this.helpers.httpRequest({
+                method: 'POST',
+                url: 'https://webhook.warecover.com/api/n8n/verify-key',
+                headers: { 'Content-Type': 'application/json' },
+                body: { api_key: apiKey, phone_number_id: phoneNumberId },
+                json: true,
+            });
+            if (!keyCheck || keyCheck.valid === false) {
+                throw new Error('Invalid Warecover API Key. Please go to Warecover Dashboard → API Keys and generate a valid key.');
+            }
+        } catch (keyError) {
+            // If endpoint not yet deployed, check key format at minimum
+            if (!apiKey || String(apiKey).length < 10) {
+                throw new Error('Warecover API Key is missing or invalid. Go to Warecover Dashboard → API Keys → Generate Key.');
+            }
+            // If server returned explicit invalid, re-throw
+            if (keyError.message && keyError.message.includes('Invalid Warecover')) {
+                throw keyError;
+            }
+            // Network/server error — allow through (key format passed)
+        }
+        // ───────────────────────────────────────────────────────────────
+
+        const sendWA = async (body) => {
+            return await this.helpers.httpRequest({
+                method: 'POST',
+                url: `${baseURL}/${phoneNumberId}/messages`,
+                headers: { Authorization: `Bearer ${accessToken}`, 'X-Warecover-Key': String(apiKey), 'Content-Type': 'application/json' },
+                body, json: true,
+            });
+        };
+
+        const parseBody = (raw) => {
+            try { return typeof raw === 'string' ? JSON.parse(raw) : (raw || {}); } catch (_) { return {}; }
+        };
+
+        const extractWebhook = (body) => {
+            const entry = body.entry?.[0];
+            const changes = entry?.changes?.[0];
+            const value = changes?.value;
+            return {
+                value,
+                messages: value?.messages?.[0],
+                contacts: value?.contacts?.[0],
+                metadata: value?.metadata,
+                statuses: value?.statuses?.[0],
+            };
+        };
+
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                let result = {};
+
+                if (operation.startsWith('_sep')) {
+                    returnData.push({ json: { info: 'Select a real operation.' }, pairedItem: { item: i } });
+                    continue;
+                }
+
+                if (operation === 'sendText') {
+                    const to = this.getNodeParameter('to', i);
+                    const text = this.getNodeParameter('text', i);
+                    const previewUrl = this.getNodeParameter('previewUrl', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'text', text: { body: text, preview_url: previewUrl } });
+
+                } else if (operation === 'sendTemplate') {
+                    const to = this.getNodeParameter('to', i);
+                    const templateName = this.getNodeParameter('templateName', i);
+                    const languageCode = this.getNodeParameter('languageCode', i);
+                    const componentsRaw = this.getNodeParameter('templateComponents', i);
+                    let components = [];
+                    try { components = typeof componentsRaw === 'string' ? JSON.parse(componentsRaw) : componentsRaw; } catch (_) { components = []; }
+                    result = await sendWA({ messaging_product: 'whatsapp', to, type: 'template', template: { name: templateName, language: { code: languageCode }, ...(components.length > 0 ? { components } : {}) } });
+
+                } else if (operation === 'sendImage') {
+                    const to = this.getNodeParameter('to', i);
+                    const link = this.getNodeParameter('imageUrl', i);
+                    const caption = this.getNodeParameter('imageCaption', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'image', image: { link, ...(caption ? { caption } : {}) } });
+
+                } else if (operation === 'sendDocument') {
+                    const to = this.getNodeParameter('to', i);
+                    const link = this.getNodeParameter('documentUrl', i);
+                    const filename = this.getNodeParameter('documentFilename', i);
+                    const caption = this.getNodeParameter('documentCaption', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'document', document: { link, filename, ...(caption ? { caption } : {}) } });
+
+                } else if (operation === 'sendAudio') {
+                    const to = this.getNodeParameter('to', i);
+                    const link = this.getNodeParameter('audioUrl', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'audio', audio: { link } });
+
+                } else if (operation === 'sendVideo') {
+                    const to = this.getNodeParameter('to', i);
+                    const link = this.getNodeParameter('videoUrl', i);
+                    const caption = this.getNodeParameter('videoCaption', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'video', video: { link, ...(caption ? { caption } : {}) } });
+
+                } else if (operation === 'sendButtons') {
+                    const to = this.getNodeParameter('to', i);
+                    const bodyText = this.getNodeParameter('btnBodyText', i);
+                    const headerText = this.getNodeParameter('btnHeaderText', i);
+                    const footerText = this.getNodeParameter('btnFooterText', i);
+                    const buttonsData = this.getNodeParameter('buttons', i);
+                    const buttons = (buttonsData.button || []).map((btn) => ({ type: 'reply', reply: { id: btn.id, title: btn.title } }));
+                    result = await sendWA({
+                        messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'interactive',
+                        interactive: {
+                            type: 'button',
+                            ...(headerText ? { header: { type: 'text', text: headerText } } : {}),
+                            body: { text: bodyText },
+                            ...(footerText ? { footer: { text: footerText } } : {}),
+                            action: { buttons },
+                        },
+                    });
+                    result.buttons_sent = buttons.map(b => b.reply);
+
+                } else if (operation === 'sendCtaButton') {
+                    const to = this.getNodeParameter('to', i);
+                    const headerText = this.getNodeParameter('ctaHeaderText', i);
+                    const bodyText = this.getNodeParameter('ctaBodyText', i);
+                    const footerText = this.getNodeParameter('ctaFooterText', i);
+                    const displayText = this.getNodeParameter('ctaDisplayText', i);
+                    const url = this.getNodeParameter('ctaUrl', i);
+                    result = await sendWA({
+                        messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'interactive',
+                        interactive: {
+                            type: 'cta_url',
+                            ...(headerText ? { header: { type: 'text', text: headerText } } : {}),
+                            body: { text: bodyText },
+                            ...(footerText ? { footer: { text: footerText } } : {}),
+                            action: { name: 'cta_url', parameters: { display_text: displayText, url } },
+                        },
+                    });
+
+                } else if (operation === 'sendList') {
+                    const to = this.getNodeParameter('to', i);
+                    const bodyText = this.getNodeParameter('listBodyText', i);
+                    const buttonLabel = this.getNodeParameter('listButtonLabel', i);
+                    const headerText = this.getNodeParameter('listHeaderText', i);
+                    const footerText = this.getNodeParameter('listFooterText', i);
+                    const sectionsRaw = this.getNodeParameter('listSections', i);
+                    let sections = [];
+                    try { sections = typeof sectionsRaw === 'string' ? JSON.parse(sectionsRaw) : sectionsRaw; } catch (_) { sections = []; }
+                    result = await sendWA({
+                        messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'interactive',
+                        interactive: {
+                            type: 'list',
+                            ...(headerText ? { header: { type: 'text', text: headerText } } : {}),
+                            body: { text: bodyText },
+                            ...(footerText ? { footer: { text: footerText } } : {}),
+                            action: { button: buttonLabel, sections },
+                        },
+                    });
+
+                } else if (operation === 'markRead') {
+                    const messageId = this.getNodeParameter('messageId', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', status: 'read', message_id: messageId });
+
+                } else if (operation === 'parseOrder') {
+                    const body = parseBody(this.getNodeParameter('webhookBody', i));
+                    const { messages, contacts, metadata } = extractWebhook(body);
+                    if (!messages || messages.type !== 'order') {
+                        result = { is_order: false, message_type: messages?.type || 'unknown' };
+                    } else {
+                        const order = messages.order;
+                        const productItems = order.product_items || [];
+                        let totalAmount = 0; let totalItems = 0;
+                        const products = productItems.map((item) => {
+                            const qty = Number(item.quantity) || 0;
+                            const price = Number(item.item_price) || 0;
+                            totalAmount += qty * price; totalItems += qty;
+                            return { product_id: item.product_retailer_id, quantity: qty, price, currency: item.currency || 'INR', subtotal: qty * price };
+                        });
+                        result = {
+                            is_order: true,
+                            customer_phone: contacts?.wa_id || messages.from,
+                            customer_name: contacts?.profile?.name || '',
+                            message_id: messages.id,
+                            timestamp: messages.timestamp,
+                            catalog_id: order.catalog_id,
+                            order_text: order.text || '',
+                            products,
+                            total_items: totalItems,
+                            total_amount: totalAmount,
+                            currency: productItems?.[0]?.currency || 'INR',
+                            phone_number_id: metadata?.phone_number_id || '',
+                            display_phone_number: metadata?.display_phone_number || '',
+                            order_summary: `Order Summary\n--------------------------\n${products.map((p, i) => `${i+1}. Item: ${p.product_id}\n   Qty: ${p.quantity}   Price: Rs. ${p.price}   Subtotal: Rs. ${p.subtotal}`).join('\n\n')}\n\n--------------------------\nTotal Items : ${totalItems}\nTotal Amount: Rs. ${totalAmount}`,
+                        };
+                    }
+
+                } else if (operation === 'sendOrderConfirmation') {
+                    const to = this.getNodeParameter('to', i);
+                    const confirmText = this.getNodeParameter('orderConfirmText', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'text', text: { body: confirmText } });
+
+                } else if (operation === 'requestAddressForm') {
+                    const to = this.getNodeParameter('to', i);
+                    const bodyText = this.getNodeParameter('addressFormBody', i);
+                    const country = this.getNodeParameter('addressCountry', i);
+                    const prefillName = this.getNodeParameter('prefillName', i);
+                    const prefillPhone = this.getNodeParameter('prefillPhone', i);
+                    const params = { country };
+                    if (prefillName || prefillPhone) {
+                        params.values = {};
+                        if (prefillName) params.values.name = prefillName;
+                        if (prefillPhone) params.values.phone_number = prefillPhone;
+                    }
+                    result = await sendWA({
+                        messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'interactive',
+                        interactive: { type: 'address_message', body: { text: bodyText }, action: { name: 'address_message', parameters: JSON.stringify(params) } },
+                    });
+
+                } else if (operation === 'parseAddressForm') {
+                    const body = parseBody(this.getNodeParameter('addressFormWebhookBody', i));
+                    const { messages, contacts } = extractWebhook(body);
+                    if (messages?.type === 'interactive' && messages?.interactive?.type === 'nfm_reply' && messages?.interactive?.nfm_reply?.name === 'address_message') {
+                        const nfmReply = messages.interactive.nfm_reply;
+                        let addressValues = {};
+                        try { const parsed = JSON.parse(nfmReply.response_json || '{}'); addressValues = parsed.values || parsed; } catch (_) { addressValues = {}; }
+                        result = {
+                            is_address_form: true,
+                            customer_phone: messages.from,
+                            customer_name: addressValues.name || contacts?.profile?.name || '',
+                            message_id: messages.id,
+                            timestamp: messages.timestamp,
+                            name: addressValues.name || '',
+                            phone: addressValues.phone_number || '',
+                            address: addressValues.address || '',
+                            city: addressValues.city || '',
+                            state: addressValues.state || '',
+                            pincode: addressValues.in_pin_code || '',
+                            floor: addressValues.floor_number || '',
+                            landmark: addressValues.landmark_area || '',
+                            building: addressValues.building_name || '',
+                            sg_post_code: addressValues.sg_post_code || '',
+                            full_address: nfmReply.body || [addressValues.name, addressValues.phone_number, addressValues.address, addressValues.floor_number, addressValues.landmark_area, addressValues.city, addressValues.state, addressValues.in_pin_code].filter(Boolean).join(', '),
+                            raw_values: addressValues,
+                        };
+                    } else {
+                        result = { is_address_form: false, message_type: messages?.type || 'unknown', customer_phone: messages?.from || '' };
+                    }
+
+                } else if (operation === 'requestAddressText') {
+                    const to = this.getNodeParameter('to', i);
+                    const bodyText = this.getNodeParameter('addressTextBody', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'text', text: { body: bodyText } });
+
+                } else if (operation === 'parseAddressText') {
+                    const body = parseBody(this.getNodeParameter('addressTextWebhookBody', i));
+                    const { messages, contacts } = extractWebhook(body);
+                    if (messages?.type === 'text') {
+                        const textBody = messages.text?.body || '';
+                        result = { is_address: true, address_text: textBody, address_lines: textBody.split('\n').map(l => l.trim()).filter(Boolean), customer_phone: messages.from, customer_name: contacts?.profile?.name || '', message_id: messages.id, timestamp: messages.timestamp };
+                    } else {
+                        result = { is_address: false, message_type: messages?.type || 'unknown', customer_phone: messages?.from || '' };
+                    }
+
+                } else if (operation === 'requestLocation') {
+                    const to = this.getNodeParameter('to', i);
+                    const bodyText = this.getNodeParameter('locationRequestBody', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'interactive', interactive: { type: 'location_request_message', body: { text: bodyText }, action: { name: 'send_location' } } });
+
+                } else if (operation === 'sendLocation') {
+                    const to = this.getNodeParameter('to', i);
+                    const latitude = this.getNodeParameter('latitude', i);
+                    const longitude = this.getNodeParameter('longitude', i);
+                    const name = this.getNodeParameter('locationName', i);
+                    const address = this.getNodeParameter('locationAddress', i);
+                    result = await sendWA({ messaging_product: 'whatsapp', recipient_type: 'individual', to, type: 'location', location: { latitude, longitude, name, address } });
+
+                } else if (operation === 'parseLocation') {
+                    const body = parseBody(this.getNodeParameter('locationWebhookBody', i));
+                    const { messages, contacts } = extractWebhook(body);
+                    if (messages?.type === 'location') {
+                        const loc = messages.location;
+                        result = { is_location: true, customer_phone: messages.from, customer_name: contacts?.profile?.name || '', message_id: messages.id, timestamp: messages.timestamp, latitude: loc.latitude, longitude: loc.longitude, name: loc.name || '', address: loc.address || '', google_maps_url: `https://www.google.com/maps?q=${loc.latitude},${loc.longitude}` };
+                    } else {
+                        result = { is_location: false, message_type: messages?.type || 'unknown', customer_phone: messages?.from || '' };
+                    }
+
+                } else if (operation === 'detectButton') {
+                    const body = parseBody(this.getNodeParameter('buttonWebhookBody', i));
+                    const { messages, contacts } = extractWebhook(body);
+                    if (messages?.type === 'interactive') {
+                        const interactive = messages.interactive;
+                        const btnReply = interactive.button_reply;
+                        const listReply = interactive.list_reply;
+                        result = { is_button_click: true, interaction_type: interactive.type, button_id: btnReply?.id || listReply?.id || '', button_text: btnReply?.title || listReply?.title || '', list_description: listReply?.description || '', customer_phone: messages.from, customer_name: contacts?.profile?.name || '', message_id: messages.id, timestamp: messages.timestamp };
+                    } else if (messages?.type === 'text') {
+                        result = { is_button_click: false, is_text_reply: true, button_id: '', text: messages.text?.body || '', customer_phone: messages.from, customer_name: contacts?.profile?.name || '', message_id: messages.id, timestamp: messages.timestamp };
+                    } else {
+                        result = { is_button_click: false, is_text_reply: false, button_id: '', message_type: messages?.type || 'unknown', customer_phone: messages?.from || '' };
+                    }
+
+                } else if (operation === 'closeChatDone') {
+                    const phone = this.getNodeParameter('closeChatPhone', i);
+                    // Warecover API: mark chat as done
+                    result = await this.helpers.httpRequest({
+                        method: 'POST',
+                        url: `https://crm.warecover.com/api/chat/done`,
+                        headers: { Authorization: `Bearer ${accessToken}`, 'X-Warecover-Key': String(apiKey), 'Content-Type': 'application/json' },
+                        body: { phone_number_id: phoneNumberId, customer_phone: phone },
+                        json: true,
+                    });
+                    result.chat_closed = true;
+                    result.customer_phone = phone;
+
+                } else if (operation === 'parseContact') {
+                    const body = parseBody(this.getNodeParameter('contactWebhookBody', i));
+                    const { messages, contacts, metadata, statuses } = extractWebhook(body);
+                    const isAddressForm = messages?.type === 'interactive' && messages?.interactive?.type === 'nfm_reply' && messages?.interactive?.nfm_reply?.name === 'address_message';
+                    result = {
+                        customer_phone: messages?.from || statuses?.recipient_id || '',
+                        customer_name: contacts?.profile?.name || '',
+                        customer_wa_id: contacts?.wa_id || '',
+                        message_id: messages?.id || '',
+                        message_type: messages?.type || (statuses ? 'status_update' : 'unknown'),
+                        timestamp: messages?.timestamp || statuses?.timestamp || '',
+                        text_body: messages?.text?.body || '',
+                        phone_number_id: metadata?.phone_number_id || '',
+                        display_phone_number: metadata?.display_phone_number || '',
+                        is_status_update: !!statuses,
+                        status: statuses?.status || '',
+                        is_order: messages?.type === 'order',
+                        is_button_reply: messages?.type === 'interactive' && !isAddressForm,
+                        is_address_form: isAddressForm,
+                        is_location: messages?.type === 'location',
+                        is_text: messages?.type === 'text',
+                    };
+                }
+
+                returnData.push({ json: result, pairedItem: { item: i } });
+            } catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: { item: i } });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Warecover = Warecover;

package/dist/nodes/Warecover/warecover.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60">
+  <rect width="60" height="60" rx="12" fill="#25D366"/>
+  <circle cx="30" cy="28" r="14" fill="#ffffff"/>
+  <circle cx="30" cy="28" r="11" fill="#25D366"/>
+  <rect x="18" y="38" width="8" height="8" rx="4" fill="#25D366"/>
+  <rect x="22" y="22" width="3" height="12" rx="1.5" fill="#ffffff"/>
+  <rect x="28" y="22" width="3" height="12" rx="1.5" fill="#ffffff"/>
+  <rect x="34" y="22" width="3" height="12" rx="1.5" fill="#ffffff"/>
+</svg>

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "n8n-nodes-warecover-v1",
+  "version": "2.8.0",
+  "description": "WhatsApp automation for n8n \u2014 send messages, buttons, CTA links, orders, address forms, location via Warecover",
+  "keywords": [
+    "n8n-community-node-package",
+    "warecover",
+    "whatsapp",
+    "meta",
+    "whatsapp-api",
+    "whatsapp-business",
+    "whatsapp-automation",
+    "whatsapp-bot",
+    "whatsapp-messaging",
+    "whatsapp-crm",
+    "messaging",
+    "sms",
+    "notification",
+    "automation",
+    "ai-agent",
+    "chatbot",
+    "crm",
+    "customer-support",
+    "business-messaging",
+    "meta-api",
+    "cloud-api",
+    "send-message",
+    "template-message",
+    "webhook",
+    "workflow",
+    "n8n-node",
+    "n8n-integration",
+    "india",
+    "saas"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Warecover"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/WarecoverApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Warecover/Warecover.node.js"
+    ]
+  },
+  "devDependencies": {
+    "typescript": "~5.1.0",
+    "n8n-workflow": "*"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}