# Telegram

Telegram ボットをプロジェクトに接続し、タスクを送信できる人を指定します。

Canonical page: https://beeuni.ai/docs/ja/connect/telegram

Telegram を接続すると、ボットとのチャットからプロジェクトのエージェントにタスクを送れます。返信は同じチャットに届き、セッションの全履歴は Beeuni で確認できます。

## ボットを接続する

1. Telegram で **@BotFather** を開き、`/newbot` でボットを作成します。ボットのトークンをコピーします。
2. プロジェクトの**チャンネル**ページで **Telegram** を見つけ、トークンを入力して接続します。
3. Telegram でボットに `/start` を送ります。まだ利用を許可されていない場合、返信に自分の数値ユーザー ID が表示されます。
4. Beeuni の許可ユーザー一覧にその ID を追加して保存し、ボットにタスクを送ります。

許可一覧が空の場合、誰もタスクを実行できません。接続と一覧の変更には、プロジェクトのコネクターを管理する権限が必要です。トークンはサーバー側に保存され、接続情報のレスポンスやエージェントには渡されません。

## セッションと権限

チャットの最初のタスクでセッションを作成し、以降のメッセージは同じセッションに届きます。フォーラムの各トピックには別のセッションがあります。`/new` を送ると、次のメッセージから新しいセッションが始まります。以前の履歴は Beeuni に残ります。

許可された Telegram ユーザーは、プロジェクトの自動化用 ID でタスクを実行します。セッションはプロジェクト内で共有されます。送信者がそれぞれ Beeuni にログインする仕組みではありません。プロジェクトの共有権限でタスクを実行してよい人だけを追加してください。

ボットからのタスク受信をやめるには、チャンネルページで接続を解除します。

## SDK

`getTelegramInstallation`、`connectTelegram`、`setTelegramAllowedUsers`、`disconnectTelegram` にプロジェクト ID を渡して操作できます。トークンの設定は [SDK 認証](/docs/ja/sdk/auth)を参照してください。