解きたかったこと
家の Mac とクラウドで、定期処理が数十本動いている。そのほとんどが Telegram に通知を送ってくる。通知ログを取り始めてからの約 5 週間で 785 通、送り元は 50 種類あった。1 日に 20 通ほどになる。いちばん多いのは定期処理の見張り役で、それだけで 200 通を超える。
数が多いと、本当に手を打つべき通知が埋もれる。ボタンを付けたあと、ツールのリポジトリを Mac へ取り込む処理の通知を 1 週間数えたら 32 通あり、ほとんどが開発中の一時的な状態に反応したものだった。判定を直して、本当に取り込みが止まっているときだけ知らせるようにした。それでも、残った通知の 1 通ずつに机へ戻って調べてはいられない。
通知を見て「何か起きている」と分かっても、パソコンの前に座って、ログを開いて、AI に状況を説明し直すまでに間が空く。通知の本文そのものを、依頼文を添えて AI の入力欄に入れてしまえば、その間を飛ばせる。
どう組んだか
Telegram のメッセージには URL ボタンを付けられる。飛び先を https://claude.ai/new?q=<本文> にすると、claude.ai の新規チャットが開き、入力欄に本文が入った状態になる。送信はしないので、読んで直してから送れる。
送信スクリプト tg_send.sh が本文を送るたびに、claude_button_url.py がボタンの URL を組み立てる。依頼文は本文の中身で変える。
| 本文に | 依頼文 |
|---|---|
| ⚠️ 失敗 エラー timeout FAIL などがある | 状況を確認し、原因と対処を教えてほしい |
| 無い(定期レポート) | この内容について相談したい。気になる点と次の一手を教えてほしい |
ハマったところ
claude.ai/new?q=に渡すと、+が空白に、%が壊れた文字になる。ボタンの中身だけ全角の+%に置き換えた- ボタンの URL が長すぎると、メッセージごと送信が失敗する。日本語は URL エンコードで 1 字約 9 バイトになるので、本文を二分探索で詰めて上限に収めた。それでも失敗したら、ボタンなしで送り直す。ボタンの成否で通知そのものを落とさないため
LANG=Cの cron から呼ぶと、bash の${#MESSAGE}がバイト数を返し、4096 字未満の日本語でも途中で切れて Telegram がtext must be encoded in UTF-8を返した。スクリプトの頭で UTF-8 ロケールを強制している
回してみて直したこと
ボタンが押された回数も数えている。記録が正しく取れていた 10 日間(10/10〜10/19)で、押したのは 23 回だった。押したのは、ほとんどが失敗の通知である。リポジトリの取り込みが止まった、定期処理が動いていない、といった通知で押していて、定期レポートのボタンはほぼ押していない。
その後の 4 週間は、記録上 0 回になっていた。押さなくなったのではなく、記録が壊れていた。タスクや通知の置き場を別のデータベースへ移したとき、通知の行は新しい置き場に書かれるようになったのに、押されたことを書き込む側は古い置き場を見たままだった。ボタン自体は claude.ai へ正しく飛ぶので、押している本人には何もおかしく見えない。数えるための仕組みは、数えていることを別に確かめないと、静かに止まる。気づいた日に、押されたことを書き込む側も新しい置き場を見るように直した。
コードの変更から拾えるものも並べておく。
- 最初は障害の通知にだけ付けていたが、3 日後に定期レポートにも付けるようにした。レポートも「で、どうする」で止まりやすかったため。ただ、上の数字を見る限り、レポートのボタンはほとんど押されていない
- 前置きの依頼文を、障害とレポートで分けた
- URL に入りきらない長文は、全文を自分のタスク DB に書いてボタンにはその ID だけを載せるようにした(公開版には含めていない。README の「広げるなら」に書いた)
- ボタンを短縮 URL 経由にして、どの通知のボタンが押されたかを数えるようにした。押されない通知は止める判断材料になる(これも公開版には含めていない)
自分の環境で動かすには
必要なのは bash・curl・python3 と、Telegram の bot だけ。
git clone https://github.com/masakiplus/telegram-ask-claude.git
cd telegram-ask-claude
mkdir -p ~/.config/telegram-ask-claude
cp .env.example ~/.config/telegram-ask-claude/.env # TELEGRAM_BOT_TOKEN と TELEGRAM_CHAT_ID を書く
bash tg_send.sh "⚠️ 夜間バックアップ 失敗: rsync exit 23"
cron で失敗したときだけ知らせるなら、backup.sh || bash tg_send.sh "⚠️ backup.sh 失敗" の形で後ろに付ける。送る前に中身を見たいときは --dry-run。