概要
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アプリの作成
- Meta for Developersにアクセス
- 「My Apps」→「Create App」をクリック
- アプリの種類として「Business」を選択
- アプリの詳細を入力してアプリを作成
ステップ2: WhatsApp製品の追加
- アプリダッシュボードで「Add Product」をクリック
- 「WhatsApp」を見つけて「Set Up」をクリック
- Business Portfolioを選択または作成
ステップ3: 認証情報の取得
- WhatsApp → API設定に移動
- 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: 受信者番号の確認
- WhatsApp API設定ページで、個人WhatsApp番号を受信者として追加
- WhatsAppに送信されたOTPで番号を確認
重要な注意事項
- 無料プランは月1,000件の会話が可能
- テストモードでは受信者番号を必ず確認
- 本番環境ではBusiness認証を完了する必要あり
2. Discord設定
Discordは通知にWebhookを使用し、最も簡単な方法です。
ステップバイステップの設定
ステップ1: サーバー設定にアクセス
- Discordを開き、サーバーへ移動
- 通知を受け取りたいチャンネルを右クリック
- 「チャンネルを編集」を選択
ステップ2: Webhookの作成
- 「インテグレーション」タブに移動
- 「Webhook」→「Webhookを作成」をクリック
- Webhookに名前を付ける(例:「MagicTradeBot Signals」)
- (オプション)カスタムアバターをアップロード
ステップ3: Webhook URLのコピー
- 「Webhook URLをコピー」をクリック
- 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アカウントへの変換
- Instagramアプリで:設定 → アカウント
- 「プロフェッショナルアカウントに切り替え」を選択
- 「Business」または「Creator」を選択
ステップ2: Facebookページへの接続
- 設定 → アカウント → リンクされたアカウントへ移動
- InstagramをFacebookページにリンク
ステップ3: Metaアプリの作成
- Meta for Developersにアクセス
- 新しいアプリを作成(まだない場合)
- 「Instagram」製品を追加
ステップ4: アクセス トークンの生成
- Instagram → Basic DisplayまたはInstagram Graph APIへ移動
- 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: ボットの作成
- Telegramを開き、@BotFatherを検索
- チャットを開始し、/newbotを送信
- 指示に従って進む:
- ボットの名前を選択(例:「My Trading Signals」)
- 「bot」で終わるユーザー名を選択(例:「mytrading_signals_bot」)
ステップ2: ボット トークンの取得
- BotFatherがボット トークンを提供
- 形式:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz - トークンを安全に保存
ステップ3: チャットIDの取得
方法1: IDBotを使用
- Telegramで@myidbotまたは@userinfobotを検索
- チャットを開始し、/startを送信
- ボットがチャットIDを返信
方法2: 手動方法
- 作成したボットにメッセージを送信
- 次を訪問:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - "chat":{"id":123456789} を検索
- その数字がchat_id
方法3: グループチャット用
- ボットをグループに追加
- グループにメッセージを送信
- 次を訪問:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - チャットIDを検索(グループは負数:-123456789)
ステップ4: ボットの開始
- Telegramでボットを検索
- 「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の問題
- 「無効なトークン」:トークン期限切れ。永続トークンを生成
- 「電話番号未認証」:Metaダッシュボードで受信者を追加・認証
- メッセージ送信不可:APIレート制限と課金を確認
Discordの問題
- 「無効なWebhook」:URLが再生成された可能性。新しく取得
- 403 Forbidden:Webhook削除。新規作成
- チャンネルが見つかりません:Webhookチャンネルが削除された可能性
Instagramの問題
- トークン期限切れ:Instagramトークンは期限切れ。新たな長期トークンを生成
- 権限拒否:必要なすべての権限が付与されていることを確認
- アカウントが対象外:BusinessまたはCreatorアカウントが必要
Telegramの問題
- 「チャットが見つかりません」:ボット未開始。まず/startを送信
- 「認証されていません」:ボット トークンが正しいか確認
- メッセージ受信不可:ボットがブロックされていないか確認
セキュリティのベストプラクティス
- トークンをバージョン管理にコミットしない
- 環境変数を使用
- 設定ファイルを.gitignoreに追加
- トークンを定期的にローテーション
- 特にWhatsAppとInstagram
- Telegramトークンは期限切れしないが再生成可能
- 環境ごとの設定を使用
- テストと本番で異なるトークン
- Webhookアクセスを制限
- Discord:アクセス制限された専用チャンネルを使用
- WhatsApp:受信者番号を認証
- 使用状況を監視
- APIクォータを定期的に確認
- 配信失敗のアラートを設定
クイックスタート推奨
初心者向け:Telegramから開始
- 最も簡単な設定(5分)
- 認証不要
- 完全に無料
- 最も信頼性が高い
チーム向け:Discordを使用
- シンプルなWebhook設定
- グループ通知に最適
- 無料で信頼性あり
ビジネス向け:WhatsAppを検討
- プロフェッショナルな外観
- 直接モバイル配信
- 設定に多くの労力が必要
サポート & リソース
最終注意事項
- 本番稼働前に簡単なメッセージで設定をテスト
- すべてのトークンのバックアップを安全なパスワードマネージャーに保管
- 冗長性のために複数のプラットフォームの使用を検討
- 予想されるメッセージ量に応じてレート制限を確認
- 1つのプラットフォームから始め、必要に応じて拡張