> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ja/messenger-channels/telegram.md).

# Telegram

Crew を Telegram に接続して、自分専用のパーソナルボットで AI アシスタントとチャットしましょう。

## セットアップガイド

### ステップ 1: Telegram でボットを作成

1. Telegram を開き、**@BotFather** を検索
2. `/newbot` コマンドを送信
3. 指示に従います:
   * ボットの**名前**を選択（例: 「My Crew Assistant」）
   * `bot` で終わる**ユーザー名**を選択（例: `my_crew_assistant_bot`）
4. BotFather から **API トークン**が発行されるのでコピー（`123456789:ABCdef...` のような形式）

### ステップ 2: ボットを Crew に接続

1. Crew の Web アプリで**メッセンジャー**を開く
2. Telegram の横にある**接続**をクリック
3. **ボットトークン**を入力フィールドに貼り付け
4. **接続**をクリック

Crew がトークンを検証し、ボットの Webhook を自動的に設定します。

### ステップ 3: チャット開始

1. Telegram を開いて自分のボットを見つける（選択したユーザー名で検索）
2. **Start** を押すか、メッセージを送信
3. Telegram で Crew アシスタントが使えるようになりました！

## 自分専用ボットのメリット

他のチャネルでは共有の Crew ボットとチャットしますが、Telegram では**パーソナルボット方式**を採用しています。

* **自分のボット、自分のブランディング**: 好きな名前やプロフィール画像を設定可能
* **完全なプライバシー**: ボットはあなた専用で、共有インフラは使いません
* **カスタムユーザー名**: ボットのリンクを各デバイスで共有可能

## 使い方の例

> 「今日の未読メールを要約して。」

> 「この箇条書きで PDF レポートを作成して: \[内容]」

> 「テック業界の最新ニュースをトップ5で教えて。」

> \[ボイスメッセージを送信] 「明日の15時に歯医者に電話するのをリマインドして。」

## 機能

* **テキストメッセージ**: 書式付きのリッチな応答
* **ファイル共有**: 画像、ドキュメント、音声ファイルの送受信
* **ボイスメッセージ**: 音声メモの自動文字起こし
* **タイピングインジケーター**: Crew がリクエストを処理中であることを表示
* **長いメッセージ**: Telegram の4,096文字制限を超える場合は自動的に複数メッセージに分割

## トラブルシューティング

### ボットが応答しない場合

* **Start** を押すか `/start` を送信してボットを開始したか確認
* メッセンジャーページで接続状態を確認 — 「接続済み」と表示されているはず
* 同じトークンで切断して再接続してみる

### ボットトークンを紛失した場合

* Telegram で @BotFather にアクセス
* `/mybots` を送信し、ボットを選択して **API Token** で確認

## 切断方法

切断するには:

1. Crew の Web アプリで**メッセンジャー**を開く
2. Telegram の横にある**切断**をクリック

ボットは応答を停止します。同じまたは別のボットトークンでいつでも再接続できます。