MagicTradeBot ブロードキャスト設定ガイド

概要

MagicTradeBotのBroadcast機能を使用すると、複数のメッセージングプラットフォームで取引シグナルを受信できます。ご希望に応じて1つまたはすべてのプラットフォームを設定できます。

設定構造

BroadCast:
  # WhatsApp通知
  whatsapp_token: null
  whatsapp_phone_id: null
 
  # Discord通知
  discord_webhook_url: null
 
  # Instagram通知
  instagram_token: null
 
  # Telegram通知
  telegram_bot_token: null
  telegram_chat_id: null

1. WhatsApp設定

WhatsApp通知はMeta WhatsApp Business APIを使用します。

前提条件

  • Meta(Facebook)Businessアカウント
  • 認証済みのビジネス電話番号
  • Meta Developerプラットフォームへのアクセス

ステップバイステップの設定

ステップ1: Metaアプリの作成

  1. Meta for Developersにアクセス
  2. 「My Apps」→「Create App」をクリック
  3. アプリの種類として「Business」を選択
  4. アプリの詳細を入力してアプリを作成

ステップ2: WhatsApp製品の追加

  1. アプリダッシュボードで「Add Product」をクリック
  2. 「WhatsApp」を見つけて「Set Up」をクリック
  3. Business Portfolioを選択または作成

ステップ3: 認証情報の取得

  1. WhatsApp → API設定に移動
  2. 2つの重要な値が表示されます:

一時アクセス トークン(whatsapp_token):

  • 表示された一時アクセス トークンをコピー
  • 注意: 本番環境では永続トークンを生成:
    • Business設定のシステム ユーザーへ移動
    • システム ユーザーを作成
    • whatsapp_business_messaging権限でトークンを生成

電話番号ID(whatsapp_phone_id):

  • 「Phone Number ID」の下に記載
  • これは電話番号ではありません、一意の識別子です

ステップ4: MagicTradeBotで設定

BroadCast:
  whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
  whatsapp_phone_id: "123456789012345"

ステップ5: 受信者番号の確認

  1. WhatsApp API設定ページで、個人WhatsApp番号を受信者として追加
  2. WhatsAppに送信されたOTPで番号を確認

重要な注意事項

  • 無料プランは月1,000件の会話が可能
  • テストモードでは受信者番号を必ず確認
  • 本番環境ではBusiness認証を完了する必要あり

2. Discord設定

Discordは通知にWebhookを使用し、最も簡単な方法です。

ステップバイステップの設定

ステップ1: サーバー設定にアクセス

  1. Discordを開き、サーバーへ移動
  2. 通知を受け取りたいチャンネルを右クリック
  3. 「チャンネルを編集」を選択

ステップ2: Webhookの作成

  1. 「インテグレーション」タブに移動
  2. 「Webhook」→「Webhookを作成」をクリック
  3. Webhookに名前を付ける(例:「MagicTradeBot Signals」)
  4. (オプション)カスタムアバターをアップロード

ステップ3: Webhook URLのコピー

  1. 「Webhook URLをコピー」をクリック
  2. URL形式: https://discord.com/api/webhooks/XXXXX/YYYYY

ステップ4: MagicTradeBotで設定

BroadCast:
  discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOpQrStUvWxYz"

重要な注意事項

  • Webhook URLを持つ人は誰でもチャンネルに投稿可能
  • URLを安全に保管
  • 異なるボット用に複数のWebhookを作成可能
  • Discord開発者アカウント不要

3. Instagram設定

Instagram通知はInstagram Graph API(Meta)を使用します。

前提条件

  • Instagram BusinessまたはCreatorアカウント
  • Instagramアカウントに接続されたFacebookページ
  • Meta開発者アカウント

ステップバイステップの設定

ステップ1: Businessアカウントへの変換

  1. Instagramアプリで:設定 → アカウント
  2. 「プロフェッショナルアカウントに切り替え」を選択
  3. 「Business」または「Creator」を選択

ステップ2: Facebookページへの接続

  1. 設定 → アカウント → リンクされたアカウントへ移動
  2. InstagramをFacebookページにリンク

ステップ3: Metaアプリの作成

  1. Meta for Developersにアクセス
  2. 新しいアプリを作成(まだない場合)
  3. 「Instagram」製品を追加

ステップ4: アクセス トークンの生成

  1. Instagram → Basic DisplayまたはInstagram Graph APIへ移動
  2. Instagram Graph APIの場合:
    • ツール → Graph API Explorerへ移動
    • アプリを選択
    • Instagramアカウントを選択
    • 権限を追加:instagram_basic、instagram_manage_messages
    • 「アクセス トークンを生成」をクリック

ステップ5: 長期トークンの取得

短期トークンは1時間で期限切れになります。長期トークン(60日)に変換:

curl -i -X GET "https://graph.facebook.com/v18.0/oauth/access_token?grant_type=fb_exchange_token&client_id=YOUR_APP_ID&client_secret=YOUR_APP_SECRET&fb_exchange_token=SHORT_LIVED_TOKEN"

ステップ6: MagicTradeBotで設定

BroadCast:
  instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"

重要な注意事項

  • Instagram APIは主にビジネス機能向け
  • API経由のダイレクトメッセージには制限あり
  • 簡単な用途にはInstagram Basic Displayを検討
  • トークンは定期的に更新が必要

