0 מתוך 11 שלבים
מדריך צעד אחר צעד

בוט שעונה כשמתייגים אותו בגוגל צ'אט

כמו @משמרת הצניעות: כותבים במרחב @פיצי, ותוך דקה מגיעה תשובה אוטומטית. הכול רץ ב־Google Apps Script בחשבון שלכם, בלי שרת ובלי תשלום.

⏱ בערך 15–20 דקות💻 עדיף ממחשב🆓 חינם

ככה זה נראה במרחב:

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

איך זה עובד

חשוב להבין את זה לפני שמתחילים:

🔁 סריקה כל דקה

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

🏷 מחפש את התיוג

אם מישהו כתב @פיצי (או המילה שתבחרו), הוא עונה עם ציטוט של ההודעה.

📝 תשובה קבועה מראש

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

👤 עונה בשמכם

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

מה צריך

חלק א

הכנה ב־Google Cloud

1

הפעלת אימות דו־שלבי

Google Cloud דורש אימות דו־שלבי בחשבון. אם הוא כבר מופעל אצלכם, דלגו לשלב הבא.

להפעלה: myaccount.google.com/security ← אימות דו־שלבי, ופעלו לפי ההוראות.

2

יצירת פרויקט חדש

  1. היכנסו ל־console.cloud.google.com. בכניסה הראשונה תתבקשו לאשר את תנאי השימוש.
  2. למעלה, ליד הלוגו, לחצו על בורר הפרויקטים ואז על New project.
  3. תנו שם (למשל chat-bot) ולחצו Create.
  4. ודאו שהפרויקט החדש הוא זה שמופיע למעלה בבורר. אם לא, בחרו בו.
3

הפעלת Google Chat API

בתפריט (שלושת הקווים ☰ בצד) עברו אל:

☰›APIs & Services›Enabled APIs & services
תפריט Google Cloud פתוח: APIs & Services ובתת־התפריט Enabled APIs & services
התפריט: APIs & Services ← Enabled APIs & services
  1. לחצו למעלה על + Enable APIs and services.
  2. בשורת החיפוש חפשו
  3. היכנסו לתוצאה הראשונה ולחצו על הכפתור הכחול Enable.
4

הגדרת האפליקציה (Configuration)

חזרו אל Enabled APIs & services, גללו לטבלה בתחתית העמוד ולחצו על Google Chat API. עברו ללשונית הרביעית:

MetricsQuotas & System LimitsCredentialsConfiguration
דף Google Chat API עם הלשוניות Metrics, Quotas & System Limits, Credentials ו־Configuration
דף Google Chat API. הלשונית Configuration היא הרביעית

מלאו כך:

שדהמה לכתוב
App nameהשם שיופיע ליד התשובות. למשל: פיצי
Avatar URLקישור לתמונה ריבועית. אפשר להשאיר ריק.
Descriptionתיאור קצר, עד 40 תווים.
App statusאם מופיע: LIVE – available to users
Interactive featuresלהשאיר כבוי.
טופס Configuration ממולא: App status LIVE, App name פיצי, Avatar URL, Description, Interactive features כבוי, ולמטה הכפתור Save
כך נראה הטופס בהדרכה של מון בלאן

גללו למטה ולחצו Save.

זה תקין: ההודעה "Users with personal Google accounts can only create apps for personal use" והסימון האפור "Build this Chat app as a Workspace add-on" מופיעים אוטומטית. לא צריך לגעת בהם.
5

העתקת מספר הפרויקט

לחצו על הלוגו Google Cloud למעלה כדי לחזור לדף הבית. בכרטיס Welcome מופיע Project number (מספר ארוך של 12 ספרות), ולידו כפתור העתקה.

דף הבית של Google Cloud: Welcome, ומתחת Project number עם כפתור העתקה
מספר הפרויקט בדף הבית, עם כפתור ההעתקה לידו

העתיקו אותו ושמרו בצד. תצטרכו אותו בשלב 9.

חלק ב

הסקריפט ב־Apps Script

6

פרויקט Apps Script חדש

היכנסו ל־script.google.com ולחצו פרויקט חדש. אפשר לשנות למעלה את השם "פרויקט ללא שם", למשל ל"בוט פיצי".

