Telegramでアラートを送信する方法

概要 MKControllerのTelegram連携機能は、オフラインイベントなどのデバイスアラート通知を、@mkcontroller_bot経由でTelegramアカウントへ直接送信します。設定は2ステップで完了します。まず@userinfobotでTelegramユーザーIDを取得し、次にSites → Settings → UsersでそれをMKControllerアカウントに紐づけるだけです。一度有効化すれば、ダッシュボードを確認しなくても24時間365日アラートが届きます。

MKControllerのTelegramアラート連携とは?

MKControllerのTelegram連携は、デバイスアラートメッセージ(オフラインイベント、再接続、カスタムアラート)を、公式の@mkcontroller_bot経由でTelegramアカウントへ直接配信する通知チャネルです。一度設定すれば、MKControllerダッシュボードを開かなくてもスマートフォン上でリアルタイムにプッシュ通知を受信できます。

Telegramは無料で利用でき、すべてのモバイルOSで動作し、低帯域環境でも確実にメッセージを配信できるため、多くのISPやWISPで通知チャネルとして選ばれています。現場へ頻繁に出向くネットワーク事業者にとって理想的なツールです。

本ガイドでは例としてオフラインデバイスアラートを取り上げますが、同じ手順はMKControllerの他のすべてのアラートタイプにも適用できます。

ステップ1: TelegramユーザーIDを確認する

アカウントを紐づけるには、Telegramの数値ユーザーIDが必要です。最も手早く取得する方法は@userinfobotを使うことです。

スマートフォンまたはweb.telegram.orgでTelegramを開きます。
検索バーに**@userinfobot**と入力します。
検索結果から@userinfobotを選択し、Startをクリックします。
ボットがアカウント情報を返してきます。Idフィールドに表示される数字をコピーしてください。これがあなたのTelegramユーザーIDです。

ステップ2: MKControllerでアラートを設定する

app.mkcontroller.comにログインします。
左側のメニューからSitesを開き、アラートを有効化したいSiteのSettingsを開きます。
Alertsセクションで、設定したいアラートタイプ(本例ではデバイスオフライン)の隣にある鉛筆アイコンをクリックします。
アラート頻度を設定します。たとえば5分に設定すると、デバイスがオフラインの間、MKControllerは5分ごとに1回アラートを送信します。SLA要件に合った間隔を選択してください。
Saveをクリックします。

ステップ3: TelegramのIDをMKControllerアカウントに紐づける

Site Settings内でUsersセクションへ移動し、自分のユーザーの隣にある鉛筆アイコンをクリックします。
Telegramフィールドに、ステップ1で取得したTelegramユーザーID(数値)を貼り付けます。
Saveをクリックし、確認ポップアップでOKを選択します。

ステップ4: MKController Telegramボットを有効化する

Telegramに戻り、@mkcontroller_botを検索します。
ボットのページでStartをクリックします。
しばらくすると、ボットから確認メッセージが届き、MKControllerアカウントからのアラート転送が開始されます。

これで、24時間365日Telegramでデバイスアラートを受信する準備が整いました。

アラート設定のヒント

アラート頻度はSLAに合わせて設定してください。 5分間隔はほとんどのISPにとって良い出発点です。短時間の障害によるアラート疲れを避けつつ、15分以内の応答SLAに対応できる長さです。ミッションクリティカルな回線がある場合は、1分間隔を検討してください。

大規模なチームではSiteごとのボットを活用してください。 複数のSiteに異なる技術者チームがある場合、各メンバーは自分が担当するSiteにのみTelegram IDを紐づければよいのです。アラートは発生元のSiteに自動的にスコープされるため、Site Aの技術者がSite Bのアラートを受け取ることはありません。

セットアップ直後に必ず連携テストを行ってください。 連携が正しく機能していることを確認する最も簡単な方法は、テストデバイスをオフラインにする(またはWANインターフェースを30秒間無効化する)ことです。設定したアラート頻度の時間内にTelegramでアラートが届くか確認してください。

Telegramアラートのトラブルシューティング

ボットから確認メッセージは届いたが、デバイスアラートが届かない。 Sites → Settings → Alertsでアラートタイプが設定されており、頻度が極端に長い間隔になっていないことを確認してください。また、Usersセクションに入力したTelegramユーザーIDが、ユーザー名ではなく正しい数値IDであることもご確認ください。

@userinfobotが応答しない。 検索結果からボットを見つけた後、必ずStartをクリックしてボットを開始してください。Telegramのボットは、メッセージを送信する前に明示的なStartコマンドを必要とします。

数日後にアラートが届かなくなった。 Telegramでは、ユーザーが最近ボットとやり取りしていない場合、ボットが再認証を求められることがあります。Telegramで@mkcontroller_botを開き、もう一度Startをクリックしてください。ボットがアラート転送を再開します。

業務時間内のみアラートを受け取りたい。 MKControllerはSiteのアラート設定に基づきアラートを送信しますが、現在はすべてのオンライン/オフラインイベントで発火する仕様です。夜間のアラートを抑制したい場合は、時間外のアラート頻度をより長い間隔に調整することを検討するか、MKControllerサポートチームと高度なフィルタリングについてご相談ください。

Telegramアラートや通知設定についてご質問がある方は、WhatsAppで弊社チームにご相談ください、またはapp.mkcontroller.comへお越しください。