راهنمای راه‌اندازی اتصال NiceNIC WHMCS

ادغام NiceNIC WHMCS به فروشندگان دامنه، ارائه‌دهندگان میزبانی، آژانس‌ها و پلتفرم‌های خدمات کمک می‌کند تا WHMCS را با NiceNIC برای فروش و مدیریت خودکار دامنه متصل کنند.

با ماژول ثبت‌کننده NiceNIC WHMCS، فروشندگان واجد شرایط می‌توانند از بررسی در دسترس بودن دامنه، ثبت، تمدید، انتقال، بازیابی اطلاعات دامنه، مدیریت نام‌سرورها، به‌روزرسانی مخاطبین، قفل یا بازکردن دامنه، بازیابی کد EPP/Auth و سایر فرآیندهای پشتیبانی شده فروشندگان پشتیبانی کنند.

برای راه‌اندازی اتصال NiceNIC WHMCS باید:

• یک فروشنده NiceNIC شوید.
• تنظیمات API NiceNIC خود را پیکربندی کنید.
• ماژول ثبت‌کننده NiceNIC WHMCS را دانلود کنید.
• ماژول را در دایرکتوری ماژول ثبت‌کننده WHMCS خود بارگذاری کنید.
• ماژول ثبت‌کننده NiceNIC را در WHMCS فعال کنید.
• اعتبارنامه‌های API NiceNIC خود را وارد کنید.
• آدرس IP خروجی سرور WHMCS را در لیست سفید قرار دهید.
• قبل از فعال‌کردن سفارش‌های زنده، قابلیت دسترسی دامنه و سایر عملیات کم‌ریسک را آزمایش کنید.

راه‌اندازی دقیق به نسخه WHMCS شما، محیط PHP/cURL، اعتبارنامه‌های API، آدرس IP خروجی سرور، وضعیت حساب فروشنده، تنظیمات TLD و قوانین رجیستری بستگی دارد.

لینک‌های اصلی:
اتصال WHMCS
فروشنده شوید
پیکربندی API
مستندات API نسخه ۲


چه کسانی باید از این اتصال استفاده کنند؟

• اتصال NiceNIC WHMCS مناسب موارد زیر است:
• فروشندگان دامنه که دامنه‌ها را زیر برند خود می‌فروشند
• ارائه‌دهندگان میزبانی که دامنه‌ها را با پلن‌های میزبانی ترکیب می‌کنند
• آژانس‌های وب که دامنه‌های مشتریان را مدیریت می‌کنند
• شرکت‌های خدمات فناوری اطلاعات که تمدیدهای دوره‌ای دامنه را مدیریت می‌کنند
• کاربران WHMCS که می‌خواهند اتوماسیون ثبت‌کننده را داشته باشند
• کسب‌وکارهایی که نیاز به فرآیندهای تکرارپذیر ثبت، تمدید، انتقال و مدیریت دامنه دارند

اگر فقط گاهی به صورت دستی دامنه ثبت می‌کنید، پنل کنترل NiceNIC ممکن است کافی باشد. اگر می‌خواهید WHMCS سفارش‌های دامنه، تمدیدها، انتقال‌ها و فرآیندهای مشتری‌محور را مدیریت کند، اتصال WHMCS گزینه بهتری است.


کارهایی که با اتصال NiceNIC WHMCS می‌توانید انجام دهید
بسته به وضعیت حساب فروشنده، پیکربندی WHMCS، اعتبارنامه‌های API، پسوند دامنه، وضعیت دامنه، قوانین رجیستری و پشتیبانی ماژول، فرآیندهای WHMCS ممکن است شامل:
بررسی در دسترس بودن دامنه
ثبت دامنه
تمدید دامنه
انتقال دامنه
بازیابی اطلاعات دامنه
مدیریت نام‌سرورها
به‌روزرسانی اطلاعات تماس
قفل و بازکردن دامنه
دریافت کد EPP/Auth
تأمین خودکار
فرآیندهای تمدید خودکار
ثبت وقایع WHMCS و پاسخ‌های API برای عیب‌یابی