7

הדבקת הקוד

בקובץ קוד.gs מחקו את כל מה שכתוב (Ctrl+A ואז Delete), העתיקו את הקוד הבא והדביקו:

קוד.gs · 128 שורות
// ✏️ כאן משנים את המילה (או כמה מילים) שמפעילה את הבוט
const TRIGGER_WORD = 'פיצי';

// נבנה אוטומטית מהמילה: @פיצי, גם עם רווח אחרי ה-@
const TRIGGER_RE = new RegExp(
  '@\\s*' + TRIGGER_WORD.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s+')
);

const CONFIG = {
  // נבחרת תשובה אקראית מהרשימה. אפשר להשאיר אחת בלבד
  REPLIES: [
    'משמרת הצניעות כאן לשרותכם, ספרו לנו מה הבעיה ומי הבעיה, ונשמח לעזור ולנקות תוכן לא ראוי.'
  ],

  INCLUDE_DMS_AND_GROUPS: false, // true = גם שיחות אישיות וקבוצות, לא רק מרחבים
  COOLDOWN_SEC: 20,              // מקסימום תשובה אחת למרחב בפרק הזמן הזה
  MAX_RUN_MS: 240000,            // הגבלת זמן ריצה לסריקה אחת
  KEEP_DONE: 100                 // כמה הודעות לזכור (מגבלת 9KB לערך ב-Properties)
};

function installBotTrigger() {
  removeBotTrigger();
  PropertiesService.getUserProperties().setProperties({
    lastScan: new Date().toISOString(),
    done: '[]'
  });
  ScriptApp.newTrigger('scanMentions').timeBased().everyMinutes(1).create();
  Logger.log('הבוט הופעל.');
}

function removeBotTrigger() {
  ScriptApp.getProjectTriggers().forEach(t => {
    if (t.getHandlerFunction() === 'scanMentions') ScriptApp.deleteTrigger(t);
  });
  Logger.log('הבוט נעצר.');
}

function status() {
  const on = ScriptApp.getProjectTriggers().some(t => t.getHandlerFunction() === 'scanMentions');
  const p = PropertiesService.getUserProperties();
  Logger.log('פעיל: ' + on + ' | סריקה אחרונה: ' + p.getProperty('lastScan') + ' | מילת הפעלה: @' + TRIGGER_WORD);
}

function authorize() { Logger.log(Chat.Spaces.list({ pageSize: 1 })); }

function scanMentions() {
  const lock = LockService.getUserLock();
  if (!lock.tryLock(5000)) return;
  try {
    const props = PropertiesService.getUserProperties();
    const started = new Date();
    const since = new Date(props.getProperty('lastScan') || started.toISOString());
    // חפיפה של דקה כדי לא לפספס הודעות; כפילויות נחסמות ע"י רשימת done
    const cut = new Date(since.getTime() - 60000).toISOString().replace(/\.\d+Z$/, '+00:00');
    const done = JSON.parse(props.getProperty('done') || '[]');
    let complete = true;

    for (const space of listSpaces_()) {
      if (new Date() - started > CONFIG.MAX_RUN_MS) { complete = false; break; }

      let msgs = [];
      try {
        msgs = Chat.Spaces.Messages.list(space, {
          pageSize: 50,
          filter: 'createTime > "' + cut + '"'
        }).messages || [];
      } catch (err) { continue; }

      for (const m of msgs) {
        if (done.indexOf(m.name) > -1) continue;
        if (!TRIGGER_RE.test(m.text || '')) continue;
        done.push(m.name);
        if (onCooldown_(space)) continue;
        try { botReply_(space, m); } catch (err) { Logger.log(err); }
      }
    }

    props.setProperties({
      lastScan: complete ? started.toISOString() : since.toISOString(),
      done: JSON.stringify(done.slice(-CONFIG.KEEP_DONE))
    });
  } finally {
    lock.releaseLock();
  }
}

