---
title: Telegramと管理者アラート
description: 運用アラート、顧客のサインアップや入金イベントをTelegramグループ、Webhook、またはメールに送信し、顧客に表示するサポートショートカットを設定します。
url: https://nexcmp.com/ja/docs/administration/telegram-notifications/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Telegramと管理者アラート {#telegram-and-admin-alerts}

> **管理画面での場所:** System › Settings › Admin alerts (`/settings/alerts`)。サポートショートカット: Customers › Support › Tickets (`/support/tickets`)、タブ **Settings**。

## 動作内容 {#what-it-does}

NexCMPは、注意が必要な状況が発生したとき、および顧客のサインアップや入金の入金処理が行われたときに、オペレーターである**あなた**に通知します。アラートは、Telegram、Webhook、メールのいずれか1つ以上の**チャンネル**に送信されます。

管理者チャンネルに送信されるイベントには、デプロイ失敗、VMの消失、ネットワーク障害、空きIPが30未満、期限切れ間近のアイテム（1時間前の警告）、Stripeの異議申し立て、ワーカーの停止、クラスターRAMが閾値を超過、新規顧客のサインアップ、入金のクレジット処理が含まれます。顧客イベントは耐久キューに保存され、Telegramが受け入れるまで、遅延を増やしながら（30秒から最大1時間）再試行されます。

## 要件 {#requirements}

| 項目 | 要件 |
|---|---|
| Telegram | **@BotFather** で作成したボット（トークン）と、メッセージを受信するグループまたはユーザーの **chat ID** |
| ネットワーク | `api.telegram.org` へのアウトバウンドHTTPS |
| Webhook（代替） | アラートペイロードを受け付けるHTTPSエンドポイント |

## Telegramの準備 {#prepare-telegram}

1. Telegramで**@BotFather**を開き、`/newbot`を送信して名前を選び、**bot token**（`123456789:AA...`）をコピーします。
2. グループを作成し、そこにbotを追加して、任意のメッセージを送信します。
3. ブラウザで`https://api.telegram.org/bot<token>/getUpdates`を開いて`chat.id`を確認し、**chat ID**を見つけます（グループIDは`-`で始まります）。

## NexCMP での接続 {#connect-in-nexcmp}

1. **System › Settings › Admin alerts**を開きます。
2. **Add channel**で**Type: Telegram**を選択し、**Destination**にchat IDを、**Secret (bot token)**にトークンを設定します。**Add**をクリックします。
3. トグルスイッチ**Send admin Telegram (VM module)**がオンになっていることを確認します。*VM module status (read-only)*の行に「on」と表示されます。

![Telegramに設定されたAdd channelフォームが表示されたAdmin alertsページ](https://nexcmp.com/ja/docs/images/administration/telegram-notifications-01-channel.webp)

## 確認 {#verify}

チャンネルが**Configured channels**の下に表示されます。イベント（テスト顧客の登録など）をトリガーすると、メッセージがグループに届きます。チャンネルが設定されていない場合、ページには「Without a channel, attacks will go unnoticed」という警告が表示され、ログにはTelegramイベントがローカルにのみ記録されます。

## 顧客向けサポートショートカット {#support-shortcuts-for-customers}

カスタマーサポートウィジェットには、**Telegram**および**Zalo**ボタンを表示できます。サポート設定で構成されるまで非表示になります：Telegramの`https://t.me/...`リンクと、ZaloのリンクまたはQRコードを入力します。受け付けられるのは`https://`リンクのみです。サポートチャットでは、質問と回答のドラフトをTelegramグループに通知することもできます。[AI Chat](https://nexcmp.com/ja/docs/ai/ai-chat/)をご覧ください。

## 制限と注意点 {#limits-and-notes}

- botトークンはチャンネルとともに保存され、二度と再表示されません。
- Telegramイベントは、宛先とトークンの両方が設定されている有効な最初のTelegramチャンネルを使用します。

## トラブルシューティング {#troubleshooting}

| 症状 | 原因 | 対処法 |
|---|---|---|
| メッセージが届かない | チャットIDが間違っている、botがグループにいない、またはbotにメッセージが一度も送られていない | `getUpdates`を使用してIDを再確認します。最初にbotまたはグループにメッセージを送信してください。 |
| しばらく動作した後に停止する | BotFatherでトークンが取り消された | 新しいトークンを作成し、チャンネルを更新します。 |
| ログ内の`Telegram: no channel` | 有効なTelegramチャンネルがない | 上記のように追加します。 |