هر TLD به یک شکل کار نمی‌کند. برخی پسوندهای دامنه ممکن است نیاز به فیلدهای تماس ویژه، اسناد، حضور محلی، بررسی صلاحیت یا بازبینی رجیستری داشته باشند. قبل از فعال‌سازی برای سفارش‌های مشتری، هر فرآیند TLD را آزمایش کنید.

به صفحه رسمی WHMCS نیاز دارید؟
از صفحه رسمی اتصال NiceNIC WHMCS برای مرور دانلود ماژول‌ها، عملیات پشتیبانی شده، الزامات فنی و اطلاعات راه‌اندازی فروشنده استفاده کنید.


قبل از شروع

• قبل از نصب موارد زیر را آماده کنید:
• یک حساب NiceNIC در سطح فروشنده واجد شرایط
• دسترسی به تنظیمات API NiceNIC
• نام کاربری و رمز عبور API NiceNIC شما
• یک رمز عبور API جداگانه، متفاوت از رمز عبور ورود به حساب NiceNIC شما
• آدرس IP عمومی خروجی سرور WHMCS شما
• WHMCS نسخه ۷.۰ یا بالاتر
• PHP نسخه ۷.۰ یا بالاتر با افزونه cURL
• پشتیبانی SSL/TLS
• دسترسی مدیریت به WHMCS
• دسترسی به بارگذاری فایل‌ها در دایرکتوری نصب WHMCS
• یک فرآیند آزمایشی قبل از قبول سفارش‌های زنده مشتری

با ثبت‌نام‌ها یا انتقال‌های زنده شروع نکنید. ابتدا تأیید کنید ماژول به درستی نصب شده است، اعتبارنامه‌ها معتبر هستند، آدرس IP خروجی WHMCS در لیست سفید قرار دارد و عملیات کم‌ریسک کار می‌کند.


مرحله ۱: تبدیل شدن به فروشنده NiceNIC
اتصال WHMCS برای فرآیندهای فروشنده طراحی شده است. اگر حساب NiceNIC شما هنوز فروشنده نیست، ابتدا برنامه فروشنده را مرور کنید.
حساب فروشنده به شما کمک می‌کند:
دامنه‌ها را به مشتریان خود بفروشید
به قیمت‌گذاری سطح فروشنده دسترسی پیدا کنید
عملیات دامنه را از طریق API یا WHMCS خودکار کنید
مدیریت دامنه‌های بیشتر از یک حساب واحد
درآمد مکرر از ثبت، انتقال و خدمات تمدید دامنه بسازید

مرحله ۲: پیکربندی تنظیمات API NiceNIC
WHMCS به اعتبارنامه‌های API معتبر NiceNIC نیاز دارد.
در حساب NiceNIC خود به بخش فروشنده بروید و تنظیمات API را باز کنید. تنظیم کنید:

• رمز عبور API
• آدرس IP مجاز برای دسترسی به API

رمز عبور API شما باید متفاوت از رمز عبور ورود به حساب NiceNIC باشد. استفاده از رمز عبور ورود به عنوان رمز عبور API ممکن است باعث شکست احراز هویت شود.
شما همچنین باید آدرس IP واقعی خروجی سرور WHMCS خود را در لیست سفید قرار دهید. این ممکن است با IP وبسایت شما، IP مشترک cPanel، IP CDN یا IP نمایش داده شده در پنل میزبانی شما متفاوت باشد.

مرحله ۳: تایید اصول اتصال API نسخه ۲
API نسخه ۲ NiceNIC از درخواست‌های HTTP استفاده می‌کند و پاسخ‌های JSON می‌دهد.
نقطه پایانی:
https://api.NiceNIC/v2/

هدرهای مورد نیاز:
Host: api.NiceNIC
Authیاization: username
Content-نوع: application/json

ممکن است WHMCS بخشی از این اتصال را به صورت خودکار مدیریت کند، اما سرور شما هنوز نیاز به cURL فعال، پشتیبانی SSL/TLS، اعتبارنامه‌های صحیح و دسترسی خروجی مجاز دارد.