function botReply_(space, m) {
  const text = CONFIG.REPLIES[Math.floor(Math.random() * CONFIG.REPLIES.length)];
  const msg = {
    text: text,
    quotedMessageMetadata: { name: m.name, lastUpdateTime: m.lastUpdateTime || m.createTime }
  };
  if (m.thread && m.thread.name) msg.thread = { name: m.thread.name };
  try {
    Chat.Spaces.Messages.create(msg, space, { messageReplyOption: 'REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD' });
  } catch (err) {
    // אם הציטוט נכשל, שולחים הודעה רגילה
    Chat.Spaces.Messages.create({ text: text }, space);
  }
}

// רשימת כל המרחבים (עם דפדוף ו-cache של 5 דקות כדי לחסוך קריאות)
function listSpaces_() {
  const cache = CacheService.getUserCache();
  const hit = cache.get('spaces');
  if (hit) return JSON.parse(hit);

  const names = [];
  let token;
  do {
    const opt = { pageSize: 200, pageToken: token };
    if (!CONFIG.INCLUDE_DMS_AND_GROUPS) opt.filter = 'spaceType = "SPACE"';
    const res = Chat.Spaces.list(opt);
    (res.spaces || []).forEach(s => names.push(s.name));
    token = res.nextPageToken;
  } while (token);

  try { cache.put('spaces', JSON.stringify(names), 300); } catch (err) {}
  return names;
}

function onCooldown_(space) {
  const cache = CacheService.getUserCache();
  const key = 'cd:' + space;
  if (cache.get(key)) return true;
  cache.put(key, '1', Math.max(CONFIG.COOLDOWN_SEC, 1));
  return false;
}

השורות המסומנות הן אלה שמשנים (ראו התאמה אישית). בינתיים אפשר להשאיר כמו שזה.

ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.

שמרו עם Ctrl+S.

8

קובץ ההגדרות (appsscript.json)

הקובץ הזה מפעיל בסקריפט את שירות Google Chat ומגדיר אילו הרשאות הוא מבקש.

  1. בתפריט הימני לחצו על ⚙️ הגדרות הפרויקט.
  2. סמנו את התיבה הצגת קובץ המניפסט appsscript.json בעורך. באנגלית היא נקראת Show "appsscript.json" manifest file in editor
  3. חזרו לעורך (הסמל <>) ופתחו את הקובץ appsscript.json שהופיע ברשימת הקבצים.
  4. מחקו את כל מה שכתוב בו והדביקו:
appsscript.json
{
  "timeZone": "Asia/Jerusalem",
  "dependencies": {
    "enabledAdvancedServices": [
      { "userSymbol": "Chat", "serviceId": "chat", "version": "v1" }
    ]
  },
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly",
    "https://www.googleapis.com/auth/chat.messages",
    "https://www.googleapis.com/auth/script.scriptapp"
  ],
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.

שמרו עם Ctrl+S.

9

חיבור הסקריפט לפרויקט ב־Google Cloud

⚙️ הגדרות הפרויקט‹פרויקט Google Cloud Platform (GCP)‹שינוי הפרויקט
  1. ב־⚙️ הגדרות הפרויקט גללו לחלק פרויקט Google Cloud Platform (GCP).
  2. לחצו שינוי הפרויקט.
  3. הדביקו את מספר הפרויקט משלב 5 ולחצו הגדרת הפרויקט.
החלק 'פרויקט Google Cloud Platform (GCP)' בהגדרות הפרויקט, עם הכפתור 'שינוי הפרויקט'
בהגדרות הפרויקט: הכפתור "שינוי הפרויקט"
קיבלתם שגיאה על מסך ההסכמה? (באנגלית: OAuth consent screen) הפתרון נמצא בתקלות נפוצות.
10

הפעלת הבוט

  1. חזרו לעורך (<>) ופתחו את קוד.gs.
  2. בסרגל שמעל הקוד ודאו שברשימה הנפתחת נבחרה הפונקציה installBotTrigger.
  3. לחצו ▷ הפעלה.
  4. בחלון "נדרשת הרשאה" לחצו בדיקת ההרשאות ובחרו את החשבון שלכם.
  5. אם מופיע מסך "Google לא אימת את האפליקציה הזו", לחצו מתקדם ואז מעבר אל … (לא בטוח). זה הסקריפט שלכם, אז זה בסדר.
  6. אשרו את ההרשאות.
