Guide: hur man gör en enkel Telegram-bot i JS för en nybörjare inom programmering

Jag började dyka in i IT-världen för bara tre veckor sedan. Allvarligt talat, för tre veckor sedan förstod jag inte ens HTML-syntax, och mina kunskaper om programmeringsspråk slutade med skolans läroplan på Pascal från 10 år sedan. Jag bestämde mig dock för att gå på ett IT-läger, för vars barn det skulle vara trevligt att göra en bot. Jag bestämde mig för att det inte kunde vara så svårt.

Det här var början på en lång resa där jag:

• driftsatte en molnserver med Ubuntu,
• registrerad på GitHub,
• lärt sig grundläggande JavaScript-syntax,
• Jag läste massor av artiklar på engelska och ryska,
• äntligen gjort en bot,
• Jag skrev äntligen den här artikeln.

Slutresultatet såg ut ungefär så här:

Låt mig säga direkt att den här artikeln är för nybörjare - bara för att förstå hur man gör grundläggande saker från grunden.

Och även - för avancerade programmerare - bara för att få dem att skratta lite.

1. Hur skriver man kod i JS?

Jag förstod att det var värt att åtminstone förstå syntaxen i språket först. Valet föll på JavaScript helt enkelt för att nästa steg för mig var att skapa en applikation i ReactNative. Jag började med kurs på Codecademy och var mycket nöjd. De första 7 dagarna är gratis. Riktiga projekt. Jag rekommenderar det. Det tog cirka 25 timmar att slutföra det. I själva verket var inte allt användbart. Ungefär så ser kursstrukturen ut och det första blocket i detalj.

2. Hur registrerar man en bot?

I början hjälpte det mig mycket den här artikeln från en viss Archakovs blogg. Han tuggar över i början. Men det viktigaste som finns är instruktionerna om hur man registrerar en bot. Jag kan inte skriva det bättre, och eftersom det här är den enklaste delen skriver jag bara kärnan. Du måste skapa en bot och få dess API. Detta görs genom en annan bot - @BotFather. Hitta honom i telegram, skriv till honom, följ den enkla vägen och få (spara!) en API-nyckel (detta är en uppsättning siffror och bokstäver). Det kom väl till pass senare.

3. Hur ser botkoden ut?

Efter att ha studerat artiklarna under en längre tid insåg jag att det är värt att använda något bibliotek (tredjepartskod i modulformat) för att inte lida av att studera Telegram API och skapa stora bitar av kod från grunden. Jag hittade en ram telegraf, som på något sätt behövde kopplas till något med hjälp av npm eller garn. Ungefär så förstod jag då vad bot-distribution bestod av. Skratta här. Jag kommer inte att bli förolämpad. Det som hjälpte mig mest när jag sedan skapade boten var exemplen längst ner på sidan:

3. Hur man skapar din egen molnserver för 100 rubel

Efter mycket letande insåg jag att kommandot 'npm' i bilden ovan refererar till kommandoraden. Kommandoraden finns överallt, men för att köra den måste du installera NodePackageManager. Problemet var att jag programmerade på en PixelBook med ChromeOS. Jag hoppar över den stora delen om hur jag lärde mig det. Linux - För de flesta är det tomt och onödigt. Om du har Windows eller MacBook, har du redan en konsol.

I ett nötskal, jag satte Linux via Crostini.

Men i processen insåg jag att för att boten ska fungera konstant (och inte bara när min dator är på) behöver jag en molnserver. jag valde vscale.io Jag satte in 100 rubel och köpte den billigaste servern. Ubuntu (se bild).

4. Hur man förbereder en server för att köra en bot

Efter det insåg jag att jag behövde skapa någon form av mapp på servern, där jag skulle lägga filen med kodtexten. För att göra detta gick jag in i konsolen (kör direkt på webbplatsen via knappen "Öppna konsolen")

mkdir bot

bot - detta blev namnet på min mapp. Efter det installerade jag npm och Node.js, vilket gör att jag kan köra kod från filer med tillägget *.js.

sudo apt update
sudo apt install nodejs
sudo apt install npm

Jag rekommenderar starkt att du i detta skede konfigurerar en anslutning till servern via din konsol. Här instruktion Detta gör att du kan arbeta med servern direkt via konsolen på din dator.

5. Hur man skriver koden för din första bot.

Men nu är det bara en uppenbarelse för mig. Alla program är bara rader med text. Du kan ange dem var som helst, spara dem med önskat tillägg och det är allt. Du är vacker. jag använde Atom, men egentligen kan du bara skriva i ett vanligt anteckningsblock. Det viktigaste är att spara filen senare i önskat tillägg. Det är som att skriva text i Word och spara den.

