קבלת וובהוק על משתתף שנוסף/הוסר מקבוצת ווצאפ

רקע

GREEN-API לא שולחים וובהוק ייעודי כשמשתמש מצטרף לקבוצה או עוזב אותה. הסקריפט הזה מגשר על הפער: הוא סורק את רשימת המשתתפים בקבוצה בתדירות שתגדירו, ומשווה לרשימה שמורה בגוגל שיטס שלכם. כל שינוי מפעיל וובהוק.

מבנה הגיליון

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

שלב 1: קבועים בסקריפט

1. פתחו את קובץ הגוגל שיטס שלכם שבו סידרתם את העמודות.
2. בתפריט, לחצו על: Extensions → Apps Script.
3. הדביקו את הסקריפט והתאימו את המשתנים:

const instanceId = "YOUR_INSTANCE_ID";   // מזהה המופע בגרין
const tokenId    = "YOUR_TOKEN_ID";      // טוקן API
const groupId    = "[email protected]";       // מזהה הקבוצה
const sheetName  = "Sheet1";             // שם הגיליון
const webhookUrl = "https://...";        // כתובת הוובהוק שלכם

הסבר

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

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

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

שלב 2: הסקריפט עצמו

זו הפונקציה עצמה שתרוץ, העתיקו אותה כמו שהיא:

function getParticipants() {
  return newParticipantsToWebhook_libary.newParticipantsToWebhook_libary(instanceId, tokenId, groupId, sheetName, webhookUrl)
}

שלב 3: הוספת הספרייה

1. לחצו על + ליד Libraries.
2. הזינו את מזהה הסקריפט בדיוק ככה: 1cItaewFWSJN-cjrVgc5sVzO3z4a7Q7Nvgx1Tug9qhK27H8P0nj0kBNRt.
3. בחרו את הגרסה הגבוהה ביותר (אמור להיות כברירת המחדל), ובשורה התחתונה כתבו: newParticipantsToWebhook_libary.
4. הריצו פעם אחת כדי לאשר הרשאות גישה.
5. שימו לב, בהרצה הגיליון שלכם יתעדכן עם פרטי המשתתפים וישלח וובהוק.

שלב 4: הגדרת Trigger

כדי שהפונקציה תרוץ בצורה קבועה צריך להגדיר טריגר מבוסס זמן:

1. עברו ל-מפעילים/Triggers.
2. הוסיפו trigger חדש, במקור האירוע תבחרו: מבוסס זמן/Time-driven.
3. בחרו את התדירות הרצויה. מומלץ לא פחות מ-5 דקות - הפעולה מתבצעת מול ווצאפ, ובדיקה כל דקה עלולה להיות מסוכנת לחסימה.
4. שמרו את הטריגר.

זהו - הסקריפט פעיל!

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

שאלות? צרו קשר ב-WhatsApp.