サードパーティ拡張機能のサポート:Pushover 統合

MagicTradeBot は、シンプルで信頼性の高いプッシュ通知サービスである Pushover とのネイティブ統合をサポートしています。これにより、各ボットインスタンスからのアラートやイベント通知を、リアルタイムでモバイルデバイス、デスクトップ、またはブラウザへ直接送信できます。

単一のボットインスタンスを管理している場合でも、複数の取引所、アカウント、サーバーにわたる数百のボットを運用している場合でも、Pushover により重要なイベント、取引アクション、システムエラーに関する情報をどこからでも受け取ることが可能です。

ボットが数百の暗号通貨ペアをスキャンおよび取引するようになると、手動による監視は非現実的になります。Pushover を使えば、重要なイベントを見逃すことがありません。


🚀 概要

Pushover 統合により、MagicTradeBot は以下のカスタムメッセージを送信できます:

  • 取引の実行(買い/売り)
  • 戦略のトリガーや利益到達の通知
  • エラー、例外、またはシステム警告
  • アカウント関連のアクション(例:残高不足、API制限)

🔧 主な機能

  • 📲 モバイルやデスクトップへの即時プッシュ通知
  • 🚨 優先度レベル(情報、警告、重大)を設定可能
  • 📡 全てのボットインスタンスとデプロイに対応
  • 🔁 個人ユーザーおよびグループユーザーの両方に対応
  • 📊 軽量で高速なメッセージ配信

🛠️ 前提条件

  • 有効な Pushover アカウント
  • ユーザーキー(受信者)およびアプリケーションAPIトークン
  • ボットホストからのHTTPSリクエスト送信用インターネット接続

⚙️ 設定手順

1. Pushover 資格情報を取得

Pushover アカウントにログインし、新しいアプリケーションを作成して APIトークン を取得します。次の情報をコピーしてください:

  • ユーザーキー: ダッシュボードで確認可能
  • APIトークン: 作成したアプリから取得

2. ボット設定を更新

MagicTradeBot の設定ファイル(例:config.yaml)に以下を追加します:

alerting:
  pushover:
    enabled: true
    user_key: "YOUR_PUSHOVER_USER_KEY"
    api_token: "YOUR_PUSHOVER_API_TOKEN"
    device: "mobile"
    priority: "normal"
    sound: "magic"

3. 通知トリガーを定義

どのようなイベントで Pushover 通知を送信するかを設定できます。例:

  • 取引実行の結果(成功または失敗)
  • 戦略の開始・終了
  • エラーレートの上昇や証拠金の低下などの閾値超過

4. 統合のテスト

以下のコマンドでテスト通知を送信して設定を確認します:

curl -s \
  --form-string "token=YOUR_PUSHOVER_API_TOKEN" \
  --form-string "user=YOUR_PUSHOVER_USER_KEY" \
  --form-string "message=MagicTradeBot のテスト通知" \
  https://api.pushover.net/1/messages.json

🧪 通知ペイロードの例

{
  "title": "MagicTradeBot アラート",
  "message": "ETH/USDT でロング取引を実行しました。利益:+2.45%",
  "priority": 1,
  "sound": "magic",
  "device": "mobile",
  "timestamp": "2025-06-20T12:42:15Z"
}

✅ Pushover 統合の利点

  • 📍 ログやダッシュボードを確認せずに即時アップデート
  • ⚠️ 外出先でも取引、エラー、イベントの通知を受信
  • 🧘 ポーリングや重い監視ツールは不要
  • 🔒 配信確認付きのセキュアかつレート制限された通知
  • 📱 デバイスや優先度ごとに通知をカスタマイズ可能

📎 Related Topics