تخطّ إلى المحتوى

دليل

وحدة منتج WHMCS

دليل 3 دقائق قراءة

تشرح هذه الصفحة كيفية إنشاء خادم ومنتج WHMCS المستخدمَين لبيع الخوادم المخصصة بواسطة وحدة الخادم srv_hetzner_dedicated. وهي موجّهة لمسؤولي WHMCS الذين يُعِدّون الفوترة لهذه العائلة، سواء استُوردت المنتجات تلقائياً أو أُعِدَّت يدوياً.

إضافة خادم WHMCS

  1. انتقل إلى Setup → Products/Services → Servers.
  2. انقر Add New Server.
  3. أدخل:
    • Name — على سبيل المثال، "Hetzner Dedicated".
    • Module — اختر Hetzner Dedicated Server.
    • Username / Password — بيانات اعتماد Robot webservice الخاصة بك (راجع مستخدم Robot Webservice).
  4. انقر Test Connection للتحقق.
  5. احفظ الخادم.

Note

نقطة نهاية Robot API هي https://robot-ws.your-server.de وتُصادِق باستخدام HTTP Basic Auth، لذا ينجح Test Connection فقط عندما يكون اسم مستخدم وكلمة مرور الخدمة صحيحين وغير محظورين مؤقتاً بسبب حد المعدل.

إنشاء منتج خادم مخصص

  1. انتقل إلى Setup → Products/Services → Products/Services وأنشئ منتجاً جديداً (أو افتح منتجاً أُنشئ عبر الاستيراد).
  2. اضبط Module Name على Hetzner Dedicated Server.
  3. في تبويب Module Settings، عيّن الخادم الذي أُنشئ أعلاه وتأكّد من مجموعة الخوادم.
  4. اضبط Product Type على Dedicated/VPS Server ليعرض WHMCS الحقول المتعلقة بالخادم بشكل صحيح.

خيارات إعداد وحدة الخادم

الخيار الربط ملاحظات
Product ID معرّف منتج Robot معرّف المنتج القياسي أو معرّف المزاد (السوق)
Location مركز البيانات إلزامي للطلبات القياسية؛ غير مستخدم للسوق
Order Type standard أو market يُضبط تلقائياً عند إنشاء المنتج عبر الاستيراد

التحكم في وصول المنتج

استخدم تبويب Module ACL / Product ACL للتحكم في إجراءات منطقة العميل وحقول الإدارة المكشوفة لهذا المنتج تحديداً، إضافة إلى الإعدادات الافتراضية على مستوى العائلة في الإعدادات.

التحكم في وصول المنتج

الحقول المخصصة (تُنشأ تلقائياً)

الحقل الغرض
serverID رقم خادم Robot النهائي، يُملأ بمجرد تهيئة الخادم
robotTransactionID معرّف معاملة الطلب غير المتزامن، يُمسح بمجرد تحديد رقم الخادم

تُنشأ هذه الحقول تلقائياً عند الاستيراد؛ وإذا كنت تبني منتجاً يدوياً، تأكّد من وجود كلا الحقلين في تبويب Custom Fields للمنتج.

تدفق التهيئة

  1. يطلب العميل منتج الخادم المخصص.
  2. تضع الوحدة طلب Robot (قياسي أو مزاد) — يُعيد Robot معرّف معاملة، لا رقم خادم.
  3. تستطلع عملية مطابقة الطلبات المعلّقة Robot، وعند التنفيذ، تملأ serverID.
  4. تصبح خدمة WHMCS Active بمجرد توفر رقم الخادم.

Warning

لأن التهيئة غير متزامنة، سيظهر منتج خادم مخصص مطلوب حديثاً كـ Pending في WHMCS لفترة من الوقت — هذا متوقع وليس عطلاً. راجع الطلبات المعلّقة.

استكشاف الأخطاء وإصلاحها

المشكلة الحل
فشل Test Connection عند إضافة الخادم تحقق من مستخدم الخدمة وكلمة المرور، وأن عنوان IP المصدر غير محظور حالياً — راجع مستخدم Robot Webservice
الطلب مُقدَّم لكن الخدمة تبقى Pending إلى أجل غير مسمى راجع الطلبات المعلّقة وشغّل Run Dedicated Cron يدوياً
serverID لا يُملأ أبداً تأكّد من وجود الحقل المخصص في المنتج وأن حساب Robot لديه تفعيل الطلب

ذات صلة