maxai-wa-agent — סוכן WhatsApp לעסקים, בעברית

🇮🇱 חבילה מוכנה-לשימוש שבונה לך סוכן WhatsApp שעובד 24/7 — Green API + Claude Agent SDK + עברית מקצה לקצה.

נוצר ע"י מקסים גומברג | MAX AI שיטה ייחודית שעבדה בשטח עם 50+ לקוחות אמיתיים.

🌐 maximgomberg.com · 📧 max@ms-marketing.co.il Instagram · Facebook · LinkedIn

---

מה זה?

חבילת Claude Code שעוטפת לך את כל מה שצריך כדי לבנות בוט WhatsApp שמשרת את הלקוחות שלך — בלי לכתוב שורת קוד אחת בעצמך.

פותח את התיקייה ב-Claude Code → /wa → קלוד מוביל אותך דרך 6 שלבים בעברית.
תוך 1-2 שעות יש לך בוט חי שעונה ללקוחות שלך אוטומטית.

---

למה יש שכזה משונה ובמה זה שונה?

הרבה בוטים בחוץ. הבעיה: כולם דורשים API key לאיזה ספק AI שעולה כסף לכל הודעה.

שלנו משתמש במנוי Claude Code שלך (פלאן Pro/Max/Team). תוצאה: עלות קבועה במקום פר-הודעה. אידיאלי לבוטים שמקבלים 50+ הודעות ביום.

מעבר לזה — קוד שהוכח בייצור עם:

• ✅ Customer profiles עם זיכרון אמיתי בין שיחות
• ✅ תיאום פגישות חצי-אוטומטי (Calendar integration)
• ✅ Handoff אינטיליגנטי לבעלים בטלגרם
• ✅ Pause Mode — הבוט עוצר אוטומטית כשאתה כותב ידנית בוואטסאפ ללקוח
• ✅ Anti-injection (לא נופלים לתחבולות)
• ✅ ניהול קבוצות חכם (לא ספאם בקבוצות תלמידים)
• ✅ Broadcast בטוח לקהילות (בדיקת כפילויות, dry-run by default)
• ✅ Daily Digest — סיכום בוקר אוטומטי לטלגרם
• ✅ Voice fallback (הודעות קוליות לא שוברות את הבוט)

---

איך מתחילים? — 3 מסלולי התקנה

🟢 מסלול A — Marketplace (הכי קל)

מתאים: יש לך Claude Code Desktop מותקן

/plugin marketplace add github.com/MaxGomb/maxai-wa-agent
/plugin install maxai-wa-agent@maxai
/wa

🟡 מסלול B — Git clone

מתאים: מכיר טרמינל בסיסי

git clone https://github.com/MaxGomb/maxai-wa-agent
cd maxai-wa-agent
claude

ואז בתוך Claude Code:

/wa

🔵 מסלול C — ZIP download

מתאים: לא יודע מה זה גיט

1. לחץ "Code" → "Download ZIP" למעלה בעמוד הזה
2. פתח את ה-ZIP
3. פתח את התיקייה ב-Claude Code Desktop (File → Open Folder)
4. בתחתית הצ'אט תקליד: /wa

---

דרישות

	חובה?
Claude Code (CLI או Desktop)	✅ חובה — וכמובן מנוי
מספר טלפון לבוט (eSIM מומלץ, ~₪15/חודש)	✅ חובה
חשבון Green API (חינמי לעוזר אישי, $15/חודש לשירות לקוחות)	✅ חובה
חשבון Google עם Gmail	⚠️ לפיצ'רים של יומן/מייל
VPS (Contabo ~$5/חודש)	⚠️ אם רוצים 24/7 — חלופה: רץ על המק
חשבון טלגרם	⚠️ אם רוצים התראות לטלפון

---

מה כלול

maxai-wa-agent/
├── .claude-plugin/        ← Claude Code Plugin recognized
├── commands/
│   └── wa.md              ← /wa — נקודת הכניסה
├── skills/                ← 6 שלבי הבנייה
│   ├── wa-setup/          ← Green API + טלפון
│   ├── wa-characterize/   ← אפיון העסק/הסוכן
│   ├── wa-build/          ← בניית הקוד
│   ├── wa-deploy/         ← העלאה (Mac או VPS)
│   ├── wa-connect/        ← חיבור Google + Telegram
│   └── wa-maintain/       ← תחזוקה
├── template/              ← הקוד המוכן (Python polling loop)
│   ├── bot/               ← 12 מודולים
│   ├── prompts/           ← templates עם {{ placeholders }}
│   ├── scripts/           ← keepalive, backup, install
│   ├── main.py
│   └── requirements.txt
├── examples/              ← 2 דוגמאות מלאות
│   ├── personal_trainer/
│   └── business_coach/
└── docs/                  ← מדריכים מפורטים בעברית
    ├── GREEN_API_GUIDE.md
    ├── CONTABO_VPS_GUIDE.md
    ├── MAC_INSTALL_GUIDE.md
    ├── GOOGLE_WORKSPACE_GUIDE.md
    └── TROUBLESHOOTING.md

---

ארכיטקטורה — מה רץ איפה?

WhatsApp ──► Green API queue (24h retention)
                │
                ▼
        main.py (polling loop, רץ על המק או VPS)
                │
                ▼
    Claude Agent SDK (משתמש במנוי שלך — לא API key!)
                │
        ┌───────┼───────┐
        ▼       ▼       ▼
   bot-tools  Skills    MCP servers
   (in-proc)  (אופציונלי) (Calendar, Gmail)
                │
                ▼
        Profiles (markdown) + SQLite (היסטוריה)

---

תרומה / שאלות

• שאלות: Discussions
• באגים: Issues
• תרומה: Pull Requests מתקבלים בברכה

---

רישיון

MIT — עשה איתו מה שאתה רוצה, אבל אם עזר לך, תרשום מילה טובה 🙏

---

שאלות / רוצה לדבר עם מקסים?

• 📧 max@ms-marketing.co.il
• 🌐 maximgomberg.com