Web SDKとTelegram Mini-appsの統合
Web SDKをTelegram Mini-appやゲームに統合し、シームレスなweb3機能を実現する方法をご紹介します。
このガイドでは、Telegram Mini-appやゲームにWeb SDKを導入し、EVMチェーン上でメール認証やゲスト認証によるweb3機能をユーザーに提供する手順を説明します。
事前準備
開始前に、以下を用意してください:
- Telegramアカウント
- Cloudflareダッシュボードのアカウントとアクセス権限
統合手順
BotFatherでTelegramボットを作成
- Telegramを開き、「@BotFather」を検索します。
- 「Start」をクリックするか、「/start」と入力して会話を開始してください。
- 「/newbot」と入力して新しいボットを作成します。
- 案内に従って進めてください:
- ボットの名前を入力します。
- ユーザー名を選択します(必ず「bot」で終わる必要があります)
必要なトークンの取得
ボット作成後、BotFatherから以下が提供されます:
- ボットトークン(HTTP APIトークン)
- ボットのユーザー名
これらの認証情報は次の手順で必要になるため、必ず保存してください。
ボットトークンは絶対に他人と共有したり、公開リポジトリにコミットしたりしないでください。秘密として扱いましょう。
プロジェクトのインストールと設定
- Sequence Telegramスターターをクローンします:
- プロジェクトのルートにサンプルファイルをコピーします:
設定後、Sequence Builderから取得したVITE_PROJECT_ACCESS_KEY
とVITE_WAAS_CONFIG_KEY
を.env
ファイルに入力してください。
- 依存関係をインストールします:
- アプリをビルドします:
wrangler.toml
ファイル内のVARS
を、BOT_SECRET
には任意のシークレット、BOT_TOKEN
にはBotFatherから取得したボットトークンで更新してください。
Cloudflareアカウントで認証する
アプリとファンクションロジックをCloudflareにデプロイします
pnpm wrangler pages deploy
を実行します
まだログインしていない場合はCloudflareへの認証を求められます。デプロイが成功したら、アプリケーションがホストされているURLをコピーしてください。
TelegramでWebhookを登録
アプリのregisterWebhook
エンドポイントを呼び出し、デプロイしたアプリケーションのURLでWebhook機能を登録して、Telegram APIからアクセスできるようにします。
許可するオリジンの更新
ウォレット設定画面で、デプロイしたアプリケーションのURLを許可するオリジンとしてSequence Builderの設定ページから追加してください。
ボットをテストしてください。
Telegramでボットにメッセージを送信し、応答するか確認してください。シェアやプレイ、詳細情報の取得などの機能が利用できるはずです。
これで、すべての統合済みEVMチェーンに対応したSequence Embedded Wallet(シーケンス・エンベデッド・ウォレット)と連携できるTelegramボットが完成しました。ゲームやアプリに合わせてボットの応答やクライアント側の機能をカスタマイズし、あとは再デプロイと許可オリジンの更新を行うだけです。
本番環境への移行
BOT_TOKEN
は、以下のコマンドでCloudflareに暗号化して保存することで、情報漏洩を防げます:
プロンプトが表示されたらボットトークンを入力してください。