הצלחתם אם ביומן הביצוע בתחתית מופיעה השורה הבוט הופעל.
11

בדיקה

כתבו באחד המרחבים שאתם חברים בו @פיצי (או המילה שבחרתם). תוך דקה–שתיים אמורה להגיע תשובה עם ציטוט של ההודעה.

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

התאמה אישית

כל ההגדרות נמצאות בראש הקובץ קוד.gs.

הגדרהמה היא עושה
TRIGGER_WORDמילת ההפעלה, בלי ה־@. אפשר גם כמה מילים, למשל 'משמרת הצניעות'.
REPLIESהתשובה. אם כותבים כמה תשובות, בכל פעם נבחרת אחת באקראי.
COOLDOWN_SECלכל היותר תשובה אחת למרחב בפרק הזמן הזה (בשניות). ברירת מחדל: 20.
INCLUDE_DMS_AND_GROUPSfalse: עונה רק במרחבים. true: עונה גם בצ'אטים אישיים ובקבוצות.

דוגמה לכמה תשובות:

דוגמה
  REPLIES: [
    'משמרת הצניעות כאן לשרותכם, ספרו לנו מה הבעיה ומי הבעיה, ונשמח לעזור ולנקות תוכן לא ראוי.',
    'קיבלנו! נבדוק את זה בהקדם.',
    'תודה על הדיווח, מטפלים בזה.'
  ],

ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.

זהירות עם גרשיים: כל תשובה עטופה בגרש ' משני הצדדים, ואחרי כל תשובה חוץ מהאחרונה יש פסיק. אם בתוך התשובה יש גרש (כמו צ'אט), כתבו לפניו לוכסן הפוך: 'צ\'אט', או השתמשו בגרש עברי ׳.
אחרי כל שינוי שומרים עם Ctrl+S, וזהו. לא צריך להפעיל את הבוט מחדש: הסריקה הבאה כבר משתמשת בקוד החדש.

הפעלה, עצירה ובדיקת מצב

בוחרים פונקציה ברשימה שבסרגל העליון ולוחצים ▷ הפעלה. התוצאה מופיעה ביומן הביצוע.

פונקציהמה היא עושה
installBotTriggerמפעילה את הבוט (או מפעילה אותו מחדש).
removeBotTriggerעוצרת את הבוט.
statusמציגה אם הבוט פעיל, מתי הייתה הסריקה האחרונה ומה מילת ההפעלה.
authorizeרק בודקת שההרשאות לגוגל צ'אט תקינות.
שדרוג

תשובות חכמות עם בינה מלאכותית

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

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

קודם משלימים את שלבים 1–10 ומוודאים שהגרסה הרגילה עובדת. אחר כך:

א

מפתח API ל־Gemini

  1. היכנסו ל־aistudio.google.com/apikey ולחצו Create API key.
  2. אם מתבקשים לבחור פרויקט, אפשר לבחור את הפרויקט שיצרתם בשלב 2.
  3. העתיקו את המפתח שנוצר.
המפתח הוא כמו סיסמה. לא משתפים אותו ולא מדביקים אותו בקבוצה.

השימוש חינמי עד מגבלה יומית. Google משנה את המגבלות מדי פעם, והמספרים המעודכנים מופיעים ב־AI Studio.

ב

שמירת המפתח בסקריפט

  1. ב־⚙️ הגדרות הפרויקט גללו לתחתית, לחלק מאפייני סקריפט (Script Properties).
  2. לחצו הוספת מאפיין סקריפט.
  3. בשדה המאפיין (Property) כתבו
  4. בשדה הערך (Value) הדביקו את המפתח.
  5. לחצו שמירת מאפייני הסקריפט.

ככה המפתח לא כתוב בתוך הקוד, ואפשר לשתף את הקוד בלי לחשוף אותו.

ג

החלפת הקוד בגרסת ה־AI

בקובץ קוד.gs מחקו הכול והדביקו את הגרסה הזו:

קוד.gs · גרסת AI
// 🤖 גרסת בינה מלאכותית (Gemini). לא עובדת בנטפרי.
// ✏️ כאן משנים את המילה (או כמה מילים) שמפעילה את הבוט
const TRIGGER_WORD = 'פיצי';

