בוט ווטסאפ אישי מ-0 — מדריך מלא לקלוד קוד

מה תקבלו בסוף המדריך — עוזר אישי בווטסאפ שיכול: לקבל הודעות קוליות ולהבין אתכם; לנהל משימות ופרויקטים; לזכור הכל במסד נתונים; לענות לכל שאלה בעברית חכמה; לעבוד 24/7 גם כשאתם לא שם. זמן הקמה: כשעה בפעם הראשונה.

הפלואו — ככה זה עובד אתם שולחים הודעה בווטסאפ ↓ Green API מקבל את ההודעה ↓ שולח אותה לשרת שלכם על המחשב ↓ הבוט מעבד ומחליט מה לעשות ↓ אם הקלטה קולית ← Groq מתמלל ← מעבד כטקסט ↓ אם שאלה חכמה ← Claude עונה ↓ אם פקודה (משימה/פרויקט) ← שמור ב-SQLite ↓ תשובה חוזרת לווטסאפ שלכם

מה צריך (הכל חינמי להתחלה)

כלי	למה	עלות
Claude Code ב-VS Code	כבר יש לכם ✓ (מי שאין לו שיתקין ויחזור)	—
Python 3	שפת הבוט	חינם
Green API	חיבור ווטסאפ	חינם 3 חודשים
ngrok	מנהרה בין ווטסאפ לשרת	חינם
Groq API	תמלול הקלטות קוליות	חינם
Anthropic API	תשובות חכמות	$5 מספיק לחודשים

שלב 1 — בדיקת Python — פתחו VS Code ← Terminal ← New Terminal ← python3 --version. אם מופיע Python 3.x.x — עברו לשלב 2. אם לא — python.org → Downloads.

שלב 2 — חשבון Green API (5 דקות)

כנסו ל-green-api.com
Console → Sign Up
Create instance → בחרו Developer (חינם)
שמרו: idInstance (מספר) ו-apiTokenInstance (מפתח ארוך)
Scan QR Code → סרקו עם הווטסאפ שלכם

✅ הווטסאפ שלכם מחובר. מכאן — כל הודעה שתשלחו לעצמכם, הבוט יראה.

שלב 3 — חשבון ngrok (5 דקות)

ngrok.com → Sign Up
Your Authtoken → העתיקו
הורידו ngrok: Mac brew install ngrok; Windows — הורידו EXE מ-ngrok.com/download ושמרו בתיקיית הפרויקט
ngrok config add-authtoken הtoken_שלכם

שלב 4 — מפתח Groq API (2 דקות) — console.groq.com → התחברו עם Google → API Keys → Create API Key → שמרו (מתחיל ב-gsk_).

שלב 5 — מפתח Anthropic API (2 דקות) — console.anthropic.com → API Keys → Create Key → שמרו (מתחיל ב-sk-ant-). הוסיפו $5 לחשבון.

שלב 6 — פתיחת הפרויקט ב-VS Code — פתחו VS Code; File → Open Folder; צרו תיקייה whatsapp-bot; פתחו אותה; פתחו Claude Code: Ctrl+Shift+P ← Claude ← Open Claude Code.

שלב 7 — הפרומפט לקלוד קוד 🔑 (העתיקו הכל ושלחו):

פרומפט

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

הטכנולוגיות:
- Python 3 עם Flask
- Green API לחיבור ווטסאפ
- SQLite למסד הנתונים (בקובץ bot_data.db)
- Groq API לתמלול הקלטות קוליות (מודל: whisper-large-v3)
- Anthropic API (claude-haiku-4-5-20251001) לתשובות חכמות

צור את הקבצים:
1. requirements.txt עם: flask, requests, anthropic, groq, python-dotenv
2. .env.example עם: GREEN_API_INSTANCE_ID, GREEN_API_TOKEN, ANTHROPIC_API_KEY, GROQ_API_KEY, MY_PHONE
3. database.py — אתחול SQLite עם 3 טבלאות
4. bot_logic.py — לוגיקת הבוט
5. app.py — שרת Flask
6. README.md — הוראות הרצה

מסד הנתונים (database.py):
- tasks: id INTEGER PRIMARY KEY, text TEXT, project_id INTEGER, status TEXT DEFAULT 'open', created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, completed_at TIMESTAMP
- projects: id INTEGER PRIMARY KEY, name TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
- messages: id INTEGER PRIMARY KEY, sender_phone TEXT, content TEXT, response TEXT, message_type TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP

