Telegram ბოტის შექმნა Yandex.Cloud-ში

დღეს ჩვენ შევაგროვებთ იმპროვიზირებული მასალებისგან Yandex.Cloud ტელეგრაფის ბოტი გამოყენებით Yandex Cloud ფუნქციები (ან Yandex ფუნქციები მოკლედ) და Yandex ობიექტების შენახვა (ან ობიექტების შენახვა - სიცხადისთვის). კოდი ჩართული იქნება Node.js. თუმცა, არის ერთი პიკანტური გარემოება - გარკვეული ორგანიზაცია ე.წ., ვთქვათ, RossKom ცენზურა (ცენზურა აკრძალულია რუსეთის ფედერაციის კონსტიტუციის 29-ე მუხლით), არ აძლევს უფლებას რუსეთში ინტერნეტ პროვაიდერებს გადასცენ მოთხოვნები Telegram API მისამართი: https://api.telegram.org/. კარგი, ჩვენ არ გავაკეთებთ - არა, არა. მართლაც, ჩვენს ჩანთაში არის ე.წ. ვებჰუკები - მათი დახმარებით ჩვენ არ ვაკეთებთ მოთხოვნებს კონკრეტულ მისამართზე, არამედ მხოლოდ ჩვენს მოთხოვნას ვაგზავნით, როგორც პასუხი ნებისმიერ მოთხოვნაზე. ანუ, როგორც ოდესაში - კითხვას კითხვით ვპასუხობთ. Ამიტომაც Telegram API არ გამოჩნდება ჩვენს კოდში.

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

ასე რომ, ჩვენ გავაკეთებთ ბოტს, რომელიც მოგვაწვდის ჭკვიან აზრებს. ზუსტად ისე, როგორც სურათზე:

შეგიძლიათ სცადოთ მოქმედებაში - აქ არის სახელი: @SmartThoughtsBot. დააკვირდით ღილაკს "ალისის უნარი"? ეს იმიტომ ხდება, რომ ბოტი ერთგვარი „თანამგზავრია“ ეპონიმისთვის ალისის უნარი, ე.ი. ის ასრულებს იგივე ფუნქციებს, როგორც ალისის უნარი და, შესაძლოა, რომ მათ მშვიდობიანად თანაარსებობენ ერთმანეთის რეკლამირებაში. იმის შესახებ, თუ როგორ უნდა შექმნათ ჭკვიანი აზროვნების უნარი აღწერილია სტატიაში ალისა იძენს უნარს. ახლა (ზემოხსენებული სტატიის გამოქვეყნების შემდეგ გარკვეული ცვლილებების შეტანის შემდეგ) სმარტფონზე ეს უნარი დაახლოებით ასე გამოიყურება:

შექმენით ბოტი

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

გახსენით აპლიკაცია ტელეგარამი, ჩვენ ყველა ბოტის მამას ვეძახით (მათ ყველაფერი აქვთ როგორც ხალხს) - @BotFather - და დასაწყისისთვის, ჩვენ მივცემთ მას / help ბრძანებას, რათა განაახლოს ჩვენი მეხსიერება იმის შესახებ, რისი გაკეთებაც შეგვიძლია. ახლა გუნდით ვართ დაინტერესებული / newbot.

ვინაიდან აქ აღწერილი ბოტი უკვე შექმნილია, სადემონსტრაციო მიზნით შევქმნი სხვა ბოტს მცირე ხნით (შემდეგ წავშლი). მე მას დავურეკავ DemoHabrBot. სახელები (მომხმარებლის სახელი) ყველა ტელეგრამის ბოტი უნდა დასრულდეს სიტყვით ბოტი, მაგალითად: MyCoolBot ან my_cool_bot ეს არის ბოტებისთვის. მაგრამ ჯერ დაარქვით ბოტს სახელი (სახელი) არის ხალხისთვის. სახელი შეიძლება იყოს ნებისმიერ ენაზე, შეიცავდეს სივრცეებს, არ უნდა დასრულდეს სიტყვით ბოტი, და არც უნდა იყოს უნიკალური. ამ მაგალითში მე დავურეკე ამ ბოტს დემო ჰაბრ.

