מדריך: כיצד ליצור בוט טלגרם פשוט ב-JS למתחילים בתכנות

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

זה התחיל מסע ארוך שבו אני:

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

התוצאה הסופית נראתה בערך כך:

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

וגם - למתכנתים מתקדמים - רק כדי להצחיק אותם קצת.

1. איך כותבים קוד ב-JS?

הבנתי שכדאי לפחות להבין קודם את התחביר של השפה. הבחירה נפלה על JavaScript, פשוט כי השלב הבא עבורי היה ליצור אפליקציה ב-ReactNative. התחלתי עם קוּרס על Codecademy והיה מאוד מאושר. 7 הימים הראשונים בחינם. פרויקטים אמיתיים. אני ממליץ. השלמתו ארכה כ-25 שעות. למעשה, לא הכל היה שימושי. כך נראה מבנה הקורס והגוש הראשון בפירוט.

2. איך רושמים בוט?

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

3. איך נראה קוד הבוט?

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

3. כיצד ליצור שרת ענן משלך עבור 100 רובל

לאחר חיפושים רבים, הבנתי שהפקודה 'npm' בתמונה למעלה מתייחסת לשורת הפקודה. שורת הפקודה נמצאת בכל מקום, אבל כדי להיות מסוגל לבצע אותה, אתה צריך להתקין את NodePackageManager. הבעיה הייתה שתכנתתי ב-PixelBook עם ChromeOS. אדלג כאן על בלוק גדול על איך למדתי לינוקס - לרוב זה ריק ומיותר. אם יש לך Windows או MacBook, כבר יש לך קונסולה.

בקיצור, התקנתי לינוקס דרך Crostini.

עם זאת, תוך כדי כך הבנתי שכדי שהבוט יעבוד כל הזמן (ולא רק כשהמחשב שלי דלוק), אני צריך שרת ענן. אני בחרתי vscale.io הוצאתי 100 רובל וקניתי את שרת אובונטו הזול ביותר (ראה תמונה).

4. איך להכין שרת להפעיל בוט

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

mkdir bot

bot - זה הפך לשם של התיקייה שלי. לאחר מכן, התקנתי npm ו-Node.js, שיאפשרו לי להריץ קוד מקבצים עם רזולוציית *.js

sudo apt update
sudo apt install nodejs
sudo apt install npm

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

5. איך לכתוב את הקוד עבור הבוט הראשון שלך.

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

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

const Telegraf = require('telegraf')

const bot = new Telegraf(process.env.BOT_TOKEN)
bot.start((ctx) => ctx.reply('Welcome!'))
bot.help((ctx) => ctx.reply('Send me a sticker'))
bot.on('sticker', (ctx) => ctx.reply(''))
bot.hears('hi', (ctx) => ctx.reply('Hey there'))
bot.launch()

6. איך להעלות קוד לשרת דרך github

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

7. כיצד להעלות קבצים לשרת דרך github חלק 2

הייתי צריך להתקין תוכנית בשרת שתוריד קבצים מ-git. התקנתי git על השרת על ידי הקלדה בקונסולה

apt-get install git

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

git clone git://github.com/b0tank/bot.git bot

כתוצאה מכך, הכל מהפרויקט הועלה לשרת. הטעות בשלב זה הייתה שבעצם יצרתי תיקיה שנייה בתוך תיקיית הבוט שכבר קיימת. הכתובת לקובץ נראתה כמו */bot/bot/index.js

החלטתי להתעלם מהבעיה הזו.

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

npm install telegraf

8. איך להפעיל בוט

לשם כך, בעודך בתיקייה עם הקובץ (כדי לעבור מתיקיה לתיקיה דרך הקונסולה, הפעל את הפקודה format cd bot כדי לוודא שאתה נמצא היכן שאתה צריך להיות, אתה יכול להזין פקודה שתציג בקונסולה את כל הקבצים והתיקיות שיש שם ls -a

כדי להתחיל, נכנסתי לקונסולה

node index.js

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

9. איך להפעיל בוט ברקע

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

screen

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

node index.js

10. איך הבוט עובד וכיצד להרחיב את הפונקציונליות שלו

מה הבוט לדוגמה שלנו יכול לעשות? הוא יכול

bot.start((ctx) => ctx.reply('Welcome!'))

אמור "ברוך הבא!" ברגע ההתחלה (נסה לשנות את הטקסט)

bot.help((ctx) => ctx.reply('Send me a sticker'))

בתגובה לפקודה הרגילה /help, שלח את ההודעה "שלח לי מדבקה"

bot.on('sticker', (ctx) => ctx.reply(''))

לשלוח אישור בתגובה למדבקה

bot.hears('hi', (ctx) => ctx.reply('Hey there'))

ענו לו "היי" אם הם כותבים לו "היי".
bot.launch()

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

חלק נכבד מהקוד נכתב על ידי ילדים בגילאי 11-13, להם נתתי גישה לבוט. הם נכנסו ל-User-case שלהם. אני חושב שקל לדעת איזה חלק נעשה על ידם.

לדוגמה, ההודעה "ג'ייק" תקבל GIF עם דמות מפורסמת מהסרט המצויר Adventure Time.

כדי לפתח את הבוט עוד יותר, עליך לחבר מקלדת, ראה דוגמאות, למשל, מכאן

11. כיצד לעדכן את הקוד ולהפעיל מחדש את הבוט

אל תשכח שאתה צריך לעדכן את הקוד לא רק ב-github, אלא גם בשרת. זה קל לעשות - עצור את הבוט (הקש ctrl+c),

- היכנס למסוף תוך כדי תיקיית היעד, git pull
- אנו מפעילים את הבוט שוב ​​עם הפקודה node index.js

הסוף

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

בעתיד, אני מתכנן פוסט על איך לבצע את היישום הראשון שלך ב-ReactNative באותו סגנון, הירשמו!

מקור: www.habr.com