n8n-nodes-nashir 0.2.2 → 0.3.0

package/README.md

@@ -1,6 +1,8 @@
 # n8n-nodes-nashir
 
-n8n community nodes for [nashir.ai](https://nashir.ai) — publish to Facebook, Instagram, TikTok, LinkedIn, YouTube, WhatsApp and Telegram.
+n8n community nodes for [nashir.ai](https://nashir.ai) — publish to Facebook, Instagram, TikTok, LinkedIn, YouTube, WhatsApp and Telegram, and manage AI-driven conversations.
+
+> Requires nashir.ai API v0.3.0+ for conversation management operations.
 
 ## Installation
 
@@ -12,34 +14,97 @@ n8n-nodes-nashir
 
 ## Nodes
 
-- **Nashir Facebook** — Publish posts and reels
-- **Nashir Instagram** — Publish feed posts, reels, and stories
-- **Nashir TikTok** — Publish video and photo posts (Direct Post API)
-- **Nashir LinkedIn** — Publish posts and articles
-- **Nashir YouTube** — Upload and schedule videos
-- **Nashir WhatsApp** — Send messages via WhatsApp Business
-- **Nashir Telegram** — Send messages and media to Telegram channels/groups
+### Nashir WhatsApp
+
+| Operation | Description |
+|-----------|-------------|
+| Send Message | Send text, template, or media message to a phone number |
+| Reply to Message | Reply to a specific message by ID |
+| Get Messages | Retrieve recent WhatsApp messages |
+| Mark as Read | Mark a message as read |
+| **Get Conversation History** | Fetch the last N messages for a phone number |
+| **Get AI Status** | Check if AI auto-reply is active or paused for a conversation |
+| **Set AI Status** | Pause or resume AI auto-reply for a conversation |
+| **Save Message to Inbox** | Store an external message in nashir.ai (ingest) |
+| **Get Contact** | Fetch contact details by phone number |
+
+### Nashir Contact
+
+| Operation | Description |
+|-----------|-------------|
+| Get Contact | Fetch contact details by phone number |
+| **Update Contact Tags** | Add tags to a contact (idempotent, comma-separated) |
+
+### Nashir Facebook
+Publish posts and reels.
+
+### Nashir Instagram
+Publish feed posts, reels, and stories.
+
+### Nashir TikTok
+Publish video and photo posts (Direct Post API).
+
+### Nashir LinkedIn
+Publish posts and articles.
+
+### Nashir YouTube
+Upload and schedule videos.
+
+### Nashir Telegram
+Send messages and media to Telegram channels/groups.
 
 ## Credentials
 
 Create a **Nashir API** credential with your API key from [nashir.ai/settings](https://nashir.ai/settings).
 
+The credential supports an optional **Base URL** field (default: `https://nashir.ai`) — override this for self-hosted or staging environments.
+
+## Example: Conversation History Lookup
+
+This workflow fetches the last 10 messages for an inbound WhatsApp number and passes them to an AI node:
+
+1. **Webhook** — receives a WhatsApp message (phone in `body.phone`)
+2. **Nashir WhatsApp** → *Get Conversation History*
+   - Phone: `={{ $json.body.phone }}`
+   - Limit: `10`
+3. **AI Agent** — receives the message array as context
+4. **Nashir WhatsApp** → *Set AI Status* (pause while agent replies)
+   - Phone: `={{ $json.body.phone }}`
+   - Action: `pause`
+   - Reason: `Human-in-the-loop`
+
 ---
 
 ## Changelog
 
+### 0.3.0 — Apr 2026
+
+**New WhatsApp operations**
+
+- **Get Conversation History** — fetch last N messages for a phone (`GET /api/v1/conversations/:phone/messages?limit=N`)
+- **Get AI Status** — check if AI is paused/active for a conversation (`GET /api/v1/conversations/:phone/ai-status`)
+- **Set AI Status** — pause or resume AI auto-reply with optional reason (`POST /api/v1/conversations/:phone/ai-toggle`)
+- **Save Message to Inbox** — store external messages in nashir.ai with role, media type, and `is_from_ai` flag (`POST /api/v1/messages/ingest`)
+- **Get Contact** — fetch contact details by phone number (`GET /api/v1/contacts/:phone`)
+
+**New Contact node**
+
+- **Update Contact Tags** — add tags to a contact, idempotent, comma-separated input (`POST /api/v1/contacts/:phone/tags`)
+
+**Improvements**
+
+- Configurable Base URL in credentials (default `https://nashir.ai`, override for dev/staging)
+- Friendly error messages: 401/403 → clear auth error, 404 → context-aware not-found message
+- Full TypeScript types for all response shapes
+
 ### 0.2.2 — Apr 2026
 
 **TikTok node — full Direct Post API compliance update**
 
 - `privacy_level` now required field with 3 options: Public to Everyone, Friends Only, Only Me
-- Interactions renamed to "Allow Comments / Allow Duet / Allow Stitch" (all default `false` per TikTok guidelines) — mapped to `disable_comment / disable_duet / disable_stitch` in the API
+- Interactions renamed to "Allow Comments / Allow Duet / Allow Stitch" (all default `false` per TikTok guidelines)
 - `brand_content_toggle` renamed to **Content Disclosure** in UI
-- `brand_organic_toggle` (Your Brand) and `brand_branded_content_toggle` (Branded Content / Paid Partnership) shown conditionally when Content Disclosure is enabled
 - Removed `FOLLOWER_OF_CREATOR` privacy option (not supported by Direct Post API)
-- Node description updated: "Privacy Level is required. Interactions are off by default per TikTok guidelines. Content Disclosure must have at least one option selected if enabled."
-- All fields map directly to nashir.ai `tiktok_options` object
-- Prepared for TikTok Direct Post API audit approval
 
 ### 0.2.1 — Mar 2026
 

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

@@ -0,0 +1,6 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class NashirContact implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=NashirContact.node.d.ts.map

package/dist/nodes/NashirContact/NashirContact.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NashirContact.node.d.ts","sourceRoot":"","sources":["../../../nodes/NashirContact/NashirContact.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAItB,qBAAa,aAAc,YAAW,SAAS;IAC9C,WAAW,EAAE,oBAAoB,CAiD/B;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAwCvE"}

package/dist/nodes/NashirContact/NashirContact.node.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NashirContact = void 0;
+const api_1 = require("../shared/api");
+class NashirContact {
+    constructor() {
+        this.description = {
+            displayName: 'Nashir Contact',
+            name: 'nashirContact',
+            icon: 'file:nashir.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Manage contacts in nashir.ai',
+            defaults: { name: 'Nashir Contact', color: '#6366f1' },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [{ name: 'nashirApi', required: true }],
+            properties: [
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Get Contact', value: 'getContact', action: 'Get contact details' },
+                        { name: 'Update Contact Tags', value: 'updateTags', action: 'Add tags to a contact' },
+                    ],
+                    default: 'getContact',
+                },
+                // ── Shared: phone ────────────────────────────────────────────────────────
+                {
+                    displayName: 'Phone Number',
+                    name: 'phone',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '+1234567890',
+                    description: 'Phone number of the contact in international format',
+                    displayOptions: { show: { operation: ['getContact', 'updateTags'] } },
+                },
+                // ── Update Tags fields ───────────────────────────────────────────────────
+                {
+                    displayName: 'Tags',
+                    name: 'tags',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: 'vip, arabic, lead',
+                    description: 'Comma-separated list of tags to apply to the contact (idempotent)',
+                    displayOptions: { show: { operation: ['updateTags'] } },
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                let responseData;
+                if (operation === 'getContact') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'GET', `/contacts/${phone}`);
+                }
+                else if (operation === 'updateTags') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    const tagsRaw = this.getNodeParameter('tags', i);
+                    const tags = tagsRaw
+                        .split(',')
+                        .map((t) => t.trim())
+                        .filter(Boolean);
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'POST', `/contacts/${phone}/tags`, { tags });
+                }
+                else {
+                    throw new Error(`Unknown operation: ${operation}`);
+                }
+                const rows = Array.isArray(responseData) ? responseData : [responseData];
+                returnData.push(...rows.map((d) => ({ json: d, pairedItem: i })));
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({ json: { error: error.message }, pairedItem: i });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.NashirContact = NashirContact;
+//# sourceMappingURL=NashirContact.node.js.map

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

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

package/dist/nodes/NashirContact/nashir.svg

@@ -0,0 +1,5 @@
+<svg viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="60" height="60" rx="12" fill="#7C3AED"/>
+  <path d="M8 30L50 10L37 52L28 33L8 30Z" fill="white"/>
+  <path d="M28 33L37 24" stroke="#7C3AED" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/dist/nodes/NashirWhatsApp/NashirWhatsApp.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NashirWhatsApp.node.d.ts","sourceRoot":"","sources":["../../../nodes/NashirWhatsApp/NashirWhatsApp.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAItB,qBAAa,cAAe,YAAW,SAAS;IAC/C,WAAW,EAAE,oBAAoB,CAwG/B;IAEF,OAAO;;uCAE4B,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;MAIxF;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAsDvE"}
+{"version":3,"file":"NashirWhatsApp.node.d.ts","sourceRoot":"","sources":["../../../nodes/NashirWhatsApp/NashirWhatsApp.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAItB,qBAAa,cAAe,YAAW,SAAS;IAC/C,WAAW,EAAE,oBAAoB,CA0O/B;IAEF,OAAO;;uCAE4B,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;;MAIxF;IAEI,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAwGvE"}

package/dist/nodes/NashirWhatsApp/NashirWhatsApp.node.js

@@ -23,10 +23,15 @@ class NashirWhatsApp {
                     type: 'options',
                     noDataExpression: true,
                     options: [
+                        { name: 'Get AI Status', value: 'getAiStatus', action: 'Get AI status for a conversation' },
+                        { name: 'Get Contact', value: 'getContact', action: 'Get contact details' },
+                        { name: 'Get Conversation History', value: 'getConversationHistory', action: 'Get conversation history for a phone number' },
                         { name: 'Get Messages', value: 'getMessages', action: 'Get messages' },
                         { name: 'Mark as Read', value: 'markRead', action: 'Mark message as read' },
                         { name: 'Reply to Message', value: 'replyMessage', action: 'Reply to a message' },
+                        { name: 'Save Message to Inbox', value: 'saveMessage', action: 'Save a message to the inbox' },
                         { name: 'Send Message', value: 'sendMessage', action: 'Send a message' },
+                        { name: 'Set AI Status', value: 'setAiStatus', action: 'Pause or resume AI auto-reply' },
                     ],
                     default: 'sendMessage',
                 },
@@ -100,6 +105,121 @@ class NashirWhatsApp {
                     required: true,
                     displayOptions: { show: { operation: ['replyMessage'] } },
                 },
+                // ── Conversation History fields ──────────────────────────────────────────
+                {
+                    displayName: 'Phone Number',
+                    name: 'phone',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '+1234567890',
+                    description: 'Phone number in international format',
+                    displayOptions: {
+                        show: {
+                            operation: [
+                                'getConversationHistory',
+                                'getAiStatus',
+                                'setAiStatus',
+                                'getContact',
+                            ],
+                        },
+                    },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    default: 20,
+                    description: 'Number of messages to return (most recent first)',
+                    displayOptions: { show: { operation: ['getConversationHistory'] } },
+                },
+                // ── Set AI Status fields ────────────────────────────────────────────────
+                {
+                    displayName: 'Action',
+                    name: 'aiAction',
+                    type: 'options',
+                    options: [
+                        { name: 'Pause', value: 'pause' },
+                        { name: 'Resume', value: 'resume' },
+                    ],
+                    default: 'pause',
+                    required: true,
+                    description: 'Pause or resume AI auto-reply for this conversation',
+                    displayOptions: { show: { operation: ['setAiStatus'] } },
+                },
+                {
+                    displayName: 'Reason',
+                    name: 'reason',
+                    type: 'string',
+                    default: '',
+                    description: 'Optional reason for pausing (e.g. "Human takeover")',
+                    displayOptions: { show: { operation: ['setAiStatus'] } },
+                },
+                // ── Save Message to Inbox fields ────────────────────────────────────────
+                {
+                    displayName: 'Phone Number',
+                    name: 'ingestPhone',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    placeholder: '+1234567890',
+                    description: 'Phone number of the contact',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
+                {
+                    displayName: 'Role',
+                    name: 'role',
+                    type: 'options',
+                    options: [
+                        { name: 'User (Inbound)', value: 'user' },
+                        { name: 'Assistant (Outbound)', value: 'assistant' },
+                    ],
+                    default: 'user',
+                    required: true,
+                    description: 'Whether this message is from the user or the AI assistant',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
+                {
+                    displayName: 'Message Content',
+                    name: 'messageContent',
+                    type: 'string',
+                    typeOptions: { rows: 3 },
+                    default: '',
+                    required: true,
+                    description: 'Text content of the message',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
+                {
+                    displayName: 'Media Type',
+                    name: 'mediaType',
+                    type: 'options',
+                    options: [
+                        { name: 'None', value: '' },
+                        { name: 'Image', value: 'image' },
+                        { name: 'Video', value: 'video' },
+                        { name: 'Audio', value: 'audio' },
+                        { name: 'Document', value: 'document' },
+                    ],
+                    default: '',
+                    description: 'Optional media type if the message contains media',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
+                {
+                    displayName: 'Media URL',
+                    name: 'mediaUrl',
+                    type: 'string',
+                    default: '',
+                    description: 'URL of the media file (required if Media Type is set)',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
+                {
+                    displayName: 'Is From AI',
+                    name: 'isFromAi',
+                    type: 'boolean',
+                    default: true,
+                    description: 'Whether this message was generated by the AI',
+                    displayOptions: { show: { operation: ['saveMessage'] } },
+                },
             ],
         };
         this.methods = {
@@ -142,13 +262,54 @@ class NashirWhatsApp {
                     const accountId = this.getNodeParameter('account', i);
                     const messageId = this.getNodeParameter('messageId', i);
                     const replyText = this.getNodeParameter('replyText', i);
-                    responseData = await (0, api_1.nashirApiRequest)(this, 'POST', `/messages/${messageId}/reply`, { message: replyText, account_id: accountId });
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'POST', `/messages/${messageId}/reply`, {
+                        message: replyText,
+                        account_id: accountId,
+                    });
                 }
-                else {
-                    // markRead
+                else if (operation === 'markRead') {
                     const messageId = this.getNodeParameter('messageId', i);
                     responseData = await (0, api_1.nashirApiRequest)(this, 'PATCH', `/messages/${messageId}/read`);
                 }
+                else if (operation === 'getConversationHistory') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    const limit = this.getNodeParameter('limit', i, 20);
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'GET', `/conversations/${phone}/messages`, undefined, { limit });
+                }
+                else if (operation === 'getAiStatus') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'GET', `/conversations/${phone}/ai-status`);
+                }
+                else if (operation === 'setAiStatus') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    const action = this.getNodeParameter('aiAction', i);
+                    const reason = this.getNodeParameter('reason', i, '');
+                    const body = { action };
+                    if (reason)
+                        body.reason = reason;
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'POST', `/conversations/${phone}/ai-toggle`, body);
+                }
+                else if (operation === 'saveMessage') {
+                    const phone = this.getNodeParameter('ingestPhone', i);
+                    const role = this.getNodeParameter('role', i);
+                    const content = this.getNodeParameter('messageContent', i);
+                    const mediaType = this.getNodeParameter('mediaType', i, '');
+                    const mediaUrl = this.getNodeParameter('mediaUrl', i, '');
+                    const isFromAi = this.getNodeParameter('isFromAi', i, true);
+                    const body = { phone, role, content, is_from_ai: isFromAi };
+                    if (mediaType)
+                        body.media_type = mediaType;
+                    if (mediaUrl)
+                        body.media_url = mediaUrl;
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'POST', '/messages/ingest', body);
+                }
+                else if (operation === 'getContact') {
+                    const phone = encodeURIComponent(this.getNodeParameter('phone', i));
+                    responseData = await (0, api_1.nashirApiRequest)(this, 'GET', `/contacts/${phone}`);
+                }
+                else {
+                    throw new Error(`Unknown operation: ${operation}`);
+                }
                 const rows = Array.isArray(responseData) ? responseData : [responseData];
                 returnData.push(...rows.map((d) => ({ json: d, pairedItem: i })));
             }

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

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