مرحله ۴: دانلود و بارگذاری ماژول WHMCS
ماژول ثبت‌کننده NiceNIC WHMCS را از: اتصال WHMCS
قبل از بارگذاری، نسخه WHMCS، نسخه PHP، پشتیبانی cURL و اینکه نصب در محیط تست یا تولید انجام می‌شود را تأیید کنید.
مشکلات رایج بارگذاری شامل:

• دایرکتوری اشتباه
• فولدر اضافی بعد از استخراج
• مشکلات مجوز فایل
• نسخه اشتباه ماژول
• فایل‌های ماژول قدیمی که با فایل‌های جدید تداخل دارند

مرحله ۵: فعال‌سازی NiceNIC در WHMCS
وارد پنل مدیریت WHMCS خود شوید.
برو به: راه‌اندازی -- محصولات/خدمات -- ثبت‌کننده‌های دامنه
NiceNIC را پیدا کنید و روی فعال‌سازی کلیک کنید.
اگر NiceNIC در لیست ثبت‌کننده‌ها ظاهر نشد، بررسی کنید که فایل‌های ماژول در دایرکتوری صحیح باشند، نام پوشه درست باشد، WHMCS قادر به خواندن فایل‌ها باشد و محیط WHMCS/PHP شما سازگار باشد.

مرحله ۶: وارد کردن اعتبارنامه API در WHMCS
بعد از فعال‌سازی، ماژول ثبت‌کننده NiceNIC را در WHMCS پیکربندی کنید.
ممکن است نیاز باشد وارد کنید:
نام کاربری: نام کاربری API NiceNIC شما
رمز عبور API: رمز عبور API NiceNIC شما
حالت آزمایش: فقط زمانی فعال شود که قصد آزمایش دارید
رمز عبور API باید رمز عبور API شما باشد، نه رمز عبور ورود به حساب NiceNIC.
قبل از استفاده زنده، تأیید کنید حالت آزمایش باید فعال یا غیرفعال باشد. روشن ماندن حالت آزمایش هنگام انتظار سفارش‌های زنده ممکن است عملیات واقعی دامنه را متوقف کند.

مرحله ۷: پیکربندی قیمت‌گذاری TLD و تنظیمات دامنه
پس از اتصال ماژول، قیمت‌گذاری دامنه و تنظیمات TLD خود را در WHMCS مرور کنید.
برای هر TLD که می‌خواهید بفروشید، بررسی کنید:
قیمت ثبت‌نام
قیمت تمدید
قیمت انتقال
گزینه‌های دوره ثبت‌نام
آیا انتقال پشتیبانی می‌شود
آیا نیازمندی‌های ویژه رجیستری وجود دارد
آیا داده‌های تماس مشتری کافی است

بعضی ccTLD‌ها و پسوندهای محدود ممکن است داده‌های اضافی، اسناد، حضور محلی یا بازبینی دستی لازم داشته باشند. فرض نکنید هر پسوند مانند .com کار می‌کند.


مرحله ۸: آزمایش قبل از فعال‌سازی زنده
با آزمایش‌های کم‌ریسک شروع کنید:
بررسی در دسترس بودن دامنه
بازبینی قیمت دامنه
دریافت اطلاعات دامنه، در صورت امکان
به‌روزرسانی نام‌سرور روی دامنه آزمایشی داخلی امن

با دامنه‌های مشتری مهم شروع نکنید. تا زمانی که اعتبارنامه‌ها، تنظیم ماژول، IP خروجی، تنظیمات TLD، موجودی حساب و واکنش‌ها تأیید نشده‌اند، از عملیات پرداخت زنده خودداری کنید.

قبل از فعال‌کردن ثبت، تمدید و انتقال زنده، تأیید کنید:

• حساب فروشنده NiceNIC فعال است
• موجودی حساب NiceNIC کافی است
• تنظیمات ماژول WHMCS به درستی ذخیره شده‌اند
• حالت آزمایش به درستی تنظیم شده است
• قیمت‌گذاری TLD صحیح است
• فیلدهای تماس مشتری کامل است
• کرون WHMCS در حال اجرا است
• تیم شما می‌داند چگونه لاگ‌های WHMCS و پاسخ‌های API NiceNIC را بررسی کند
• اولین سفارش‌های زنده را به‌صورت دستی مانیتور کنید.

