-- ═══════════════════════════════════════════════════════════════
-- تحديث نصوص المساعدة - أوامر Webhook المجمّعة
-- ═══════════════════════════════════════════════════════════════
--
-- يضيف:
-- 1. أوامر webhook_*_all (للتحكم في جميع البوتات)
-- 2. أوامر webhook_*_multi (للتحكم في مجموعة محددة)
-- 3. شرح مفصل للأوامر الجديدة مع أمثلة
--
-- ═══════════════════════════════════════════════════════════════

-- إنشاء أو تحديث قالب help_webhook
INSERT INTO `message_templates` (`key`, `text`, `scope`, `scope_value`) 
VALUES ('help_webhook', '', 'control', NULL)
ON DUPLICATE KEY UPDATE `key`='help_webhook';

-- تحديث نص المساعدة الخاص بـ Webhook
UPDATE `message_templates` 
SET `text` = '🌐 <b>قسم Webhook</b>

━━━━━━━━━━━━━━━━━━━━
<b>📌 أوامر بوت واحد:</b>
━━━━━━━━━━━━━━━━━━━━

<b>/webhook_create</b> <code>bot</code>
➡️ إنشاء رابط Webhook لبوت معين
💡 <code>/webhook_create mybot</code>
✅ يعرض الرابط وزر التفعيل السريع

<b>/webhook_enable</b> <code>bot</code>
➡️ تفعيل Webhook لبوت معين
💡 <code>/webhook_enable mybot</code>
✅ يرسل طلب setWebhook إلى Telegram

<b>/webhook_reset</b> <code>bot</code>
➡️ إعادة ضبط Webhook (حذف + تفعيل)
💡 <code>/webhook_reset mybot</code>
✅ يحذف الطلبات المعلقة ويعيد التفعيل

<b>/webhook_delete</b> <code>bot</code>
➡️ حذف Webhook لبوت معين
💡 <code>/webhook_delete mybot</code>
✅ يعطل Webhook تماماً

<b>/webhook_info</b> <code>bot</code>
➡️ عرض معلومات Webhook التفصيلية
💡 <code>/webhook_info mybot</code>
📊 يعرض: الرابط، الأخطاء، الطلبات المنتظرة

━━━━━━━━━━━━━━━━━━━━
<b>🌍 أوامر جميع البوتات:</b> 🆕
━━━━━━━━━━━━━━━━━━━━

<b>/webhook_create_all</b>
➡️ إنشاء Webhook لجميع البوتات المسجّلة
📊 يعرض تقريراً شاملاً بالروابط
⚡ سريع ومنظم

<b>/webhook_enable_all</b>
➡️ تفعيل Webhook لجميع البوتات دفعة واحدة
✅ يطبق setWebhook على كل البوتات
📊 تقرير مفصل: نجح / فشل
⚠️ قد يستغرق وقتاً حسب عدد البوتات

<b>/webhook_reset_all</b>
➡️ إعادة ضبط Webhook لجميع البوتات
🔄 حذف + إعادة تفعيل لكل بوت
✅ يحذف الطلبات المعلقة
💡 مفيد عند تغيير السيرفر أو النطاق

<b>/webhook_delete_all</b>
➡️ حذف Webhook لجميع البوتات
⚠️ يعطل جميع البوتات
💡 استخدمه عند الصيانة أو الانتقال لنظام polling

<b>/webhook_info_all</b>
➡️ عرض معلومات Webhook لجميع البوتات
📊 تقرير شامل يعرض لكل بوت:
  • حالة التفعيل (✅ / ❌)
  • عدد الطلبات المنتظرة
  • آخر خطأ (إن وجد)
📄 يقسم النص تلقائياً إذا كان طويلاً

━━━━━━━━━━━━━━━━━━━━
<b>🎯 أوامر مجموعة محددة:</b> 🆕
━━━━━━━━━━━━━━━━━━━━

<b>/webhook_create_multi</b> <code>bot1 bot2 bot3 ...</code>
➡️ إنشاء Webhook لعدة بوتات محددة
💡 <code>/webhook_create_multi test1 test2 vip</code>
✅ يعمل على البوتات المحددة فقط

<b>/webhook_enable_multi</b> <code>bot1 bot2 bot3 ...</code>
➡️ تفعيل Webhook لعدة بوتات محددة
💡 <code>/webhook_enable_multi free premium basic</code>
📊 تقرير بالنجاح والفشل لكل بوت

<b>/webhook_reset_multi</b> <code>bot1 bot2 bot3 ...</code>
➡️ إعادة ضبط Webhook لعدة بوتات
💡 <code>/webhook_reset_multi bot1 bot2</code>
🔄 حذف + إعادة تفعيل للبوتات المحددة

<b>/webhook_delete_multi</b> <code>bot1 bot2 bot3 ...</code>
➡️ حذف Webhook لعدة بوتات محددة
💡 <code>/webhook_delete_multi old1 old2</code>
⚠️ يعطل البوتات المحددة فقط

