איך לחבר את Claude Code (קלוד קוד) לוואטסאפ עם Green API — מדריך מלא למתחילים

רוב האנשים מכירים את Claude Code (קלוד קוד) ככלי לכתיבת קוד בטרמינל — אבל אפשר לחבר אותו לוואטסאפ ולשלוט בו מהטלפון. לשלוח לו משימות, לקבל תשובות, ולהמשיך לעבוד על הפרויקט גם כשאתם רחוקים מהמחשב. במדריך הזה נעבור צעד-אחר-צעד איך לחבר סוכן Claude Code — בנפרד לכל פרויקט — לקבוצת וואטסאפ ייעודית, דרך שירות בשם Green API. בנינו את זה בעצמנו, כולל התקלות בדרך, אז תקבלו גם את הפתרונות. המדריך כתוב למתחילים גמורים — לא צריך להיות מתכנת.

איך מחברים את Claude Code לוואטסאפ — בקצרה

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

1. פותחים Instance ב-Green API ומחברים מספר וואטסאפ בסריקת QR.
2. מעתיקים את שני המפתחות: idInstance ו-apiTokenInstance.
3. פותחים קבוצת וואטסאפ ייעודית לפרויקט ומוסיפים אליה את מספר הבוט.
4. מאתרים את ה-Group ID של הקבוצה (מזהה שמסתיים ב-@g.us).
5. מרוקנים את ה-Webhook כדי לקבל הודעות במצב Polling.
6. מריצים שני סקריפטים — האזנה ושליחה — ש-Claude Code מפעיל בלולאה.

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

מה זה Green API?

Green API הוא שירות שמחבר את וואטסאפ לכל מערכת או סקריפט דרך API פשוט (HTTP), בלי צורך ב-WhatsApp Business API הרשמי. הוא עובד בדיוק כמו ״מכשיר מקושר״ (Linked Device) בוואטסאפ: סורקים קוד QR פעם אחת, ומאותו רגע אפשר לשלוח ולקבל הודעות באופן תוכנתי. יש תוכנית Developer חינמית (מוגבלת במכסת הודעות) ותוכניות בתשלום לשימוש רציף.

למה לחבר את Claude Code לוואטסאפ

Claude Code יושב על המחשב שלכם ומכיר את כל הפרויקט — הקבצים, הקוד, ההיסטוריה. צ׳אט רגיל לא מכיר את זה. החיבור לוואטסאפ נותן לכם שלט רחוק לסוכן:

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

	צ׳אט AI רגיל	Claude Code בוואטסאפ
מכיר את הפרויקט שלכם	❌	✅ כל הקבצים וההיסטוריה
מבצע פעולות אמיתיות (קבצים, קוד, פקודות)	❌	✅
נגיש מהטלפון	✅	✅
עובד כשהמחשב כבוי	✅	❌ (המחשב הוא ה״מוח״)

מגבלה אחת חשובה להבין מראש: זה עובד כל עוד הסשן של Claude Code פתוח במחשב — המחשב הוא המוח, והוואטסאפ הוא רק הצינור.

מה צריך לפני שמתחילים

• מחשב עם Claude Code מותקן ופועל. אם עוד לא — קראו קודם איך מתקינים את Claude Code ומה זה MCP.
• מספר טלפון לוואטסאפ ל״בוט״. מומלץ מספר נפרד מהאישי, אבל גם האישי יעבוד.
• חשבון חינמי ב-Green API.
• 15 דקות וקצת סבלנות.

שלב 1: פתיחת חשבון ויצירת Instance ב-Green API

Green API מחבר וואטסאפ לכל מערכת דרך API פשוט — בלי WhatsApp Business רשמי. החיבור מתבצע בדיוק כמו מכשיר מקושר (Linked Device) בוואטסאפ רגיל.

• היכנסו ל-console.green-api.com והירשמו (חינם). התיעוד הרשמי: Green API Docs.
• צרו Instance חדש בתוכנית Developer (החינמית) להתחלה.
• ה-Instance הוא ״החיבור״ — כל פרויקט יכול לקבל Instance משלו, או להשתמש באותו אחד עם קבוצות שונות.

שלב 2: חיבור הוואטסאפ בסריקת QR

זה החלק שמרגיש קסם:

• בתוך ה-Instance תראו קוד QR.
• בטלפון של הבוט: וואטסאפ ← הגדרות ← מכשירים מקושרים ← קישור מכשיר.
• סרקו את ה-QR.
• אחרי כמה שניות מצב ה-Instance ישתנה ל-authorized. זהו — הוואטסאפ מחובר.

