قبل أن تبدأ تحتاج ثلاثة أشياء منّا: ملف الوحدة BBReseller-client.zip، واسم المستخدم، ومفتاح الواجهة. والمفتاح يُعرض مرة واحدة عند إصداره — إن ضاع أصدرنا غيره، ويتوقف القديم في اللحظة نفسها.
١. تركيب الوحدة
فُكّ الملف المضغوط في جذر WHMCS. يحوي مجلداً واحداً هو modules/servers/BBReseller ولا يمسّ شيئاً غيره. ولا يوجد ما يُفعَّل: WHMCS يكتشف وحدات التزويد من نظام الملفات.
٢. إضافة الخادم
اذهب إلى System Settings ← Products/Services ← Servers واختر Add New Server:
- Name — ما شئت، مثل
BIGBANG - Hostname — رابط نقطة النهاية كاملاً لا النطاق وحده:
https://portal.its.ae/modules/addons/BBReseller/api/index.php - Type —
BIGBANG Reseller - Username — اسم المستخدم الذي أعطيناك إيّاه
- Access Hash — مفتاح الواجهة
اترك Secure والمنفذ وخوادم الأسماء وحقول عنوان الحالة كما هي، فلا تنطبق هنا. ومعظم وحدات الخوادم في WHMCS تريد اسم نطاق مجرّداً، أمّا هذه فتريد الرابط كاملاً لأنها تخاطب سكربتاً واحداً عبر HTTP لا لوحة تحكّم على منفذ.
٣. فحص الاتصال
اضغط Test Connection. نجاحه يعني أن ثلاثة أمور منفصلة استقامت معاً: نقطة النهاية قابلة للوصول، ومفتاحك صالح، وساعة خادمك متّفقة مع ساعتنا.
والردّ يحمل كذلك كتلة readiness، ويجب أن تكون قيمها الأربع موجبة أو true. وإن لم تكن، فالاتصال سليم لكنّ الطلبات سترفض — وذلك من جهتنا، فأرسل لنا الردّ.
٤. ربط منتج
أنشئ منتجاً أو حرّر منتجاً قائماً، وافتح تبويب Module Settings، واضبط الوحدة على BIGBANG Reseller ومجموعة الخوادم على الخادم الذي أضفته، ثم:
- BIGBANG plan code — رمز الباقة من كتالوجك. انظر مقالة رموز الباقات والتسعير والفوترة.
- Order on cycle — الدورة التي نفوترك أنت عليها، وهي مستقلّة عمّا تفوتر به زبونك.
٥. طلب تجريبي
اطلب المنتج لعميل تجريبي ودعه يُزوَّد. عند النجاح تسجّل الوحدة معرّف الخدمة عندنا مقابل خدمتك المحلية، وتستعمله كل عملية لاحقة. وتراه في تبويب الوحدة على سطر BIGBANG service مع الحالة الحيّة مقروءة من جهتنا.
ثم جرّب الباقي: الإيقاف، وإعادة التشغيل، وتغيير الباقة، والإنهاء. الأربع يجب أن تكتمل بلا خطوة يدوية عند أيّ من الطرفين.
لا تُدخل خدمات يدوياً. أي خدمة أُنشئت خارج الوحدة لا معرّف لها عندنا، وسترفض عمليات الإيقاف والترقية والإنهاء أن تعمل عليها بدل المخاطرة بالتصرّف في حساب خاطئ. راسلنا ونربطها لك.