// נבנה אוטומטית מהמילה: @פיצי, גם עם רווח אחרי ה-@
const TRIGGER_RE = new RegExp(
  '@\\s*' + TRIGGER_WORD.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\s+/g, '\\s+')
);

const CONFIG = {
  // ✏️ ההנחיה לבינה המלאכותית: מי היא ואיך לענות
  AI_INSTRUCTIONS: 'אתה עוזר בקבוצת גוגל צ׳אט. ענה בעברית, בקצרה ובנימוס, בטקסט רגיל בלי כוכביות ובלי עיצוב Markdown.',
  AI_MODEL: 'gemini-flash-latest', // תמיד מודל ה-Flash העדכני של Google

  // תשובת גיבוי: נשלחת אם Gemini לא ענה (למשל כשנגמרה המכסה החינמית)
  REPLIES: [
    'סליחה, לא הצלחתי לענות כרגע. נסו שוב בעוד כמה דקות.'
  ],

  INCLUDE_DMS_AND_GROUPS: false, // true = גם שיחות אישיות וקבוצות, לא רק מרחבים
  COOLDOWN_SEC: 20,              // מקסימום תשובה אחת למרחב בפרק הזמן הזה
  MAX_RUN_MS: 240000,            // הגבלת זמן ריצה לסריקה אחת
  KEEP_DONE: 100                 // כמה הודעות לזכור (מגבלת 9KB לערך ב-Properties)
};

function installBotTrigger() {
  removeBotTrigger();
  PropertiesService.getUserProperties().setProperties({
    lastScan: new Date().toISOString(),
    done: '[]'
  });
  ScriptApp.newTrigger('scanMentions').timeBased().everyMinutes(1).create();
  Logger.log('הבוט הופעל.');
}

function removeBotTrigger() {
  ScriptApp.getProjectTriggers().forEach(t => {
    if (t.getHandlerFunction() === 'scanMentions') ScriptApp.deleteTrigger(t);
  });
  Logger.log('הבוט נעצר.');
}

function status() {
  const on = ScriptApp.getProjectTriggers().some(t => t.getHandlerFunction() === 'scanMentions');
  const p = PropertiesService.getUserProperties();
  Logger.log('פעיל: ' + on + ' | סריקה אחרונה: ' + p.getProperty('lastScan') + ' | מילת הפעלה: @' + TRIGGER_WORD);
}

function authorize() { Logger.log(Chat.Spaces.list({ pageSize: 1 })); }

// בדיקה: שולח ל-Gemini שאלה לדוגמה ומציג את התשובה ביומן
function testAI() {
  Logger.log(aiReply_({ text: '@' + TRIGGER_WORD + ' שלום! מה אתה יודע לעשות?' }) || 'לא התקבלה תשובה. בדקו את המפתח ואת השגיאה ביומן.');
}

function scanMentions() {
  const lock = LockService.getUserLock();
  if (!lock.tryLock(5000)) return;
  try {
    const props = PropertiesService.getUserProperties();
    const started = new Date();
    const since = new Date(props.getProperty('lastScan') || started.toISOString());
    // חפיפה של דקה כדי לא לפספס הודעות; כפילויות נחסמות ע"י רשימת done
    const cut = new Date(since.getTime() - 60000).toISOString().replace(/\.\d+Z$/, '+00:00');
    const done = JSON.parse(props.getProperty('done') || '[]');
    let complete = true;

    for (const space of listSpaces_()) {
      if (new Date() - started > CONFIG.MAX_RUN_MS) { complete = false; break; }

      let msgs = [];
      try {
        msgs = Chat.Spaces.Messages.list(space, {
          pageSize: 50,
          filter: 'createTime > "' + cut + '"'
        }).messages || [];
      } catch (err) { continue; }

      for (const m of msgs) {
        if (done.indexOf(m.name) > -1) continue;
        if (!TRIGGER_RE.test(m.text || '')) continue;
        done.push(m.name);
        if (onCooldown_(space)) continue;
        try { botReply_(space, m); } catch (err) { Logger.log(err); }
      }
    }

    props.setProperties({
      lastScan: complete ? started.toISOString() : since.toISOString(),
      done: JSON.stringify(done.slice(-CONFIG.KEEP_DONE))
    });
  } finally {
    lock.releaseLock();
  }
}