שלב 3: העתקת ה-idInstance וה-API Token

בתוך ה-Instance יש שני מפתחות שתצטרכו: idInstance (מספר מזהה) ו-apiTokenInstance (מחרוזת ארוכה וסודית).

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

שלב 4: פתיחת קבוצת וואטסאפ ייעודית

עכשיו פותחים את ערוץ השליטה:

• צרו קבוצת וואטסאפ חדשה בטלפון האישי.
• הוסיפו אליה את מספר הבוט (זה שחיברתם ב-Green API).
• תנו לה שם ברור לפי הפרויקט, למשל: ״פיתוח Claude — האתר שלי״.

למה קבוצה ולא צ׳אט פרטי? כי קבוצה נותנת ערוץ נקי ומבודד לכל פרויקט, ואפשר בעתיד לצרף עוד אנשי צוות. אצלנו הקבוצה הכילה בדיוק שני חברים: אתם + הבוט.

שלב 5: איתור ה-Group ID (המזהה של הקבוצה)

ל-Green API לא מספיק שם הקבוצה — הוא צריך את ה-Group ID, מזהה שנראה כך: 120363XXXXXXXXXXXX@g.us.

הדרך הקלה להשיג אותו — לבקש מ-Green API את רשימת הצ׳אטים. הריצו בטרמינל (אחרי שתחליפו את שני המפתחות שלכם):

curl -s "https://api.green-api.com/waInstance$ID_INSTANCE/getContacts/$API_TOKEN"

חפשו ברשימה את הקבוצה לפי השם שנתתם לה — לידה יופיע ה-id שמסתיים ב-@g.us. זה ה-Group ID. (טיפ: אפשר גם פשוט לשלוח הודעה בקבוצה ולקרוא את ההתראה הנכנסת — היא תכיל את אותו מזהה.)

שלב 6: ריקון ה-Webhook — קריטי לקבלת הודעות

זו נקודה שתפסה אותנו בהפתעה. יש שתי דרכים לקבל הודעות מ-Green API: Webhook (Green API ״דוחף״ כל הודעה לכתובת שרת שלכם) או Polling (אתם ״מושכים״ הודעות בעצמכם דרך receiveNotification).

לשליטה דרך Claude Code אנחנו משתמשים ב-Polling, וזה עובד רק אם שדה ה-Webhook ריק. אם מוגדר אצלכם webhook, היכנסו להגדרות ה-Instance ורוקנו את שדה ה-webhookUrl.

שיטה	איך עובדת	מתי להשתמש
Polling (receiveNotification)	אתם מושכים הודעות יזומה מ-Green API	חיבור ל-Claude Code מקומי — זו השיטה במדריך
Webhook	Green API דוחף כל הודעה לכתובת שרת ציבורי שלכם	כשיש שרת תמידי עם כתובת ציבורית

שימו לב: אחרי שמרוקנים את ה-webhook, ל-Green API לוקח כדקה-שתיים להחיל את השינוי. עד אז receiveNotification יחזיר שגיאה ״custom webhook url is set״ — זה תקין, פשוט חכו ונסו שוב.

שלב 7: סקריפט שליחה — send.sh

נתחיל באחסון המפתחות בקובץ נפרד ומאובטח. צרו קובץ ~/.green-api-creds:

ID_INSTANCE=1101234567
API_TOKEN=שימו-כאן-את-הטוקן-שלכם
GROUP=120363XXXXXXXXXXXX@g.us

נעלו אותו כך שרק אתם תוכלו לקרוא:

chmod 600 ~/.green-api-creds

עכשיו ניצור את סקריפט השליחה send.sh:

#!/usr/bin/env bash
source ~/.green-api-creds
MESSAGE="$1"
curl -s "https://api.green-api.com/waInstance$ID_INSTANCE/sendMessage/$API_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @<(python3 - "$GROUP" "$MESSAGE" <<'PY'
import sys, json
print(json.dumps({"chatId": sys.argv[1], "message": sys.argv[2], "linkPreview": False}))
PY
)

שימו לב ל-"linkPreview": False — כיבוי התצוגה המקדימה של קישורים. גילינו שכשמשאירים אותה דלוקה ושולחים הודעה עם קישור, Green API לפעמים תוקע את תור השליחה. כיבוי קטן שחוסך כאב ראש גדול.

שלב 8: סקריפט האזנה — listen.sh