ახლა აირჩიე სახელი ბოტისთვის (მომხმარებლის სახელი, ბოტებისთვის). დავარქვათ DemoHabrBot. ყველაფერი რაც ეხება ბოტის სახელს (სახელი) საერთოდ არ არის დაკავშირებული მის სახელთან - მომხმარებლის სახელი (ან ვრცელდება, მაგრამ ზუსტად პირიქით). უნიკალური ბოტის სახელის წარმატებით შექმნის შემდეგ, ჩვენ უნდა დავაკოპიროთ და შევინახოთ (მკაცრ კონფიდენციალურობაში!) სკრინშოტზე ნაჩვენები ჟეტონი წითელი ისრით. მისი დახმარებით ჩვენ მოგვიანებით დავაყენებთ გამავალს დეპეშა'ვებჰუკი ჩვენთვის Yandex ფუნქცია.

და ახლა ჩვენ მივცემთ ბრძანებას ყველა ბოტის მამას: /mybotsდა ის გვაჩვენებს ჩვენს მიერ შექმნილი ყველა ბოტის ჩამონათვალს. ახლად გამომცხვარი ბოტი ჯერ დავტოვოთ დემო ჰაბრ (ის შეიქმნა იმისთვის, რომ აჩვენოს, როგორ შევქმნათ ბოტები, მაგრამ ჩვენ მას დღეს გამოვიყენებთ სხვა საჩვენებელი მიზნებისთვის) და განიხილეთ ბოტი ჭკვიანი აზრები (@SmartThoughtsBot). დააწკაპუნეთ ღილაკზე მისი სახელით ბოტების სიაში.

