ブログに戻る

Telegram ボットの通知と開発者向けアラートのプッシュ通知 API の比較

Telegram ボットの通知と開発者向けアラートのプッシュ通知 API の比較

スクリプトからのアラートをどう受け取っているか開発者に尋ねると、半数は「Telegram ボット」と答えるでしょう。無料で、Telegram はすでにスマホに入っており、最初のメッセージを送れるようになるまで 10 分ほどしかかかりません。

ただ、これはチャットアプリがポケベルの役割を担っているにすぎません。重要なアラートがグループチャットと同じ流れに届いたり、アンダースコアを含むファイル名がメッセージを壊したりするまでは問題なく機能します。この記事では、Telegram のセットアップを率直に見ていき、どこで有効でどこで不十分かを整理したうえで、同じアラートがプッシュ通知 API ではどう見えるかを示します。

Telegram のセットアップ全手順

  1. ボットを作成する。 @BotFather にメッセージを送り、/newbot を送信して、名前と bot で終わるユーザー名を決めます。110201543:AAH... のようなトークンが発行されます。
  2. 先に挨拶する。 ボットから会話を始めることはできないため、ボットを開いて何かメッセージを送ってください。グループの場合は、ボットをグループに追加します。
  3. チャット ID を調べる。 getUpdates を呼び出し、結果の message.chat.id を確認します。
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'

アップデートは 24 時間保持されます。また、ボットに Webhook が設定されると getUpdates は使えなくなります。グループの ID は負の数で、スーパーグループの ID は -100 から始まります。

  1. アラートを送信する:
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id="$TG_CHAT_ID" \
  -d text="Backup failed on db-01"

連携全体はこれだけです。環境変数ファイルに 2 つのシークレットを置き、HTTP 呼び出しを 1 回行います。

Telegram が優れている点

  • 費用がかからない。 Telegram 公式の FAQ によると、ボットはユーザーに無料でメッセージを送れます。
  • どこでも使える。 スマホ、デスクトップ、Web のクライアントがすべて同期されます。
  • グループも無料。 チームのチャットにボットを追加すれば、全員がアラートを見て、同じスレッドで話し合えます。
  • すでに開いている。 新しいアプリも新しいアカウントも不要です。

「夜間レポートができました」のような影響の小さい通知なら、これ以上の手段はなかなかありません。

扱いにくい点

すべてのアラートが同じ音で届く

Bot API の配信制御は disable_notification の 1 つだけです。これは音を出さずにメッセージを送るものです。優先度も、時間的制約のあるレベルも、おやすみモードを通過する仕組みもありません。深夜 3 時の失敗したバックアップも、グループチャットのスタンプと同じ形で届きます。騒がしさを避けるためにチャットをミュートすれば、アラートもまとめてミュートされてしまいます。

書式でつまずく

parse_mode=MarkdownV2 を使う場合、_ * [ ] ( ) ~ > # + - = | { } . ! の文字とバッククオートは、書式以外で使われるとバックスラッシュでエスケープしなければなりません。アラートにはまさにこうした文字が多く含まれます。ファイル名、バージョン番号、URL、スタックトレースなどです。db-01.internal の中のエスケープされていないドット 1 つで Telegram は 400 エラーを返してメッセージを拒否し、障害を知らせるアラートそのものが失敗します。HTML モードのほうが安全ですが、送信するすべての内容で <、>、& をエスケープする必要があります。

トークンがそのままボットの鍵になる

トークンはすべてのリクエストの URL パスに含まれます。Telegram のドキュメントにも、トークンを持つ者はボットを操作できると明記されています。実際には、その URL はシェルの履歴、CI のログ、リクエスト URL が記録されるあらゆる場所に残ります。漏えいした場合は、BotFather の /token で新しいトークンを発行しますが、その後はすべてのスクリプトを更新しなければなりません。

ボタンには常駐するボットが必要

インラインボタンで URL を開くことは問題ありません。しかし「サービスを再起動」のように何かを実行するボタンは callback_data を使い、ボットが応答するまでユーザーのタップ後にスピナーが表示され続けます。つまり、アップデートを 24 時間待ち受けるプロセスが必要になります。これは cron ジョブが抱えたいものよりも大きな負担です。

バーストでレート制限に当たる

Telegram は、ボットがチャットごとに毎秒 1 件、グループでは毎分 20 件を超えないよう求めています。おしゃべりの多い Webhook をグループに向けると、障害が起きてアラートが最も急増しているときに、429 Too Many Requests の値を含む retry_after が返ってきます。

サービスから直接投稿できない

