دليل إعداد البث لـ MagicTradeBot

1. إعداد واتساب

تستخدم إشعارات واتساب واجهة برمجة تطبيقات واتساب للأعمال من ميتا.

المتطلبات الأساسية

• حساب أعمال ميتا (فيسبوك)
• رقم هاتف أعمال تم التحقق منه
• الوصول إلى منصة مطوري ميتا

الإعداد خطوة بخطوة

الخطوة 1: إنشاء تطبيق ميتا

1. انتقل إلى Meta for Developers
2. انقر على "My Apps" → "Create App"
3. اختر "Business" كنوع التطبيق
4. املأ تفاصيل التطبيق وأنشئه

الخطوة 2: إضافة منتج واتساب

1. في لوحة تحكم التطبيق، انقر على "Add Product"
2. ابحث عن "WhatsApp" وانقر على "Set Up"
3. اختر أو أنشئ محفظة أعمال

الخطوة 3: الحصول على بيانات الاعتماد

1. انتقل إلى واتساب → إعداد واجهة البرمجة
2. سترى قيمتين مهمتين:

رمز الوصول المؤقت (whatsapp_token):

• انسخ رمز الوصول المؤقت المعروض
• ملاحظة: للإنتاج، أنشئ رمزًا دائمًا:
  • انتقل إلى مستخدمي النظام في إعدادات الأعمال
  • أنشئ مستخدم نظام
  • أنشئ رمزًا بإذن whatsapp_business_messaging

معرف رقم رقم الهاتف (whatsapp_phone_id):

• مُدرج تحت "Phone Number ID"
• هذا ليس رقم هاتفك، بل معرف فريد

الخطوة 4: التكوين في MagicTradeBot

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

الخطوة 5: التحقق من رقم المستقبل

1. في صفحة إعداد واجهة برمجة واتساب، أضف رقم واتساب الشخصي كمستقبل
2. تحقق من الرقم عبر رمز OTP المرسل إلى واتساب

2. إعداد ديسكورد

يستخدم ديسكورد الويب هوك للإشعارات — أبسط طريقة.

الإعداد خطوة بخطوة

الخطوة 1: الوصول إلى إعدادات السيرفر

1. افتح ديسكورد وانتقل إلى سيرفرك
2. انقر بزر الفأرة الأيمن على القناة التي تريد الإشعارات فيها
3. اختر "تعديل القناة"

الخطوة 2: إنشاء ويب هوك

1. انتقل إلى تبويب "التكاملات"
2. انقر على "Webhook" → "إنشاء ويب هوك"
3. أعطِ الويب هوك اسمًا (مثل "MagicTradeBot Signals")
4. (اختياري) ارفع صورة رمزية مخصصة

الخطوة 3: نسخ عنوان URL الخاص بالويب هوك

1. انقر على "نسخ عنوان URL الخاص بالويب هوك"
2. صيغة URL: https://discord.com/api/webhooks/XXXXX/YYYYY

الخطوة 4: التكوين في MagicTradeBot

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

3. إعداد إنستغرام

تستخدم إشعارات إنستغرام واجهة برمجة تطبيقات Instagram Graph (ميتا).

المتطلبات الأساسية

• حساب إنستغرام أعمال أو منشئ محتوى
• صفحة فيسبوك مرتبطة بحساب إنستغرام
• حساب مطور ميتا

الإعداد خطوة بخطوة

الخطوة 1: التحويل إلى حساب أعمال

1. في تطبيق إنستغرام: الإعدادات → الحساب
2. اختر "الانتقال إلى حساب احترافي"
3. اختر "أعمال" أو "منشئ محتوى"

الخطوة 2: الربط بصفحة فيسبوك

1. انتقل إلى الإعدادات → الحساب → الحسابات المرتبطة
2. اربط إنستغرام بصفحة فيسبوك

الخطوة 3: إنشاء تطبيق ميتا

1. انتقل إلى Meta for Developers
2. أنشئ تطبيقًا جديدًا (إذا لم يكن لديك)
3. أضف منتج "إنستغرام"

الخطوة 4: إنشاء رمز وصول

1. انتقل إلى إنستغرام → Basic Display أو Instagram Graph API
2. لواجهة Instagram Graph API:
   • انتقل إلى الأدوات → Graph API Explorer
   • اختر تطبيقك
   • اختر حساب إنستغرام
   • أضف الأذونات: instagram_basic، instagram_manage_messages
   • انقر على "إنشاء رمز وصول"

الخطوة 5: الحصول على رمز طويل الأمد

تنتهي صلاحية الرموز قصيرة الأمد بعد ساعة. حوّل إلى رمز طويل الأمد (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"

4. إعداد تيليغرام

يوفر تيليغرام أسهل إعداد للروبوت بين جميع المنصات.

الإعداد خطوة بخطوة

الخطوة 1: إنشاء روبوت

1. افتح تيليغرام وابحث عن @BotFather
2. ابدأ محادثة وأرسل /newbot
3. اتبع التعليمات:
   • اختر اسمًا للروبوت (مثل "My Trading Signals")
   • اختر اسم مستخدم ينتهي بـ "bot" (مثل "mytrading_signals_bot")

الخطوة 2: الحصول على رمز الروبوت

1. سيقدم لك BotFather رمز الروبوت
2. الصيغة: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
3. احفظ هذا الرمز بأمان

الخطوة 3: الحصول على معرف الدردشة

الطريقة 1: باستخدام IDBot

1. ابحث عن @myidbot أو @userinfobot في تيليغرام
2. ابدأ محادثة وأرسل /start
3. سيرد الروبوت بمعرف الدردشة الخاص بك

الطريقة 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. ابحث عن معرف الدردشة (سلبي للمجموعات: -123456789)

الخطوة 4: بدء تشغيل الروبوت

1. ابحث عن الروبوت في تيليغرام
2. انقر على "Start" أو أرسل /start

الخطوة 5: التكوين في MagicTradeBot

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