לוגיקת הבוט (bot_logic.py) — זהה פקודות לפי מילות מפתח:
- "הוסף" / "תוסיף" / "תזכיר" / "צור משימה" → INSERT לטבלת tasks, ענה "נוסף! המשימה: [טקסט]"
- "משימות" / "מה יש לי" / "רשימה" / "מה המשימות" → SELECT tasks WHERE status=open, החזר ממוספר
- "סיימתי" / "הסתיים" / "בוצע" + מספר → UPDATE task SET status=done, ענה "מצוין! סומן כהושלם"
- "פרויקט חדש" + שם → INSERT לטבלת projects, ענה "נוצר פרויקט: [שם]"
- "פרויקטים" → הצג רשימת כל הפרויקטים
- "עזרה" → החזר תפריט כל הפקודות בעברית
- כל שאלה אחרת → שלח ל-Claude Haiku עם system prompt בעברית, החזר תשובה

לוגיקת הקלטה קולית:
אם typeMessage הוא audioMessage או pttMessage:
1. הורד קובץ מה-downloadUrl עם requests.get
2. שמור זמנית כ-/tmp/audio_temp.ogg
3. שלח ל-Groq: client.audio.transcriptions.create(model=whisper-large-v3, file=...)
4. עבד את הטקסט המתומלל בדיוק כמו הודעת טקסט
5. מחק את הקובץ הזמני

שרת Flask (app.py):
- POST /webhook — מקבל הודעות
- GET /health — מחזיר {"status": "ok"}
- סנן: רק typeWebhook == "incomingMessageReceived"
- סנן: רק אם senderData.sender מתחיל ב-MY_PHONE (רק אתם)
- לוג כל הודעה ותשובה לטבלת messages
- הרץ על port=5000

מבנה webhook שמגיע מ-Green API:
{"typeWebhook": "incomingMessageReceived", "senderData": {"sender": "972501234567@c.us"}, "messageData": {"typeMessage": "textMessage", "textMessageData": {"textMessage": "..."}}}

להקלטה: messageData.typeMessage == "audioMessage", messageData.fileMessageData.downloadUrl

שליחת תשובה ב-Green API:
POST https://api.green-api.com/waInstance{GREEN_API_INSTANCE_ID}/sendMessage/{GREEN_API_TOKEN}
body: {"chatId": "972501234567@c.us", "message": "תשובה"}

חשוב:
- כל הודעות הבוט בעברית
- try/except על כל פעולה עם print(error) והודעה ידידותית
- ב-README: כל שלבי ההרצה בעברית ברורים

⏱️ קלוד ייקח 3-5 דקות לבנות הכל. לא לסגור את החלון.

שלב 8 — מלאו את המפתחות — מצאו .env.example; שנו שם ל-.env; מלאו:

קוד

GREEN_API_INSTANCE_ID=המספר_שקיבלתם
GREEN_API_TOKEN=המפתח_הארוך
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
MY_PHONE=972501234567

⚠️ MY_PHONE — מספר הטלפון שלכם בפורמט בינלאומי, בלי + בהתחלה. לדוגמה 050-1234567 → 972501234567

שלב 9 — התקנת חבילות — ב-Terminal: pip install -r requirements.txt

שלב 10 — הרצת הבוט — צריך שני Terminals. ראשון: python app.py (תראו Running on http://localhost:5000). שני (Split Terminal): ngrok http 5000 (תראו כתובת כמו https://abcd-12-34-56.ngrok-free.app — העתיקו).

שלב 11 — חיבור Green API לבוט — green-api.com → Console → ה-instance → Settings → Notifications → הדביקו כתובת ngrok + /webhook → Save.

בדיקה ראשונה 🎉 — שלחו לעצמכם עזרה; אז הוסף משימה לסיים את הבוט, מה המשימות שלי?, סיימתי 1; שלחו הקלטה קולית.

שאלות נפוצות (details/summary blocks):

הבוט לא עונה → בדקו: Terminal של הבוט רץ ✓ → ngrok רץ ✓ → webhook הוגדר ב-Green API ✓ → MY_PHONE נכון ב-.env ✓
הקלטות קוליות לא עובדות → בדקו שמפתח Groq תקין ומתחיל ב-gsk_
ngrok מפסיק כל כמה שעות → בגרסה החינמית זה קורה. הריצו מחדש והגדירו שוב. לגרסה יציבה: Railway או Render
רוצים להוסיף עוד יכולות → תגידו לקלוד קוד מה להוסיף

אהבתם את המדריך? (color: blue) — לחצו כאן להצטרף →

בוט ווטסאפ אישי מ-0 — מדריך מלא לקלוד קוד

רוצים את הכלים והמערכות שלי, מוכנים?