مسار حركة البيانات المباشرة
كيف تعمل البوابة بين الواتساب، n8n، و ووردبريس؟
دورة قراءة ومعالجة الاستعلام بالذكاء الاصطناعي دون تخزين بيانات الاعتماد في السيرفرات الخارجيّة
1
1. رسالة العميل على الواتساب
يرسل ولي الأمر أو المشترك رسالته للاستفسار عن الحساب أو المواعيد أو التجديد.
2
2. استقبال n8n Webhook
تستقبل منصة n8n الرسالة وتمرر رقم الهاتف في الهيدر السرّي `X-Player-Phone`.
3
3. ChatGPT يفهم وينفذ
يفهم الذكاء الاصطناعي السؤال ويحدد الأداة المناسبة (Tool) لجلب البيانات من الموقع.
4
4. استجابة BGM API الفورية
ترجع بوابة BGM البيانات المفلترة بأمان تام ليصيغ ChatGPT الرد ويرسله للعميل.
مساعد الأكاديمية الذكي (n8n WhatsApp Bot)
متصل الآن عبر ChatGPT gpt-4o-mini
REST API Endpoints Blueprint
الأدوات الخمس الذكية (AI Tools Framework)
تستخدم المنصة 5 نقاط اتصال آمنة لتوفير البيانات الدقيقة للذكاء الاصطناعي دون إمكانية التأليف أو التخمين
get_player_profile
GET /wp-json/bgm/v1/ai/me/profile
استرجاع كود اللاعب، أسماء الأبناء، ورابط صورة الـ QR
curl -X GET "https://YOUR-SITE.com/wp-json/bgm/v1/ai/me/profile" \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ -H "X-Player-Phone: 966500000000"
get_player_schedules
GET /wp-json/bgm/v1/ai/me/schedule
استرجاع المواعيد، الأيام، الفروع، واسم المدرب المسؤول
curl -X GET "https://YOUR-SITE.com/wp-json/bgm/v1/ai/me/schedule" \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ -H "X-Player-Phone: 966500000000"
get_player_memberships
GET /wp-json/bgm/v1/ai/me/memberships
توليد رابط renew_url لتسجيل الدخول وتعبئة السلة فوراً
curl -X GET "https://YOUR-SITE.com/wp-json/bgm/v1/ai/me/memberships" \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ -H "X-Player-Phone: 966500000000"
get_player_attendance
GET /wp-json/bgm/v1/ai/me/attendance
فحص حضور اليوم اللحظي وسجل آخر 12 حصة سابقة
curl -X GET "https://YOUR-SITE.com/wp-json/bgm/v1/ai/me/attendance?date=2026-07-27" \ -H "Authorization: Bearer YOUR_API_SECRET_KEY" \ -H "X-Player-Phone: 966500000000"
search_academy_products
GET /wp-json/bgm/v1/ai/products
البحث بالرياضة، الفرع، الجنس، والسن
curl -X GET "https://YOUR-SITE.com/wp-json/bgm/v1/ai/products?game=كرة%20القدم&branch=الشعلة&gender=male&age=8" \ -H "Authorization: Bearer YOUR_API_SECRET_KEY"
الحماية من التخمين ومهلة التهدئة
- جدار حماية ضد التخمين (Brute-Force IP Ban): حظر آلي لأي عنوان IP يجرب مفتاح سر خاطئ (5 محاولات خاطئة خلال 15 دقيقة = حظر 15 دقيقة) مع زر فك حظر يدوي فوري للمدير.
- نظام التهدئة لمنع حظر الواتساب (Anti-Spam Cooldown): تطبيق مهلة زمنية (3 دقائق) لمنع تكرار طلب الـ QR أو روابط التجديد باستمرار لتفادي حظر رقم الواتساب.
- عزل الحسابات (Zero-Trust Identity Isolation): البوابة تضمن مطابقة رقم الهاتف باللاعبين فقط وترفض مساعي الاستعلام عن بيانات حسابات أخرى.
نظام التجديد الذكي بنقرة واحدة (renew_url)
- تسجيل دخول تلقائي (Auto-Login): بنقر المشترك على الرابط في الواتساب، يتم تسجيل دخوله فوراً وبأمان بدون كلمة مرور.
- تحميل السلة التلقائي: تفريغ السلة القديمة وتعبئتها آلياً بنفس منتجات وعناصر اشتراكه وأيامه السابقة.
- توجيه مباشر لصفحة Checkout: يتم تحويل المشترك مباشرةً إلى صفحة إتمام الطلب والدفع لإنهاء التجديد في 10 ثوانٍ.
إجابات استفسارات المطورين
الأسئلة الشائعة حول الربط والتشغيل
كيف يتعرف الذكاء الاصطناعي على رقم العميل ليرسل له بياناته فقط؟
عند ورود الرسالة في الواتساب، يستخرج الـ Webhook رقم هاتف العميل ويمرره آلياً في الهيدر الخاص `X-Player-Phone`. تقوم البوابة في ووردبريس بمطابقة هذا الرقم مع بيانات المشترك في النظام وترجع فقط الأبناء والبيانات المترابطة مع هذا الرقم بشكل آمن تماماً.
ماذا يحدث لو حاول شخص تخمين مفتاح الأمان السرّي للـ API؟
النظام مزود بـ Brute-Force IP Ban. إذا تكرر إرسال مفتاح سر خاطئ 5 مرات متتالية من نفس عنوان الـ IP خلال 15 دقيقة، يقوم النظام بحظر هذا الـ IP فوراً وإظهار شارة حظر حمراء في لوحة تشخيص الأخطاء، مع إمكانية فك الحظر يدويًا من لوحة التحكم بنقرة زر.
هل يمكن تجربة الطلبات على Postman قبل البدء في n8n؟
نعم بالتأكيد! قمنا بتوفير أوامر cURL جاهزة ووثيقة شاملة في `docs/AI_API_GATEWAY_DOCS.md`. يمكنك نسخ أي أمر واستيراده مباشرةً في Postman (عبر Import -> Raw Text) وتمرير Bearer Token ورقم الهاتف في `X-Player-Phone`.
منظومة BGM AI REST API Gateway v1.6.0 | تم التطوير بنجاح لدعم ربط n8n والواتساب والذكاء الاصطناعي 💚