دليل
وحدة منتج WHMCS
تشرح هذه الصفحة كيفية إنشاء خادم ومنتج WHMCS المستخدمَين لبيع الخوادم المخصصة بواسطة وحدة الخادم srv_hetzner_dedicated. وهي موجّهة لمسؤولي WHMCS الذين يُعِدّون الفوترة لهذه العائلة، سواء استُوردت المنتجات تلقائياً أو أُعِدَّت يدوياً.
إضافة خادم WHMCS
- انتقل إلى Setup → Products/Services → Servers.
- انقر Add New Server.
- أدخل:
- Name — على سبيل المثال، "Hetzner Dedicated".
- Module — اختر Hetzner Dedicated Server.
- Username / Password — بيانات اعتماد Robot webservice الخاصة بك (راجع مستخدم Robot Webservice).
- انقر Test Connection للتحقق.
- احفظ الخادم.
Note
نقطة نهاية Robot API هي https://robot-ws.your-server.de وتُصادِق باستخدام HTTP Basic Auth، لذا ينجح Test Connection فقط عندما يكون اسم مستخدم وكلمة مرور الخدمة صحيحين وغير محظورين مؤقتاً بسبب حد المعدل.
إنشاء منتج خادم مخصص
- انتقل إلى Setup → Products/Services → Products/Services وأنشئ منتجاً جديداً (أو افتح منتجاً أُنشئ عبر الاستيراد).
- اضبط Module Name على Hetzner Dedicated Server.
- في تبويب Module Settings، عيّن الخادم الذي أُنشئ أعلاه وتأكّد من مجموعة الخوادم.
- اضبط Product Type على Dedicated/VPS Server ليعرض WHMCS الحقول المتعلقة بالخادم بشكل صحيح.
خيارات إعداد وحدة الخادم
| الخيار | الربط | ملاحظات |
|---|---|---|
| Product ID | معرّف منتج Robot | معرّف المنتج القياسي أو معرّف المزاد (السوق) |
| Location | مركز البيانات | إلزامي للطلبات القياسية؛ غير مستخدم للسوق |
| Order Type | standard أو market |
يُضبط تلقائياً عند إنشاء المنتج عبر الاستيراد |
التحكم في وصول المنتج
استخدم تبويب Module ACL / Product ACL للتحكم في إجراءات منطقة العميل وحقول الإدارة المكشوفة لهذا المنتج تحديداً، إضافة إلى الإعدادات الافتراضية على مستوى العائلة في الإعدادات.

الحقول المخصصة (تُنشأ تلقائياً)
| الحقل | الغرض |
|---|---|
serverID |
رقم خادم Robot النهائي، يُملأ بمجرد تهيئة الخادم |
robotTransactionID |
معرّف معاملة الطلب غير المتزامن، يُمسح بمجرد تحديد رقم الخادم |
تُنشأ هذه الحقول تلقائياً عند الاستيراد؛ وإذا كنت تبني منتجاً يدوياً، تأكّد من وجود كلا الحقلين في تبويب Custom Fields للمنتج.
تدفق التهيئة
- يطلب العميل منتج الخادم المخصص.
- تضع الوحدة طلب Robot (قياسي أو مزاد) — يُعيد Robot معرّف معاملة، لا رقم خادم.
- تستطلع عملية مطابقة الطلبات المعلّقة Robot، وعند التنفيذ، تملأ
serverID. - تصبح خدمة WHMCS Active بمجرد توفر رقم الخادم.
Warning
لأن التهيئة غير متزامنة، سيظهر منتج خادم مخصص مطلوب حديثاً كـ Pending في WHMCS لفترة من الوقت — هذا متوقع وليس عطلاً. راجع الطلبات المعلّقة.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| فشل Test Connection عند إضافة الخادم | تحقق من مستخدم الخدمة وكلمة المرور، وأن عنوان IP المصدر غير محظور حالياً — راجع مستخدم Robot Webservice |
| الطلب مُقدَّم لكن الخدمة تبقى Pending إلى أجل غير مسمى | راجع الطلبات المعلّقة وشغّل Run Dedicated Cron يدوياً |
serverID لا يُملأ أبداً |
تأكّد من وجود الحقل المخصص في المنتج وأن حساب Robot لديه تفعيل الطلب |
ذات صلة
- استيراد المنتجات القياسية والمزادات — ينشئ منتجات بخيارات إعداد صحيحة مضبوطة مسبقاً
- الطلبات المعلّقة