4. Telegram設定

Telegramはすべてのプラットフォームの中で最も簡単なボット設定を提供します。

ステップバイステップの設定

ステップ1: ボットの作成

  1. Telegramを開き、@BotFatherを検索
  2. チャットを開始し、/newbotを送信
  3. 指示に従って進む:
    • ボットの名前を選択(例:「My Trading Signals」)
    • 「bot」で終わるユーザー名を選択(例:「mytrading_signals_bot」)

ステップ2: ボット トークンの取得

  1. BotFatherがボット トークンを提供
  2. 形式: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  3. トークンを安全に保存

ステップ3: チャットIDの取得

方法1: IDBotを使用

  1. Telegramで@myidbotまたは@userinfobotを検索
  2. チャットを開始し、/startを送信
  3. ボットがチャットIDを返信

方法2: 手動方法

  1. 作成したボットにメッセージを送信
  2. 次を訪問: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  3. "chat":{"id":123456789} を検索
  4. その数字がchat_id

方法3: グループチャット用

  1. ボットをグループに追加
  2. グループにメッセージを送信
  3. 次を訪問: https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
  4. チャットIDを検索(グループは負数:-123456789)

ステップ4: ボットの開始

  1. Telegramでボットを検索
  2. 「Start」をクリックまたは/startを送信

ステップ5: MagicTradeBotで設定

BroadCast:
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"

重要な注意事項

  • ボットは会話を開始できません。まず開始する必要があります
  • グループの場合、ボットを追加し、chat_idは負数
  • 認証や承認プロセス不要
  • 完全に無料でメッセージ制限なし
  • 個人利用に最も信頼できるオプション

マルチプラットフォーム設定例

複数のプラットフォームを同時に有効化できます:

BroadCast:
  # WhatsApp
  whatsapp_token: "EAAxxxxxxxxxxxxxxxxxxxxxxxx"
  whatsapp_phone_id: "123456789012345"
 
  # Discord
  discord_webhook_url: "https://discord.com/api/webhooks/123456789/AbCdEfGhIjKlMnOp"
 
  # Instagram
  instagram_token: "IGQVJxxxxxxxxxxxxxxxxxxxxxxxxxx"
 
  # Telegram
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"

または必要なものだけを有効化:

BroadCast:
  # Telegramのみ有効
  whatsapp_token: null
  whatsapp_phone_id: null
  discord_webhook_url: null
  instagram_token: null
  telegram_bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
  telegram_chat_id: "987654321"

プラットフォーム比較

プラットフォーム 設定の難易度 コスト 信頼性 最適な用途
Telegram 簡単 無料 優れている 個人、グループ
Discord 簡単 無料 優れている コミュニティ、チーム
WhatsApp ⭐⭐⭐ 複雑 無料プラン制限あり 良好 ビジネスコミュニケーション
Instagram ⭐⭐⭐⭐ 非常に複雑 無料 普通 ソーシャル統合

トラブルシューティング

WhatsAppの問題

  • 「無効なトークン」:トークン期限切れ。永続トークンを生成
  • 「電話番号未認証」:Metaダッシュボードで受信者を追加・認証
  • メッセージ送信不可:APIレート制限と課金を確認

Discordの問題

  • 「無効なWebhook」:URLが再生成された可能性。新しく取得
  • 403 Forbidden:Webhook削除。新規作成
  • チャンネルが見つかりません:Webhookチャンネルが削除された可能性

Instagramの問題

  • トークン期限切れ:Instagramトークンは期限切れ。新たな長期トークンを生成
  • 権限拒否:必要なすべての権限が付与されていることを確認
  • アカウントが対象外:BusinessまたはCreatorアカウントが必要

Telegramの問題

  • 「チャットが見つかりません」:ボット未開始。まず/startを送信
  • 「認証されていません」:ボット トークンが正しいか確認
  • メッセージ受信不可:ボットがブロックされていないか確認

セキュリティのベストプラクティス

  1. トークンをバージョン管理にコミットしない
    • 環境変数を使用
    • 設定ファイルを.gitignoreに追加
  2. トークンを定期的にローテーション
    • 特にWhatsAppとInstagram
    • Telegramトークンは期限切れしないが再生成可能
  3. 環境ごとの設定を使用
    • テストと本番で異なるトークン
  4. Webhookアクセスを制限
    • Discord:アクセス制限された専用チャンネルを使用
    • WhatsApp:受信者番号を認証
  5. 使用状況を監視
    • APIクォータを定期的に確認
    • 配信失敗のアラートを設定

クイックスタート推奨

初心者向け:Telegramから開始

  • 最も簡単な設定(5分)
  • 認証不要
  • 完全に無料
  • 最も信頼性が高い

チーム向け:Discordを使用

  • シンプルなWebhook設定
  • グループ通知に最適
  • 無料で信頼性あり

ビジネス向け:WhatsAppを検討

  • プロフェッショナルな外観
  • 直接モバイル配信
  • 設定に多くの労力が必要

サポート & リソース

最終注意事項

  • 本番稼働前に簡単なメッセージで設定をテスト
  • すべてのトークンのバックアップを安全なパスワードマネージャーに保管
  • 冗長性のために複数のプラットフォームの使用を検討
  • 予想されるメッセージ量に応じてレート制限を確認
  • 1つのプラットフォームから始め、必要に応じて拡張

📎 Related Topics