ეს არის სადაც ჩვენ შეგვიძლია დავაყენოთ ჩვენი ბოტი. ღილაკის დაჭერა რედაქტირება… ჩვენ გადავალთ ამა თუ იმ ვარიანტის რედაქტირებაზე. მაგალითად, ღილაკზე დაჭერით სახელის რედაქტირება ჩვენ შეგვიძლია შევცვალოთ ბოტის სახელი, ამის ნაცვლად ვთქვათ ჭკვიანი აზრები, დაწერე გიჟური იდეები. ბოთპიკი - ეს არის ბოტის ავატარი, უნდა იყოს მაინც 150 150 x px. აღწერა არის მოკლე აღწერა, რომელსაც მომხმარებელი ხედავს ბოტის პირველად გაშვებისას, როგორც პასუხი კითხვაზე: რისი გაკეთება შეუძლია ამ ბოტს? მომხმარებლის - კიდევ უფრო მოკლე აღწერა, რომელიც გადაცემულია ბოტის ბმულით (https://t.me/SmartThoughtsBot) ან მის შესახებ ინფორმაციის ნახვისას.

ჩვენ უბრალოდ უნდა დავაყენოთ ბრძანებები. ამისათვის დააჭირეთ ღილაკს ბრძანებების რედაქტირება. მომხმარებლის პრაქტიკის სტანდარტიზაცია დეპეშა გირჩევთ ყოველთვის გამოიყენოთ ორი ბრძანება: /დაწყება и / დახმარებადა თუ ბოტს სჭირდება პარამეტრები, დამატებითი /settings ბრძანება. ჩვენი ბოტი ბურთივით მარტივია, ამიტომ მას ჯერ არ სჭირდება პარამეტრები. ჩვენ ვწერთ პირველ ორ ბრძანებას, რომელსაც შემდეგ დავამუშავებთ კოდში. ახლა, თუ მომხმარებელი შეყვანის ველში შეიყვანს ხაზს (slash სიმბოლო: /), გამოჩნდება ბრძანებების სია მათი სწრაფი შერჩევისთვის. ყველაფერი ისეა, როგორც სურათზე: მარცხნივ - ვაყენებთ ბრძანებებს ბოტ-მამას მეშვეობით; მარჯვნივ, ეს ბრძანებები უკვე ხელმისაწვდომია მომხმარებლებისთვის ჩვენს ბოტში.

Yandex ფუნქცია

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

ასე რომ, კონსოლში Yandex.ღრუბლები მარცხენა ნავიგაციის მენიუში აირჩიეთ ელემენტი ღრუბლის ფუნქციები, და შემდეგ დააჭირეთ ღილაკს შექმენით ფუნქცია. ჩვენ ვაძლევთ მას სახელს, ჩვენთვის კი - მოკლე აღწერა.

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

ახლა მარცხენა მენიუს გამოყენებით გადადით რედაქტორი ფუნქციები. მოდით, ერთი წუთით გვერდზე გადავდოთ ჩვენი ჭკვიანი აზრები, და შევქმნათ მინიმალური შაბლონის ფუნქცია ჩვენი ბოტის მუშაობის შესამოწმებლად... თუმცა, ამ კონტექსტში ეს ფუნქცია ჩვენი ბოტია... მოკლედ, ახლა და სწორედ აქ გავაკეთებთ უმარტივეს ბოტს, რომელიც „ასახავს“ ( ანუ უკან გაგზავნა ) მომხმარებლის მოთხოვნები. ეს შაბლონი ყოველთვის შეიძლება გამოყენებულ იქნას ახალი ტელეგრამის ბოტების შექმნისას, რათა დარწმუნდეთ, რომ კომუნიკაცია Telegram'om კარგად მუშაობს. დააწკაპუნეთ შექმენით ფაილი, დაუძახე 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). დატოვე ყველა სხვა ველი "როგორც არის" და ზედა მარჯვენა კუთხეში დააჭირეთ ღილაკს ვერსიის შექმნა. რამდენიმე წამის შემდეგ შეიქმნება ფუნქციის ეს ვერსია. ტესტირების შემდეგ მალევე ვებჰუკი, ჩვენ შევქმნით ახალ ვერსიას − ჭკვიანი აზრები.

ობიექტების შენახვა

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

ამის შემდეგ, ყველა თაიგულების სია შეიძლება ასე გამოიყურებოდეს (თუ ეს თქვენი ერთადერთი ვედროა):

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

ახლა შეგიძლიათ დააჭიროთ საქაღალდის სახელს, შეხვიდეთ მასში და ატვირთოთ ფაილები:

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

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

ვებჰუკი

ახლა ჩვენ დავაყენებთ ვებჰუკი — ე.ი. როდესაც ბოტი მიიღებს განახლებას (მაგალითად, შეტყობინებას მომხმარებლისგან), სერვერისგან დეპეშა ჩვენსში Yandex ფუნქცია მოთხოვნა გაიგზავნებამოითხოვოს) მონაცემებით. აქ არის სტრიქონი, რომელიც შეგიძლიათ უბრალოდ ჩასვათ ბრაუზერის მისამართის ველში და შემდეგ განაახლოთ გვერდი (ეს მხოლოდ ერთხელ უნდა გაკეთდეს): https://api.telegram.org/bot{bot_token}/setWebHook?url={webhook_url}
უბრალოდ შეცვალეთ {bot_token} იმ ჟეტონს, რომელიც მივიღეთ მამა ბოტისგან ჩვენი ბოტის შექმნისას და {webhook_url} - ჩართულია URL ჩვენი Yandex ფუნქციები. Ერთი წუთი მაცადე! მაგრამ RossKom ცენზურა კრძალავს პროვაიდერებს რუსეთის ფედერაციაში მისამართის მოწოდებას 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 და საქაღალდე კვანძის_მოდულები შიგნით, მაგალითად, ე.წ ჭკვიანი.zip.

ახლა გადადით ჩვენს კონსოლში Yandex ფუნქციებიაირჩიეთ ჩანართი ZIP არქივი, დააჭირეთ ღილაკს აირჩიეთ ფაილიდა ჩამოტვირთეთ ჩვენი არქივი ჭკვიანი.zip. დაბოლოს, ზედა მარჯვენა კუთხეში დააჭირეთ ღილაკს ვერსიის შექმნა.

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

დღეისთვის სულ ესაა. სხვა სტატიები მოჰყვება. თუ გაინტერესებთ ამის წაკითხვა, გამოიწერეთ ახალი სტატიების შეტყობინებები. შეგიძლიათ გამოიწეროთ აქ ან დეპეშაარხი IT გაკვეთილი Zakharან Twitter @mikezaharov.

ლიტერატურა

კოდი GitHub-ზე
Yandex Cloud ფუნქციები
Yandex ობიექტების შენახვა
ბოტები: შესავალი დეველოპერებისთვის
Telegram Bot API

დონატი

წყარო: www.habr.com