このガイドでは、Telegram Mini-appやゲームにWeb SDKを導入し、EVMチェーン上でメール認証やゲスト認証によるweb3機能をユーザーに提供する手順を説明します。

事前準備

開始前に、以下を用意してください:

統合手順

1

BotFatherでTelegramボットを作成

  1. Telegramを開き、「@BotFather」を検索します。
  2. 「Start」をクリックするか、「/start」と入力して会話を開始してください。
  3. 「/newbot」と入力して新しいボットを作成します。
  4. 案内に従って進めてください:
    • ボットの名前を入力します。
    • ユーザー名を選択します(必ず「bot」で終わる必要があります)
2

必要なトークンの取得

ボット作成後、BotFatherから以下が提供されます:

  • ボットトークン(HTTP APIトークン)
  • ボットのユーザー名

これらの認証情報は次の手順で必要になるため、必ず保存してください。

ボットトークンは絶対に他人と共有したり、公開リポジトリにコミットしたりしないでください。秘密として扱いましょう。

3

プロジェクトのインストールと設定

  1. Sequence Telegramスターターをクローンします:
git clone https://github.com/0xsequence-demos/telegram-kit-embedded-wallet-react-boilerplate
  1. プロジェクトのルートにサンプルファイルをコピーします:
cp .env.example .env && cp example.wrangler.toml wrangler.toml

設定後、Sequence Builderから取得したVITE_PROJECT_ACCESS_KEYVITE_WAAS_CONFIG_KEY.envファイルに入力してください。

  1. 依存関係をインストールします:
pnpm install
  1. アプリをビルドします:
pnpm run build
  1. wrangler.tomlファイル内のVARSを、BOT_SECRETには任意のシークレット、BOT_TOKENにはBotFatherから取得したボットトークンで更新してください。
4

Cloudflareアカウントで認証する

アプリとファンクションロジックをCloudflareにデプロイします

  1. pnpm wrangler pages deployを実行します

まだログインしていない場合はCloudflareへの認証を求められます。デプロイが成功したら、アプリケーションがホストされているURLをコピーしてください。

5

TelegramでWebhookを登録

アプリのregisterWebhookエンドポイントを呼び出し、デプロイしたアプリケーションのURLでWebhook機能を登録して、Telegram APIからアクセスできるようにします。

curl -X POST \

     "<YOUR_CLOUDFLARE_DEPLOYED_URL>/api/registerWebhook"
6

許可するオリジンの更新

ウォレット設定画面で、デプロイしたアプリケーションのURLを許可するオリジンとしてSequence Builderの設定ページから追加してください。

7

ボットをテストしてください。

Telegramでボットにメッセージを送信し、応答するか確認してください。シェアやプレイ、詳細情報の取得などの機能が利用できるはずです。

これで、すべての統合済みEVMチェーンに対応したSequence Embedded Wallet(シーケンス・エンベデッド・ウォレット)と連携できるTelegramボットが完成しました。ゲームやアプリに合わせてボットの応答やクライアント側の機能をカスタマイズし、あとは再デプロイと許可オリジンの更新を行うだけです。

本番環境への移行

BOT_TOKENは、以下のコマンドでCloudflareに暗号化して保存することで、情報漏洩を防げます:

pnpm wrangler pages secret put BOT_TOKEN

プロンプトが表示されたらボットトークンを入力してください。