ماژول WHMCS

ماژول WHMCS مربوط به Domain Name API یک افزونه registrar است که نصب WHMCS شما را مستقیماً به زیرساخت ثبت دامنه و SSL در Domain Name API متصل می‌کند. پس از نصب، WHMCS ثبت دامنه، تمدید، انتقال، مدیریت DNS و به‌روزرسانی‌های WHOIS را به‌صورت خودکار از طرف مشتریان شما انجام می‌دهد — بدون اینکه شما یا تیمتان نیازی به هیچ کار دستی داشته باشید. صدور صورتحساب، پیگیری پرداخت‌ها و اعلان‌های تاریخ انقضا نیز به‌طور خودکار مدیریت می‌شوند.

این ماژول از بیش از 800 پسوند دامنه پشتیبانی می‌کند؛ از جمله همه gTLDهای اصلی مانند .com، .net و .org و همچنین ccTLDهای منطقه‌ای مانند .tr، .com.tr، .de، .uk، .us، .cn، .ru، .in و .ge. این ماژول با cPanel، Plesk، DirectAdmin، SolusVM و همه کنترل‌پنل‌های اصلی میزبانی سازگار است.

💡 ماژول WHMCS را می‌توانید پلی میان ویترین فروش خود و مرجع ثبت دامنه در نظر بگیرید. بدون آن، هر سفارش به پردازش دستی نیاز دارد؛ اما پس از نصب، کل کسب‌وکار دامنه شما روی حالت خودکار کار می‌کند. برای نمایندگانی که ترکیه و منطقه MENA را هدف گرفته‌اند، پشتیبانی داخلی از .tr و .com.tr همراه با تطبیق فیلدهای شماره ملی ترکیه (T.C. Kimlik No) و شماره مالیاتی، رعایت الزامات قانونی را از همان ابتدا آسان می‌کند.

نصب کمتر از 15 دقیقه طول می‌کشد. راهنمای گام‌به‌گام نصب در آدرس domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur و آموزش ویدیویی در آدرس youtube.com/watch?v=LEw_iMnquSo در دسترس است.

جدیدترین بسته ماژول را از آدرس github.com/domainreseller دانلود کنید.

فایل ZIP را باز کنید و پوشه modules را در دایرکتوری نصب WHMCS کپی کنید (مثلاً /home/whmcs/public_html). فایل‌های .gitignore، README.md و LICENSE را حذف نکنید.

در پنل مدیریت WHMCS به بخش System Settings > Domain Registrars بروید. اگر فایل‌ها در دایرکتوری درست قرار گرفته باشند، «Domain Name API» در فهرست نمایش داده می‌شود.

ماژول را فعال کنید و نام کاربری و رمز عبوری را که Domain Name API در اختیارتان گذاشته است وارد کنید. پس از ذخیره، موجودی حساب شما روی صفحه نمایش داده می‌شود.

اگر دامنه‌های .tr می‌فروشید، فیلدهای شماره ملی ترکیه (T.C. Kimlik No) و شماره مالیاتی را با فیلدهای سفارشی مشتری در WHMCS تطبیق دهید.

قیمت‌ها را به‌صورت دستی وارد کنید یا با ابزار Utilities > Registrar TLD Sync > DomainNameApi قیمت‌های لحظه‌ای را همراه با تنظیمات حاشیه سود به‌صورت گروهی وارد کنید.

از بخش System Settings > General Settings > Domains، ثبت دامنه، مجوزهای انتقال، سفارش‌های تمدید، تمدید خودکار هنگام پرداخت، همگام‌سازی دامنه و پشتیبانی از IDN را فعال کنید.

در بخش Automation Settings، گزینه‌های Domain Sync و Sync Next Due Date را فعال کنید.

مهم: اگر ماژول را به‌روزرسانی می‌کنید، پیش از بازنویسی فایل‌های فعلی ماژول از آن‌ها نسخه پشتیبان بگیرید.

💡 رایج‌ترین خطای نصب، بارگذاری فایل‌های ماژول در دایرکتوری اشتباه است — در این حالت WHMCS بدون هیچ پیام خطایی شکست می‌خورد. پس از نصب، مطمئن شوید که موجودی Domain Name API شما در صفحه پیکربندی registrar نمایش داده می‌شود. برای عیب‌یابی، از بخش Utilities > Logs > Module Log با فعال بودن debug logging استفاده کنید. در محیط عملیاتی (production)، debug logging را خاموش نگه دارید.

