n8n
המדריך המלא בעברית

מה זה n8n ולמה הוא שונה?

n8n (מבטאים "n-eight-n") הוא כלי אוטומציה ויזואלי בקוד פתוח שמאפשר לחבר אפליקציות, לבנות Workflows מורכבים, ולהריץ AI Agents — הכל בממשק drag-and-drop. בניגוד ל-Zapier ו-Make.com שמריצים הכל בענן שלהם בתשלום חודשי, n8n מאפשר Self-hosting מלא: הנתונים שלך נשארים אצלך, וה-Executions הם בחינם לעולם.

הפלוסופיה של n8n היא "visual-first, code when needed" — רוב האוטומציות נבנות ויזואלית, אבל כשצריך לוגיקה מורכבת אפשר להכניס JavaScript מלא בתוך Code Node. זה מה שמבדיל אותו מהמתחרים: לא בחירה בין no-code לקוד, אלא שניהם יחד.

n8n vs Zapier vs Make.com — טבלת השוואה מהירה

התקנה — 3 אפשרויות

n8n ניתן להתקנה בשלוש דרכים עיקריות. לרוב המשתמשים Docker הוא הבחירה הטובה ביותר — הוא מבודד, קל לעדכון, ועובד זהה בכל מערכת הפעלה.

אפשרות 1 — Docker (מומלץ לשרתים)

# הרצה בסיסית — n8n זמין בhttp://localhost:5678
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

אפשרות 2 — Docker Compose (לפרודקשיין)

version: "3"
services:
  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your_secure_password
      - N8N_ENCRYPTION_KEY=your_32_char_key
      - N8N_HOST=your-domain.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https

אפשרות 3 — npm (לפיתוח מקומי)

# דרישה: Node.js 18+
npx n8n

# או התקנה גלובלית
npm install n8n -g
n8n start

# פתח: http://localhost:5678

מושגי יסוד

לפני שבונים את ה-Workflow הראשון, חשוב להבין את הבנייה הבסיסית של n8n.

Triggers — מה מפעיל את ה-Workflow?

• Webhook Trigger: HTTP POST/GET נכנס מאפליקציה חיצונית — הדרך הנפוצה ביותר
• Schedule (Cron): הרצה לפי לוח זמנים — כל יום ב-09:00, כל שעה, כל ראשון בחודש
• App Event Triggers: מאזין לאירועים ספציפיים — "מייל חדש ב-Gmail", "שורה חדשה ב-Sheets"
• Manual Trigger: הפעלה ידנית לטסטינג מה-UI
• Error Trigger: מופעל כשקורית שגיאה ב-Workflow אחר

Nodes — הלבנים של ה-Workflow

• Input Nodes: קוראים נתונים — HTTP Request, Google Sheets Read, Database Query
• Process Nodes: Code, Set, IF, Switch, Merge, Loop Over Items, Function
• Output Nodes: Gmail Send, Slack Message, Notion Create Page, DB Insert
• AI Nodes: AI Agent, OpenAI, Claude, Embeddings, Vector Store (ראה פרק AI)

Data Flow — איך נתונים זורמים?

כל Node מקבל מערך של Items — כל Item הוא JSON Object. אם Node קודם החזיר 5 פריטים, ה-Node הבא יעבד כל אחד מהם בנפרד (אלא אם Merge). זה מה שנקרא "Loop implicite" — לולאה אוטומטית.

Expressions — גישה לנתונים

{{ $json.email }}                        // שדה email מה-Item הנוכחי
{{ $json.user.name }}                    // nested field
{{ $now.format('YYYY-MM-DD') }}         // תאריך היום
{{ $items("Gmail Trigger")[0].json.subject }} // שדה מ-Node ספציפי
{{ $env.MY_API_KEY }}                    // משתנה סביבה
{{ $json.price * 1.17 }}                // חישוב מתמטי
{{ $json.text.toUpperCase() }}          // פעולות מחרוזת