function botReply_(space, m) {
  const text = aiReply_(m) || CONFIG.REPLIES[Math.floor(Math.random() * CONFIG.REPLIES.length)];
  const msg = {
    text: text,
    quotedMessageMetadata: { name: m.name, lastUpdateTime: m.lastUpdateTime || m.createTime }
  };
  if (m.thread && m.thread.name) msg.thread = { name: m.thread.name };
  try {
    Chat.Spaces.Messages.create(msg, space, { messageReplyOption: 'REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD' });
  } catch (err) {
    // אם הציטוט נכשל, שולחים הודעה רגילה
    Chat.Spaces.Messages.create({ text: text }, space);
  }
}

// שולח את ההודעה ל-Gemini ומחזיר את התשובה, או null אם משהו נכשל
function aiReply_(m) {
  const key = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  if (!key) { Logger.log('חסר GEMINI_API_KEY במאפייני הסקריפט.'); return null; }

  // ההודעה בלי התיוג עצמו
  const tagAll = new RegExp(TRIGGER_RE.source, 'g');
  const question = (m.text || '').replace(tagAll, ' ').trim() || 'שלום';

  try {
    const res = UrlFetchApp.fetch(
      'https://generativelanguage.googleapis.com/v1beta/models/' + CONFIG.AI_MODEL + ':generateContent',
      {
        method: 'post',
        contentType: 'application/json',
        headers: { 'x-goog-api-key': key },
        payload: JSON.stringify({
          systemInstruction: { parts: [{ text: CONFIG.AI_INSTRUCTIONS }] },
          contents: [{ role: 'user', parts: [{ text: question }] }]
        }),
        muteHttpExceptions: true
      }
    );
    if (res.getResponseCode() !== 200) {
      Logger.log('Gemini החזיר שגיאה ' + res.getResponseCode() + ': ' + res.getContentText().slice(0, 300));
      return null;
    }
    const data = JSON.parse(res.getContentText());
    const c = (data.candidates || [])[0];
    const parts = (c && c.content && c.content.parts) || [];
    let out = parts.filter(p => p.text && !p.thought).map(p => p.text).join('').trim();
    // שהתשובה לא תכיל את התיוג, אחרת הבוט יענה לעצמו בלולאה
    out = out.replace(tagAll, TRIGGER_WORD);
    return out ? out.slice(0, 4000) : null;
  } catch (err) {
    Logger.log('Gemini: ' + err);
    return null;
  }
}

// רשימת כל המרחבים (עם דפדוף ו-cache של 5 דקות כדי לחסוך קריאות)
function listSpaces_() {
  const cache = CacheService.getUserCache();
  const hit = cache.get('spaces');
  if (hit) return JSON.parse(hit);

  const names = [];
  let token;
  do {
    const opt = { pageSize: 200, pageToken: token };
    if (!CONFIG.INCLUDE_DMS_AND_GROUPS) opt.filter = 'spaceType = "SPACE"';
    const res = Chat.Spaces.list(opt);
    (res.spaces || []).forEach(s => names.push(s.name));
    token = res.nextPageToken;
  } while (token);

  try { cache.put('spaces', JSON.stringify(names), 300); } catch (err) {}
  return names;
}

function onCooldown_(space) {
  const cache = CacheService.getUserCache();
  const key = 'cd:' + space;
  if (cache.get(key)) return true;
  cache.put(key, '1', Math.max(CONFIG.COOLDOWN_SEC, 1));
  return false;
}

השורות המסומנות הן אלה שמשנים: מילת ההפעלה, ההנחיה ל־AI ותשובת הגיבוי.

ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.

שמרו עם Ctrl+S.

ד

עדכון appsscript.json

נוספה שורה אחת: הרשאה לפנות לשירות חיצוני. מחקו הכול בקובץ appsscript.json והדביקו:

