Groupy - מדריך משתמש מלא

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

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

הדרך המהירה: שולחים היסטוריה, שואלים בפרטי

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

1. מייצאים את היסטוריית הקבוצה מוואטסאפ (ראו "ייצוא היסטוריה מוואטסאפ" בהמשך).
2. שולחים את הקובץ לגרופי בפרטי (ZIP או TXT) - המספר מופיע בראש הדף. אפשר להוסיף בכיתוב את שם הקבוצה: זו ההיסטוריה של "טיול 26".
3. שואלים שאלות בפרטי. אם העלית היסטוריה של קבוצה אחת — פשוט שואלים. אם של כמה — מקדימים את השם:
   • בקבוצה: "טיול 26" - מה החלטנו על הלינה?
   • או באנגלית: in group: "Trip 26" - what did we decide about lodging?

אין צורך להיות חבר באותה קבוצה כדי להעלות עליה היסטוריה ולשאול עליה.

ייצוא היסטוריה מוואטסאפ

אייפון: פתיחת הקבוצה ← לחיצה על שם הקבוצה למעלה ← גלילה לתחתית ← Export Chat ← Without Media ← שיתוף עם גרופי.

אנדרואיד: פתיחת הקבוצה ← תפריט (שלוש נקודות) ← More → Export Chat → Without Media ← שיתוף עם גרופי.

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

מה אפשר לעשות עם גרופי?

• לשאול שאלות על מה שדובר בקבוצה - גם דברים שעלו לפני חודשים. תייגו אותי בקבוצה או שאלו אותי בפרטי.
• סיכום יומי אוטומטי של הדיונים בקבוצה.
• מודרציה וסינון ספאם בקבוצה (תוך כדי שמירה על הרשאות שמוגדרות לקבוצה).
• זיהוי נושאים מובילים ושמירת ידע ממוקד.
• המשך שיחה דרך ממשק ווב כדי לחפור על דבר מסוים בלי להציף את הקבוצה.

