通知と Telegram 設定

二系統通知、BotFather でのボット作成、chat_id の取得、システム通知／通知設定への登録とテスト送信。

Adswds Platform は、ライセンス期限やドメイン異常などの運用通知を Telegram で配信できます。運営・アカウント双方で Webhook（URL＋任意署名）も設定でき、Telegram と単独／併用できます。Webhook の詳細は 通知と Webhook 設定。

二系統の設定（互いに独立）

運営コンソール「システム通知」コンソール「システム管理 → 通知設定」
利用者プラットフォーム運営側本アカウントの管理者
受信内容運営側アラート本アカウント関連アラート
Telegram運営用 Bot Token と Chat ID本アカウント用 Bot Token と Chat ID
Webhook運営側の受信 URL（任意署名）本アカウントの受信 URL（任意署名）
通知言語 / テンプレートシステム側一式（システム通知のみ）アカウントごと（本アカウントの通知設定のみ）
停止・期限切れアカウント—当該アカウントの通知は送らない

同一イベントは両側へ fan-out できます。片方未設定でも、もう片方だけで配信可能です。同一側で Telegram と Webhook を同時有効にもできます。

通知イベント

  • ライセンス期限：設定した日前に通知
  • ドメイン異常：疎通失敗または証明書の申請/更新失敗
  • その他は各通知画面の一覧に従います（例：アカウント側の「日次ドメイン健全性」、運営側の「システム健全性」）

イベントはスイッチで制御します。利用可能な Telegram / Webhook が未設定、システム側マスターオフ、またはアカウントが利用不可のときは送信しません。

通知言語とメッセージテンプレート

  • 通知言語（zh / en / ja、既定は中国語）：本文言語。コンソール UI 言語とは独立
  • テンプレート：イベントごとにタイトル/本文を編集可能。{{変数}} は画面にヒント表示
  • 編集と「既定に戻す」は現在の通知言語だけに作用。言語切替で他言語の上書きは消えません
  • 空欄ならその言語の内蔵デフォルトを使用

Telegram ボットの設定

運営コンソールとコンソールの入力項目は同じです：Bot Token + Chat ID。1 つのボットを共有しても、別々に作っても構いません。

1. BotFather でボットを作成

  1. Telegram で公式 @BotFather（認証マーク付き）を開く
  2. /newbot を送り、表示名とユーザー名（末尾 bot 必須）を設定
  3. 成功すると HTTP API token が返ります。これが製品に入れる Bot Token です
  4. token を公開グループやスクリーンショットに載せないでください。漏洩時は BotFather の /revoke で無効化し、差し替えてください

Bot Token の形式（必ず完全な値）

  • 形式は 数字ID:秘密鍵（例：7123456789:AAH...）
  • コロンの前後を必ず残す
  • 先頭に bot を付けない（製品側で API パスを組み立てます）
  • https://api.telegram.org/bot... の URL 全体を貼らない。token のみ
  • コロン後だけを入れると Telegram は HTTP 404 Not Found を返します

Token の検証

curl https://api.telegram.org/bot<TOKEN>/getMe

JSON の "ok": true なら有効です。

2. Chat ID の取得

個人チャット

  1. Telegram でボットを開き Start を押すか、任意のメッセージを送る（ボットがそのチャットを一度受信している必要があります）
  2. ブラウザで開く（<BOT_TOKEN> を実値に置換）：
https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
  1. "chat":{"id": ...} の数値が Chat ID（個人は通常正の数）

グループ / スーパーグループ

  1. ボットを対象グループに追加
  2. グループでメッセージを送る（getUpdates が空なら BotFather で Group Privacy をオフにして再送）
  3. 同じ getUpdates で chat.id を読む
  4. グループ / スーパーグループの ID は負数。スーパーグループ化後は -100... 形式が多い
  5. マイナス符号を含む完全な数値を入力する

グループがスーパーグループへ昇格した後

古い chat id が無効になることがあります。ボットへ再度メッセージを送り、getUpdates で新しい -100... を取得して製品側を更新してください。

以前ボットに Telegram 側 Webhook を設定していると getUpdates が空になることがあります。先に deleteWebhook するか、別の確実な方法で Chat ID を取得して製品に入力してください。

3. どこに入力するか

コンソール（本アカウント）

  1. 管理者でログイン
  2. システム管理 → 通知設定 を開く
  3. 「チャネル」で Telegram を有効にし、Bot Token と Chat ID を貼る
  4. 必要なイベントを有効化し、通知言語を選び、必要ならテンプレートを編集
  5. 保存後に テスト送信 し、受信を確認

運営コンソール（プラットフォームアラート）

  1. 運営コンソールにログイン
  2. システム通知 を開く
  3. マスター、事前日数、イベント、言語、テンプレートを設定
  4. 「チャネル」で Telegram を有効にし、運営用 Bot Token と Chat ID を入力
  5. 保存してテスト。本番アラートはライセンス走査・ドメイン疎通などの定期ジョブも必要です

運営側とアカウント側の token / chat_id は別ストアです。片方を変えてももう片方は上書きされません。

よくある入力ミス

テスト送信が失敗したら、まず次を確認してください。

ミス症状 / 原因正しい入力
Token のコロン前の数字 ID 欠け:AAH... だけを貼った；Telegram が 404 Not Found完全な 数字ID:秘密鍵
bot 接頭辞や API URL 全体フィールド不正、パス重複BotFather の token のみ
グループ Chat ID のマイナス欠け-100123... を 100123... にしたグループはマイナス必須
昇格前の古いグループ IDスーパーグループ化後に無効getUpdates で新しい -100... を取得

テスト送信と切り分け

症状確認点
テスト失敗上記ミス、token 完全性、Chat ID 符号、ボットがチャットを受信済みか。getMe で先に検証
テスト成功だが本番が来ないイベントスイッチ、運営マスター、アカウントが利用中か
グループに届かないボット在籍、Group Privacy、スーパーグループ新 ID
文面が違う現在の通知言語とテンプレート。既定に戻すは現在言語のみ

関連：通知と Webhook 設定 · システムとアカウント · コンソール概要 · FAQ。