پیش‌نیازهای ماژول WHMCS مربوط به Domain Name API:

WHMCS نسخه 7.8 یا بالاتر (جدیدترین نسخه پایدار توصیه می‌شود)

PHP نسخه 7.4 یا بالاتر (PHP 8.1 توصیه می‌شود)

فعال بودن افزونه PHP SOAPClient روی سرور

فیلدهای سفارشی مشتری برای شماره ملی ترکیه (T.C. Kimlik No)، شماره مالیاتی و اداره مالیات — برای ثبت دامنه .tr الزامی است

💡 همیشه از جدیدترین نسخه پایدار WHMCS استفاده کنید؛ وصله‌های امنیتی به‌طور منظم منتشر می‌شوند. اگر به بازار ترکیه خدمات می‌دهید، فیلدهای شماره ملی ترکیه و شماره مالیاتی برای ثبت .tr یک الزام قانونی است. این فیلدها را پیش از داشتن مشتریان واقعی و در همان مرحله راه‌اندازی تعریف کنید.

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

💡 لایسنس مادام‌العمری که تا سال 2017 ارائه می‌شد، پایگاه کاربران WHMCS را بسیار پایدار کرد. کسب‌وکارهای تازه‌کاری که در 2025–2026 گزینه‌ها را بررسی می‌کنند، بهتر است هزینه ماهانه WHMCS را با WiseCP (رقابتی در بازار ترکیه و MENA) و Blesta (پرداخت یک‌باره و مالکیت قوی بر داده‌ها) مقایسه کنند. Domain Name API از هر سه پلتفرم با ماژول‌های اختصاصی خود پشتیبانی می‌کند.

جایگزین‌های WHMCS که به‌طور فعال توسعه داده می‌شوند و کاملاً با Domain Name API سازگارند:

Blesta — مناسب برای توسعه‌دهندگان، لایسنس یک‌باره، قابلیت بالای انتقال داده‌ها

HostBill — در سطح سازمانی، بیش از 150 یکپارچه‌سازی، ایدئال برای نمایندگان با حجم فروش بالا

WiseCP — رابط کاربری مدرن، با رشد سریع در ترکیه و منطقه MENA

ClientExec — مجموعه امکانات ساده‌تر، گزینه‌ای مقرون‌به‌صرفه برای شروع

HostFact — رایج در هلند و اروپای غربی

پلتفرم‌های قدیمی مانند AWBS، WHMAutoPilot، Lpanel، Modernbill و PerlBill دیگر به‌طور فعال توسعه داده نمی‌شوند و برای نصب‌های جدید توصیه نمی‌شوند.

💡 انتخاب پلتفرم باید بر اساس بازار هدف شما باشد. WHMCS مطمئن‌ترین انتخاب برای فعالیت‌های جهانی است. WiseCP جایگزینی است که به‌سرعت در میان نمایندگان بازار ترکیه برجسته شده و با ماژول اختصاصی WiseCP از Domain Name API به‌طور کامل پشتیبانی می‌شود. HostBill برای نمایندگان سازمانی که به بیش از 150 یکپارچه‌سازی نیاز دارند و Blesta برای اپراتورهایی که مالکیت کامل داده‌ها و هزینه یک‌باره می‌خواهند توصیه می‌شود.

WHMCS یک نرم‌افزار دارای لایسنس پولی است که بر اساس تعداد مشتریان فعال سطح‌بندی می‌شود و چهار پلن دارد: Starter، Plus، Business و Direct. صدور صورتحساب به‌صورت ماهانه انجام می‌شود. برای ارزیابی پلتفرم پیش از تعهد، یک دوره آزمایشی رایگان ارائه می‌شود.

Domain Name API بسته‌های نصب WHMCS Starter و Mega را ارائه می‌دهد که با نصب قالب و پیکربندی کامل ماژول تحویل داده می‌شوند. این بسته‌ها زمان و هزینه راه‌اندازی یک کسب‌وکار جدید نمایندگی دامنه را به‌طور چشمگیری کاهش می‌دهند.

