בסיס הידע של GetMyBot

פרויקטים וערוצים

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

בעמוד זה

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

צרו פרויקט בפרויקטים ואז הוסיפו לו ערוץ. כדי לחבר Telegram צריך טוקן מ-@BotFather, המפתח לניהול הבוט. בורר הפרויקטים נמצא בראש לוח הבקרה.

הבוט אינו מוגבל ל-Telegram. אפשר לחבר גם WhatsApp ו-VK ולהשתמש באותן תגובות בכל הערוצים. ראו ערוצים וחיבור WhatsApp.

חיבור בוט

  1. אם עדיין אין פרויקט, פתחו את פרויקטים ולחצו הוספת פרויקט. בכרטיס שלו לחצו הוספת ערוץ ובחרו Telegram. לבוט הראשון אפשר להשתמש גם באשף ההתחלה.
  2. הדביקו את הטוקן מ-@BotFather ולחצו אימות. GetMyBot יציג את @username שמצא, כדי שתוכלו לוודא שזה הבוט הנכון.
  3. לחצו חיבור. הטוקן נשמר כשהוא מוצפן, וקבלת האירועים מתחילה מיד.

ערוץ Telegram יופיע בכרטיס הפרויקט לצד הערוצים האחרים. הכרטיס מציג את שם הפרויקט, @username של הבוט, מספר המשתמשים, תגובות פעילות ובקשות מהיום. את יתרת הבקשות אפשר לראות במנוי או בסטטיסטיקה.

כמה בוטים באותו חשבון

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

איך הבוט מקבל הודעות?

אחרי החיבור GetMyBot מקבל בעצמו אירועי Telegram: הודעות, לחיצות על כפתורים, הצטרפות לצ'אט ותשלומים. כל עוד הטוקן תקף, אין צורך להגדיר בנפרד את קבלת האירועים. בהתאם להגדרות השרת, Telegram שולח אותם לכתובת הפלטפורמה (webhook), או שהפלטפורמה מבקשת אותם מ-Telegram מדי פעם (long polling).

הפעלה וכיבוי

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

מצב הפרויקט וזמינות הערוץ

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

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

הפלטפורמה מפעילה כמה תהליכי שירות שווי ערך. כל אחד מהם שולח אות לבוט שהוא משרת אחת ל-30 שניות. האות נחשב עדכני למשך דקה וחצי, כך שאות אחד שחסר לא יקפיץ את המצב מיד.

מה כדאי לבדוק בפועל:

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

מה קורה כשהבוט אינו מחובר?

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

בכרטיס Bot health בהגדרות עשויות להופיע ארבע סיבות:

  • Webhook: Telegram אינו מצליח למסור עדכונים לכתובת הפלטפורמה, והיא רושמת אותה מחדש.
  • טוקן שבוטל: getMe מחזיר 401. הפעלה מחדש לא תתקן זאת; צרו טוקן חדש ב-@BotFather והזינו אותו דרך החלף טוקן.
  • אין שרת שמטפל בבוט: אין תהליך שמעבד את העדכונים, והפלטפורמה מפעילה מחדש את הבוט.
  • הסיבה אינה ידועה: Telegram לא ענה לבדיקת המצב.

הפעלה מחדש עושה את מה שעושה סנכרן: היא בודקת את הטוקן באמצעות getMe ורושמת מחדש את ה-webhook. המרווחים בין הניסיונות גדלים בהדרגה. Restart log רושם לכל ניסיון את השעה, התוצאה והודעת השגיאה אם הייתה; בכרטיס מוצג גם מועד הניסיון הבא.

אם הבוט שקט יותר מסף ההתראה בכרטיס Bot health (ברירת המחדל היא 5 דקות), הבעלים מקבל הודעת „Бот офлайн” („הבוט אינו מחובר”) בפעמון שביישום ובאימייל. הבוט שולח הודעה גם לצ'אטים שנבחרו כמקבלי התראות. לכל אירוע תקלה נשלחת התראה אחת. כשאותות הפעילות חוזרים, מגיעה הודעת „Бот снова онлайн” („הבוט שוב מחובר”) עם משך ההפסקה. רשימת אירועי העבר, משכם וסיבתם נשארת באותו כרטיס.

הקפאה בגלל התוכנית

נוסף על „פעיל / כבוי”, בוט יכול להיות מוקפא. הפלטפורמה, ולא המשתמש, מקפיאה בוט כאשר התוכנית הנוכחית אינה מכסה את מספר הבוטים המחוברים. יש לכך שתי סיבות בלבד:

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

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

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

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

פרופיל וסנכרון

לחיצה על סנכרן בהגדרות מעדכנת את שם הבוט מ-Telegram אם שיניתם אותו ב-@BotFather. תמונת הפרופיל של הבוט נמשכת אוטומטית.

החלפת טוקן

אם חידשתם טוקן ב-@BotFather (Bot Settings ← Revoke / New token), עדכנו אותו בהגדרות ← ערוצים ← Telegram 🔑. הטוקן החדש חייב להיות שייך לאותו בוט (זהה על פי ID פנימי ב-Telegram) — כך כל הריאקציות, המנויים והנתונים נשמרים. אם ערוץ ה-Telegram לא מוצג, בחרו «החלף טוקן» באותו חלון.

העברת הפרויקט לחשבון אחר

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

תבניות בוט

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

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

כך אפשר לשכפל הגדרות של פרויקט טיפוסי.

התקנת פתרון מוכן מהקטלוג

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

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

מדידת תוצאות של פתרון מוכן

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

מה הלאה?