מי יכול לעשות מה תלוי בהרשאות שהוגדרו לקבוצה (QA_PERMISSION, DM_QA_PERMISSION וכו') - ראו "הגדרות וקונפיגורציה" בהמשך.

הוספת הבוט לקבוצה

יש שתי דרכים להוסיף את גרופי לקבוצה - שתיהן זמינות לכל חבר בקבוצה (לא רק למנהל):

אפשרות 1 - מתוך הקבוצה (הדרך הרגילה): מוסיפים את מספר הבוט (המופיע בראש הדף) כמשתתף בקבוצה דרך תפריט הקבוצה → "הוסף משתתפים".

אפשרות 2 - שליחת לינק הזמנה בפרטי: פותחים בקבוצה את "הזמנה דרך קישור" (Invite via link), מעתיקים את הלינק https://chat.whatsapp.com/..., ושולחים אותו לגרופי בפרטי. גרופי יזהה את הלינק ויצטרף בעצמו. תנאי יחיד: גם השולח חייב להיות חבר בקבוצה - אחרת גרופי יוצא מיד ושולח הסבר.

מה שקורה אחרי ההוספה (בשתי הדרכים):

1. גרופי מתחיל מיד לקרוא ולאסוף ידע מהקבוצה.
2. מי שהוסיף את הבוט (או שלח את הלינק) מקבל ב-DM הסבר קצר ולינק לפורטל הניהול.
3. בקבוצה לא מתפרסמת הודעה - גרופי מצטרף בשקט.

לניהול ההגדרות של הקבוצה (סיכומים יומיים, מצב שקט, מודרציה, הרשאות) - https://groupy.online/admin

שים לב: אם גרופי הוסר מהקבוצה הזו בעבר ע"י מנהל, WhatsApp חוסם הצטרפות דרך לינק במקרה הזה. במקרה כזה - להוסיף ידנית מתוך הקבוצה (אפשרות 1).

איך שואלים את גרופי שאלות

בתוך הקבוצה

תייגו את גרופי עם @ ושאלו את השאלה.

דוגמאות:

• @Groupy מה החלטנו על הטיול?
• @Groupy מי המליץ על מסעדה בעכו?
• @Groupy סכם לי את מה שדובר היום על משכנתאות

טיפ: אפשר לעשות reply להודעה ולתייג את גרופי - זה משאיר את הקונטקסט של ההודעה המקורית. למשל reply להודעה של חבר עם @Groupy תרגם את זה לאנגלית או @Groupy תענה לשאלה הזו.

בפרטי (DM)

אם העלית היסטוריה של קבוצה אחת בלבד: פשוט שולחים את השאלה.

אם של כמה קבוצות:

• בקבוצה: "שם הקבוצה" השאלה שלך
• בקבוצה 3: השאלה שלך (לפי מספר מהרשימה - שולחים קבוצות כדי לראות)
• in group: "name" question (אנגלית)

פקודות עזרה כלליות

כל הפקודות case-insensitive. גם HELP:, Help:, help: יעבדו זהה.

פקודות אדמין (DM)

מיועדות למנהל הבוט הראשי. כל הפקודות בקלט ב-DM, case-insensitive. כל פקודה שלוקחת <group> יכולה לקבל:

• מספר מהרשימה: START_BOT 3
• שם בגרשיים: START_BOT "שם הקבוצה"
• ללא ארגומנט (אם יש קבוצה אחת מנוהלת בלבד): START_BOT

בקרת בוט בקבוצה

סיכומים יומיים

סיכומי תקופה (DM, אחרי בקבוצה N: <פקודה>)

כל הסיכומים חוזרים כתצוגה מקדימה ב-DM. לאחר מכן (כ-reply לתשובת הבוט):

• SEND - שולח את הטקסט לקבוצה.
• SEND: <טקסט מותאם> - שולח טקסט ערוך.
• כל טקסט אחר - בקשה לערוך מחדש (גרופי יחזיר גרסה משודרגת).

מצב שקט (Silent Mode)

מצב שבו הבוט קורא ולומד ושומר ידע, אבל לא עונה לשאלות בקבוצה. הסיכום היומי נשלח לאדמין ב-DM במקום לקבוצה. שימושי לאיסוף ידע מקבוצה רגישה / טרום-launch.

הערה: גם במצב שקט, אדמין שעושה @mention לבוט בקבוצה - הבוט עונה לו. רק משתמשים רגילים מתעלמים מהם.

נעילת/פתיחת קבוצה לדיונים

דורש שהבוט יהיה אדמין בקבוצה. נועל/פותח את היכולת של חברים רגילים לכתוב בקבוצה (אדמינים תמיד יכולים).

חסימה

ייבוא היסטוריה

סשנים ו-LLM

תפעול שאלות-תשובות (reply ב-DM)

כשהבוט עונה לשאלה ב-DM, אפשר לעשות reply לתשובה עם:

• SEND - שולח את התשובה לקבוצה.
• SEND: <טקסט> - שולח טקסט ערוך לקבוצה.
• REF - מוסיף את שאלה+תשובה לבסיס הידע הקבוע (custom-static).
• כל טקסט חופשי - בקשת עריכה (הבוט יחזיר גרסה משודרגת).

טיפים שימושיים למנהלי קבוצות

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

תייגו את גרופי כמענה לשאלה של מישהו אחר בקבוצה

מישהו שאל בקבוצה ולא תייג את גרופי ואתם רוצים שגרופי יענה לו?

• עושים reply לשאלה של החבר.
• מתייגים את גרופי (@) ב-reply.
• אפשר להוסיף טקסט לפני או אחרי התיוג - גרופי יתייחס גם לשאלה המקורית וגם לטקסט שהוספתם.

תשובה לשאלה שנשאלה בקבוצה - בפרטי

רוצים שגרופי יענה לשאלה מהקבוצה בפרטי, מבלי להציף את הקבוצה?

• מעבירים (Forward) את השאלה לגרופי בפרטי.
• גרופי ישיב לכם ב-DM.

העברת התשובה של גרופי מהפרטי לקבוצה

גרופי ענה לכם בפרטי ואתם רוצים שהוא יענה את התשובה בקבוצה?

• עושים reply לתשובה של גרופי בפרטי בתוספת המילה SEND - גרופי יפרסם את התשובה כלשונה בקבוצה.
• או: SEND <הנוסח הערוך שלכם> - גרופי יפרסם את הנוסח שלכם במקום שלו.

שמירת תשובה טובה לבסיס הידע

קיבלתם מגרופי תשובה מצוינת ורוצים שיזכור אותה לפעם הבאה?

• עושים reply לתשובה של גרופי בתוספת המילה REF.
• גרופי יוסיף את שאלה+תשובה לבסיס הידע שלו על הקבוצה.

סיכום יומי בפרטי במקום בקבוצה

רוצים לראות את הסיכום היומי בלי שכל הקבוצה תראה?

• בהגדרות הקבוצה: הפעילו "סיכום יומי" + "מצב שקט".
• התוצאה: גרופי יכין את הסיכום היומי וישלח אותו רק אליכם בפרטי.

פרסום סיכום יומי בקבוצה (עם או בלי עריכה)

קיבלתם מגרופי בפרטי סיכום יומי שאתם רוצים לפרסם לקבוצה?

• עושים reply לסיכום שגרופי שלח לכם בפרטי בצירוף המילה SEND - גרופי ישלח את הסיכום לקבוצה כמו שהוא.
• או: SEND <הסיכום הערוך שלכם> - גרופי ישלח לקבוצה את הנוסח שלכם.

סגירת הקבוצה לדיונים (קבוצת 'שקטה')

רוצים שרק אדמינים יוכלו לכתוב בקבוצה?

• אפשר בפורטל הניהול - דרך הגדרות הקבוצה.
• או בהודעה פרטית לגרופי - עם המילה LOCK (או LOCK <הודעת הסגירה> כדי לקבוע גם את הטקסט שיופיע בקבוצה).
• לפתיחה מחדש - UNLOCK באותו אופן.

ייבוא היסטוריה - פרטים נוספים

הצעדים הבסיסיים מופיעים למעלה ב"הדרך המהירה". כאן רק מה שלא נכנס שם.

פורמטים נתמכים

• ZIP (היציאה הסטנדרטית של וואטסאפ - מכיל .txt בפנים).
• TXT (הקובץ הגולמי, ללא מדיה).
• JSON Catalog (למקרים מתקדמים).

העלאה מהקבוצה במקום מ-DM

מנהלים יכולים גם להעלות בקבוצה עצמה - כ-reply לבוט עם הקובץ מצורף. הבוט יזהה ויטפל.

מעקב אחר ייבוא רץ

שולחים בפרטי IMPORT_STATUS כדי לראות איפה הבוט עומד בעיבוד.

עדכון היסטוריה אחרי הפסקה

אם הבוט היה מחוץ לקבוצה לתקופה, אפשר לשלוח לו ייצוא חדש - הוא יזהה אוטומטית את הטווח החדש (אחרי ההודעה האחרונה ששמר) ויעבד רק אותו. כדי להריץ הכל מחדש: REIMPORT.

הגדרות וקונפיגורציה

הצגת ההגדרות

שולחים ב-DM config או קונפיג - מקבלים רשימה של כל המפתחות עם התיאור והערך הנוכחי.

שינוי הגדרה

config KEY=VALUE

דוגמאות:

• config MAX_QUESTIONS_PER_HOUR=10
• config DAILY_SUMMARY_HOUR=18
• config AUTO_KICK_BLACKLISTED=true

הגדרות שכיחות

הרשאות:

• QA_PERMISSION - מי יכול לשאול בקבוצה (all / admins / superadmin).
• DM_QA_PERMISSION - מי יכול לשאול בפרטי (superadmin / admins / members / none).
• CONFIG_PERMISSION - מי יכול לשנות הגדרות.
• STATS_PERMISSION - מי יכול לראות סטטיסטיקות.
• HISTORY_UPLOAD_PERMISSION - מי יכול להעלות היסטוריה.

מגבלות שאלות (Q&A):

• MAX_QUESTIONS_PER_HOUR - לקבוצה לשעה (0 = ללא מגבלה).
• MAX_QUESTIONS_PER_DAY - לקבוצה ליום.
• MAX_QUESTIONS_PER_USER_PER_DAY - למשתמש ליום (בקבוצה).

מגבלות שאלות עזרה (DM help: / עזרה:):

• MAX_HELP_PER_HOUR_PER_USER - שאלות עזרה למשתמש לשעה.
• MAX_HELP_PER_DAY_PER_USER - שאלות עזרה למשתמש ליום.

סיכום יומי:

• DAILY_SUMMARY_HOUR - שעה (0-23, שעון ישראל).
• DAILY_SUMMARY_MINUTE - דקה.
• TIMEZONE - אזור זמן (Asia/Jerusalem).

מודרציה:

• AUTO_KICK_BLACKLISTED - האם להסיר משתמשים שנחסמו אוטומטית מהקבוצה.
• AUTO_REMOVE_SPAM - האם להסיר ספאם פיננסי אוטומטית (קישורי קבוצות פיננס).
• SPAM_KEYWORDS - מילות מפתח לזיהוי ספאם (פסיק מפריד).
• MAX_UNAUTHORIZED_DM_ATTEMPTS - אחרי כמה ניסיונות DM ממשתמש לא מורשה הוא יחסם.

בוט:

• BOT_DISPLAY_NAME - השם שהבוט מציג בהודעות.
• BOT_GENDER - male / female (משפיע על דקדוק עברי).
• TRIGGER_WORDS - מילים שיעוררו את הבוט בקבוצה (נוסף ל-@mention).

מגבלות קצב (Rate Limiting)

יש מגבלות על מספר השאלות שאפשר לשאול בכל קבוצה - לפי שעה, ליום, ולמשתמש בודד. המגבלות נקבעות בהגדרות הקבוצה (MAX_QUESTIONS_PER_HOUR, MAX_QUESTIONS_PER_DAY, MAX_QUESTIONS_PER_USER_PER_DAY). אדמינים פטורים מהמגבלות האלה.

הפקודה STATUS מציגה את הניצול הנוכחי לכל קבוצה.

פיצ'ר המשך שיחה (Web Chat)

אחרי שהבוט עונה על שאלה, לפעמים מתווסף לתשובה קישור: 💬 להמשך שיחה: groupy.online/chat/....

לחיצה על הקישור פותחת ממשק צ'אט בדפדפן עם:

• הקשר מלא של הקבוצה (snapshot של הידע ברגע הפתיחה).
• היסטוריית השאלה והתשובה הראשונית.
• אפשרות להמשיך לשאול עד 20 הודעות.
• תוקף 24 שעות.

הפיצ'ר מאפשר לשואל להעמיק מבלי להציף את הקבוצה.

הקישור מוצג רק אם המנהל הפעיל את הפיצ'ר עבור הקבוצה (per-group toggle).

נושאים (Topics)

הבוט מסווג כל הודעה בקבוצה לנושא רלוונטי (לפי קונטקסט). כשמישהו שואל שאלה הקשורה לנושא ספציפי, הבוט שולף ידע ממוקד יותר על אותו נושא במקום להסתמך רק על הסיכום הכללי.

לראות את הנושאים המובילים: סטטיסטיקות / stats.

שגיאות נפוצות ופתרונות

"לא קיבלתי תשובה לשאלה בקבוצה"

• ודאו שהבוט מופעל בקבוצה: STATUS.
• ודאו שיש לו קונטקסט (לפחות MIN_MESSAGES_FOR_CONTEXT הודעות, ברירת מחדל 500).
• ודאו שלא הגעתם למגבלת שאלות (לשעה / יום / משתמש) - הפקודה STATUS מציגה את הניצול הנוכחי.
• ודאו שלמי שמנסה לשאול יש את ההרשאה לכך (QA_PERMISSION).

"הבוט לא רואה הודעה מסוימת"

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

"סיכום יומי לא הגיע"

• ודאו ש-START_DAILY הופעל לקבוצה.
• ודאו שהשעה והאזור זמן נכונים: config DAILY_SUMMARY_HOUR, config TIMEZONE.
• בקבוצות במצב שקט הסיכום מגיע ל-DM של האדמין, לא לקבוצה.

"מישהו שולח ספאם והבוט לא מטפל"

• ודאו ש-AUTO_REMOVE_SPAM=true.
• ודאו שהבוט הוא אדמין בקבוצה ב-WhatsApp (אחרת אין לו הרשאה לבעוט/למחוק).
• בדקו שהמילים הרלוונטיות נמצאות ב-SPAM_KEYWORDS.

"אני מקבל הודעת חסימה למרות שלא עשיתי כלום"

מנגנון החסימה האוטומטית פועל אחרי MAX_UNAUTHORIZED_DM_ATTEMPTS ניסיונות DM ממישהו שלא חבר באף קבוצה. אם נחסמת בטעות, האדמין יכול לשחרר עם UNBLACKLIST <מספר@c.us>.

מתי לא לפנות אלי

• שאלות שלא קשורות לקבוצה הספציפית (חוץ משאלות עזרה: שהן על השימוש בי).
• בקשות לפעולות שלא נמצאות ברשימת הפקודות (לדוגמה: לשלוח הודעה בשם משתמש אחר, ליצור קבוצה חדשה, להוסיף משתתפים - אני לא עושה את אלה).
• מידע אישי על משתתפים שלא נחשף בקבוצה (אני יודע רק מה שנאמר פומבית בקבוצה).