مشکلات رایج راه‌اندازی
1. NiceNIC در WHMCS نمایش داده نمی‌شود
بررسی کنید:

• ماژول در مسیر /modules/registrars/nicenic بارگذاری شده است
• ماژول در یک پوشه اضافی قرار ندارد
• دسترسی فایل‌ها اجازه می‌دهد WHMCS فایل‌ها را بخواند
• نسخه ماژول با محیط WHMCS شما سازگار است
• خطاهای PHP ماژول را مسدود نمی‌کنند

2. احراز هویت ناموفق است
علل رایج شامل:
نام کاربری API اشتباه
استفاده از رمز عبور ورود NiceNIC به جای رمز عبور API
رمز عبور API نادرست
دسترسی فروشنده وجود ندارد
آدرس IP خروجی WHMCS در لیست سفید نیست
WHMCS درخواست‌ها را از IP غیرمنتظره ارسال می‌کند

3. بررسی در دسترس بودن دامنه کار می‌کند اما ثبت‌نام شکست می‌خورد
دلایل ممکن شامل:
موجودی ناکافی در NiceNIC
داده‌های تماس مشتری ناقص یا نامعتبر
نیازمندی‌های ویژه رجیستری TLD
دوره ثبت‌نام پشتیبانی نشده
دامنه قبل از تکمیل ثبت‌نام غیرقابل دسترس می‌شود
انطباق نداشتن قیمت‌گذاری یا تنظیمات خودکار WHMCS

4. خودکارسازی تمدید کار نمی‌کند
بررسی کنید:
کرون WHMCS
صورتحساب مشتری و وضعیت پرداخت
موجودی NiceNIC
صلاحیت تمدید دامنه
قوانین تمدید TLD
تنظیمات اتوماسیون WHMCS

5. سفارش‌های انتقال شکست می‌خورند یا در حالت انتظار می‌مانند
بررسی کنید:
دامنه در ثبت‌کننده فعلی باز است
کد EPP/Auth صحیح است
دامنه برای انتقال واجد شرایط است
تأیید ثبت‌کننده انجام شده است اگر لازم باشد {{T423}}دامنه به دلیل انقضا، سیاست یا وضعیت رجیستری مسدود نیست{{/T423}}{{G424}} {{T425}}TLD فرآیند انتقال مورد نظر را پشتیبانی می‌کند{{/T425}}{{G426}}

کارهایی که NiceNIC می‌تواند انجام دهد و نمی‌تواند انجام دهد
NiceNIC می‌تواند به بررسی دسترسی فروشنده در سمت ثبت‌کننده، پیکربندی API، منابع اتصال WHMCS، پاسخ‌های API و مسائل مربوط به حساب یا عملیات دامنه در سمت NiceNIC کمک کند.
برخی مشکلات ممکن است به نسخه WHMCS، محیط میزبانی، پیکربندی PHP/cURL، مجوزهای فایل، تنظیمات کرون، نصب ماژول، آدرس IP خروجی سرور، داده‌های مشتری، تنظیمات TLD، موجودی حساب، وضعیت دامنه یا قوانین رجیستری بستگی داشته باشند.
برای عیب‌یابی سریع‌تر، لاگ‌های WHMCS و پاسخ‌های API را ذخیره کنید. پیغام کلی مانند «WHMCS کار نمی‌کند» معمولاً برای شناسایی علت کافی نیست.


چک‌لیست امنیتی برای فروشندگان WHMCS
از رمز عبور اختصاصی API استفاده کنید.
رمز عبور ورود NiceNIC خود را به عنوان رمز عبور API استفاده نکنید.
فقط آدرس‌های IP سرور WHMCS مورد اعتماد را در لیست سفید قرار دهید.
اطلاعات اعتبار API را در قالب‌های فرانت‌اند یا کد سمت مشتری افشا نکنید.
اطلاعات اعتبار API را در مخازن عمومی ذخیره نکنید.
دسترسی مدیریت WHMCS را محدود به کارکنان مورد اعتماد کنید.
WHMCS، PHP، ماژول‌ها و نرم‌افزار سرور را به‌روز نگه دارید.
برای بخش مدیریت و مشتری WHMCS از HTTPS استفاده کنید.
به طور منظم فعالیت‌های WHMCS و لاگ‌های ماژول را بررسی کنید.
پس از تغییر توسعه‌دهنده، فروشنده یا کارکنان، اعتبارنامه‌های API را تغییر دهید.


