文字起こしTelegramボット
Supabase Edge Functions上でDenoとTypeScriptを使い、90以上の言語でオーディオとビデオメッセージを文字起こしするTelegramボットを構築します。
ハウツーガイド · スピーチtoテキストの クイックスタートを完了し、Telegramボットのトークンと Supabaseアカウントを取得済みであることを前提としています。
はじめに
このチュートリアルでは、TypeScriptとElevenLabsのScribeモデルをスピーチtoテキストAPI経由で使用し、90以上の言語でオーディオやビデオメッセージを文字起こしするTelegramボットの構築方法を説明します。
要件
- APIキーを取得済みのElevenLabsアカウント。
- Supabaseアカウント(database.newから無料アカウントを登録できます)。
- マシンにインストール済みのSupabase CLI。
- マシンにインストール済みのDenoランタイム。必要に応じて任意のIDEでセットアップしてください。
- Telegramアカウント。
セットアップ
Telegramボットを登録する
BotFatherを使って、新しいTelegramボットを作成します。/newbotコマンドを実行し、案内に従って新しいボットを作成してください。最後に、ボットのシークレットトークンが発行されます。次の手順で使用するため、安全な場所に記録してください。

Supabaseプロジェクトをローカルに作成する
Supabase CLIをインストールしたら、次のコマンドを実行して新しいSupabaseプロジェクトをローカルに作成します。
文字起こし結果を記録するデータベーステーブルを作成する
次に、文字起こし結果を記録する新しいデータベーステーブルを作成します。
これにより、supabase/migrationsディレクトリに新しいマイグレーションファイルが作成されます。ファイルを開き、次のSQLを追加します。
TelegramのWebhookリクエストを処理するSupabase Edge Functionを作成する
次に、TelegramのWebhookリクエストを処理する新しいEdge Functionを作成します。
VS CodeまたはCursorを使用している場合、CLIに「Generate VS Code settings for Deno? [y/N]」と表示されたらyを選択してください。
環境変数を設定する
supabase/functionsディレクトリ内に新しい.envファイルを作成し、次の変数を追加します。
依存関係
このプロジェクトでは、次の依存関係を使用します。
- TelegramのWebhookリクエストを処理するオープンソースのgrammY Framework。
- Supabaseデータベースを操作する@supabase/supabase-jsライブラリ。
- スピーチtoテキストAPIを操作するElevenLabsのJavaScript SDK。
Supabase Edge FunctionはDenoランタイムを使用するため、依存関係をインストールする必要はありません。代わりに、npm:プレフィックスを使用してインポートできます。
Telegramボットを実装する
新しく作成したscribe-bot/index.tsファイルに、次のコードを追加します。
コードの詳細
このコードには、注目すべき点がいくつかあります。順を追って見ていきましょう。
受信リクエストを処理する
受信リクエストの処理には、Deno.serveハンドラーを使用します。ハンドラーはリクエストに正しいシークレットが含まれているかを確認し、リクエストをhandleUpdate関数に渡します。
音声、オーディオ、ビデオメッセージを処理する
grammY Frameworkには、特定のメッセージタイプをフィルタリングする便利な方法があります。ここでは、ボットが音声、オーディオ、ビデオメッセージを待ち受けます。
ボットはリクエストコンテキストからファイルのメタデータを抽出し、Supabase Background TasksのEdgeRuntime.waitUntilを使用して、バックグラウンドで文字起こしを実行します。
これにより、ユーザーにはすぐに応答しながら、ファイルの文字起こしをバックグラウンドで処理できます。
ElevenLabs APIで文字起こしする
最後に、バックグラウンドワーカーでElevenLabs JavaScript SDKを使用してファイルを文字起こしします。文字起こしが完了すると、ボットはその内容をユーザーに返信し、supabase-jsを使用してSupabaseデータベースにログエントリを書き込みます。
Supabaseにデプロイする
まだ作成していない場合は、database.newで新しいSupabaseアカウントを作成し、ローカルプロジェクトをSupabaseアカウントにリンクします。
データベースマイグレーションを適用する
次のコマンドを実行して、supabase/migrationsディレクトリのデータベースマイグレーションを適用します。
Supabaseダッシュボードのテーブルエディターに移動すると、空のtranscription_logsテーブルが表示されます。

最後に、次のコマンドを実行してEdge Functionをデプロイします。
SupabaseダッシュボードのEdge Functions画面に移動すると、デプロイ済みのscribe-bot関数が表示されます。後で必要になるため、関数のURLを記録してください。URLはhttps://<project-ref>.functions.supabase.co/scribe-botのようになります。

Webhookを設定する
ボットのWebhook URLをhttps://<PROJECT_REFERENCE>.functions.supabase.co/telegram-botに設定します(<...>をそれぞれの値に置き換えてください)。設定するには、次のURLにGETリクエストを送信します(ブラウザからでも実行できます)。
FUNCTION_SECRETには、.envファイルで設定したシークレットを使用してください。

関数のシークレットを設定する
すべてのシークレットをローカルに設定したら、次のコマンドを実行してSupabaseプロジェクトにシークレットを設定します。
ボットをテストする
最後に、音声メッセージ、オーディオファイル、またはビデオファイルを送信してボットをテストします。

返信として文字起こしが表示されたら、Supabaseダッシュボードのテーブルエディターに戻ります。transcription_logsテーブルに新しい行が追加されています。
