サーバー管理の手間をかけずに Telegram ボットを構築する準備はできていますか? Cloudflare Workers を使用すると、すべての面倒な作業を引き受ける強力でスケーラブルなプラットフォームを活用して、ボットを数分でデプロイできます。このガイドでは、TypeScript のシンプルでわかりやすいテンプレートを使用して、開発環境のセットアップから完全に機能する Telegram ボットのデプロイまでのプロセス全体を説明します。早速ボットを立ち上げて実行してみましょう。
? Telegram Bot に Cloudflare Workers を選択する理由は何ですか?
Cloudflare Workers は、開発者が最小限の遅延でユーザーに近いエッジで JavaScript、TypeScript、または Python コードを実行できるサーバーレス プラットフォームです。このプラットフォームを活用することで、超高速なだけでなく拡張性の高い Telegram ボットを展開できます。サーバーの管理、スケーリングの処理、複雑なインフラストラクチャの処理は必要ありません - Cloudflare がすべてを処理します。
?ボットを構築するためのステップバイステップ ガイド
それでは、プロセスを詳しく見ていきましょう。
?新しいワーカー プロジェクトを作成する
- 開発環境をセットアップする
構築を開始する前に、ワーカーを管理するための Cloudflare のコマンドライン ツールである Wrangler をインストールする必要があります。
npm install wrangler
ログイン後にコピー
ヒント: npm がインストールされていない場合は、nodejs.org から Node.js をダウンロードしてインストールすることで簡単に入手できます。
- Telegram ボット テンプレートを使用して新しいワーカーを作成する
Wrangler をセットアップしたら、ワーカー ファイルを配置するディレクトリに移動します。次のコマンドを実行してワーカーを作成します:
npm create cloudflare@latest MY_WORKER_NAME
ログイン後にコピー
MY_WORKER_NAME をワーカーの任意の名前に置き換えます。 Wrangler を初めて使用する場合は、Cloudflare アカウントに接続し、ブラウザ ウィンドウ経由で認証するように求められます。指示に従ってください。
テンプレートの入力を求められたら、GitHub リポジトリからのテンプレート を選択し、次のように入力します。
https://github.com/m-sarabi/cloudflare-telegram-bot
ログイン後にコピー
次に、尋ねられたら、Typescript を選択します。
必ずこのリポジトリにアクセスして、スター ⭐️を付けてください。
- Git を初期化し、デプロイメントをスキップ
セットアップ中に、バージョン管理に Git を使用するかどうか、またワーカーをすぐにデプロイするかどうかを尋ねられます。両方とも いいえ を選択し、すべての設定が完了するまで保留することをお勧めします。
次のメッセージが表示されるはずです: SUCCESS アプリケーションは正常に作成されました!
? @BotFather を使用して Telegram ボットをセットアップする
- /newbot コマンドを使用してボットを作成します。
- プロンプトに従い、提供された API トークンをメモします。
次に、プロジェクト ディレクトリ内の wrangler.toml ファイルに環境変数を設定します。したがって、次の行をファイルに追加します。
[vars]
SECRET = "<SECRET>"
TOKEN = "<API_TOKEN>"
ログイン後にコピー
-
SECRET: を置き換えます。リクエストが設定された Webhook から送信されることを保証するランダム トークンを使用します。 A ～ Z、a ～ z、0 ～ 9、_、- を含む 1 ～ 256 文字を使用できます。
-
API_TOKEN: を置き換えます。 @BotFather から取得した API トークンを使用します。
これらの変数を設定した後、プロジェクト ディレクトリ内で次のコマンドを実行します。
npm run cf-typegen
ログイン後にコピー
このコマンドは、新しく設定した変数を反映して、worker-configuration.d.ts ファイルを再生成します。
?ボットのロジックを作成する
さあ、楽しい部分に入りましょう ボットのコーディングです!この例では、これを作成します:
シナリオ: ユーザーが /start コマンドを送信すると、ボットはボタン付きのメッセージを表示します。ボタンを押すと、ボットはボタンを削除し、フォローアップ メッセージを送信します。
/start コマンドを処理する
すべての更新ハンドラー関数は src/Telegram/handlers ディレクトリにあります。
まず、メッセージとインライン ボタンを使用して /start コマンドに応答します。 src/Telegram/handlers/handleMessage.ts を次のように変更します:
import { tg } from '../lib/methods';
export async function handleMessage(message: tgTypes.Message) {
const messageText = message.text;
const chatId = message.chat.id;
if (messageText === '/start') {
await tg.sendMessage({
text: 'Welcome to my bot! Press the button to accept my rules!',
chat_id: chatId,
reply_markup: {
inline_keyboard: [
[{
text: 'I Accept',
callback_data: 'accept_rules'
}]
]
}
});
}
}
ログイン後にコピー
このコード スニペットは、tg.sendMessage メソッドを使用してインライン キーボード ボタンを含むメッセージを送信します。
インラインボタン押しの処理
ユーザーがインライン ボタンを押したときに、ボットがこのアクションを認識するようにします。 src/Telegram/handlers/handleCallbackQuery.ts を変更します:
import { tg } from '../lib/methods';
export async function handleCallbackQuery(callbackQuery: tgTypes.CallbackQuery) {
const data = callbackQuery.data;
const messageId = callbackQuery.message?.message_id;
const chatId = callbackQuery.message?.chat.id;
if (messageId && chatId) {
if (data === 'accept_rules') {
await tg.editMessageReplyMarkup({
chat_id: chatId,
message_id: messageId,
reply_markup: undefined
});
await tg.sendMessage({
chat_id: chatId,
text: 'Thanks for accepting my rules.'
});
}
}
}
ログイン後にコピー
このコードは、accept_rules データ クエリをリッスンし、一致するとインライン ボタンを削除し、tg.editMessageReplyMarkup メソッドを使用してフォローアップ メッセージを送信します。
? Webhook の登録
ボット ロジックを配置したら、ワーカーをデプロイし、Webhook 経由で Telegram に接続します。
- wranglerdeploy を実行してワーカーをデプロイします。
- Cloudflare ダッシュボードに移動し、ワーカーとページ を選択します。
- プロジェクト名の横にある 訪問 をクリックします。
- URL バーに /registerWebhook (例: https://my-project.my-username.workers.dev/registerWebhook) を追加して Enter キーを押します。 「Webhook が登録されました」と表示されたら、正しく登録されています!
デプロイして登録すると、Telegram でボットと対話できるようになります。 Start をクリック (または /start を送信) して開始すると、インライン ボタン付きのウェルカム メッセージが表示されます。
?結論
Cloudflare Workers のおかげで、Telegram ボットの構築とデプロイがかつてないほど簡単になりました。このガイドに従うことで、サーバーレス テクノロジーの力を利用して、スケーラブルで高速なだけでなく、メンテナンスも簡単なボットを作成できます。
個人用の単純なボットを構築する場合でも、ビジネス向けにより複雑なものを展開する場合でも、このテンプレートは強固な基盤を提供します。コーディングを楽しんでください!
?リソースと参考資料
- Cloudflare ワーカーのドキュメント
- テレグラムボット API
- テンプレートの GitHub リポジトリ
以上がTelegram ボットを Cloudflare Workers にデプロイする: ステップバイステップガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