سوالات متداول
اتصال NiceNIC WHMCS چیست؟
اتصال NiceNIC WHMCS به فروشندگان واجد شرایط NiceNIC اجازه می‌دهد WHMCS را با NiceNIC برای بررسی در دسترس بودن دامنه، ثبت، تمدید، انتقال، مدیریت نام‌سرورها، به‌روزرسانی مخاطبین و سایر عملیات پشتیبانی شده فروشندگان دامنه متصل کنند.

آیا به حساب فروشنده NiceNIC نیاز دارم؟
بله. اتصال WHMCS برای فرآیندهای فروشنده طراحی شده است. باید حساب NiceNIC خود را به سطح فروشنده ارتقا دهید و دسترسی API را قبل از راه‌اندازی WHMCS پیکربندی کنید.

الزامات فنی چیست؟
الزامات اتصال NiceNIC WHMCS فعلی شامل WHMCS نسخه ۷.۰ یا بالاتر، PHP نسخه ۷.۰ یا بالاتر با افزونه cURL، اعتبارنامه‌های API معتبر NiceNIC و پشتیبانی SSL/TLS است.

کجا ماژول NiceNIC WHMCS را دانلود کنم؟
آن را از صفحه رسمی اتصال NiceNIC WHMCS دانلود کنید:

چرا احراز هویت WHMCS شکست می‌خورد؟
علل رایج شامل اعتبارنامه‌های اشتباه API، استفاده از رمز عبور ورود به جای رمز عبور API، عدم دسترسی فروشنده، عدم لیست سفید بودن IP خروجی WHMCS یا ارسال درخواست‌ها از IP غیرمنتظره توسط WHMCS است.

چرا بررسی در دسترس بودن دامنه کار می‌کند اما ثبت نام شکست می‌خورد؟
ثبت نام معمولاً به داده‌های بیشتری نسبت به بررسی در دسترس بودن نیاز دارد. ممکن است به دلیل موجودی ناکافی، داده تماس نامعتبر، فیلدهای ناقص، نیازمندی‌های ویژه TLD، دوره‌های ثبت‌نام پشتیبانی نشده یا تغییر در دسترس بودن دامنه قبل از تکمیل ثبت نام شکست بخورد.

آیا WHMCS می‌تواند تمدیدها را با NiceNIC خودکار کند؟
اتصال NiceNIC WHMCS از فرآیندهای تمدید پشتیبانی می‌کند، اما موفقیت به تنظیمات WHMCS، کرون، وضعیت پرداخت مشتری، موجودی حساب NiceNIC، وضعیت دامنه، قوانین TLD و پیکربندی ماژول بستگی دارد.

اگر راه‌اندازی شکست خورد، چه اطلاعاتی باید به پشتیبانی ارسال کنم؟
شناسه حساب فروشنده، نسخه WHMCS، نسخه PHP، عملیات انجام شده، نام دامنه، زمان‌ثبت، لاگ ماژول WHMCS، کد/پیغام پاسخ API در صورت موجود بودن و IP خروجی سرور WHMCS را ارسال کنید. رمزهای عبور کامل یا اطلاعات خصوصی سرور را ارسال نکنید.


نتیجه‌گیری
فروش دامنه‌ها را با اتصال NiceNIC WHMCS آغاز کنید!
اتصال NiceNIC WHMCS به فروشندگان دامنه، ارائه‌دهندگان میزبانی و آژانس‌ها کمک می‌کند تا WHMCS را با خودکارسازی دامنه در سمت ثبت‌کننده برای بررسی در دسترس بودن، ثبت، تمدید، انتقال، مدیریت نام‌سرورها، به‌روزرسانی مخاطبین و فرآیندهای فروشنده متصل کنند.

راه‌اندازی اتصال WHMCS
فروشنده NiceNIC شوید
مشاهده مستندات API نسخه ۲
ارسال تیکت