WhatsCRM — מדריך מלא לדשבורד

מדריך זה מסביר פריט אחר פריט מה כל מסך בדשבורד עושה, איך משתמשים בו, ולמה הוא קיים. לקריאה רציפה או כעזר נקודתי.

1. מבוא ומושגי יסוד

WhatsCRM היא מערכת CRM ל-WhatsApp שמאפשרת ניהול שיחות, שליחת קמפיינים, צ'אטבוטים, ואוטומציות — דרך שני ערוצים מרכזיים:

תפקידים במערכת

2. כניסה והרשמה

הרשמה

טופס /signup דורש שם, מייל וסיסמה. ניתן גם להירשם דרך Google/Facebook (אם האדמין הפעיל זאת).

כניסה

טופס /login מחזיר JWT שנשמר ב-LocalStorage. ה-JWT מצורף לכל בקשה (גם ל-Socket.IO).

3. לוח הבקרה (Dashboard)

מסך הבית של המשתמש. מציג מבט-על על הפעילות:

4. חיבור WhatsApp

4.1 חיבור דרך QR (Baileys)

תפריט: WhatsApp QR Plugin או Add WhatsApp by QR.

1. לחץ Generate QR — נוצר instance חדש.
2. פתח WhatsApp בטלפון → מכשירים מקושרים → קישור מכשיר.
3. סרוק את ה-QR שמופיע במסך.
4. הסטטוס יעבור ל-connected והמספר יוצג.

פעולות על instance

4.2 חיבור Meta Cloud API

תפריט: Meta API Keys. כדי להפעיל חשבון WhatsApp Business צריך:

• Meta Access Token — מ-developers.facebook.com
• Phone Number ID — מספר הטלפון העסקי
• WABA ID — מזהה חשבון העסק
• Webhook URL — להעתיק לפאנל Meta בתור endpoint לקבלת הודעות

5. Inbox — תיבת הדואר

הלב של המערכת. ניהול שיחות בזמן אמת.

5.1 רשימת שיחות (צד ימין)

5.2 חלון השיחה (מרכז)

• תצוגת הודעות — בועות פנימה/החוצה, סטטוסים: ✓ נשלח, ✓✓ נמסר, ✓✓ כחול נקרא
• תיבת קלט — תומכת ב: טקסט, אמוג'י, קבצים, מיקום, איש קשר, הקלטת קול
• Quick Reply — קיצורי תשובות שמורות (מנוהל מהפרופיל)
• Translate Message — תרגום הודעה נכנסת/יוצאת דרך OpenAI
• Reply — לחיצה ארוכה על הודעה ← ציטוט בתשובה
• Reaction — הוספת אימוג'י תגובה להודעה

5.3 פאנל פרטי שיחה (צד שמאל)

6. ספר טלפונים (Phonebook)

מאגר אנשי הקשר שלך — בסיס לקמפיינים ושידורים.

פעולות עיקריות

7. שידור (Broadcast / Campaigns)

שליחה מסיבית של הודעה לרבים בו-זמנית.

7.1 יצירת קמפיין

1. Title — שם פנימי
2. Source — מאיזה instance/Meta number לשלוח
3. Audience — תווית מה-Phonebook, או רשימת מספרים, או CSV
4. Content — טקסט / מדיה / Template (חובה ב-Meta)
5. Delay — השהייה בין הודעות (שניות) למניעת ban
6. Schedule — מיידי או למועד עתידי

7.2 ניטור הקמפיין

אחרי שיצרת קמפיין, מסך הסטטיסטיקה מראה:

• Sent / Delivered / Read / Failed
• סיבות כשל (Number not on WhatsApp / Banned / Template rejected)
• ייצוא דוח

8. תבניות WhatsApp (META Templates)

תבניות הן הודעות מאושרות מראש על ידי Meta — חובה ליצירת שיחה חדשה (לא בתוך 24 שעות מתשובה אחרונה של הלקוח).

סוגי תבניות

קטגוריות

• MARKETING — קמפיינים, מבצעים, ניוזלטר
• UTILITY — אישורי הזמנה, התראות, עדכוני סטטוס
• AUTHENTICATION — OTP בלבד

תהליך יצירת תבנית

