בניית בוט טלגרם ב-Yandex.Cloud

היום, מחומרי גרוטאות, נרכיב Yandex.Cloud בוט טלגרם עם פונקציות ענן של Yandex (או פונקציות Yandex - בקיצור) ו אחסון אובייקטים של Yandex (או אחסון חפצים - לשם הבהירות). הקוד יפעל Node.js. עם זאת, יש נסיבה פיקנטית אחת - ארגון מסוים שנקרא, נניח, RossKomTsenzur (הצנזורה אסורה על פי סעיף 29 של חוקת הפדרציה הרוסית), אינה מאפשרת לספקי אינטרנט רוסים להעביר בקשות אל ממשק API של טלגרם подосу: https://api.telegram.org/. ובכן, אנחנו לא נעשה - לא, לא. אחרי הכל, בתיק שלנו יש מה שנקרא. webhooks — בעזרתם, אנחנו לא פונים לכתובת ספציפית, אלא פשוט שולחים את בקשתנו כמענה לכל בקשה אלינו. כלומר, כמו באודסה, אנחנו עונים על שאלה בשאלה. בגלל זה ממשק API של טלגרם לא יופיע בקוד שלנו.

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

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

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

יצירת בוט

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

פתח את האפליקציה טלגראם, בואו נקרא לאבא של כל הבוטים (יש להם הכל כמו אנשים) - @BotFather - ותחילה ניתן לו את הפקודה /help כדי לרענן את הזיכרון שלו לגבי מה שאנחנו יכולים לעשות. כעת נתעניין בצוות / newbot.

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

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

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

