ماژول GeoMailer برای WHMCS؛ مسیریابی ایمیل با چند SMTP

26 آبان 1405

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

داشبورد ماژول GeoMailer
داشبورد ماژول GeoMailer

GeoMailer چه کاری انجام می‌دهد؟

GeoMailer در WHMCS به‌عنوان Mail Provider انتخاب می‌شود. ایمیل‌هایی مانند صورتحساب، پاسخ تیکت و یادآوری تمدید پیش از ارسال از مسیر تنظیم‌شده عبور می‌کنند. منطق تشخیص مقصد در حالت مبتنی بر موقعیت میل‌سرور، به این ترتیب است:

  1. رکورد MX دامنه گیرنده خوانده می‌شود (مثلاً chmail.ir یا gmail.com).
  2. IP میل‌سرور گیرنده با رنج‌های رسمی RIPE مقایسه و کشور آن مشخص می‌شود.
  3. اگر میل‌سرور در ایران باشد، ایمیل از SMTP ایران و در غیر این صورت از SMTP خارج ارسال می‌شود.

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

امکانات کامل ماژول

۱. مسیریابی هوشمند بر اساس کشور میل‌سرور

  • تشخیص کشور از روی MX و IP میل‌سرور گیرنده، نه فقط پسوند دامنه؛ دامنه‌های .com که میل‌سرورشان در ایران است هم درست شناسایی می‌شوند.
  • بارگذاری خودکار رنج‌های IP ایران از RIPE و به‌روزرسانی دوره‌ای با Cron.
  • کش MX دامنه‌ها و کشور IPها برای سرعت بالا و کاهش درخواست‌های DNS.
  • تعریف قانون بر اساس دامنه یا MX، برای انتخاب صریح مسیر برخی مقصدها؛ تقدم قوانین را با ابزار تست مسیر بررسی کنید.
  • ابزار تست مسیر: یک ایمیل وارد کنید و ببینید از کدام SMTP و به چه دلیل ارسال می‌شود.
قوانین مسیر ایمیل
قوانین مسیر ایمیل

۲. چند SMTP با کشور، اولویت و سقف ارسال

  • تعریف هر تعداد SMTP (مثلاً cPanel ایران و cPanel خارج) با همان اطلاعاتی که در تنظیمات SMTP خود WHMCS وارد می‌کنید.
  • تعیین کشورهای هر SMTP و یک SMTP پیش‌فرض برای بقیه مقصدها.
  • تعیین سقف ساعتی مطابق ظرفیت و محدودیت SMTP؛ این تنظیم به‌تنهایی مانع همهٔ محدودیت‌های گیرنده نمی‌شود.
  • SMTP جایگزین: اگر یک سرور خطا بدهد، تلاش بعدی خودکار از SMTP دیگر انجام می‌شود.
  • دکمه «تست اتصال» و «ایمیل آزمایشی» برای هر SMTP.
  • ارسال با کلاس SMTP خود WHMCS؛ یعنی پیوست‌ها (PDF فاکتور)، هدر و فوتر و استایل ایمیل‌ها دقیقاً مثل قبل حفظ می‌شود.
تعریف SMTP ایران و خارج
تعریف SMTP ایران و خارج

۳. صف ارسال، تلاش مجدد و پایداری

  • دو حالت ارسال: صف (WHMCS منتظر SMTP نمی‌ماند و صفحات کند نمی‌شوند) یا فوری با برگشت به صف در صورت خطا.
  • تلاش مجدد زمان‌بندی‌شده با فاصله‌های قابل تنظیم (مثلاً ۵، ۱۵، ۶۰، ۱۸۰ و ۷۲۰ دقیقه).
  • تعیین تعداد ارسال در هر اجرا و حداکثر تعداد تلاش.
  • اجرا با Cron اختصاصی هر دقیقه، یا اگر Cron جدا تنظیم نکنید، همراه Cron خود WHMCS.
  • محافظت در برابر گیر کردن: اگر سرور SMTP پاسخ ندهد، ارسال بعد از مهلت کوتاه قطع می‌شود و اجرای گیرکرده بعدی به‌صورت خودکار آزاد می‌شود.
  • پیام‌های نیازمند تلاش مجدد در صف نگهداری می‌شوند؛ نتیجه به اجرای Cron، دسترسی SMTP و محدودیت تعداد تلاش وابسته است.

۴. گزارش کامل ارسال و تحویل

  • صف و گزارش با جستجو بر اساس ایمیل، موضوع یا شناسه و فیلتر بر اساس وضعیت، نتیجه تحویل و SMTP.
  • نمایش SMTP و کشور مسیر هر ایمیل و دلیل انتخاب آن مسیر.
  • نتیجه ارسال هر گیرنده: تحویل به SMTP، رد شده توسط سرور با پیام خطای دقیق آن، در انتظار ارسال یا ارسال‌شده داخل ایمیل تجمیعی.
  • پیگیری باز شدن ایمیل (تعداد و زمان اولین باز شدن).
  • خط زمانی رویدادهای هر ایمیل: ثبت، مسیریابی، تلاش‌ها، خطاها و ارسال.
  • نمایش دلیل دقیق رد شدن ایمیل توسط سرور (مثلاً ۵۵۰ Message rejected as spam) به جای خطای کلی «data not accepted».
  • ارسال مجدد یک ایمیل یا ارسال دوباره همه ایمیل‌های ناموفق ۷ روز اخیر با یک کلیک.
  • داشبورد با آمار ۲۴ ساعت اخیر و چک‌لیست وضعیت راه‌اندازی.