package/dist/nodes/shared/api.d.ts

@@ -3,7 +3,7 @@ type AnyContext = IExecuteFunctions | ILoadOptionsFunctions;
 /**
  * Make an authenticated request to the Nashir API.
  */
-export declare function nashirApiRequest(ctx: IExecuteFunctions, method: string, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject>;
+export declare function nashirApiRequest(ctx: IExecuteFunctions, method: string, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject | IDataObject[]>;
 /**
  * Upload a binary item to /api/v1/upload and return the public URL.
  */

package/dist/nodes/shared/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../nodes/shared/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EACX,iBAAiB,EAEjB,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,WAAW,EAClB,EAAE,CAAC,EAAE,WAAW,GACd,OAAO,CAAC,WAAW,CAAC,CAuBtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,UAAU,EACf,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAC1B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAiCjC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../nodes/shared/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EACX,iBAAiB,EAEjB,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,cAAc,CAAC;AAEtB,KAAK,UAAU,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;AAkC5D;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,WAAW,EAClB,EAAE,CAAC,EAAE,WAAW,GACd,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC,CAuBtC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GACxB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,UAAU,EACf,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAC1B,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAqCjC"}

package/dist/nodes/shared/api.js

@@ -3,6 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.nashirApiRequest = nashirApiRequest;
 exports.nashirUploadBinary = nashirUploadBinary;
 exports.loadAccounts = loadAccounts;
+function throwFriendlyError(error, endpoint) {
+    var _a, _b;
+    const status = (_a = error.statusCode) !== null && _a !== void 0 ? _a : (_b = error.response) === null || _b === void 0 ? void 0 : _b.statusCode;
+    if (status === 401 || status === 403) {
+        throw new Error('Authentication failed: your Nashir API key is invalid or does not have permission for this action. ' +
+            'Check your credentials at nashir.ai → Settings → API.');
+    }
+    if (status === 404) {
+        // Give a context-aware message based on the endpoint path
+        if (endpoint.includes('/contacts/')) {
+            throw new Error(`Contact not found. Verify the phone number is registered in nashir.ai.`);
+        }
+        if (endpoint.includes('/conversations/')) {
+            throw new Error(`Conversation not found for this phone number.`);
+        }
+        throw new Error(`Resource not found (404): ${endpoint}`);
+    }
+    throw error;
+}
 /**
  * Make an authenticated request to the Nashir API.
  */
@@ -26,7 +45,7 @@ async function nashirApiRequest(ctx, method, endpoint, body, qs) {
         return await ctx.helpers.request(options);
     }
     catch (error) {
-        throw error;
+        throwFriendlyError(error, endpoint);
     }
 }
 /**
@@ -56,11 +75,11 @@ async function nashirUploadBinary(ctx, itemIndex, binaryPropertyName) {
         json: true,
     };
     try {
-        const response = await ctx.helpers.request(options);
+        const response = (await ctx.helpers.request(options));
         return response.url;
     }
     catch (error) {
-        throw error;
+        throwFriendlyError(error, '/upload');
     }
 }
 /**
@@ -82,7 +101,7 @@ async function loadAccounts(ctx, platform) {
         json: true,
     };
     try {
-        const response = await ctx.helpers.request(options);
+        const response = (await ctx.helpers.request(options));
         let accounts = Array.isArray(response)
             ? response
             : ((_a = response.data) !== null && _a !== void 0 ? _a : []);
@@ -92,7 +111,11 @@ async function loadAccounts(ctx, platform) {
         }
         return accounts.map((account) => ({
             value: String(account.id),
-            name: (account.pageName || account.page_name || account.account_name || account.name || String(account.id)),
+            name: (account.pageName ||
+                account.page_name ||
+                account.account_name ||
+                account.name ||
+                String(account.id)),
         }));
     }
     catch {

package/dist/nodes/shared/api.js.map

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

package/nodes/NashirContact/NashirContact.node.ts

@@ -0,0 +1,103 @@
+import {
+	IDataObject,
+	IExecuteFunctions,
+	INodeExecutionData,
+	INodeType,
+	INodeTypeDescription,
+} from 'n8n-workflow';
+
+import { nashirApiRequest } from '../shared/api';
+
+export class NashirContact implements INodeType {
+	description: INodeTypeDescription = {
+		displayName: 'Nashir Contact',
+		name: 'nashirContact',
+		icon: 'file:nashir.svg',
+		group: ['transform'],
+		version: 1,
+		subtitle: '={{$parameter["operation"]}}',
+		description: 'Manage contacts in nashir.ai',
+		defaults: { name: 'Nashir Contact', color: '#6366f1' },
+		inputs: ['main'],
+		outputs: ['main'],
+		credentials: [{ name: 'nashirApi', required: true }],
+		properties: [
+			{
+				displayName: 'Operation',
+				name: 'operation',
+				type: 'options',
+				noDataExpression: true,
+				options: [
+					{ name: 'Get Contact', value: 'getContact', action: 'Get contact details' },
+					{ name: 'Update Contact Tags', value: 'updateTags', action: 'Add tags to a contact' },
+				],
+				default: 'getContact',
+			},
+
+			// ── Shared: phone ────────────────────────────────────────────────────────
+			{
+				displayName: 'Phone Number',
+				name: 'phone',
+				type: 'string',
+				default: '',
+				required: true,
+				placeholder: '+1234567890',
+				description: 'Phone number of the contact in international format',
+				displayOptions: { show: { operation: ['getContact', 'updateTags'] } },
+			},
+
+			// ── Update Tags fields ───────────────────────────────────────────────────
+			{
+				displayName: 'Tags',
+				name: 'tags',
+				type: 'string',
+				default: '',
+				required: true,
+				placeholder: 'vip, arabic, lead',
+				description: 'Comma-separated list of tags to apply to the contact (idempotent)',
+				displayOptions: { show: { operation: ['updateTags'] } },
+			},
+		],
+	};
+
+	async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+		const items = this.getInputData();
+		const returnData: INodeExecutionData[] = [];
+
+		for (let i = 0; i < items.length; i++) {
+			try {
+				const operation = this.getNodeParameter('operation', i) as string;
+				let responseData: IDataObject | IDataObject[];
+
+				if (operation === 'getContact') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					responseData = await nashirApiRequest(this, 'GET', `/contacts/${phone}`);
+
+				} else if (operation === 'updateTags') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					const tagsRaw = this.getNodeParameter('tags', i) as string;
+					const tags = tagsRaw
+						.split(',')
+						.map((t) => t.trim())
+						.filter(Boolean);
+					responseData = await nashirApiRequest(this, 'POST', `/contacts/${phone}/tags`, { tags });
+
+				} else {
+					throw new Error(`Unknown operation: ${operation}`);
+				}
+
+				const rows = Array.isArray(responseData) ? responseData : [responseData];
+				returnData.push(...rows.map((d) => ({ json: d, pairedItem: i })));
+
+			} catch (error) {
+				if (this.continueOnFail()) {
+					returnData.push({ json: { error: (error as Error).message }, pairedItem: i });
+					continue;
+				}
+				throw error;
+			}
+		}
+
+		return [returnData];
+	}
+}

package/nodes/NashirContact/nashir.svg

@@ -0,0 +1,5 @@
+<svg viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="60" height="60" rx="12" fill="#7C3AED"/>
+  <path d="M8 30L50 10L37 52L28 33L8 30Z" fill="white"/>
+  <path d="M28 33L37 24" stroke="#7C3AED" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/nodes/NashirWhatsApp/NashirWhatsApp.node.ts

@@ -30,10 +30,15 @@ export class NashirWhatsApp implements INodeType {
 				type: 'options',
 				noDataExpression: true,
 				options: [
+					{ name: 'Get AI Status', value: 'getAiStatus', action: 'Get AI status for a conversation' },
+					{ name: 'Get Contact', value: 'getContact', action: 'Get contact details' },
+					{ name: 'Get Conversation History', value: 'getConversationHistory', action: 'Get conversation history for a phone number' },
 					{ name: 'Get Messages', value: 'getMessages', action: 'Get messages' },
 					{ name: 'Mark as Read', value: 'markRead', action: 'Mark message as read' },
 					{ name: 'Reply to Message', value: 'replyMessage', action: 'Reply to a message' },
+					{ name: 'Save Message to Inbox', value: 'saveMessage', action: 'Save a message to the inbox' },
 					{ name: 'Send Message', value: 'sendMessage', action: 'Send a message' },
+					{ name: 'Set AI Status', value: 'setAiStatus', action: 'Pause or resume AI auto-reply' },
 				],
 				default: 'sendMessage',
 			},
@@ -114,6 +119,131 @@ export class NashirWhatsApp implements INodeType {
 				required: true,
 				displayOptions: { show: { operation: ['replyMessage'] } },
 			},
+
+			// ── Conversation History fields ──────────────────────────────────────────
+			{
+				displayName: 'Phone Number',
+				name: 'phone',
+				type: 'string',
+				default: '',
+				required: true,
+				placeholder: '+1234567890',
+				description: 'Phone number in international format',
+				displayOptions: {
+					show: {
+						operation: [
+							'getConversationHistory',
+							'getAiStatus',
+							'setAiStatus',
+							'getContact',
+						],
+					},
+				},
+			},
+
+			{
+				displayName: 'Limit',
+				name: 'limit',
+				type: 'number',
+				default: 20,
+				description: 'Number of messages to return (most recent first)',
+				displayOptions: { show: { operation: ['getConversationHistory'] } },
+			},
+
+			// ── Set AI Status fields ────────────────────────────────────────────────
+			{
+				displayName: 'Action',
+				name: 'aiAction',
+				type: 'options',
+				options: [
+					{ name: 'Pause', value: 'pause' },
+					{ name: 'Resume', value: 'resume' },
+				],
+				default: 'pause',
+				required: true,
+				description: 'Pause or resume AI auto-reply for this conversation',
+				displayOptions: { show: { operation: ['setAiStatus'] } },
+			},
+
+			{
+				displayName: 'Reason',
+				name: 'reason',
+				type: 'string',
+				default: '',
+				description: 'Optional reason for pausing (e.g. "Human takeover")',
+				displayOptions: { show: { operation: ['setAiStatus'] } },
+			},
+
+			// ── Save Message to Inbox fields ────────────────────────────────────────
+			{
+				displayName: 'Phone Number',
+				name: 'ingestPhone',
+				type: 'string',
+				default: '',
+				required: true,
+				placeholder: '+1234567890',
+				description: 'Phone number of the contact',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
+
+			{
+				displayName: 'Role',
+				name: 'role',
+				type: 'options',
+				options: [
+					{ name: 'User (Inbound)', value: 'user' },
+					{ name: 'Assistant (Outbound)', value: 'assistant' },
+				],
+				default: 'user',
+				required: true,
+				description: 'Whether this message is from the user or the AI assistant',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
+
+			{
+				displayName: 'Message Content',
+				name: 'messageContent',
+				type: 'string',
+				typeOptions: { rows: 3 },
+				default: '',
+				required: true,
+				description: 'Text content of the message',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
+
+			{
+				displayName: 'Media Type',
+				name: 'mediaType',
+				type: 'options',
+				options: [
+					{ name: 'None', value: '' },
+					{ name: 'Image', value: 'image' },
+					{ name: 'Video', value: 'video' },
+					{ name: 'Audio', value: 'audio' },
+					{ name: 'Document', value: 'document' },
+				],
+				default: '',
+				description: 'Optional media type if the message contains media',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
+
+			{
+				displayName: 'Media URL',
+				name: 'mediaUrl',
+				type: 'string',
+				default: '',
+				description: 'URL of the media file (required if Media Type is set)',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
+
+			{
+				displayName: 'Is From AI',
+				name: 'isFromAi',
+				type: 'boolean',
+				default: true,
+				description: 'Whether this message was generated by the AI',
+				displayOptions: { show: { operation: ['saveMessage'] } },
+			},
 		],
 	};
 
@@ -153,21 +283,71 @@ export class NashirWhatsApp implements INodeType {
 					}
 
 					responseData = await nashirApiRequest(this, 'POST', '/messages', body);
+
 				} else if (operation === 'getMessages') {
 					responseData = await nashirApiRequest(this, 'GET', '/messages', undefined, { platform: 'whatsapp' });
+
 				} else if (operation === 'replyMessage') {
 					const accountId = this.getNodeParameter('account', i) as string;
 					const messageId = this.getNodeParameter('messageId', i) as string;
 					const replyText = this.getNodeParameter('replyText', i) as string;
-					responseData = await nashirApiRequest(this, 'POST', `/messages/${messageId}/reply`, { message: replyText, account_id: accountId });
-				} else {
-					// markRead
+					responseData = await nashirApiRequest(this, 'POST', `/messages/${messageId}/reply`, {
+						message: replyText,
+						account_id: accountId,
+					});
+
+				} else if (operation === 'markRead') {
 					const messageId = this.getNodeParameter('messageId', i) as string;
 					responseData = await nashirApiRequest(this, 'PATCH', `/messages/${messageId}/read`);
+
+				} else if (operation === 'getConversationHistory') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					const limit = this.getNodeParameter('limit', i, 20) as number;
+					responseData = await nashirApiRequest(
+						this,
+						'GET',
+						`/conversations/${phone}/messages`,
+						undefined,
+						{ limit },
+					);
+
+				} else if (operation === 'getAiStatus') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					responseData = await nashirApiRequest(this, 'GET', `/conversations/${phone}/ai-status`);
+
+				} else if (operation === 'setAiStatus') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					const action = this.getNodeParameter('aiAction', i) as string;
+					const reason = this.getNodeParameter('reason', i, '') as string;
+					const body: IDataObject = { action };
+					if (reason) body.reason = reason;
+					responseData = await nashirApiRequest(this, 'POST', `/conversations/${phone}/ai-toggle`, body);
+
+				} else if (operation === 'saveMessage') {
+					const phone = this.getNodeParameter('ingestPhone', i) as string;
+					const role = this.getNodeParameter('role', i) as string;
+					const content = this.getNodeParameter('messageContent', i) as string;
+					const mediaType = this.getNodeParameter('mediaType', i, '') as string;
+					const mediaUrl = this.getNodeParameter('mediaUrl', i, '') as string;
+					const isFromAi = this.getNodeParameter('isFromAi', i, true) as boolean;
+
+					const body: IDataObject = { phone, role, content, is_from_ai: isFromAi };
+					if (mediaType) body.media_type = mediaType;
+					if (mediaUrl) body.media_url = mediaUrl;
+
+					responseData = await nashirApiRequest(this, 'POST', '/messages/ingest', body);
+
+				} else if (operation === 'getContact') {
+					const phone = encodeURIComponent(this.getNodeParameter('phone', i) as string);
+					responseData = await nashirApiRequest(this, 'GET', `/contacts/${phone}`);
+
+				} else {
+					throw new Error(`Unknown operation: ${operation}`);
 				}
 
 				const rows = Array.isArray(responseData) ? responseData : [responseData];
 				returnData.push(...rows.map((d) => ({ json: d, pairedItem: i })));
+
 			} catch (error) {
 				if (this.continueOnFail()) {
 					returnData.push({ json: { error: (error as Error).message }, pairedItem: i });

package/nodes/shared/api.ts

@@ -8,6 +8,38 @@ import {
 
 type AnyContext = IExecuteFunctions | ILoadOptionsFunctions;
 
+/** Shape of error objects thrown by ctx.helpers.request */
+interface RequestError extends Error {
+	statusCode?: number;
+	response?: { statusCode?: number; body?: IDataObject | string };
+}
+
+function throwFriendlyError(error: RequestError, endpoint: string): never {
+	const status =
+		error.statusCode ??
+		(error.response as { statusCode?: number } | undefined)?.statusCode;
+
+	if (status === 401 || status === 403) {
+		throw new Error(
+			'Authentication failed: your Nashir API key is invalid or does not have permission for this action. ' +
+				'Check your credentials at nashir.ai → Settings → API.',
+		);
+	}
+
+	if (status === 404) {
+		// Give a context-aware message based on the endpoint path
+		if (endpoint.includes('/contacts/')) {
+			throw new Error(`Contact not found. Verify the phone number is registered in nashir.ai.`);
+		}
+		if (endpoint.includes('/conversations/')) {
+			throw new Error(`Conversation not found for this phone number.`);
+		}
+		throw new Error(`Resource not found (404): ${endpoint}`);
+	}
+
+	throw error;
+}
+
 /**
  * Make an authenticated request to the Nashir API.
  */
@@ -17,7 +49,7 @@ export async function nashirApiRequest(
 	endpoint: string,
 	body?: IDataObject,
 	qs?: IDataObject,
-): Promise<IDataObject> {
+): Promise<IDataObject | IDataObject[]> {
 	const credentials = await ctx.getCredentials('nashirApi');
 	const baseUrl = ((credentials.baseUrl as string) || 'https://nashir.ai').replace(/\/$/, '');
 	const apiKey = credentials.apiKey as string;
@@ -38,7 +70,7 @@ export async function nashirApiRequest(
 	try {
 		return await ctx.helpers.request(options);
 	} catch (error) {
-		throw error;
+		throwFriendlyError(error as RequestError, endpoint);
 	}
 }
 
@@ -76,10 +108,10 @@ export async function nashirUploadBinary(
 	};
 
 	try {
-		const response = await ctx.helpers.request(options) as IDataObject;
+		const response = (await ctx.helpers.request(options)) as IDataObject;
 		return response.url as string;
 	} catch (error) {
-		throw error;
+		throwFriendlyError(error as RequestError, '/upload');
 	}
 }
 
@@ -106,7 +138,7 @@ export async function loadAccounts(
 	};
 
 	try {
-		const response = await ctx.helpers.request(options) as IDataObject | IDataObject[];
+		const response = (await ctx.helpers.request(options)) as IDataObject | IDataObject[];
 		let accounts: IDataObject[] = Array.isArray(response)
 			? response
 			: ((response.data as IDataObject[]) ?? []);
@@ -118,7 +150,11 @@ export async function loadAccounts(
 
 		return accounts.map((account) => ({
 			value: String(account.id),
-			name: (account.pageName || account.page_name || account.account_name || account.name || String(account.id)) as string,
+			name: (account.pageName ||
+				account.page_name ||
+				account.account_name ||
+				account.name ||
+				String(account.id)) as string,
 		}));
 	} catch {
 		return [];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "n8n-nodes-nashir",
-  "version": "0.2.2",
-  "description": "n8n community nodes for nashir.ai — publish to Facebook, Instagram, TikTok, LinkedIn, YouTube, WhatsApp and Telegram",
+  "version": "0.3.0",
+  "description": "n8n community nodes for nashir.ai — publish to Facebook, Instagram, TikTok, LinkedIn, YouTube, WhatsApp and Telegram, plus AI conversation management",
   "keywords": [
     "n8n-community-node-package",
     "nashir",
@@ -12,7 +12,10 @@
     "linkedin",
     "youtube",
     "whatsapp",
-    "telegram"
+    "telegram",
+    "ai",
+    "chatbot",
+    "conversation-history"
   ],
   "license": "MIT",
   "homepage": "https://nashir.ai",
@@ -48,7 +51,8 @@
       "dist/nodes/NashirLinkedIn/NashirLinkedIn.node.js",
       "dist/nodes/NashirYouTube/NashirYouTube.node.js",
       "dist/nodes/NashirWhatsApp/NashirWhatsApp.node.js",
-      "dist/nodes/NashirTelegram/NashirTelegram.node.js"
+      "dist/nodes/NashirTelegram/NashirTelegram.node.js",
+      "dist/nodes/NashirContact/NashirContact.node.js"
     ]
   },
   "devDependencies": {