Telegram ボットをホストする方法

はじめに

Square Cloud でを開発してホストするには、構成と前提条件の体系的な手順に従うことが不可欠です。この技術ガイドでは、初期セットアップから本番環境へのデプロイまで、プロセス全体を解説します。

前提条件

Square Cloud アカウント: 登録ページからメールアドレスを使って登録します。
有効な有料プラン: アプリケーションに専用リソースと最適化されたパフォーマンスを提供します。利用可能なプランを確認し、ニーズに最も適したものを選択してください。

プロジェクトの作成

Telegram アカウントは、ボットのテストと操作に不可欠です。まだお持ちでない場合は、Telegram 公式サイトにアクセスして無料でアカウントを作成してください。

Telegram でのボットアプリケーション

はじめに

Telegram Web にアクセスし、プラットフォーム上でボットの作成と管理を担当する公式の BotFather ボットを検索します。

認証トークンの取得

BotFather との会話を開始し、/start と入力します。次に、/newbot オプションを選択して新しいボットを作成します。システムがボットの名前を尋ね、確認後、必要な認証トークンが自動的に生成されます。

重要なセキュリティ: ボットのトークンは絶対に秘密にしてください。このトークンはボットの完全な制御権を与えるものであり、機密情報として扱う必要があります。

プロジェクトの開発

ライブラリやフレームワークの選択は、使用するプログラミング言語によって異なります。以下は最も人気のある選択肢の一部です。

Node.js - grammY
Python - telebot

環境のセットアップ

システムに Node.js がインストールされていることを確認してください。まだの場合は、Node.js 公式サイトからダウンロードしてください。
新しい Node.js プロジェクトを初期化します。

Terminal

npm init -y

grammY ライブラリをインストールします。

Terminal

npm install grammy

基本的な実装

次の構造でメインファイル (index.js) を作成します。

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 ライブラリをインストールします。

Terminal

pip install pyTelegramBotAPI

基本的な実装

メインファイル (main.py) を作成します。

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 ファイルを作成します。

requirements.txt

pyTelegramBotAPI

デプロイ

プロジェクトファイルの準備ができたら、それらを Square Cloud にアップロードしてプロジェクトをホストできます。そのためには、すべてのプロジェクトファイルを含む ZIP ファイルを作成してください。

ダッシュボード経由

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

CLI 経由

この方法を使用するには、プロジェクトのルートディレクトリに squarecloud.app という名前の設定ファイルを作成する必要があります。このファイルには、プロジェクトに必要な設定が含まれます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。

CLI をインストール

まず、環境に CLI がインストールされている必要があります。まだの場合は、ターミナルで次のコマンドを実行してください:

npm install -g @squarecloud/cli

すでにお持ちの場合は、更新することを推奨します。更新するには、ターミナルで次のコマンドを実行してください:

Windows
Linux, macOS, and WSL

squarecloud update

curl -fsSL https://cli.squarecloud.app/install | bash

認証

次に、認証して他の CLI コマンドを使用するには、こちらで「Request API Key」をクリックして認証キーを取得します。認証キーを取得したら、次のコマンドを実行してください:

squarecloud auth login

プロジェクトをアップロード

最後に、CLI を使用してアプリケーションを Square Cloud にデプロイするには、次のコマンドを実行する必要があります:

squarecloud upload

または、zip を手動で作成した場合は、次を使用できます:

squarecloud upload --file <path/to/zip>

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。

squarecloud app status
squarecloud app logs

ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。

アプリが起動しませんか？よくある原因と修正方法はトラブルシューティングガイドを参照してください。

ボットのテスト

デプロイに成功したら、Telegram でボットを見つけてテストメッセージを送信します。ボットはあなたのメッセージをそのまま返すはずで、これにより実装が正しく機能していることが確認できます。

追加リソース

Telegram ボット開発に関する知識を深めるには、pyTelegramBotAPI 公式ドキュメントを参照してください。このドキュメントには、詳細なガイド、高度なチュートリアル、完全な API リファレンスが用意されています。

お問い合わせ

技術的な問題が解決しない場合は、専門のサポートチームがお手伝いします。お問い合わせいただければ、どのような問題でも喜んで解決をサポートいたします — サポートの質の高さも、開発者が Google と Trustpilot で Square Cloud に402 件のレビューで 4.9/5という評価をつけている理由の 1 つです。

チュートリアル

Bots

すぐに使えるプロジェクト

データベース

APIs

ウェブサイト

移行ガイド

Telegram ボットをホストする方法

はじめに

前提条件

プロジェクトの作成

Telegram でのボットアプリケーション

プロジェクトの開発

デプロイ

ダッシュボード経由

CLI 経由

設定ファイルガイド

ボットのテスト

追加リソース

お問い合わせ

​はじめに

​前提条件

​プロジェクトの作成

​Telegram でのボットアプリケーション

​プロジェクトの開発

​デプロイ

​ダッシュボード経由

​CLI 経由

設定ファイルガイド

​ボットのテスト

​追加リソース

​お問い合わせ

はじめに

前提条件

プロジェクトの作成

Telegram でのボットアプリケーション

プロジェクトの開発

デプロイ

ダッシュボード経由

CLI 経由

ボットのテスト

追加リソース

お問い合わせ