<b>/webhook_info_multi</b> <code>bot1 bot2 bot3 ...</code>
➡️ معلومات Webhook لبوتات محددة
💡 <code>/webhook_info_multi test1 test2</code>
📊 تقرير مفصل للبوتات المطلوبة فقط

━━━━━━━━━━━━━━━━━━━━
<b>💡 أمثلة عملية:</b>
━━━━━━━━━━━━━━━━━━━━

<b>مثال 1: تفعيل بوت واحد</b>
<code>/webhook_enable mybot</code>
✅ سريع ومباشر

<b>مثال 2: تفعيل جميع البوتات</b>
<code>/webhook_enable_all</code>
⏳ سيستغرق بضع ثوانٍ
📊 سيعرض تقريراً بالنتائج

<b>مثال 3: تفعيل بوتات VIP فقط</b>
<code>/webhook_enable_multi vip1 vip2 vip3</code>
✅ يعمل على البوتات المحددة فقط

<b>مثال 4: إعادة ضبط بعد تغيير النطاق</b>
<code>/webhook_reset_all</code>
🔄 يحدّث جميع البوتات بالنطاق الجديد

<b>مثال 5: فحص حالة بوتات معينة</b>
<code>/webhook_info_multi prod1 prod2 prod3</code>
📊 معلومات سريعة للبوتات الإنتاجية

━━━━━━━━━━━━━━━━━━━━
<b>⚙️ معالجة الأخطاء الجزئية:</b>
━━━━━━━━━━━━━━━━━━━━

عند استخدام أوامر <code>_all</code> أو <code>_multi</code>:

✅ <b>إذا نجح بعض البوتات وفشل آخرون:</b>
  • يستمر التنفيذ على البقية
  • يعرض تقريراً مفصلاً:
    - ✅ البوتات الناجحة
    - ❌ البوتات الفاشلة مع سبب الفشل
  • لا يتوقف التنفيذ بسبب خطأ واحد

📊 <b>التقرير النموذجي:</b>
<code>📊 ملخص العملية: تفعيل Webhook

📦 إجمالي: 10
✅ نجح: 8
❌ فشل: 2

✅ البوتات الناجحة:
  • test1 - تم التفعيل
  • test2 - تم التفعيل
  • vip1 - تم التفعيل
  ...

❌ البوتات الفاشلة:
  • old_bot
    └ Invalid bot token
  • broken_bot
    └ Connection timeout</code>

━━━━━━━━━━━━━━━━━━━━
<b>🔒 الصلاحيات:</b>
━━━━━━━━━━━━━━━━━━━━

• جميع أوامر Webhook متاحة <b>للمالك فقط</b>
• أوامر <code>_all</code> و <code>_multi</code> قوية جداً
• استخدمها بحذر على البوتات الإنتاجية

━━━━━━━━━━━━━━━━━━━━
<b>🚀 نصائح الأداء:</b>
━━━━━━━━━━━━━━━━━━━━

• <b>تأخير تلقائي:</b> 100ms بين كل عملية (لتجنب Rate Limits)
• <b>تقسيم الرسائل:</b> تلقائي للرسائل الطويلة
• <b>معالجة متوازية:</b> سريع وفعّال
• <b>إعادة محاولة:</b> لا توجد - راجع التقرير وأعد المحاولة يدوياً للفاشلة

━━━━━━━━━━━━━━━━━━━━
<b>📚 حالات الاستخدام:</b>
━━━━━━━━━━━━━━━━━━━━

✅ <b>متى تستخدم _all:</b>
  • تفعيل نظام جديد
  • تغيير السيرفر أو النطاق
  • صيانة شاملة
  • فحص صحة جميع البوتات

✅ <b>متى تستخدم _multi:</b>
  • العمل على مجموعة معينة
  • بوتات من نفس المشروع
  • اختبار تحديث جديد
  • إصلاح مشكلة محددة

✅ <b>متى تستخدم الأمر الفردي:</b>
  • إضافة بوت جديد
  • إصلاح بوت واحد
  • اختبار سريع
  • تعديل محدد'
WHERE `key` = 'help_webhook';

-- رسالة نجاح
SELECT '
═══════════════════════════════════════
✅ تحديث نصوص المساعدة - Webhook
═══════════════════════════════════════

📋 الأوامر المضافة:

🌍 أوامر جميع البوتات (5):
• /webhook_create_all
• /webhook_enable_all
• /webhook_reset_all
• /webhook_delete_all
• /webhook_info_all

🎯 أوامر مجموعة محددة (5):
• /webhook_create_multi
• /webhook_enable_multi
• /webhook_reset_multi
• /webhook_delete_multi
• /webhook_info_multi

💡 لعرض المساعدة المحدثة:
/help

═══════════════════════════════════════
' as 'نتيجة التحديث';