הסקריפט הזה ״מקשיב״ לקבוצה ומחזיר את ההודעה הבאה שתגיע אליה:

#!/usr/bin/env bash
source ~/.green-api-creds
BASE="https://api.green-api.com/waInstance$ID_INSTANCE"

while true; do
  RESP=$(curl -s "$BASE/receiveNotification/$API_TOKEN")
  [ -z "$RESP" ] || [ "$RESP" = "null" ] && { sleep 2; continue; }

  RECEIPT=$(echo "$RESP" | python3 -c "import sys,json;print(json.load(sys.stdin).get('receiptId',''))")

  echo "$RESP" | python3 -c "
import sys, json, os
d = json.load(sys.stdin); b = d.get('body', {})
sd = b.get('senderData', {})
if b.get('typeWebhook') == 'incomingMessageReceived' and sd.get('chatId') == os.environ['GROUP']:
    md = b.get('messageData', {})
    txt = (md.get('textMessageData') or {}).get('textMessage', '')
    print('MSG:', txt)
"
  curl -s -X DELETE "$BASE/deleteNotification/$API_TOKEN/$RECEIPT" > /dev/null
done

נקודה חשובה: אחרי שקוראים הודעה, חובה למחוק אותה מהתור עם deleteNotification — אחרת תקבלו אותה שוב ושוב.

שלב 9: חיבור הכל ל-Claude Code

עכשיו מחברים את שני הסקריפטים לסוכן. הרעיון פשוט — אומרים ל-Claude Code:

״הרץ את listen.sh ברקע, וכשמגיעה הודעה — בצע אותה כאילו כתבתי לך בצ׳אט, וענה לי בחזרה עם send.sh. ואז תאזין שוב.״

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

אבטחה — אל תדלגו על זה

• שמרו את המפתחות רק בקובץ ~/.green-api-creds עם chmod 600. לעולם לא בתוך הקוד.
• אם הפרויקט ב-Git — הוסיפו את הקובץ ל-.gitignore כדי שלא יעלה בטעות.
• אל תשלחו את ה-idInstance/Token באף צ׳אט, מייל או צילום מסך ציבורי.
• אם חשפתם טוקן בטעות — אפסו אותו מיד מתוך ה-console של Green API.

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

• ״custom webhook url is set״ — שדה ה-webhook לא ריק, או שעדיין לא עברה הדקה מאז שריקנתם. רוקנו וחכו דקה-שתיים.
• ההודעות לא נשלחות / נתקעות — קרה לנו בדיוק. בדקו: (1) שטלפון הבוט מחובר לאינטרנט ווואטסאפ פעיל — Green API שולח רק כשהמכשיר המקושר חי; (2) שלא נגמרה מכסת השליחה של התוכנית החינמית. אם כן — שדרגו לתוכנית בתשלום. אפשר לבדוק את התור התקוע עם showMessagesQueue.
• לא מקבלים הודעות בכלל — ודאו ששלחתם בקבוצה הנכונה (אותו Group ID), ושה-webhook באמת ריק.

נקודות מפתח

• Claude Code + וואטסאפ = שלט רחוק לסוכן שמכיר את הפרויקט שלכם, מכל מקום.
• החיבור נעשה דרך Green API בסריקת QR אחת — בלי לדעת לתכנת.
• משתמשים ב-Polling, ולכן ה-Webhook חייב להיות ריק.
• קבוצת וואטסאפ ייעודית לכל פרויקט = ערוץ שליטה נקי ונפרד.
• שומרים את המפתחות בקובץ נעול (chmod 600) — לעולם לא בקוד או בפומבי.
• עובד רק כל עוד הסשן פתוח במחשב — הוא המוח, והוואטסאפ הוא הצינור.

סיכום — והצעד הבא

חיברתם את Claude Code לוואטסאפ: פתחתם Instance ב-Green API, סרקתם QR, פתחתם קבוצה ייעודית, מצאתם את ה-Group ID, ריקנתם את ה-webhook, ובניתם שני סקריפטים — שליחה והאזנה — שהסוכן מריץ בלולאה. עכשיו אתם שולטים בפרויקט מהטלפון.

זו רק דוגמה אחת לעוצמה של סוכני AI מותאמים. רוצים להעמיק? למדו עוד על Claude Code, הוסיפו Skills שימושיים, והצטרפו לקהילת Claude הישראלית או לקורסים החינמיים.

רוצים שהצוות שלכם יבנה כלים כאלה בעצמו? דברו איתנו על סדנת Claude Code לארגונים או על הטמעת AI מלאה.