ガイド: プログラミング初心者向けに JS で簡単な Telegram ボットを作成する方法

私が IT の世界にどっぷりと浸かり始めたのは、わずか 10 週間前です。 正直なところ、XNUMX 週間前、私は HTML 構文さえ理解していませんでした。私のプログラミング言語への入門は、XNUMX 年前の Pascal に関する学校カリキュラムで終わりました。 しかし、子どもたちにボットを作ってもらうのは良いだろうということで、ITキャンプに行くことにしました。 それほど難しいことではないと判断しました。

これにより、私は次のような長い旅をすることになりました。

• Ubuntuを使用してクラウドサーバーをデプロイし、
• GitHubに登録されている、
• 基本的な JavaScript 構文を学習し、
• 英語とロシア語の記事を大量に読み、
• ついにボットを作りました
• やっとこの記事を書きました。

最終的な結果は次のようになります。

すぐに言っておきますが、これは初心者向けの記事であり、基本的なことを一から行う方法を理解するためのものです。

また、上級プログラマにとっては、少し笑わせるためでもあります。

1. JS でコードを記述するにはどうすればよいですか?

少なくともその言語の構文を最初に理解することは価値があることを理解しました。 私にとって次のステップは ReactNative でアプリケーションを作成することであったため、選択は JavaScript になりました。 私はから始めました もちろん Codecademy に参加し、とてもうれしく思いました。 最初の 7 日間は無料です。 実際のプロジェクト。 お勧めします。 完成までに約25時間かかりました。 実際、そのすべてが役に立ったわけではありません。 コースの構造と最初のブロックの詳細はこんな感じです。

2. ボットを登録するにはどうすればよいですか?

これは最初のうちはとても役に立ちました この記事 某アルカコフ氏のブログより。 彼は最初から噛みます。 ただし、そこにある主なものは、ボットを登録するための手順です。 これ以上うまく書くことはできませんが、これが最も簡単な部分なので、要点だけ書きます。 ボットを作成し、その API を取得する必要があります。 これは別のボット @BotFather を通じて行われます。 電報で彼を見つけて手紙を書き、簡単なパスに従って API キー (これは数字と文字のセットです) を取得 (保存) してください。 後で役に立ちました。

3. ボットのコードはどのようなものですか?

長い間記事を読んだ後、Telegram API を勉強して大きなコードを最初から作成することを心配する必要がないように、ある種のライブラリ (モジュール形式のサードパーティ コード) を使用する価値があることに気づきました。 枠組みを見つけた 電信、npmまたはyarnを使用して何らかの方法で何かに接続する必要がありました。 これは、ボットの展開の構成を私が理解したおおよその方法です。 ここで笑ってください。 気分を害することはありません。 ページの下部にある例は、その後のボットの作成時に最も役立ちました。

3. 100ルーブルで独自のクラウドサーバーを作成する方法

いろいろ検索した結果、上の図の「npm」コマンドがコマンド ラインを指していることがわかりました。 コマンド ラインはどこにでもありますが、実行するには NodePackageManager をインストールする必要があります。 問題は、ChromeOS を搭載した PixelBook でプログラミングしていたことでした。 ここでは、私が Linux をどのように学んだかについての大きなブロックを省略します。ほとんどの場合、それは空であり、不要です。 Windows または MacBook をお持ちの場合は、すでにコンソールをお持ちです。

簡単に言うと、Crostini 経由で Linux をインストールしました。

しかし、その過程で、ボットが (コンピューターの電源が入っているときだけでなく) 常時動作するには、クラウド サーバーが必要であることに気付きました。 私が選んだ vscale.io 私は100ルーブルを費やして、最も安いUbuntuサーバーを購入しました（写真を参照）。

4. ボットを実行するためのサーバーを準備する方法

その後、サーバー上にコード テキストを含むファイルを置く何らかのフォルダーを作成する必要があることに気付きました。 これを行うには、コンソール (「コンソールを開く」ボタンを使用して Web サイト上で直接実行) で次のように入力しました。

mkdir bot

bot - これが私のフォルダーの名前になりました。 その後、npm と Node.js をインストールしました。これにより、*.js 解像度のファイルからコードを実行できるようになります。

sudo apt update
sudo apt install nodejs
sudo apt install npm

この段階でコンソールを介してサーバーへの接続を設定することを強くお勧めします。 ここ 命令 これにより、コンピュータのコンソールから直接サーバーを操作できるようになります。

5. 最初のボットのコードの書き方。

しかし、今ではそれは私にとって単なる発見です。 どのプログラムも単なるテキスト行です。 どこにでも挿入し、必要な拡張子を付けて保存するだけで完了です。 あなたは美しいです。 私が使用した アトム, しかし実際には、普通のメモ帳に書くだけで大丈夫です。 主なことは、後でファイルを目的の拡張子で保存することです。 Word でテキストを書いて保存するようなものです。

新しいファイルを作成し、そこに Telegraf ページの例のコードを挿入し、index.js ファイルに保存しました (通常、ファイルにそのような名前を付ける必要はありませんが、これは慣例です)。 重要 - BOT_TOKEN の代わりに、XNUMX 番目の段落から 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の そしてやった 新しいプロジェクト, ここにファイルをアップロードしました。 その後、自分のアカウント (開いています!) から bot フォルダー内のサーバーにファイルをアップロードする設定方法を理解する必要がありました (突然そこから離れた場合は、cd bot と書くだけです)。

7. Github経由でサーバーにファイルをアップロードする方法 その2

git からファイルをダウンロードするプログラムをサーバーにインストールする必要がありました。 コンソールに入力してサーバーに git をインストールしました

apt-get install git

その後、ファイルのアップロードを設定する必要がありました。 これを行うには、コマンドラインに次のように入力しました。

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

その結果、プロジェクトのすべてがサーバーにアップロードされました。 この段階での間違いは、基本的に既存のボット フォルダー内に XNUMX 番目のフォルダーを作成したことです。 ファイルのアドレスは */bot/bot/index.js のようになりました。

私はこの問題を無視することにしました。

コードの最初の行で要求する telegraf ライブラリをロードするには、コンソールにコマンドを入力します。

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 歳の子供たちによって書かれており、私は彼らにボットへのアクセスを許可しました。 彼らはユーザーケースを入力しました。 どの部分が彼らが作ったかは簡単にわかると思います。

たとえば、メッセージ「ジェイク」は、漫画「アドベンチャー タイム」の有名なキャラクターを含む GIF を受け取ります。

ボットをさらに開発するには、キーボードを接続する必要があります。例を参照してください。 故に

11. コードを更新してボットを再起動する方法

Github だけでなくサーバー上のコードも更新する必要があることを忘れないでください。 これは簡単です - ボットを停止します (Ctrl+C を押します)。

- ターゲットフォルダー内でコンソールに入ります。 git pull
— 次のコマンドでボットを再度起動します node index.js

終わり

このファイルに記述されている内容の多くは、上級プログラマにとっては非常に明白です。 しかし、私自身がキャズムを越えて一気にボットの世界に飛び込もうとしたとき、そのような指針を本当に見逃してしまったのです。 IT スペシャリストにとって当たり前のことを見逃さないガイド。

将来的には、同じスタイルで ReactNative 上で最初のアプリケーションを作成する方法について投稿する予定です。購読してください!

出所： habr.com