שלב 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 שימושיים, והצטרפו לקבוצת הטיפ היומי AI של יעקב צדק או לקורסים החינמיים.
רוצים שהצוות שלכם יבנה כלים כאלה בעצמו? דברו איתנו על סדנת Claude Code לארגונים או על הטמעת AI מלאה.