صف و گزارش ارسال ایمیل‌ها
صف و گزارش ارسال ایمیل‌ها
جزئیات و رویدادهای یک ایمیل
جزئیات و رویدادهای یک ایمیل

۵. ایمیل تجمیعی کرون (Digest)

برای مشتری دارای چند سرویس، اجرای Cron ممکن است چندین پیام مشابه تولید کند. قابلیت Digest، پیام‌های یک قالب برای یک مشتری را در بازهٔ پردازش جمع می‌کند و در یک ایمیل فهرست‌وار نمایش می‌دهد. انتخاب قالب‌های قابل تجمیع در اختیار مدیر است؛ پیام‌های امنیتی را با اعلان‌های دوره‌ای یکسان در نظر نگیرید.

  • ۱۰ صورتحساب جدید ← یک ایمیل با جدول ۱۰ صورتحساب (شماره، مبلغ، سررسید و لینک پرداخت).
  • ۱۰ سرویس مسدود شده ← یک ایمیل با فهرست ۱۰ سرویس.
  • برای هر قالب جداگانه انتخاب کنید که تجمیعی ارسال شود یا تکی، و موضوع ایمیل تجمیعی را هم خودتان تعیین کنید.
  • پیوست‌های همه ایمیل‌ها (مثل PDF فاکتورها) در ایمیل تجمیعی حفظ می‌شوند.
  • ایمیل‌های امنیتی (بازیابی رمز، تأیید ایمیل، دعوت‌نامه) و ایمیل‌های مدیر هیچ‌وقت تجمیع نمی‌شوند.
  • برای پیام‌های تجمیعی، حداکثر زمان نگهداری تعیین می‌شود و پردازش آن‌ها در اجرای صف پیگیری می‌شود.
تنظیمات ایمیل تجمیعی کرون
تنظیمات ایمیل تجمیعی کرون

۶. تنظیمات کامل و نگهداری خودکار

  • تعیین مدت کش MX و IP، دوره به‌روزرسانی رنج‌ها و آدرس فایل RIPE (امکان استفاده از mirror داخلی).
  • حذف خودکار پیام‌های قدیمی و پیوست‌ها بعد از مدت دلخواه تا دیتابیس سنگین نشود.
  • ثبت جزئیات در Module Log برای عیب‌یابی، با مخفی‌سازی رمزها.
  • پنل مدیریت کاملاً فارسی و راست‌چین با فونت وزیرمتن و راهنمای راه‌اندازی داخل ماژول.
تنظیمات ارسال و صف
تنظیمات ارسال و صف

راه‌اندازی در چند دقیقه

  1. ماژول را در پوشه modules/addons آپلود و از بخش Addon Modules فعال کنید.
  2. در بخش «SMTPها» یک SMTP برای سرور ایران (کشور IR) و یک SMTP برای سرور خارج (پیش‌فرض) بسازید و دکمه تست اتصال را بزنید.
  3. در «رنج IP و کش» رنج‌های IP را بارگذاری کنید.
  4. خط Cron نمایش داده شده در داشبورد را هر دقیقه زمان‌بندی کنید.
  5. در Setup > General Settings > Mail گزینه Mail Provider را روی GeoMailer بگذارید.
  6. رکورد SPF دامنه فرستنده را طوری تنظیم کنید که هر دو سرور را شامل شود و DKIM هر دو سرور را فعال کنید (راهنمای کامل داخل ماژول هست).

پیش‌نیازها

  • WHMCS نسخه ۹ (تست‌شده روی ۹.۰.۶)
  • PHP 8.1 یا بالاتر
  • دو سرور SMTP (مثلاً ایمیل cPanel روی یک هاست ایران و یک هاست خارج)
  • دسترسی به Cron سرور

چرا GeoMailer؟

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

پیش از خرید، نسخهٔ WHMCS، PHP و مشخصات SMTPهای خود را آماده کنید. برای بررسی سازگاری و شرایط لایسنس، از پشتیبانی لایسنس‌ها راهنمایی بگیرید.

معنی گزارش تحویل و باز شدن ایمیل

پذیرش پیام از طرف SMTP به معنی قرار گرفتن آن در Inbox نیست. برای عیب‌یابی، پاسخ سرور، احراز هویت دامنه، DNS معکوس و سیاست گیرنده را بررسی کنید. در آمار باز شدن نیز ابزارهایی مانند Mail Privacy Protection می‌توانند مانع برداشت قطعی از رفتار گیرنده شوند.

پرسش‌های متداول

آیا GeoMailer رسیدن همهٔ پیام‌ها به Inbox را تضمین می‌کند؟

خیر؛ ماژول مسیر و صف ارسال را مدیریت می‌کند. اعتبار IP و دامنه، تنظیمات احراز هویت و تصمیم گیرنده نیز در نتیجه اثر دارند.

برای راه‌اندازی به چه چیزهایی نیاز دارم؟

نسخهٔ سازگار WHMCS و PHP، SMTPهای قابل اتصال و Cron فعال را آماده کنید. پس از تست هر SMTP، مسیریابی و قالب‌های تجمیعی را با نمونه بررسی کنید.

آموزش مرتبط

راهنمای اتصال ایمیل سازمانی و تنظیمات امن ایمیل

منابع و راهنماهای رسمی

لطفا به این محتوا امتیاز دهید