Rube MCP 経由の Telegram 自動化

Composio の Telegram ツールキットを Rube MCP 経由で使用して Telegram 操作を自動化します。

前提条件

• Rube MCP が接続されていること (RUBE_SEARCH_TOOLS が利用可能)
• RUBE_MANAGE_CONNECTIONS 経由で telegram ツールキットを使用した有効な Telegram 接続
• 常に RUBE_SEARCH_TOOLS を最初に呼び出して現在のツールスキーマを取得する
• Telegram Bot Token が必要 (@BotFather 経由で作成)

セットアップ

Rube MCP を取得: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要です — エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して Rube MCP が利用可能か検証する
2. RUBE_MANAGE_CONNECTIONS を telegram ツールキットで呼び出す
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Telegram ボットを設定する
4. ワークフローを実行する前に接続ステータスが ACTIVE であることを確認する

コアワークフロー

1. メッセージを送信

使用時機: ユーザーが Telegram チャットにテキストメッセージを送信したい場合

ツール順序:

1. TELEGRAM_GET_ME - ボットのアイデンティティと接続を確認 [前提条件]
2. TELEGRAM_GET_CHAT - チャット詳細を取得してアクセスを確認 [オプション]
3. TELEGRAM_SEND_MESSAGE - テキストメッセージを送信 [必須]

主要パラメータ:

• chat_id: 数値チャット ID またはチャネルユーザー名 (例: '@channelname')
• text: メッセージテキストコンテンツ
• parse_mode: フォーマット用の 'HTML' または 'MarkdownV2'
• disable_notification: 通知音なしでサイレント送信
• reply_to_message_id: 返信先メッセージ ID

落とし穴:

• ボットはメッセージを送信するために、チャット/グループのメンバーである必要があります
• MarkdownV2 は特殊文字のエスケープが必要: _*[]()~>#+-=|{}.!
• HTML モードは限定的なタグをサポート: <b>, <i>, <code>, <pre>, <a>
• メッセージは 4096 文字の制限があります。長いコンテンツは分割してください

2. 写真とドキュメントを送信

使用時機: ユーザーが Telegram チャットに画像またはファイルを共有したい場合

ツール順序:

1. TELEGRAM_SEND_PHOTO - 画像を送信 [オプション]
2. TELEGRAM_SEND_DOCUMENT - ファイル/ドキュメントを送信 [オプション]

主要パラメータ:

• chat_id: ターゲットチャット ID
• photo: 写真 URL またはファイル ID (SEND_PHOTO の場合)
• document: ドキュメント URL またはファイル ID (SEND_DOCUMENT の場合)
• caption: メディア用の任意のキャプション

落とし穴:

• 写真キャプションは 1024 文字の制限があります
• ドキュメントキャプションも 1024 文字の制限があります
• ボット API 経由で最大 50MB のファイルを送信できます
• 写真は Telegram により圧縮されます。圧縮されていない画像の場合は SEND_DOCUMENT を使用してください

3. チャットを管理

使用時機: ユーザーがチャット情報を取得またはチャット設定を管理したい場合

ツール順序:

1. TELEGRAM_GET_CHAT - 詳細なチャット情報を取得 [必須]
2. TELEGRAM_GET_CHAT_ADMINISTRATORS - チャット管理者を一覧表示 [オプション]
3. TELEGRAM_GET_CHAT_MEMBERS_COUNT - メンバー数を取得 [オプション]
4. TELEGRAM_EXPORT_CHAT_INVITE_LINK - 招待リンクを生成 [オプション]

主要パラメータ:

• chat_id: ターゲットチャット ID またはユーザー名

落とし穴:

• 招待リンクをエクスポートするには、ボットが管理者である必要があります
• GET_CHAT はプライベートチャット、グループ、チャネルで異なるフィールドを返します
• メンバー数は非常に大きなグループではおおよその値になることがあります
• 管理者リストは通常メンバーを含みません

4. メッセージを編集および削除

使用時機: ユーザーが以前に送信されたメッセージを変更または削除したい場合

ツール順序:

1. TELEGRAM_EDIT_MESSAGE - 送信されたメッセージを編集 [オプション]
2. TELEGRAM_DELETE_MESSAGE - メッセージを削除 [オプション]

主要パラメータ:

• chat_id: メッセージが配置されているチャット
• message_id: 編集または削除するメッセージの ID
• text: 新しいテキストコンテンツ (編集の場合)

落とし穴:

• ボットは自分自身のメッセージのみ編集できます
• メッセージは送信後 48 時間以内にのみ削除できます
• グループでは、削除権限を持つボットはどのメッセージでも削除できます
• メッセージを編集すると 'edited' タイムスタンプ履歴が削除されます

5. メッセージを転送して更新を取得

使用時機: ユーザーがメッセージを転送または最近の更新を取得したい場合

ツール順序:

1. TELEGRAM_FORWARD_MESSAGE - 別のチャットにメッセージを転送 [オプション]
2. TELEGRAM_GET_UPDATES - 最近のボット更新/メッセージを取得 [オプション]
3. TELEGRAM_GET_CHAT_HISTORY - チャットメッセージ履歴を取得 [オプション]