{
  "id": 1,
  "email": "user@example.com",
  "name": "ישראל ישראלי",
  "company": "StartupXYZ",
  "createdAt": "2026-04-16T09:00:00Z",
  "tags": ["lead", "enterprise"]
}

IF / Switch — Branching Logic

• IF Node: מפצל ל-2 נתיבים לפי תנאי — True / False
• Switch Node: מפצל למספר נתיבים לפי ערך (כמו switch/case בקוד)
• Loop Over Items: מעבד מערך — שולח request לכל פריט בנפרד
• Error Trigger + Try/Catch: לטיפול בשגיאות בצורה מובנית

Workflow ראשון — שלב אחרי שלב

נבנה Workflow מלא: Webhook מקבל נתון → שולח HTTP Request לAPI חיצוני → מעבד את התשובה → שולח מייל עם התוצאה.

שלב 1 — Webhook Trigger

לחץ "+ Add Node" → חפש "Webhook" → בחר Webhook. הגדר:

• HTTP Method: POST
• Path: my-first-workflow
• Authentication: None (לטסטינג)

n8n יתן לך URL: https://your-n8n.com/webhook/my-first-workflow

שלב 2 — HTTP Request Node

הוסף Node → HTTP Request. הגדר:

Method: GET
URL: https://jsonplaceholder.typicode.com/posts/{{ $json.postId }}
# postId מגיע מה-Webhook body

שלב 3 — Set Node (Transform)

הוסף Set Node כדי לעצב את הנתונים:

# הגדר Fields חדשים:
subject:  "פוסט חדש: {{ $json.title }}"
body:     "{{ $json.body }}"
postId:   {{ $json.id }}
fetchedAt: {{ $now.toISO() }}

שלב 4 — Gmail Node (Send Email)

• Resource: Message
• Operation: Send
• To: {{ $json.recipientEmail }}
• Subject: {{ $json.subject }}
• Message: {{ $json.body }}

שלב 5 — Test!

curl -X POST https://your-n8n.com/webhook/my-first-workflow \
  -H "Content-Type: application/json" \
  -d '{"postId": 1, "recipientEmail": "you@example.com"}'

AI & LLM Nodes — n8n כ-AI Orchestrator

זה הסעיף החשוב ביותר לקוראי האתר שלנו. n8n v1.0+ כולל Langchain integration מלאה עם AI Agent Node, Vector Store Nodes, Embeddings ועוד — הכל ויזואלית, ללא שורת קוד אחת (אם לא רוצים).

AI Agent Node — הלב של n8n AI

AI Agent Node הוא LangChain Agent שמרוצה ישירות ב-n8n. הוא מקבל Chat Message, מחליט אילו Tools להשתמש, מריץ אותם, ומחזיר תשובה. Tools הם Nodes אחרים ב-n8n — Google Search, Calculator, HTTP Request, Notion, ועוד.

כל AI Nodes ב-n8n

• AI Agent: Agent מלא עם Tool Use — ReAct loop, multi-step reasoning
• OpenAI Chat Model: GPT-4o, GPT-4 Turbo — חיבור ישיר לOpenAI API
• Anthropic (Claude): Claude 3.5 Sonnet/Opus — מיועד לניתוח מורכב
• Google Gemini: Gemini 1.5 Pro/Flash — context window של 1M tokens
• Ollama: מריץ מודלים מקומיים — Llama 3, Mistral, Qwen (פרטיות מלאה)
• Embeddings Nodes: OpenAI Embeddings, Google Embeddings — לVector DB
• Vector Store Nodes: Pinecone, Supabase pgvector, Qdrant, Chroma
• Chat Memory: Buffer Memory, Summary Memory, Redis Memory — שמירת היסטוריה
• Document Loaders: PDF, CSV, JSON, Website Scraper — לRAG Pipeline

Code Node — AI Processing עם JavaScript

כשצריך לוגיקה שהNodes המובנים לא מספקים, Code Node מאפשר JavaScript מלא עם גישה לכל ה-n8n API:

// Code Node — custom AI processing
const items = $input.all();
const results = [];

for (const item of items) {
  const response = await $http.request({
    method: 'POST',
    url: 'https://api.openai.com/v1/chat/completions',
    headers: {
      Authorization: `Bearer ${$env.OPENAI_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: {
      model: 'gpt-4o',
      messages: [
        {
          role: 'system',
          content: 'אתה עוזר לניתוח נתוני לידים. החזר JSON בלבד.'
        },
        {
          role: 'user',
          content: `נתח את הליד הבא:\n${JSON.stringify(item.json)}`
        }
      ],
      response_format: { type: 'json_object' }
    }
  });

  const analysis = JSON.parse(
    response.choices[0].message.content
  );

  results.push({
    json: {
      ...item.json,
      aiScore: analysis.score,
      aiSummary: analysis.summary,
      nextAction: analysis.recommendedAction
    }
  });
}

return results;

אינטגרציות פופולריות

n8n מגיעה עם 400+ Native Nodes ועוד אלפי אינטגרציות דרך HTTP Request Node (כל API שיש לו documentation).

Google Workspace

• Gmail: שליחה, קריאה, חיפוש, תיוג, Draft יצירה, מעקב Attachments
• Google Sheets: קריאה, כתיבה, עדכון, מחיקה, חיפוש — בסיס נתונים קל לכולם
• Google Drive: Upload, Download, יצירת תיקיות, שיתוף
• Google Calendar: יצירת אירועים, בדיקת זמינות, עדכון
• Google Docs: יצירת מסמכים, עדכון תוכן, מיזוג Templates

CRM & Business Tools

• HubSpot: Contacts, Deals, Forms, Emails — CRM מלא
• Salesforce: SOQL queries, Leads, Opportunities
• Notion: Databases, Pages, Blocks — בסיס נתונים + wiki
• Airtable: Records, Views, Automations

Communication

• Slack: Messages, Channel management, Files, Webhooks
• Telegram Bot: שליחה, קבלה, Inline Keyboards, Media
• WhatsApp Business: דרך Twilio או 360dialog — Messages, Templates
• Discord: Bot messages, Channel management

E-commerce & Dev

• Shopify: Orders, Products, Customers, Inventory
• WooCommerce: Orders, Coupons, Products
• GitHub: Issues, PRs, Repos, Webhooks
• Jira / Linear: Issues, Sprints, Comments
• HTTP Request Node: כל API שיש לו documentation — גמישות בלתי מוגבלת

טכניקות מתקדמות

Sub-workflows — Reusable Components

Sub-workflow הוא Workflow שנקרא מתוך Workflow אחר. זה מאפשר מודולריות — "Send Email" Sub-workflow אחד שכל ה-Workflows האחרים קוראים לו. שינוי אחד עדכן את כולם.

# להפעיל Sub-workflow:
# הוסף Node: "Execute Workflow"
# Workflow: בחר את ה-Sub-workflow
# Wait for Sub-workflow Completion: true
# Parameters: { "email": "{{ $json.email }}" }

Webhooks עם Authentication

# Header Authentication
Authorization: Bearer {{ $env.WEBHOOK_SECRET }}

# Basic Auth
Username: {{ $env.WEBHOOK_USER }}
Password: {{ $env.WEBHOOK_PASS }}

# HMAC Signature Verification (Code Node)
const crypto = require('crypto');
const signature = $request.headers['x-hub-signature-256'];
const expectedSig = 'sha256=' + crypto
  .createHmac('sha256', $env.WEBHOOK_SECRET)
  .update(JSON.stringify($request.body))
  .digest('hex');

if (signature !== expectedSig) {
  throw new Error('Invalid webhook signature');
}

Database Nodes

• PostgreSQL: Execute Query, Insert, Update, Delete — מסד נתונים מלא
• MySQL / MariaDB: Query execution + Parameterized queries
• MongoDB: CRUD operations, Aggregation pipelines
• Redis: Get/Set/Delete Keys — לCache ולQueue Mode
• SQLite: לפרויקטים קטנים ב-Self-hosted

Triggering Workflows Programmatically

# Trigger Webhook מ-Terminal
curl -X POST https://your-n8n.com/webhook/my-workflow \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SECRET" \
  -d '{"action": "process", "userId": 123, "data": "hello"}'

# Trigger דרך n8n REST API
curl -X POST https://your-n8n.com/api/v1/workflows/1/activate \
  -H "X-N8N-API-KEY: your-api-key"

Queue Mode — Scaling לנפח גדול

לאתרים עם אלפי Executions בשעה, n8n תומך ב-Queue Mode עם Redis:

# .env לQueue Mode
EXECUTIONS_MODE=queue
QUEUE_BULL_REDIS_HOST=redis
QUEUE_BULL_REDIS_PORT=6379
N8N_CONCURRENCY_PRODUCTION_LIMIT=10

# Docker Compose עם Redis
services:
  redis:
    image: redis:7-alpine
    restart: always
  n8n-main:
    image: n8nio/n8n
    environment:
      - EXECUTIONS_MODE=queue
  n8n-worker:
    image: n8nio/n8n
    command: n8n worker
    scale: 3  # 3 worker processes

n8n vs Make.com vs Zapier — ניתוח מלא

כל הכלים טובים — השאלה היא מה המקרה שלך. ככה להחליט:

5 פרויקטים מוכנים לבנייה

5 Workflows אמיתיים מוכנים להעתקה, מסודרים לפי רמת קושי:

גיליון עזר — Quick Reference

Expressions נפוצות

// גישה לנתונים
{{ $json.fieldName }}                    // שדה בסיסי
{{ $json.nested.field }}                // nested
{{ $json.array[0].value }}              // ראשון במערך

// תאריך ושעה
{{ $now.toISO() }}                      // ISO format
{{ $now.format('DD/MM/YYYY') }}         // פורמט ישראלי
{{ $now.minus({days: 7}).toISO() }}     // שבוע אחורה

// קבצים וסביבה
{{ $env.MY_SECRET_KEY }}                // env variable
{{ $binary.data }}                      // binary data (files)

// Node אחר
{{ $items("Node Name")[0].json.field }} // מ-Node ספציפי
{{ $("Node Name").first().json.field }} // קיצור דרך

// Conditional
{{ $json.score > 80 ? "VIP" : "Standard" }}  // ternary

Cron Expressions נפוצות

Node Patterns נפוצים

# Pattern 1 — Enrich Data
HTTP Request (GET /users/{id}) → Set (merge fields) → output

# Pattern 2 — Filter + Route
IF (score > 80) → [True] Premium path / [False] Standard path

# Pattern 3 — Batch Processing
Split In Batches (size: 10) → HTTP Request → Wait (1s) → Merge

# Pattern 4 — Error Handling
Try: [Main Workflow] → Catch: Error Trigger → Slack Alert + Retry

# Pattern 5 — RAG Pipeline
Document Loader → Text Splitter → Embeddings → Vector Store Insert

Webhook Testing Tips

• השתמש ב-ngrok לפיתוח מקומי: ngrok http 5678 — מייצר URL ציבורי זמני
• לחץ "Listen for Test Event" ב-n8n לפני שליחת ה-Webhook
• Webhook.site — כלי חינמי לבדיקת Payload לפני חיבור ל-n8n
• תמיד בדוק את Response Code — n8n מחזיר 200 גם אם ה-Workflow נכשל

Environment Variables חשובים

N8N_ENCRYPTION_KEY=32_char_secret_key    # הכרחי!
N8N_HOST=your-domain.com
N8N_PORT=5678
N8N_PROTOCOL=https
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=secure_password
N8N_LOG_LEVEL=info                        # debug | info | warn | error
EXECUTIONS_DATA_SAVE_ON_SUCCESS=all       # שמור היסטוריה
EXECUTIONS_DATA_MAX_AGE=168               # שמור 7 ימים (שעות)