GitHub、Stripe、Grafana、Sentry は、それぞれ独自の JSON で Webhook を送信します。一方、Bot API が求めるのは chat_id と text です。その間を取り持つものが必要で、小さなサーバー、サーバーレス関数、あるいは n8n や Zapier のフローなどが該当します。この中継も、常に稼働させ続けなければならない要素がもう 1 つ増えることを意味します。

アラートがメッセンジャーの中に埋もれる

ボットのメッセージは通常の Telegram チャットメッセージとして保存され、個人のチャットと混ざります。先月のインシデントを探すには、チャットをスクロールするしかなく、送信元で履歴を絞り込むことはできません。

同じアラートをプッシュ通知 API で送る

ここでは、バックアップのアラートを優先度付きで Pocket Alert に送り、ジョブログを開くボタンを付けます:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Backup failed",
    "message": "db-01.internal: pg_dump exited with code 1",
    "level": "high",
    "actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
  }'

変わる点は次のとおりです:

  • シークレットは 1 つで、ヘッダーに入る。 チャット ID と URL 内のトークンではなく、Token ヘッダーに API キーを入れます。
  • 入力もそのまま出力もプレーンテキスト。 エスケープのルールはありません。ドット、アンダースコア、括弧はそのまま届きます。
  • メッセージごとに優先度を指定できる。 silent、low、default、high、critical から選べます。iPhone では high と critical が集中モードを時間的制約のある通知として通過し、Android では critical アラートがおやすみモードより優先されます。詳しくは重大なアラートをご覧ください。
  • ボットなしでボタンを使える。 アクションボタンを最大 3 つ付けられます。URL を開く、HTTP エンドポイントを呼び出す、値をコピーする、のいずれかです。タップを待ち受けるプロセスは不要です。
  • サービスから直接投稿できる。 各Webhookには専用の URL があります。GitHub や Grafana は独自の JSON を送信でき、%alerts.0.labels.alertname% のようなプレースホルダーでフィールドを通知に取り込めます。すべての呼び出しは Webhook 履歴に記録されます。
  • 独自の履歴を持つ。 アラートは別のアプリとダッシュボードに保存され、チャットの間に埋もれることなくアプリケーションごとにまとめられます。

それでも Telegram が適している場合

公平に言うと:

  • 低予算で大量に送る。 Telegram は無料で、レート制限を超えなければ 1 日の上限もありません。Pocket Alert の無料プランは 1 日 50 件までで、それ以上は月額 6 ドルからの有料プランが必要です。
  • 会話のきっかけになるアラート。 目的がチームでアラートを届いた場所で話し合うことなら、グループチャットが向いており、プッシュ通知では代わりになりません。
  • デスクトップと Web が中心。 一日中ノートパソコンを使っているなら、Telegram のデスクトップクライアントが、いつも見ている場所にアラートを表示してくれます。Pocket Alert のアプリは iPhone と Android 向けで、履歴は Web ダッシュボードで確認します。

多くのチームにうまく機能する使い分けは、雑談や日次サマリーには Telegram グループを使い、誰かを起こすべきものは優先度付きのプッシュとして送ることです。

FAQ

Telegram ボットのメッセージはおやすみモードを回避できますか?

ボット側からはできません。Bot API には優先度の設定がなく、メッセージを無音にする disable_notification があるだけです。iPhone の集中モードを通過させる唯一の方法は、受信者が Telegram をアプリの例外として許可することです。ただしこれにより、アラートだけでなくすべての Telegram 通知が通過してしまいます。

Telegram のチャット ID はどうやって調べますか?

ボットに任意のメッセージを送ってから、https://api.telegram.org/bot<token>/getUpdates を呼び出し、message.chat.id を確認してください。結果が空の場合は、アップデートが 24 時間より古いか、ボットに Webhook が設定されている可能性があります。Webhook が設定されていると getUpdates は動作しません。

Telegram のアラートが 400 エラーで失敗するのはなぜですか?

多くの場合、MarkdownV2 または HTML モードでエスケープされていない文字があることが原因です。parse_mode を外してプレーンテキストで送るか、送信前に予約文字をすべてエスケープしてください。

プッシュ通知 API の設定は Telegram ボットより難しいですか?

ほぼ同じです。Pocket Alert では、アプリをインストールし、ダッシュボードから API キーをコピーして、POST を 1 回送信します。調べるチャット ID も、作成するボットもありません。

両方に送ることはできますか?

はい。多くのチームは、話し合いには Telegram を使い、対応が必要なアラートはプッシュで送っています。スクリプトは両方の API を呼び出せますし、Webhook を送信するほとんどのサービスは複数の URL を受け付けます。

無料の Pocket Alert アカウントを作成して上記の curl を実行するか、先に プッシュ通知 API とは何かをお読みください。他の選択肢を検討中であれば、比較ハブで Pushover、ntfy、Bark、Gotify などを比較できます。

この記事をシェア