💡 اگر تازه شروع کرده‌اید، پلن WHMCS Starter تا 250 مشتری فعال کافی است. بسته‌های آماده Domain Name API، 2 تا 3 روز زمان راه‌اندازی را که صرف نصب قالب و اتصال ماژول می‌شود حذف می‌کنند؛ می‌توانید ظرف چند ساعت یک ویترین فروش با برند خودتان راه‌اندازی کنید.

بله. می‌توانید هر زمان که بخواهید میان سطوح لایسنس WHMCS و بسته‌های نصب WHMCS از Domain Name API جابه‌جا شوید. تغییر از دوره صورتحساب بعدی اعمال می‌شود. ماژول WHMCS مربوط به Domain Name API با همه سطوح لایسنس WHMCS از جمله Starter، Plus، Business و Direct سازگار است.

💡 با WHMCS Starter شروع کنید. وقتی تعداد مشتریان شما از 250 گذشت، برای ثبت نامحدود مشتری و سرویس به Plus یا Business ارتقا دهید. بسته‌های Starter و Mega از Domain Name API برای کسانی که نمی‌خواهند همه‌چیز را از صفر پیکربندی کنند، یک محیط فروش آماده فراهم می‌کنند.

ماژول WHMCS مربوط به Domain Name API از بیش از 800 پسوند دامنه پشتیبانی می‌کند؛ از جمله همه gTLDهای اصلی مانند .com، .net، .org، .info و .biz و همچنین .tr، .com.tr، .de، .uk، .us، .cn، .ru، .in، .ge و بسیاری از ccTLDهای دیگر. ثبت دامنه‌های پریمیوم نیز برای مراجع ثبتی که قیمت‌گذاری پریمیوم ارائه می‌دهند پشتیبانی می‌شود.

💡 نمایندگانی که بازارهای جغرافیایی مشخصی را هدف گرفته‌اند، باید جدول‌های قیمت TLD خود را طوری تنظیم کنند که پسوندهای محلی در اولویت باشند. نمایندگان در ترکیه باید پسوندهای .tr و .com.tr را برجسته کنند — این پسوندها سیگنال اعتماد قوی در میان مشتریان محلی ایجاد می‌کنند و نرخ تبدیل را افزایش می‌دهند. جایگاه‌دهی محلی TLDها یکی از پربازده‌ترین تاکتیک‌ها (از نظر ROI) در کمپین‌های سئوی جغرافیامحور (GEO) است.

WHMCS به‌طور پیش‌فرض از طریق یک cron job خودکار که هر پنج دقیقه یک بار اجرا می‌شود، تاریخ انقضای دامنه‌ها را بررسی می‌کند. وقتی تاریخ انقضای یک دامنه نزدیک می‌شود، WHMCS به‌طور خودکار برای مشتری فاکتور تمدید صادر می‌کند، در فواصل قابل تنظیم (معمولاً 60، 30، 14 و 7 روز پیش از انقضا) اعلان انقضا می‌فرستد و اگر حساب مشتری موجودی کافی یا روش پرداخت معتبر داشته باشد، تمدید را خودکار انجام می‌دهد.

برای اینکه این فرایند درست کار کند، Domain Sync باید در بخش System Settings > General Settings > Domains فعال باشد؛ به این ترتیب WHMCS همیشه تاریخ‌های انقضای به‌روز را از Domain Name API دریافت می‌کند.

💡 یک توالی 4 ایمیلی در 60/30/14/7 روز پیش از انقضا، در مقایسه با یک یادآور منفرد، نرخ از دست رفتن دامنه را تا 60 درصد کاهش می‌دهد. گزینه Sync Next Due Date را نیز در بخش Automation Settings فعال کنید — ناهمخوانی تاریخ‌ها میان WHMCS و مرجع ثبت، یکی از رایج‌ترین دلایل از دست رفتن غیرمنتظره دامنه‌هاست.