Jag gjorde en ny fil, klistrade in koden från exemplet på telegrafsidan i den och sparade den som index.js (det är inte nödvändigt att namnge filen på det sättet, men det är praxis). Viktigt: ersätt BOT_TOKEN med din API-nyckel från den andra punkten.

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. Hur man laddar upp kod till servern via github

Nu behövde jag på något sätt kasta den här koden på servern och köra den. Det blev en utmaning för mig. Till slut, efter mycket lidande, insåg jag att det skulle vara lättare att skapa en fil på github som låter dig uppdatera koden med ett kommando i konsolen. Jag registrerade ett konto på github och gjorde nytt projekt, där jag laddade upp filen. Efter det behövde jag ta reda på hur jag ställer in filuppladdningar från mitt konto (öppet!) till servern i bot-mappen (om du plötsligt avslutar den, skriv bara cd-bot).

7. Hur man laddar upp filer till servern via github del 2

Jag behövde installera ett program på servern som skulle ladda ner filer från git. Jag installerade git på servern genom att skriva in i konsolen

apt-get install git

Efter det behövde jag ställa in filuppladdningar. För att göra detta gick jag in på kommandoraden

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

Som ett resultat laddades allt från projektet upp till servern. Felet i det här skedet var att jag i princip skapade en andra mapp i den befintliga botmappen. Adressen före filen såg ut som */bot/bot/index.js

Jag bestämde mig för att ignorera detta problem.

Och för att ladda telegrafbiblioteket, som vi begär i den första raden kod, skriv in kommandot i konsolen.

npm install telegraf

8. Hur man startar en bot

För att göra detta, medan du är i mappen med filen (för att flytta från mapp till mapp via konsolen, kör formatkommandot cd bot För att vara säker på att du är där du behöver vara kan du ange ett kommando som visar alla filer och mappar som finns där i konsolen. ls -a

För att börja gick jag in i konsolen

node index.js

Om det inte finns något fel är allt bra, boten fungerar. Leta efter honom på Telegram. Om det finns ett fel, tillämpa dina kunskaper från punkt 1.

9. Hur man kör en bot i bakgrunden

Du kommer snabbt att inse att boten bara fungerar när du själv sitter i konsolen. För att lösa detta problem använde jag kommandot

screen

Efter detta kommer en skärm med lite text upp. Det betyder att allt är bra. Du är på en virtuell server på en molnserver. För att bättre förstå hur det hela fungerar - här är artikeln. Gå bara till din mapp och ange kommandot för att starta boten

node index.js

10. Hur boten fungerar och hur man utökar dess funktionalitet

Vad kan vår bot från exemplet göra? Han kan göra det

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

säg "Välkommen!" i början (försök att ändra texten)

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

som svar på standardkommandot /help, skicka meddelandet "Skicka mig en klistermärke"

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

som svar på klistermärket skicka godkännande

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

svara "Hej där" om någon skriver "hej" till honom
bot.launch()

Om du tittar på koden på github, då förstår du snabbt att jag inte har gått särskilt långt från denna funktionalitet. Det som används aktivt är funktionen ctx.replyWithPhoto Det låter dig skicka ett specifikt foto eller gif som svar på en specifik text.

En betydande del av koden skrevs av barn i åldern 11-13, som jag gav tillgång till boten. De presenterade sitt användarfall. Jag tror att det är lätt att säga vilken del som gjordes av dem.

Till exempel får meddelandet "Jake" en GIF med en känd karaktär från den tecknade Adventure Time.

För att utveckla boten ytterligare behöver du ansluta tangentbordet, titta på exempel, till exempel, hence

11. Hur man uppdaterar koden och startar om boten

Glöm inte att du behöver uppdatera koden inte bara på github, utan även på servern. Det är lätt att göra - stoppa boten (tryck på ctrl+c),

- gå in i konsolen medan du är i målmappen, git pull
— vi startar boten igen med kommandot node index.js

SLUT

Många av de saker som beskrivs i den här filen kommer att vara superuppenbara för avancerade programmerare. Men när jag själv försökte hoppa över avgrunden till botsvärlden i ett svep saknade jag verkligen en sådan guide. En guide som inte hoppar över saker som är självklara och enkla för vilken IT-specialist som helst.

I framtiden planerar jag att skriva om hur du gör din första ReactNative-app i samma stil, prenumerera!

Källa: will.com