הפעלת אימות דו־שלבי
Google Cloud דורש אימות דו־שלבי בחשבון. אם הוא כבר מופעל אצלכם, דלגו לשלב הבא.
להפעלה: myaccount.google.com/security ← אימות דו־שלבי, ופעלו לפי ההוראות.
כמו @משמרת הצניעות: כותבים במרחב @פיצי, ותוך דקה מגיעה תשובה אוטומטית. הכול רץ ב־Google Apps Script בחשבון שלכם, בלי שרת ובלי תשלום.
ככה זה נראה במרחב:
חשוב להבין את זה לפני שמתחילים:
סקריפט קטן בחשבון שלכם בודק פעם בדקה את המרחבים שאתם חברים בהם.
אם מישהו כתב @פיצי (או המילה שתבחרו), הוא עונה עם ציטוט של ההודעה.
בגרסה הבסיסית הבוט לא מבין את ההודעה. הוא שולח טקסט שכתבתם מראש. רוצים שיענה בעצמו? יש שדרוג עם בינה מלאכותית.
התשובה נשלחת מהחשבון שלכם, ולידה מופיע שם האפליקציה. אין "משתמש בוט" נפרד.
Google Cloud דורש אימות דו־שלבי בחשבון. אם הוא כבר מופעל אצלכם, דלגו לשלב הבא.
להפעלה: myaccount.google.com/security ← אימות דו־שלבי, ופעלו לפי ההוראות.
chat-bot) ולחצו Create.בתפריט (שלושת הקווים ☰ בצד) עברו אל:
חזרו אל Enabled APIs & services, גללו לטבלה בתחתית העמוד ולחצו על Google Chat API. עברו ללשונית הרביעית:
מלאו כך:
| שדה | מה לכתוב |
|---|---|
| App name | השם שיופיע ליד התשובות. למשל: פיצי |
| Avatar URL | קישור לתמונה ריבועית. אפשר להשאיר ריק. |
| Description | תיאור קצר, עד 40 תווים. |
| App status | אם מופיע: LIVE – available to users |
| Interactive features | להשאיר כבוי. |
גללו למטה ולחצו Save.
לחצו על הלוגו Google Cloud למעלה כדי לחזור לדף הבית. בכרטיס Welcome מופיע Project number (מספר ארוך של 12 ספרות), ולידו כפתור העתקה.
העתיקו אותו ושמרו בצד. תצטרכו אותו בשלב 9.
היכנסו ל־script.google.com ולחצו פרויקט חדש. אפשר לשנות למעלה את השם "פרויקט ללא שם", למשל ל"בוט פיצי".
בקובץ קוד.gs מחקו את כל מה שכתוב (Ctrl+A ואז Delete), העתיקו את הקוד הבא והדביקו:
// ✏️ כאן משנים את המילה (או כמה מילים) שמפעילה את הבוט
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.
הקובץ הזה מפעיל בסקריפט את שירות Google Chat ומגדיר אילו הרשאות הוא מבקש.
<>) ופתחו את הקובץ 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.
<>) ופתחו את קוד.gs.installBotTrigger.כתבו באחד המרחבים שאתם חברים בו @פיצי (או המילה שבחרתם). תוך דקה–שתיים אמורה להגיע תשובה עם ציטוט של ההודעה.
כל ההגדרות נמצאות בראש הקובץ קוד.gs.
| הגדרה | מה היא עושה |
|---|---|
TRIGGER_WORD | מילת ההפעלה, בלי ה־@. אפשר גם כמה מילים, למשל 'משמרת הצניעות'. |
REPLIES | התשובה. אם כותבים כמה תשובות, בכל פעם נבחרת אחת באקראי. |
COOLDOWN_SEC | לכל היותר תשובה אחת למרחב בפרק הזמן הזה (בשניות). ברירת מחדל: 20. |
INCLUDE_DMS_AND_GROUPS | false: עונה רק במרחבים. true: עונה גם בצ'אטים אישיים ובקבוצות. |
דוגמה לכמה תשובות:
REPLIES: [
'משמרת הצניעות כאן לשרותכם, ספרו לנו מה הבעיה ומי הבעיה, ונשמח לעזור ולנקות תוכן לא ראוי.',
'קיבלנו! נבדוק את זה בהקדם.',
'תודה על הדיווח, מטפלים בזה.'
],
ההעתקה האוטומטית לא עבדה. הקוד סומן: לחצו Ctrl+C.
' משני הצדדים, ואחרי כל תשובה חוץ מהאחרונה יש פסיק. אם בתוך התשובה יש גרש (כמו צ'אט), כתבו לפניו לוכסן הפוך: 'צ\'אט', או השתמשו בגרש עברי ׳.בוחרים פונקציה ברשימה שבסרגל העליון ולוחצים ▷ הפעלה. התוצאה מופיעה ביומן הביצוע.
| פונקציה | מה היא עושה |
|---|---|
installBotTrigger | מפעילה את הבוט (או מפעילה אותו מחדש). |
removeBotTrigger | עוצרת את הבוט. |
status | מציגה אם הבוט פעיל, מתי הייתה הסריקה האחרונה ומה מילת ההפעלה. |
authorize | רק בודקת שההרשאות לגוגל צ'אט תקינות. |
במקום תשובה קבועה, הבוט שולח את ההודעה ל־Gemini (הבינה המלאכותית של Google) ועונה במה שהוא ניסח. הכול קורה בתוך המרחבים הקיימים, בלי להוסיף אפליקציה לצ'אט.
קודם משלימים את שלבים 1–10 ומוודאים שהגרסה הרגילה עובדת. אחר כך:
השימוש חינמי עד מגבלה יומית. Google משנה את המגבלות מדי פעם, והמספרים המעודכנים מופיעים ב־AI Studio.
ככה המפתח לא כתוב בתוך הקוד, ואפשר לשתף את הקוד בלי לחשוף אותו.
בקובץ קוד.gs מחקו הכול והדביקו את הגרסה הזו:
// 🤖 גרסת בינה מלאכותית (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 והדביקו:
{
"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.
testAI ולחצו ▷ הפעלה.installBotTrigger ולחצו ▷ הפעלה.| הגדרה | מה היא עושה |
|---|---|
AI_INSTRUCTIONS | ההנחיה ל־AI: מי הוא ואיך לענות. למשל: "אתה עוזר בנושאי מחשבים. ענה בקצרה ובעברית." |
REPLIES | כאן זו תשובת גיבוי, שנשלחת רק אם Gemini לא ענה (למשל כשנגמרה המכסה היומית). |
AI_MODEL | המודל. אפשר להשאיר: gemini-flash-latest תמיד מצביע על מודל ה־Flash העדכני. |
| ביומן כתוב | מה לעשות |
|---|---|
| חסר GEMINI_API_KEY | המפתח לא נשמר. חזרו לשלב ב ובדקו שהשם כתוב בדיוק GEMINI_API_KEY. |
| שגיאה 400 או 403 | בעיה במפתח. צרו מפתח חדש בשלב א והחליפו את הערך בשלב ב. |
| שגיאה 429 | נגמרה המכסה החינמית לעכשיו. מחכים ומנסים שוב. בינתיים הבוט שולח את תשובת הגיבוי. |
status ובדקו שכתוב פעיל: true. אם כתוב false, הריצו שוב את installBotTrigger.scanMentions עם שגיאה.INCLUDE_DMS_AND_GROUPS ל־true).COOLDOWN_SEC).ההגדרה משלב 4 לא נשמרה, או שהסקריפט מחובר לפרויקט אחר. חזרו לשלב 4, ודאו שלחצתם Save, ובדקו שבשלב 9 הדבקתם את המספר של אותו פרויקט.
צריך להגדיר פעם אחת מסך הסכמה (OAuth consent screen) בפרויקט ב־Google Cloud:
חזרו לשלב 9 ונסו שוב.
אם בזמן מתן ההרשאות מופיע "Access blocked": באותו מקום, תחת Audience ← Test users, הוסיפו את כתובת המייל שלכם.
הריצו שוב את installBotTrigger ואשרו הרשאות אם תתבקשו. אם הוא מפסיק בכל פעם אחרי כשבוע, היכנסו ל־OAuth consent screen ← Audience ולחצו Publish app.
נכון, בגרסה הבסיסית אין בו בינה מלאכותית. הוא מחפש רק את מילת ההפעלה, וכשהיא מופיעה הוא שולח את אחת התשובות הקבועות שכתבתם ב־REPLIES.
כן, אפשר לחבר אותו ל־Gemini. ההוראות נמצאות בפרק שדרוג: תשובות חכמות עם בינה מלאכותית. השדרוג לא עובד בנטפרי.
יש גם שיטה אחרת, בוט AI כאפליקציה נפרדת שמדברים איתה בצ'אט פרטי: מדריך | הוספת צ'אט AI בגוגל צ'אט (לא של מון בלאן).