გზამკვლევი: როგორ შევქმნათ მარტივი Telegram ბოტი JS-ში პროგრამირების დამწყებთათვის

მხოლოდ სამი კვირის წინ დავიწყე IT სამყაროში ჩაძირვა. სერიოზულად, სამი კვირის წინ მე არც კი მესმოდა HTML სინტაქსი და ჩემი გაცნობა პროგრამირების ენებში დასრულდა პასკალზე 10 წლის წინანდელი სასკოლო კურიკულუმით. თუმცა გადავწყვიტე IT ბანაკში წავსულიყავი, სადაც ბავშვებისთვის კარგი იქნებოდა ბოტის გაკეთება. გადავწყვიტე, რომ ეს ძნელად რთული იყო.

ამით დაიწყო გრძელი მოგზაურობა, რომელშიც მე:

• განათავსა ღრუბლოვანი სერვერი Ubuntu-სთან ერთად,
• რეგისტრირებულია GitHub-ზე,
• ვისწავლე ძირითადი JavaScript სინტაქსი,
• წაიკითხეთ უამრავი სტატია ინგლისურ და რუსულ ენებზე,
• ბოლოს შექმენი ბოტი,
• საბოლოოდ დავწერე ეს სტატია.

საბოლოო შედეგი ასე გამოიყურებოდა:

მე დაუყოვნებლივ ვიტყვი, რომ ეს არის სტატია დამწყებთათვის - უბრალოდ იმის გასაგებად, თუ როგორ უნდა გააკეთოთ ძირითადი საქმეები ნულიდან.

და ასევე - მოწინავე პროგრამისტებისთვის - მხოლოდ იმისთვის, რომ ცოტათი გააცინონ.

1. როგორ დავწეროთ კოდი JS-ში?

მივხვდი, რომ ჯერ მაინც ღირდა ენის სინტაქსის გაგება. არჩევანი JavaScript-ზე დაეცა, უბრალოდ იმიტომ, რომ შემდეგი ნაბიჯი ჩემთვის იყო აპლიკაციის შექმნა ReactNative-ში. დავიწყე იმით რა თქმა უნდა Codecademy-ზე და ძალიან გამიხარდა. პირველი 7 დღე უფასოა. რეალური პროექტები. Მე გირჩევ. მის დასრულებას დაახლოებით 25 საათი დასჭირდა. სინამდვილეში, ეს ყველაფერი არ იყო სასარგებლო. ასე გამოიყურება კურსის სტრუქტურა და პირველი ბლოკი დეტალურად.

2. როგორ დავრეგისტრირდეთ ბოტი?

ეს თავიდან ძალიან დამეხმარა ეს არტიკლი რომელიღაც არჩაკოვის ბლოგიდან. ის თავიდანვე ღეჭავს. მაგრამ მთავარი, რაც არის, არის ბოტის რეგისტრაციის ინსტრუქცია. უკეთესად ვერ დავწერ და რადგან ეს ყველაზე მარტივი ნაწილია, მხოლოდ არსს დავწერ. თქვენ უნდა შექმნათ ბოტი და მიიღოთ მისი API. ეს კეთდება სხვა ბოტის მეშვეობით - @BotFather. იპოვეთ იგი ტელეგრამაში, მიწერეთ, მიჰყევით მარტივ გზას და მიიღეთ (შეინახეთ!) API გასაღები (ეს არის რიცხვებისა და ასოების ნაკრები). მოგვიანებით გამოადგა.

3. როგორ გამოიყურება ბოტის კოდი?

სტატიების დიდი ხნის შესწავლის შემდეგ მივხვდი, რომ ღირდა რაიმე სახის ბიბლიოთეკის გამოყენება (მესამე მხარის კოდი მოდულის ფორმატში), რათა არ ინერვიულო Telegram API-ს შესწავლაზე და ნულიდან დიდი კოდის შექმნაზე. ჩარჩო ვიპოვე ტელეგრაფი, რომელიც საჭირო იყო რაღაცასთან დაკავშირება npm ან ნართის გამოყენებით. დაახლოებით ასე გავიგე მაშინ, რისგან შედგებოდა ბოტის განლაგება. იცინე აქ. არ მეწყინება. გვერდის ბოლოში მოცემული მაგალითები ყველაზე მეტად დამეხმარა ბოტის შემდგომ შექმნისას:

3. როგორ შევქმნათ საკუთარი ღრუბლოვანი სერვერი 100 რუბლისთვის

ბევრი ძებნის შემდეგ მივხვდი, რომ ზემოთ მოცემულ სურათზე ბრძანება 'npm' ეხება ბრძანების ხაზს. ბრძანების სტრიქონი ყველგან არის, მაგრამ იმისათვის, რომ შეძლოთ მისი შესრულება, თქვენ უნდა დააინსტალიროთ NodePackageManager. პრობლემა ის იყო, რომ მე ვაპროგრამებდი PixelBook-ზე ChromeOS-ით. აქ გამოვტოვებ დიდ ბლოკს იმის შესახებ, თუ როგორ ვისწავლე Linux - უმეტესობისთვის ის ცარიელი და არასაჭიროა. თუ თქვენ გაქვთ Windows ან MacBook, თქვენ უკვე გაქვთ კონსოლი.

მოკლედ, Linux დავაყენე Crostini-ის საშუალებით.

თუმცა, ამ პროცესში მივხვდი, რომ იმისთვის, რომ ბოტი მუდმივად იმუშაოს (და არა მხოლოდ მაშინ, როცა კომპიუტერი ჩართულია), მჭირდება ღრუბლოვანი სერვერი. მე ვირჩევ vscale.io დავხარჯე 100 მანეთი და ვიყიდე ყველაზე იაფი Ubuntu სერვერი (იხ. სურათი).

