Description

n8n-nodes-nashir

n8n community nodes for 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

In your n8n instance, go to Settings → Community Nodes → Install and enter:

n8n-nodes-nashir

Nodes

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) |
| Get Conversation History | Fetch recent messages by sender id for AI agent context (cross-platform: FB / IG / WhatsApp) |
| Search Knowledge Base | Find relevant knowledge chunks from the business’s knowledge base for AI agent context (server-side embedding) |

Nashir Facebook

| Operation | Description |
|———–|————-|
| Publish Post | Publish a post / reel to a Facebook Page |
| Schedule Post | Schedule a post for later |
| Get Posts | List posts published via nashir.ai |
| Delete Post | Remove a post from the page |
| Get Comments | List comments received on Page posts |
| Reply to Comment | Reply to a Page comment |
| Delete Comment | Delete a Page comment via the team’s page token (used by AI moderation) |
| Get Messages | List inbound Messenger messages |
| Reply to Message | Reply to a Messenger thread |

Nashir Instagram

| Operation | Description |
|———–|————-|
| Publish Post | Publish a feed post / reel / story / carousel |
| Schedule Post | Schedule a post for later |
| Get Posts | List posts published via nashir.ai |
| Delete Post | Remove a post |
| Get Comments | List comments received on IG media |
| Reply to Comment | Reply to an IG comment |
| Delete Comment | Delete an IG comment via the team’s page token (used by AI moderation) |
| Get Messages | List inbound DMs |
| Reply to Message | Reply to a DM thread |

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.

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.6.1 — Apr 2026

Fix: Nashir Contact is now wireable as an AI Agent tool

• Added usableAsTool: true to Nashir Contact‘s node description. n8n requires this flag on community nodes for ai_tool connections to survive workflow import. Without it, dropping Nashir Contact → Search Knowledge Base into an Agent’s tools input was silently rejected on re-import (the connection lived in the JSON but the n8n UI rendered the agent disconnected).
• Symptom this fixes: importing the AI Auto Reply v2 template with 0.6.0 left the four KB nodes floating, agents showed no Tool / Chat Model / Memory wiring. Update to 0.6.1, re-import the template, wiring renders correctly.
• No API change — workflows and credentials migrate cleanly. Operation surface is unchanged from 0.6.0.

0.6.0 — Apr 2026

New operation: Search Knowledge Base on Nashir Contact

• Search Knowledge Base on Nashir Contact — retrieve the top N most relevant chunks from the team’s knowledge base. The customer passes plain text; nashir.ai handles embedding (OpenAI text-embedding-3-small) and vector similarity server-side. No OPENAIAPIKEY or Supabase credentials needed in n8n.
• Inputs: query (required — the customer’s question or topic) and kbLimit (default 4, max 10).
• Returns { chunks: [{ id, content, metadata, similarity }, ...], count }.
• Backed by POST /api/v1/knowledge/search on nashir.ai.
• Used by the v2 AI Auto Reply template to replace the four Supabase Vector Store + OpenAI Embeddings node pairs — knowledge retrieval is now a single nashir-native call.

0.5.0 — Apr 2026

New operation: Get Conversation History on Nashir Contact

• Get Conversation History on Nashir Contact — fetch the last N messages exchanged with a sender across any platform (FB Messenger, IG Direct, FB/IG comments, WhatsApp). Returns chronological { role, content, created_at } rows ready to inject into an AI agent prompt.
• Inputs: senderId (required — the platform-specific sender id from the inbound webhook payload) and limit (default 20, max 50).
• Backed by GET /api/v1/conversations/by-sender/:sender_id?limit=N on nashir.ai.
• Used by the v2 AI Auto Reply template to replace the n8n memoryBufferWindow step — history is now persisted server-side in inbox_messages and shared across workflow executions.

0.4.0 — Apr 2026

New operation: Delete Comment (Facebook + Instagram)

• Delete Comment on Nashir Facebook and Nashir Instagram — removes a comment via Meta Graph using the team’s page token, looked up server-side. No METAPAGEACCESS_TOKEN env var required in n8n.
• Auto-resolves the account/page from the stored comment row — only the commentId (nashir.ai message id) is needed. No account dropdown.
• Idempotent: re-deleting an already-removed comment returns { success: true, already_deleted: true }.
• Recoverable Meta errors (notfound, permissiondenied) return { success: false, error, detail } with HTTP 200 so the workflow can continue. Token / network errors return HTTP 502 so n8n surfaces them.
• Backed by POST /api/v1/comments/:id/delete on nashir.ai.
• Bumped Meta Graph API version to v25.0 for both reply and delete endpoints.

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 isfromai 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)
• brandcontenttoggle renamed to Content Disclosure in UI
• Removed FOLLOWEROFCREATOR privacy option (not supported by Direct Post API)

0.2.1 — Mar 2026

• TikTok node: add brandcontenttoggle, brandorganictoggle, brandbrandedcontent_toggle
• TikTok node: carousel support via comma-separated image URLs
• YouTube node: madeForKids, tags, category, license, notifySubscribers, comments fields

0.2.0 — Feb 2026

• Initial release: Facebook, Instagram, TikTok, LinkedIn, YouTube, WhatsApp, Telegram nodes