כאן מוגדרים חיבורים אמיתיים למערכות חיצוניות נתמכות. לכל מערכת (GreenAPI, Google Ads וכו') יש הגדרות כלליות משותפות (תיעוד/הסבר/מדיניות — ראו "הגדרות סוגי מערכת") ואוסף חיבורים ספציפיים (למשל כמה חשבונות שונים מאותה מערכת). פרטי אישור נשמרים מוצפנים, לעולם לא מוצגים במלואם, וקביעה/שינוי/מחיקה שלהם דורשים קוד אימות חד-פעמי. אחרי כל שמירה מתבצעת בדיקת חיבור אמיתית. לחיצה על חיבור בטבלה פותחת את מסך הניהול הייעודי שלו.

טוען...

API ומערכות נוספות /

ב-Google Cloud Console יש להוסיף ל-OAuth client את ה-Redirect URI: https://lin.vidis.co.il/api/integrations/youtube-channel/oauth/callback

צפייה ביומן קריאות של החיבור הזה (כולל קריאות שנכשלו)

שלב א: השגת api_id ו-api_hash (פעם אחת)

  1. היכנסו ל-my.telegram.org והזינו את מספר הטלפון של החשבון בפורמט בינלאומי (למשל +9725...).
  2. טלגרם תשלח קוד לאפליקציית הטלגרם של החשבון (לא ב-SMS). הזינו אותו באתר.
  3. לחצו על API development tools ומלאו: App title (כל שם), Short name (5-32 אותיות לטיניות/ספרות). שדה URL אינו webhook ואפשר להשאיר ריק. Platform: כל בחירה.
  4. לחצו Create application. יוצגו api_id (מספר) ו-api_hash (מחרוזת ארוכה). אם מוצגת שגיאה כללית, נסו שוב אחרי כמה דקות ובלי VPN.

שלב ב: הזנה בחיבור

  1. בלשונית "פרטי אישור" מלאו api_id, api_hash ומספר טלפון (פורמט בינלאומי) ולחצו "קביעה / עדכון" ואשרו בקוד OTP.
  2. שימו לב: אחרי השמירה השדות נעולים לצמיתות. בדקו אותם לפני האישור.

שלב ג: התחברות לחשבון

  1. בלשונית "פרטי אישור" לחצו "שליחת קוד התחברות לחשבון הטלגרם".
  2. בטלגרם של החשבון תגיע הודעה מ-Telegram עם קוד בן 5 ספרות. הזינו אותו בשדה שמופיע ולחצו "אישור התחברות".
  3. אם בחשבון מופעל אימות דו-שלבי, יופיע שדה סיסמה. הזינו אותה ואשרו שוב.
  4. בהצלחה התג יהפוך ל"מחובר". לחצו "בדיקת חיבור" לאימות: התוצאה התקינה היא "מחובר בתור <שם החשבון>".

חשוב לדעת

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

שלב א: יצירת חשבון שירות ב-Google Cloud (פעם אחת)

  1. היכנסו ל-console.cloud.google.com עם חשבון הגוגל הארגוני, ובחרו פרויקט קיים או צרו פרויקט חדש (כל שם).
  2. בתפריט APIs & Services ← Library, חפשו Google Sheets API ולחצו Enable.
  3. בסרגל הצד של APIs & Services לחצו Credentials, ואז + Create credentials ← Service account. תנו שם (למשל vidis-sheets) ולחצו Create and continue. אין צורך לבחור תפקידים, ואפשר לסיים ב-Done.
  4. בעמוד Credentials, בטבלת Service Accounts, לחצו על כתובת חשבון השירות שנוצר, היכנסו ללשונית Keys, ולחצו Add key ← Create new key ← JSON ← Create. קובץ JSON יורד למחשב.
  5. פתחו את הקובץ (עורך טקסט) ושימו לב לשדה client_email: כתובת שנראית כך vidis-sheets@project-id.iam.gserviceaccount.com. תצטרכו אותה בשלב הבא.

שלב ב: שיתוף הגיליון עם חשבון השירות

  1. פתחו את הגיליון ב-Google Sheets ולחצו Share (שיתוף).
  2. הדביקו את כתובת client_email מהשלב הקודם, בחרו הרשאה Editor (עורך), וכבו את Notify people (חשבון שירות אינו קורא מיילים). לחצו Share.
  3. כל גיליון נוסף שהאפליקציות צריכות לגשת אליו חייב להיות משותף כך בנפרד.

שלב ג: הזנה בחיבור

  1. בלשונית "פרטי אישור": בשדה "קובץ חשבון שירות" הדביקו את כל תוכן קובץ ה-JSON (מהסוגר הפותח ועד הסוגר הסוגר).
  2. אופציונלי: בשדה "מזהה גיליון ברירת מחדל" הדביקו את המזהה מכתובת הגיליון, החלק שבין /d/ ל-/edit (למשל בכתובת docs.google.com/spreadsheets/d/1AbC...xyz/edit). עם מזהה, בדיקת החיבור מוכיחה גם שהגיליון שותף.
  3. לחצו "קביעה / עדכון" ואשרו בקוד OTP. אחרי השמירה השדות נעולים לצמיתות, לכן בדקו אותם לפני האישור.

שלב ד: בדיקה

  1. לחצו "בדיקת חיבור". תוצאה תקינה: "מחובר בתור <client_email>", ואם הוגדר מזהה גיליון גם "הגיליון '<שם>' נגיש".
  2. אם מתקבלת שגיאה 403 או 404, הגיליון לא שותף עם הכתובת (שלב ב) או שהמזהה שגוי.

חשוב לדעת

  • קובץ ה-JSON הוא סוד: מי שמחזיק בו יכול לערוך כל גיליון שמשותף עם החשבון. אין לשלוח אותו במייל או בצ'אט, ומומלץ למחוק אותו מהמחשב אחרי ההזנה.
  • אם הארגון חוסם יצירת מפתחות לחשבונות שירות (השגיאה מופיעה בשלב א, סעיף 4), מנהל ה-Workspace צריך להסיר את מדיניות הארגון iam.disableServiceAccountKeyCreation.
  • החלפת חשבון שירות מחייבת לפתוח את השדה לעריכה ב"הגדרות סוגי מערכת" ולשתף מחדש את הגיליונות עם הכתובת החדשה.

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

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

API ומערכות נוספות / הגדרות סוגי מערכת

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

API ומערכות נוספות / הגדרות סוגי מערכת /

API ומערכות נוספות / הוספת מערכת

הוספת מערכת

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

API ומערכות נוספות / הוספת מערכת /

הגדרת מערכת

מדריך ותיעוד רשמי

החיבור יישמר רק לאחר מילוי כל שדות החובה (מסומנים ב-*). יציאה לפני השמירה לא תשאיר כלום.

API ומערכות נוספות / סל מיחזור

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