4. როგორ მოვამზადოთ სერვერი ბოტის გასაშვებად

ამის შემდეგ მივხვდი, რომ მჭირდებოდა სერვერზე რაიმე სახის საქაღალდის გაკეთება, რომელშიც ჩავდებდი ფაილს კოდის ტექსტით. ამისათვის, კონსოლში (გაშვება პირდაპირ ვებსაიტზე ღილაკის "ღია კონსოლის" საშუალებით), მე შევედი

mkdir bot

bot - ეს გახდა ჩემი საქაღალდის სახელი. ამის შემდეგ დავაინსტალირე npm და Node.js, რაც საშუალებას მომცემს შემდეგ გავუშვა კოდი ფაილებიდან *.js გარჩევადობით.

sudo apt update
sudo apt install nodejs
sudo apt install npm

უაღრესად გირჩევთ ამ ეტაპზე სერვერთან კავშირის შექმნას თქვენი კონსოლის საშუალებით. Აქ ინსტრუქცია ეს საშუალებას მოგცემთ იმუშაოთ სერვერთან პირდაპირ თქვენი კომპიუტერის კონსოლის საშუალებით.

5. როგორ დავწეროთ კოდი თქვენი პირველი ბოტისთვის.

მაგრამ ახლა ეს მხოლოდ აღმოჩენაა ჩემთვის. ნებისმიერი პროგრამა მხოლოდ ტექსტის ხაზებია. მათი ჩასმა შესაძლებელია სადმე, შეინახება სასურველი გაფართოებით და ეს არის ის. Ლამაზი ხარ. მე გამოვიყენე Atom, მაგრამ სინამდვილეში, შეგიძლიათ უბრალოდ ჩაწეროთ სტანდარტული ბლოკნოტში. მთავარია ფაილი მოგვიანებით შეინახოთ სასურველ გაფართოებაში. ეს ჰგავს ტექსტის დაწერას Word-ში და შენახვას.

შევქმენი ახალი ფაილი, რომელშიც ჩავდე კოდი ტელეგრაფის გვერდზე და შევინახე 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-ზე ფაილის შექმნა, რომელიც საშუალებას მოგცემთ განაახლოთ კოდი კონსოლში ბრძანების გამოყენებით. მე დავარეგისტრირე ანგარიში გითუბი და გააკეთეს ახალი პროექტი, სადაც ავტვირთე ფაილი. ამის შემდეგ, მე უნდა გამეგო, როგორ დავაყენო ფაილების ატვირთვა ჩემი ანგარიშიდან (გახსენით!) სერვერზე ბოტის საქაღალდეში (თუ მოულოდნელად დატოვეთ, უბრალოდ ჩაწერეთ 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. როგორ გავუშვათ ბოტი

ამისათვის, ფაილის საქაღალდეში ყოფნისას (კონსოლის საშუალებით საქაღალდიდან საქაღალდეში გადასატანად, გაუშვით ფორმატის ბრძანება 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'))

სტანდარტული /დახმარების ბრძანების საპასუხოდ, გაგზავნეთ შეტყობინება "გამომიგზავნე სტიკერი"

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

გაგზავნეთ დამტკიცება სტიკერის საპასუხოდ

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

უპასუხეთ „ჰეი იქ“, თუ „გამარჯობა“ დაუწერეს მას
bot.launch()

თუ დააკვირდებით კოდს გითუბი, მაშინ თქვენ სწრაფად მიხვდებით, რომ მე არც ისე შორს წავსულვარ ამ ფუნქციონალიდან. რაც აქტიურად გამოიყენება არის ფუნქცია ctx.replyWithPhoto ის საშუალებას გაძლევთ გაგზავნოთ მითითებული ფოტო ან gif კონკრეტული ტექსტის საპასუხოდ.

კოდის მნიშვნელოვანი ნაწილი დაიწერა 11-13 წლის ბავშვებმა, რომლებსაც ბოტზე წვდომა მივეცი. ისინი შევიდნენ თავიანთი მომხმარებლის საქმეში. ვფიქრობ, ადვილი სათქმელია, რომელი ნაწილია მათ მიერ გაკეთებული.

მაგალითად, შეტყობინება "Jake" მიიღებს GIF-ს ცნობილი პერსონაჟით მულტფილმიდან Adventure Time.

ბოტის შემდგომი განვითარებისთვის, თქვენ უნდა დააკავშიროთ კლავიატურა, იხილეთ მაგალითები, მაგალითად, აქედან გამომდინარე,

11. როგორ განაახლოთ კოდი და გადატვირთოთ ბოტი

არ დაგავიწყდეთ, რომ კოდის განახლება გჭირდებათ არა მხოლოდ github-ზე, არამედ სერვერზეც. ამის გაკეთება მარტივია - გააჩერეთ ბოტი (დააჭირეთ ctrl+c),

- შედით კონსოლში სამიზნე საქაღალდეში ყოფნისას, git pull
— ბრძანებით ისევ გავუშვით ბოტი node index.js

END

ამ ფაილში აღწერილი ბევრი რამ ძალიან აშკარა იქნება მოწინავე პროგრამისტებისთვის. თუმცა, როცა მე თვითონ ვცდილობდი უფსკრულზე ერთი დარტყმით გადამეხტა ბოტების სამყაროში, ძალიან მომენატრა ასეთი სახელმძღვანელო. გზამკვლევი, რომელსაც არ გამოტოვებს ის, რაც აშკარა და მარტივია ნებისმიერი IT სპეციალისტისთვის.

სამომავლოდ ვგეგმავ პოსტს იმის შესახებ, თუ როგორ უნდა გააკეთოთ თქვენი პირველი აპლიკაცია ReactNative-ზე იმავე სტილში, გამოიწერეთ!

წყარო: www.habr.com