قیمت دامنه را می‌توان برای هر TLD به‌صورت دستی وارد کرد یا با ابزار Registrar TLD Sync به‌طور خودکار وارد کرد. برای همگام‌سازی خودکار: به بخش Utilities > Registrar TLD Sync بروید، DomainNameApi را انتخاب کنید و منتظر بمانید تا مقایسه کامل شود. صفحه نتایج، حاشیه سود/زیان هر پسوند را نشان می‌دهد و امکان وارد کردن گروهی قیمت‌ها را فراهم می‌کند.

همچنین می‌توانید Domain Name API را به‌عنوان Lookup Provider تنظیم کنید (System Settings > Domain Pricing > Lookup Provider > Change > DomainNameApi). به این ترتیب، استعلام دسترس‌پذیری دامنه به‌جای سرورهای عمومی WHOIS، به‌صورت آنی از زیرساخت Domain Name API انجام می‌شود.

💡 همگام‌سازی خودکار قیمت یکی از کم‌استفاده‌ترین قابلیت‌های WHMCS است. اجرای ماهانه TLD Sync تضمین می‌کند که حتی پس از تغییر قیمت‌های تأمین‌کننده، قیمت‌های فروش شما بالاتر از بهای تمام‌شده باقی بماند. یک قاعده حاشیه سود ثابت (مثلاً بهای تمام‌شده + 25%) سودآوری را در بیش از 800 پسوند بدون نیاز به بررسی دستی حفظ می‌کند.

WHMCS برای تشخیص مشکلات یکپارچه‌سازی، یک سیستم داخلی ثبت لاگ ماژول ارائه می‌دهد. به بخش Utilities > Logs > Module Log بروید. اگر دکمه Enable Debug Logging نمایش داده می‌شود، با کلیک روی آن ثبت لاگ را فعال کنید. پس از فعال‌سازی، همه درخواست‌ها و پاسخ‌های میان WHMCS و Domain Name API ثبت می‌شوند. با کلیک روی تاریخ هر رکورد لاگ، می‌توانید جزئیات کامل درخواست، پاسخ و پاسخ فیلترشده را بررسی کنید.

مشکلات رایج:

بارگذاری فایل‌های ماژول در دایرکتوری اشتباه — WHMCS ماژول را بی‌صدا شناسایی نمی‌کند

اطلاعات ورود API نادرست — پس از ذخیره، موجودی نمایش داده نمی‌شود

غیرفعال بودن Domain Sync — تاریخ‌های انقضا قدیمی می‌شوند و تمدیدها بی‌صدا شکست می‌خورند

💡 پیش از تماس با تیم پشتیبانی، رکورد Module Log مربوط به عملیات ناموفق را تهیه کنید. بخش پاسخ فیلترشده دقیقاً خطایی را که Domain Name API برگردانده نشان می‌دهد؛ در بیشتر موارد مشکل خودبه‌خود روشن می‌شود. آماده داشتن این لاگ، روند حل مشکل را به‌طور چشمگیری کوتاه می‌کند. برای جلوگیری از تأثیر بر عملکرد، debug logging را در محیط عملیاتی خاموش نگه دارید.

انتقال دامنه‌ها به‌طور خودکار از طریق ماژول registrar پردازش می‌شود. وقتی مشتری یک انتقال ورودی را آغاز می‌کند، WHMCS درخواست انتقال را با استفاده از کد مجوز EPP که مشتری ارائه داده است به Domain Name API ارسال می‌کند. وضعیت انتقال و تاریخ‌های شروع/پایان آن به‌صورت آنی در پنل مدیریت قابل مشاهده است. مدیران همچنین می‌توانند درخواست لغو انتقال را مستقیماً از پنل مدیریت دامنه ثبت کنند.

💡 شکست انتقال‌ها بیشتر به دلیل کدهای EPP منقضی‌شده، قفل انتقال در سمت مرجع ثبت یا دوره قفل 60 روزه ICANN پس از آخرین ثبت رخ می‌دهد. در انتقال دامنه‌های .tr دقت ویژه‌ای داشته باشید: اطلاعات شماره ملی ترکیه و شماره مالیاتی در حساب مشتری گیرنده باید با سوابق نزد مرجع ثبت مطابقت داشته باشد؛ ناهمخوانی‌ها به رد بی‌صدای انتقال منجر می‌شوند که تشخیص آن بدون بررسی لاگ‌ها دشوار است.