כאן נוכל להגדיר את הבוט שלנו. על ידי לחיצה על הכפתור ערוך ... נעבור לעריכת אפשרות כזו או אחרת. לדוגמה, על ידי לחיצה על הכפתור ערוך שם אנחנו יכולים לשנות את שם הבוט, נניח במקום זאת מחשבות חכמות, לכתוב רעיונות מטורפים. Botpic - זה הדמות של הבוט, חייב להיות לפחות 150 x 150 px. תיאור - זהו תיאור קצר שהמשתמש רואה בעת הפעלת הבוט בפעם הראשונה, כתשובה לשאלה: מה הבוט הזה יכול לעשות? אודות - תיאור קצר עוד יותר, אשר מועבר עם קישור לבוט (https://t.me/SmartThoughtsBot) או בעת הצגת מידע אודותיו.

כל שעלינו לעשות הוא להגדיר את הפקודות. לשם כך, לחץ על הכפתור ערוך פקודות. לסטנדרטיזציה של פרקטיקת המשתמש מברק ממליץ להשתמש תמיד בשתי פקודות: /הַתחָלָה и /עֶזרָה, ואם הבוט זקוק להגדרות, השתמש בפקודה הנוספת /settings. הבוט שלנו פשוט כמו כדור, כך שהוא עדיין לא צריך שום הגדרות. אנו כותבים את שתי הפקודות הראשונות, אותן נעבד בקוד. כעת, אם המשתמש יזין לוכסן (סימן לוכסן: /) בשדה הקלט, תופיע רשימה של פקודות לבחירה מהירה. הכל כמו בתמונה: משמאל - אנו מתקינים פקודות דרך הבוט האב; בצד ימין, הפקודות הללו כבר זמינות למשתמשים בבוט שלנו.

פונקציית Yandex

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

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

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

כעת, באמצעות התפריט השמאלי, עבור אל Редактор פונקציות. בואו נניח לרגע בצד שלנו מחשבות חכמות, וליצור פונקציית תבנית מינימלית כדי לבדוק את הפונקציונליות של הבוט שלנו... עם זאת, בהקשר הזה, הפונקציה הזו היא הבוט שלנו... בקיצור, עכשיו וכאן ניצור בוט פשוט ש"ישקף" ( כלומר שלח בחזרה) בקשות משתמשים. תמיד ניתן להשתמש בתבנית זו בעת יצירת בוטים חדשים של טלגרם כדי לוודא שהתקשורת איתם מִברָק'אוהם עובד בסדר. נְקִישָׁה צור קובץ, בואו נקרא לזה index.js, ובאינטרנט עורך קוד הדבק את הקוד הבא בקובץ הזה:

module.exports.bot = async (event) => {
  
  const body = JSON.parse(event.body);

  const msg = {
    'method': 'sendMessage',
    'chat_id': body.message.chat.id,
    'text': body.message.text
  };

  return {
    'statusCode': 200,
    'headers': {
      'Content-Type': 'application/json'
    },
    'body': JSON.stringify(msg),
    'isBase64Encoded': false
  };
};

במסוף Yandex.Cloud זה אמור להיראות בערך כך:

בהמשך נציין נקודת כניסה - index.botאיפה מדד זה שם הקובץ (index.js), ו לוע - שם פונקציה (module.exports.bot). השאר את כל שאר השדות כפי שהם, ולחץ על הכפתור בפינה השמאלית העליונה צור גרסה. תוך מספר שניות תיווצר גרסה זו של הפונקציה. זמן קצר לאחר הבדיקה webhook, ניצור גרסה חדשה - מחשבות חכמות.

אחסון חפצים

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

לאחר מכן, הרשימה של כל הדליים עשויה להיראות בערך כך (אם זה הדלי היחיד שלך):

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

כעת תוכלו ללחוץ על שם התיקיה, להיכנס אליה ולהעלות קבצים:

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

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

Webhook

עכשיו נתקין webhook - כלומר. כאשר הבוט מקבל עדכון (לדוגמה, הודעה ממשתמש) מהשרת מברק לתוך שלנו פונקציית Yandex תישלח בקשה (לבקש) עם נתונים. הנה שורה שאתה יכול פשוט להדביק בשדה הכתובת של הדפדפן שלך ואז לרענן את הדף (עליך לעשות זאת רק פעם אחת): https://api.telegram.org/bot{bot_token}/setWebHook?url={webhook_url}
פשוט נחליף אותו {bot_token} לאסימון שקיבלנו מהבוט האב בעת יצירת הבוט שלנו, ו {webhook_url} - דולק כתובת האתר שלנו פונקציות Yandex. חכה דקה! אבל RossKomTsenzur אוסר על ספקים בפדרציה הרוסית לתת שירות לכתובת https://api.telegram.org. כן זה נכון. אבל תמציא משהו. אחרי הכל, אתה יכול, למשל, לשאול את סבתא שלך על זה באוקראינה, בישראל או בקנדה - אין שם "רוסקומצנזורה", ורק אלוהים יודע איך אנשים חיים בלעדיה. כתוצאה מכך, התגובה לבקשה בעת התקנת webhook צריכה להיראות כך:

אנחנו בוחנים. זה צריך "לשקף".

זה נכון. ברכותינו - עכשיו פונקציית Yandex הפך מברק-בוט!

מחשבות חכמות

עכשיו בואו נעשה מחשבות חכמות. הקוד פתוח ושוכב GitHub. יש לו הערות די טובות ואורכו רק מאה שורות. קרא את זה כמו ליברית דיווה אופרה!

שכפול הפרויקט והתקן תלות:

git clone https://github.com/stmike/tg-bot-smart-thoughts.git
cd tg-bot-smart-thoughts
npm i

בצע את השינויים הדרושים לך בקובץ index.js (אופציונלי; לא צריך לשנות כלום). לִיצוֹר zip-ארכיון, עם קובץ index.js ותיקיה צומת_מודולים בפנים, למשל, תחת השם smart.zip.

כעת עבור אל המסוף אל שלנו פונקציות Yandex, בחר בכרטיסייה ארכיון ZIP, לחץ על הכפתור בחר קובץ, והורד את הארכיון שלנו smart.zip. לבסוף, בפינה השמאלית העליונה, לחץ על הכפתור צור גרסה.

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

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

תזכור

קוד ב-GitHub
פונקציות ענן של Yandex
אחסון אובייקטים של Yandex
בוטים: מבוא למפתחים
ממשק ה- API של טלגרם בוט

תרומות

מקור: www.habr.com