はじめに
Square Cloud で を開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。
前提条件
- Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
- 有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。
プロジェクトの作成
Telegram アカウントは、ボットのテストと操作に不可欠です。まだお持ちでない場合は、Telegram 公式サイト にアクセスして無料でアカウントを作成してください。
Telegram でのボットアプリケーション
はじめに
Telegram Web にアクセスし、プラットフォーム上でボットの作成と管理を担当する公式の BotFather ボットを検索します。 認証トークンの取得
BotFather との会話を開始し、/start と入力します。次に、/newbot オプションを選択して新しいボットを作成します。システムがボットの名前を尋ね、確認後、必要な認証トークンが自動的に生成されます。 重要なセキュリティ: ボットのトークンは絶対に秘密にしてください。このトークンはボットの完全な制御権を与えるものであり、機密情報として扱う必要があります。
プロジェクトの開発
ライブラリやフレームワークの選択は、使用するプログラミング言語によって異なります。以下は最も人気のある選択肢の一部です。
Node.js - grammY
Python - telebot
環境のセットアップ
-
システムに Node.js がインストールされていることを確認してください。まだの場合は、Node.js 公式サイト からダウンロードしてください。
-
新しい Node.js プロジェクトを初期化します。
- grammY ライブラリをインストールします。
基本的な実装
- 次の構造でメインファイル (
index.js) を作成します。
const { Bot } = require("grammy");
// Authentication token configuration
const token = "YOUR_TOKEN_HERE";
// Bot initialization
const bot = new Bot(token);
(async () => {
// Get bot information
const botInfo = await bot.api.getMe();
const botName = botInfo.username;
// Define handler for text messages
bot.on("message:text", async (ctx) => {
const userMsg = ctx.message.text;
const responseMsg = `${botName} responds: ${userMsg}`;
await ctx.reply(responseMsg);
});
// Start the bot
bot.start();
console.log(`Bot ${botName} started successfully!`);
})();
環境のセットアップ
-
Python と pip がインストールされていることを確認してください。まだの場合は、Python 公式サイト からダウンロードしてください。
-
pyTelegramBotAPI ライブラリをインストールします。
pip install pyTelegramBotAPI
- メインファイル (
main.py) を作成します。
import telebot
# Authentication token configuration
TOKEN = "YOUR_TOKEN_HERE"
# Bot initialization
bot = telebot.TeleBot(TOKEN)
# Define handler for non-command messages
@bot.message_handler(func=lambda message: not message.text.startswith('/'))
def echo_handler(message):
# Get bot information
bot_info = bot.get_me()
bot_name = bot_info.username
# Format response message
response_msg = f"{bot_name} responds: {message.text}"
# Reply to the user
bot.reply_to(message, response_msg)
# Main execution
if __name__ == '__main__':
bot_info = bot.get_me()
print(f"Bot {bot_info.username} started successfully!")
# Start polling
bot.infinity_polling()
- 依存関係を管理するために
requirements.txt ファイルを作成します。
デプロイ
プロジェクトファイルの準備ができたら、それらを Square Cloud にアップロードしてプロジェクトをホストできます。
そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。
ダッシュボード経由
環境を設定
zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
プロジェクトをデプロイ
最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。 CLI 経由
この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。
詳細はこちら: Square Cloud の設定ファイルの作成方法。
squarecloud.app ファイルはアプリケーションを構成するために使用される設定ファイルであり、環境を定義するために使用されます。
CLI をインストール
まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:npm install -g @squarecloud/cli
Windows
Linux, macOS, and WSL
curl -fsSL https://cli.squarecloud.app/install | bash
認証
次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください: プロジェクトをアップロード
最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:または、zip を手動で作成した場合は、次を使用できます:squarecloud upload --file <path/to/zip>
ボットのテスト
デプロイに成功したら、Telegram でボットを見つけてテストメッセージを送信します。ボットはあなたのメッセージをそのまま返すはずで、これにより実装が正しく機能していることが確認できます。
追加リソース
Telegram ボット開発に関する知識を深めるには、pyTelegramBotAPI 公式ドキュメント を参照してください。このドキュメントには、詳細なガイド、高度なチュートリアル、完全な API リファレンスが用意されています。
お問い合わせ
技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします。