appsscript.json · גרסת AI
{
  "timeZone": "Asia/Jerusalem",
  "dependencies": {
    "enabledAdvancedServices": [
      { "userSymbol": "Chat", "serviceId": "chat", "version": "v1" }
    ]
  },
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly",
    "https://www.googleapis.com/auth/chat.messages",
    "https://www.googleapis.com/auth/script.scriptapp",
    "https://www.googleapis.com/auth/script.external_request"
  ],
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8"
}

ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.

שמרו עם Ctrl+S.

ה

בדיקה והפעלה

  1. בחרו ברשימה בסרגל העליון את הפונקציה testAI ולחצו ▷ הפעלה.
  2. תתבקשו לאשר הרשאה חדשה, לפנייה לשירות חיצוני. אשרו כמו בשלב 10.
  3. ביומן הביצוע אמורה להופיע תשובה מ־Gemini. אם מופיעה שגיאה, ראו את הטבלה למטה.
  4. בחרו את installBotTrigger ולחצו ▷ הפעלה.
  5. במרחב כתבו שאלה עם תיוג, למשל: @פיצי מה ההבדל בין RAM לזיכרון רגיל?

הגדרות גרסת ה־AI

הגדרהמה היא עושה
AI_INSTRUCTIONSההנחיה ל־AI: מי הוא ואיך לענות. למשל: "אתה עוזר בנושאי מחשבים. ענה בקצרה ובעברית."
REPLIESכאן זו תשובת גיבוי, שנשלחת רק אם Gemini לא ענה (למשל כשנגמרה המכסה היומית).
AI_MODELהמודל. אפשר להשאיר: gemini-flash-latest תמיד מצביע על מודל ה־Flash העדכני.

אם testAI מראה שגיאה

ביומן כתובמה לעשות
חסר GEMINI_API_KEYהמפתח לא נשמר. חזרו לשלב ב ובדקו שהשם כתוב בדיוק GEMINI_API_KEY.
שגיאה 400 או 403בעיה במפתח. צרו מפתח חדש בשלב א והחליפו את הערך בשלב ב.
שגיאה 429נגמרה המכסה החינמית לעכשיו. מחכים ומנסים שוב. בינתיים הבוט שולח את תשובת הגיבוי.
חשוב לדעת על גרסת ה־AI:

חשוב לדעת

תקלות נפוצות

הבוט לא עונה
  1. חכו 2 דקות. הסריקה רצה פעם בדקה.
  2. הריצו את status ובדקו שכתוב פעיל: true. אם כתוב false, הריצו שוב את installBotTrigger.
  3. בתפריט הימני של Apps Script לחצו ביצועים (☰ עם חץ) וחפשו ריצות של scanMentions עם שגיאה.
  4. ודאו שכתבתם במרחב ולא בצ'אט אישי או בקבוצה (או שנו את INCLUDE_DMS_AND_GROUPS ל־true).
  5. אחרי תשובה, הבוט לא יענה שוב באותו מרחב במשך 20 שניות (COOLDOWN_SEC).
שגיאה: "Google Chat app not found"

ההגדרה משלב 4 לא נשמרה, או שהסקריפט מחובר לפרויקט אחר. חזרו לשלב 4, ודאו שלחצתם Save, ובדקו שבשלב 9 הדבקתם את המספר של אותו פרויקט.

הבוט עבד ואחרי כמה ימים הפסיק

הריצו שוב את installBotTrigger ואשרו הרשאות אם תתבקשו. אם הוא מפסיק בכל פעם אחרי כשבוע, היכנסו ל־OAuth consent screen ← Audience ולחצו Publish app.

הבוט לא מבין מה כתבו לו. אפשר לחבר אותו לבינה מלאכותית?

נכון, בגרסה הבסיסית אין בו בינה מלאכותית. הוא מחפש רק את מילת ההפעלה, וכשהיא מופיעה הוא שולח את אחת התשובות הקבועות שכתבתם ב־REPLIES.

כן, אפשר לחבר אותו ל־Gemini. ההוראות נמצאות בפרק שדרוג: תשובות חכמות עם בינה מלאכותית. השדרוג לא עובד בנטפרי.

יש גם שיטה אחרת, בוט AI כאפליקציה נפרדת שמדברים איתה בצ'אט פרטי: מדריך | הוספת צ'אט AI בגוגל צ'אט (לא של מון בלאן).