Notifier for CC Cent

Notifier for CC Cent：牛の乳搾りが終わった瞬間がわかります。

CC Cent のバスケットが決済されるたびに、スマートフォンへ Telegram メッセージを送る小さな読み取り専用ユーティリティです。日次と週次の利益サマリーも選べます。MT5 を開かずに、結果、純利益、今日の合計を確認できます。

Notifier は口座履歴を読むだけです。注文を出す、決済する、変更することはできないため、リアル口座と並べて安全に使えます。

メッセージの内容

• Result：WIN または LOSS。Notifier が動いていない間にバスケットが決済された場合は "while offline" と表示されます。
• 純結果：スワップと手数料を含む利益。それぞれの内訳も表示できます。
• バスケット詳細：方向、ポジション数とロット、継続時間、今日の合計、口座番号。

日次・週次サマリー

• 日次サマリー：前日の結果を、毎朝ローカル時間の 00:05 に送信します（時刻は変更可能）。日の区切りは CC Cent パネルの "Today" と同じです。
• 週次サマリー：前週の月曜から日曜までの結果を月曜日に送信します。取引日数、最良日と最悪日も含みます。
• Best と Worst：その日のバスケット単位の結果で、スワップと手数料を含みます。バスケットは決済された日に計上されます。
• 静かな日：バスケットのない週末はスキップされます。バスケットのない日も、オンにしない限りスキップされます。

機能

• CC Cent のバスケットのみ：CC Cent の注文コメントまたは設定ビーコンで識別します。口座上の他の EA は無視されます。
• 通知内容を選べる：1つまたは複数のマジックナンバー、1つの銘柄または全銘柄を監視し、指定したレイヤー（例：L3 以上）に達したバスケットだけを通知できます。
• 重複なし：再起動しても同じバスケットが二度送られることはありません。オフライン中に見逃した決済は一度だけ送信されます。
• 送信元は1つ：メッセージは Algo Trading がオンのターミナルからのみ送信されるため、自宅 PC と MQL5 VPS の両方から届くことはありません。
• 確実な配信：送信に失敗すると再試行し、指定した期限より古いメッセージは遅れて届く代わりに破棄されます。
• ステータスパネル：設定と現在の状態を表示し、テストメッセージ送信ボタンを備えます。同じ牛のテーマで、1行に折りたためます。

設定手順

約10分です。スマートフォンの Telegram と、CC Cent が動いている MT5 ターミナルが必要です。

パート1：自分の Telegram ボットを作る（スマートフォンで）

1. Telegram をインストールしてログインします。
2. 検索アイコンをタップして BotFather と入力します。青い認証マークが付いたものを開きます。ボットを作るための Telegram 公式ボットです。
3. Start をタップし、/newbot というメッセージを送ります。
4. BotFather が名前を聞いてきます。好きな名前を送ります（例："CC Cent Ultima"）。これがスマートフォン上のチャット名になります。
5. BotFather がユーザー名を聞いてきます。"bot" で終わる固有の名前を送ります（例：cccent_ultima_bot）。
6. BotFather がトークンを返信します。123456789:AAE-xxxxxxxx のような長い文字列です。行全体をコピーし、他人に見せないでください。
7. 同じ返信の中で新しいボットの名前をタップして開き、Start をタップします。この手順は必須です。これがないとボットはメッセージを送れません。
8. 任意：BotFather に /setuserpic を送ってボットに画像を設定します（例：ブローカーのロゴ）。

パート2：MT5 から Telegram への接続を許可する（パソコンまたは VPS で）

1. MT5 で ツール > オプション を開き、エキスパートアドバイザ タブを選びます。
2. 「WebRequest を許可する URL リスト」にチェックを入れます。
3. リストにアドレス api.telegram.org を、先頭に https:// を付けて追加します。nfs.faireconomy.media も残しておいてください。CC Cent のニュースフィルターに必要です。
4. OK をクリックします。

パート3：Notifier を起動する

1. Algo Trading がオンであることを確認します（MT5 ツールバーの Algo Trading ボタンが緑）。メッセージはオンの間だけ送信されます。
2. CC Cent のチャートとは別に、新しいチャートを開きます（銘柄は任意）。
3. ナビゲーターで Notifier for CC Cent（エキスパートアドバイザ の Market フォルダ内）を見つけ、新しいチャートにドラッグします。
4. 入力タブで、トークンを "Bot token (from @BotFather)" に貼り付けます。"Chat ID (empty = automatic)" は空欄のままにします。
5. CC Cent で 888888 以外のマジックナンバーを使っていますか？ "CC Cent magic number(s), comma separated" に入力してください。複数入力できます（例：888888, 888898）。
6. OK をクリックします。チャートにパネルが表示され、数秒でチャットを見つけます。
7. パネルの "Send test message" を押します。スマートフォンにテストメッセージが届くはずです。

パート4：複数口座または MQL5 VPS（任意）

• 複数口座：口座ごとにボットを1つ作ります（パート1を繰り返す）。各口座が独自の名前と画像を持つ別々のチャットとして表示されます。
• MQL5 VPS：ターミナルで CC Cent の隣に Notifier を付け、通常どおり移行します。WebRequest の許可リストも一緒に移行されます。自宅のターミナルは Algo Trading をオフにすると送信を止めます。

うまくいかないとき

• パネルにボットで Start を押すよう表示される：Telegram でボットを開き、Start をタップします（パート1、手順7）。
• パネルに Telegram のアドレスを許可するよう表示される：パート2を繰り返し、アドレスが正確に入力されているか確認します。
• "Telegram rejected the bot token"：BotFather からトークンを行全体、空白なしでコピーし直します。
• テストは届くがバスケットのメッセージが来ない：Algo Trading がオンか、マジックナンバーが CC Cent と一致しているか、"Notify from layer" がバスケットの到達レイヤーより高く設定されていないかを確認します。

知っておきたいこと

• Notifier は CC Cent 専用です。口座に CC Cent のバスケットがなければ、通知する内容はありません。
• ボットのトークンはあなたのターミナル内にとどまります。メッセージは MT5 から Telegram へ直接送られます。
• ストラテジーテスターでは Telegram が使えないため、待機状態のままです。