1. Templates → Add New
2. בחר שפה, קטגוריה, סוג
3. הזן Header / Body / Footer / Buttons
4. השתמש במשתנים {{1}} במקום נתונים דינמיים (שם, סכום וכו')
5. שלח לאישור Meta
6. סטטוס יחזור: APPROVED / PENDING / REJECTED

9. צ'אטבוט אוטומטי (Auto Reply)

תגובה אוטומטית להודעות נכנסות לפי כללים פשוטים.

סוגי טריגרים

סוגי תגובה

• טקסט פשוט (תומך משתנים: {{senderName}})
• תמונה/וידאו/קובץ
• רשימה (List Message) או כפתורים
• הפניה ל-Flow Builder לזרימה מורכבת
• הקצאה לסוכן (Assign to Agent)

10. בונה זרימות (Flow Builder)

אוטומציה ויזואלית מבוססת nodes — כמו תרשים זרימה.

סוגי Nodes נפוצים

תהליך עבודה

1. New Flow → תן שם
2. גרור nodes למסך, חבר אותם בקווים
3. הגדר משתנים: {{name}}, {{phone}}, {{custom.field}}
4. Test בסימולטור או על מספר ניסיון
5. שמור והפעל

11. סוכני AI

הפעלת GPT (OpenAI) כסוכן וירטואלי המנהל שיחות.

הגדרה

1. AI Settings → הזנת OpenAI API Key
2. בחירת מודל: gpt-4o-mini (זול, מהיר) או gpt-4o (חכם יותר, יקר)
3. הזנת System Prompt — האישיות וההנחיות לבוט
4. הגבלת הקשר: כמה הודעות אחורה לזכור
5. תנאי העברה לאדם (Transfer Rules) — מילות מפתח / כשל בהבנה

12. סוכנים אנושיים (Agents)

הוספת חברי צוות לטיפול בשיחות.

ניהול סוכנים

• Add Agent — מייל, סיסמה, שם
• Permissions — האם רואה רק שיחות מוקצות, או הכל
• Department / Skills — לסוכנים אוטומטיים
• Status — Active / Disabled

תצוגת הסוכן

סוכן מתחבר ל-/agent ורואה רק שיחות שהוקצו לו (אלא אם יש לו הרשאת View All). בפאנל שלו: My Tasks, רשימת שיחות פתוחות, סטטיסטיקות אישיות.

13. WhatsApp Warmer

"חימום" מספר WhatsApp חדש על ידי שיחות אוטומטיות בין מספרים שלך — להגדלת אמינות אצל WhatsApp.

1. חברו 2+ instances של QR
2. הגדירו הודעות חימום (Warmer Messages) — טקסטים אנושיים שונים
3. לחצו Start Warmer
4. המערכת תשלח אוטומטית הודעות בין המספרים בקצב טבעי

14. Telegram

חיבור Telegram bot לאותה תיבת Inbox מאוחדת.

1. קבלו API ID ו-API Hash מ-my.telegram.org
2. הזינו ב-Settings → Telegram
3. אשרו עם קוד SMS
4. שיחות Telegram יופיעו ב-Inbox עם תג TG

15. Webhooks

שליחת אירועים אוטומטית למערכות חיצוניות (n8n, Zapier, Make, CRM שלכם).

הגדרה

1. Settings → Webhooks → Add
2. URL — כתובת המערכת החיצונית
3. Secret — מפתח לאימות חתימה (HMAC-SHA256)
4. Events — message.received / message.sent / chat.assigned / וכו'

אימות חתימה

כל webhook יוצא נשלח עם header X-Webhook-Signature: sha256=<hex>. במקלט:

const expected = "sha256=" + crypto
  .createHmac("sha256", SECRET)
  .update(rawBody)
  .digest("hex");
if (header !== expected) reject();

16. REST API

שליחה וקבלה של הודעות מתוכנות חיצוניות באמצעות API Key.

קבלת API Key

Profile → Generate API Keys → העתיקו את ה-token (לא ניתן לראותו שוב).

endpoints עיקריים

Rate Limit

60 בקשות לדקה לכל endpoint, headers X-RateLimit-* בכל תגובה. חריגה ← 429 + Retry-After.

17. פרופיל ותשלומים

פרופיל אישי

תוכנית (Plan)

הסעיף Plan Details מראה:

• שם התוכנית הנוכחית + תאריך תפוגה
• מגבלות: מספר QR accounts, contacts, agents, יכולות (Cloud API, Warmer, AI)
• כפתור Upgrade / Renew

תשלום

שערי תשלום נתמכים: Stripe, PayPal, Razorpay, Paystack, MercadoPago — לפי הגדרת האדמין.

18. פאנל אדמין

גישה רק עם תפקיד Admin. כתובת: /admin.

סעיפים מרכזיים

19. פתרון תקלות נפוצות

WhatsCRM Guide · גרסה 2026.04 · חזרה למעלה ↑