主要パラメータ:

• from_chat_id: 転送元チャット
• chat_id: 転送先チャット
• message_id: 転送するメッセージ
• offset: GET_UPDATES の更新オフセット
• limit: 取得する更新の数

落とし穴:

• 転送されたメッセージは元の送信者の帰属を表示します
• GET_UPDATES は限定的な最近の更新ウィンドウを返します
• チャット履歴へのアクセスはボットの権限とチャットタイプにより制限される場合があります
• オフセットを使用して同じ更新を 2 回処理することを避けてください

6. ボットコマンドを管理

使用時機: ユーザーがボットコマンドメニューを設定または更新したい場合

ツール順序:

1. TELEGRAM_SET_MY_COMMANDS - ボットのコマンドリストを設定 [必須]
2. TELEGRAM_ANSWER_CALLBACK_QUERY - インラインボタンプレスに応答 [オプション]

主要パラメータ:

• commands: command と description を持つコマンドオブジェクトの配列
• callback_query_id: 応答するコールバッククエリの ID

落とし穴:

• コマンドは '/' で始まり、小文字である必要があります
• コマンド説明は 256 文字の制限があります
• コールバッククエリは 10 秒以内に応答する必要があります。そうでなければ有効期限が切れます
• コマンドの設定はコマンドリスト全体を置き換えます

共通パターン

チャット ID の解決

ユーザー名から:

1. '@username' フォーマットを chat_id として使用 (公開チャネル/グループの場合)
2. プライベートチャットの場合、数値 chat_id が必要です
3. GET_CHAT をユーザー名で呼び出して数値 ID を取得します

GET_UPDATES から:

1. TELEGRAM_GET_UPDATES を呼び出す
2. メッセージオブジェクトから chat.id を抽出
3. その後の呼び出しで数値 chat_id を使用

メッセージフォーマット

• parse_mode: 'HTML' を <b>bold</b>, <i>italic</i>, <code>code</code> に使用
• parse_mode: 'MarkdownV2' を *bold*, _italic_, `code` に使用
• MarkdownV2 で特殊文字をエスケープ: _ * [ ] ( ) ~ > # + - = | { } . !
• フォーマットなしのプレーンテキストの場合は parse_mode を省略

既知の落とし穴

ボットの権限:

• ボットはグループ/チャネルと対話するために追加されている必要があります
• 管理権限が必要: メッセージの削除、招待リンクのエクスポート、メンバー管理
• ボットは会話を開始できません。ユーザーが最初に開始する必要があります

レート制限:

• 同じグループへ毎秒 30 メッセージ
• グループ内の同じユーザーへ毎分 20 メッセージ
• 一括操作はコール間に遅延を実装する必要があります
• API は制限に達したときに 429 Too Many Requests を返します

チャットタイプ:

• プライベートチャット: ボットとの 1 対 1
• グループ: マルチユーザーチャット (ボットを追加する必要があります)
• スーパーグループ: 管理機能が強化されたグループ
• チャネル: ブロードキャストのみ (ボットは投稿するために管理者である必要があります)

メッセージ制限:

• テキストメッセージ: 最大 4096 文字
• キャプション: 最大 1024 文字
• ファイルアップロード: ボット API 経由で最大 50MB
• インラインキーボードボタン: 1 行あたり最大 8 個

クイックリファレンス

タスク	ツールスラッグ	主要パラメータ
ボットを確認	TELEGRAM_GET_ME	(なし)
メッセージを送信	TELEGRAM_SEND_MESSAGE	chat_id, text, parse_mode
写真を送信	TELEGRAM_SEND_PHOTO	chat_id, photo, caption
ドキュメントを送信	TELEGRAM_SEND_DOCUMENT	chat_id, document, caption
メッセージを編集	TELEGRAM_EDIT_MESSAGE	chat_id, message_id, text
メッセージを削除	TELEGRAM_DELETE_MESSAGE	chat_id, message_id
メッセージを転送	TELEGRAM_FORWARD_MESSAGE	chat_id, from_chat_id, message_id
チャット情報を取得	TELEGRAM_GET_CHAT	chat_id
チャット管理者を取得	TELEGRAM_GET_CHAT_ADMINISTRATORS	chat_id
メンバー数を取得	TELEGRAM_GET_CHAT_MEMBERS_COUNT	chat_id
招待リンクをエクスポート	TELEGRAM_EXPORT_CHAT_INVITE_LINK	chat_id
更新を取得	TELEGRAM_GET_UPDATES	offset, limit
チャット履歴を取得	TELEGRAM_GET_CHAT_HISTORY	chat_id
ボットコマンドを設定	TELEGRAM_SET_MY_COMMANDS	commands
コールバックに応答	TELEGRAM_ANSWER_CALLBACK_QUERY	callback_query_id

使用時機

このスキルは、上記の概要で説明されたワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、上記で説明されたスコープに明確に一致するタスクの場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替物として扱わないでください。
• 必要な入力、権限、セキュリティ境界、または成功基準が不足している場合は、停止して説明を求めてください。