Telegram ／ 公式リポジトリの日本語解説
Telegram Harness OSS版を、コードを読まずに理解する
Telegram Harnessは、Telegramのチャンネルとグループを公式のBot APIでまとめて扱う、オープンソースのソフトウェアです。すべての送信が「承認」を通る作りになっています。
- ソフトウェア利用料
- このリポジトリの範囲では発生しない（MIT License）
- 別にかかる費用
- 運用するサーバー、接続先の費用
- 送信のしかた
- 下書き→承認→予約時刻に送信
- 始め方
- 自分のCloudflareに配置。The Harness Cloudからは外部のTelegram Harnessに接続して使う
Telegram Harnessで何ができるか
複数のボットとチャンネル
複数のボット、チャンネル、グループを登録できます。ボットのトークンは値ではなく、環境変数の名前だけを保存します。
下書きの作成
テキスト、画像、動画、アルバム、ボタン付きのメッセージを下書きにできます。
承認と予約
下書きは承認するまで送られません。承認した下書きのうち、時刻が来たものだけが送られます。
編集と削除も承認制
公開済みのメッセージの編集や削除も、承認待ちを通してから実行します。
受信と返信の下書き
届いたメッセージやコメントを保存し、返信も下書き→承認の流れで扱います。ほかのSNSの下書きを取り込むこともできます。
会員と決済（別アプリ）
会員の参加承認、期限切れ時の自動退出、Telegram Starsでの会員プラン販売、予約などを行う会員用のボットが同梱されています。
どんな人に向いているか
- Telegramでコミュニティや会員向けの配信をしている事業者
- 公開前に、必ず人の確認を挟みたい人
- AIに下書きを作らせても、送信は自分で決めたい人
先に知っておきたいこと
- 一斉DM、メンバーの収集、知らない人への招待、アカウントの大量作成はできません。
- Starsで有償販売する場合は、利用規約・特定商取引法に基づく表記と、支払いの問い合わせ窓口を自分の事業者情報で整える必要があります。
押して進める
下書きが送られるまでの5ステップ
-
下書きを作る
投稿・返信・編集・削除の依頼は、まず「承認待ち」として保存されます。この時点では何も送られません。
-
承認する
承認すると「予約済み」に変わります。承認しただけでは、まだ送信されません。
-
時刻が来たら送られる
送信の処理は、承認済みで、予約時刻が来た（または時刻の指定がない）下書きだけを送ります。未来の時刻のものは待ちます。
-
取り下げる・戻す
却下した下書きは送られません。送信前の予約は、承認待ちに戻すこともできます。
-
失敗したら承認からやり直す
送信に失敗した下書きは「失敗」のまま残ります。もう一度送るには、承認待ちに戻して改めて承認します。
会員・Stars決済を使う前に
会員用のボットは、通常の承認キューとは別のアプリとして動きます。
- 会員のルールは、初期状態ではすべてOFFです。
- 会員プランを登録し、購入のルールを有効にするまで、販売は始まりません。
- 日本で有償販売する場合は、特定商取引法に基づく表記が必要です。利用規約と支払いの問い合わせ窓口を、自分の事業者情報で整えてから始めます。
- 会員用ボットのAI操作（MCP）は、送信・返金・退出などを「オーナー承認待ち」に積むだけで、その場では実行しません。
よくある質問
承認したらすぐ送信されますか？
承認は状態を変えるだけで、送信はしません。送信の処理が、承認済みで予約時刻が来た下書きだけを送ります。
AIに任せても大丈夫ですか？
AI向けのツールは、下書きの作成・承認・送信処理の実行が別々に分かれています。下書きを作るツールは送信しません。
Telegramで一斉にDMを送れますか？
できません。一斉DM、メンバーの収集、知らない人への招待、アカウントの大量作成は対象外です。
有料の会員販売はできますか？
会員用のボットで、Telegram Starsによる会員プランの販売ができます。販売前に、利用規約・特定商取引法に基づく表記・支払いの問い合わせ窓口を整える必要があります。
自分でサーバーを用意しないと使えませんか？
基本は自分のCloudflareに配置して使います。The Harness CloudからTelegramを使う場合も、Cloudが代わりに用意するのではなく、外部のTelegram Harnessとの接続と、接続先での承認が必要です。
次に読む1本
L Harnessの解説 →
Telegramの承認の考え方を、お客様との主な窓口になりやすいLINEにも当てはめるなら、L Harnessの解説へ。
このページの特典（無料）
そのまま送れる お知らせ文例12＋送る前の30秒チェック
Telegramのチャンネルやグループで使える、お知らせの文例12個と、送る前に見ておく5つの点。コピーして送るだけです。
- チャンネルのお知らせ7つ（はじめに・イベント・お休みなど）
- グループ・会員向けの文例5つ
- 送る前の30秒チェック（5つの点）
- AIに下書きを頼むお願い文
友だち追加すると、この特典がLINEで届きます。配信が不要になったら、いつでもブロックで止められます。
- ［チャンネル名］へようこそ。
- 【［イベント名］のお知らせ】
- □ 送り先は合っている？
- □ ［ ］が残っていない？