پیکربندی اعلان‌ها (ایمیل و پیامک)

> version: 1.6 | last_updated: 2026-09-20 | audience: admin

هدف

ارسال خودکار اعلان به مشتریان هنگام رویدادهایی مثل ثبت سفارش، فعال‌سازی سرویس، فاکتور و ….

اگر روی مشتری در **ویرایش → تماس** گزینهٔ **عدم ارسال ایمیل** یا **عدم ارسال پیامک** فعال باشد، همان کانال برای آن مشتری skip می‌شود (سیستمی و دستی).

تمپلیت اعلان

**تنظیمات → تمپلیت اعلان**

**مشخصات** تمپلیت (نام، رویداد، فعال)

**محتوای پیام:**

- موضوع ایمیل
- **متن ایمیل** با ادیتور **TinyMCE** (فارسی / راست‌چین) — دکمه‌های قالب‌بندی، لیست، لینک، جدول؛ دکمه **کد** برای HTML خام
- **متن پیامک** (فقط متن ساده، بدون HTML)

**جایگزین‌های قابل استفاده** در انتهای فرم — باکس‌های دسته‌بندی‌شده؛ با کلیک کپی می‌شوند

روی **دسته محصول → تب اعلان‌ها** تمپلیت را به رویداد وصل کنید

ایمیل به‌صورت HTML با `dir="rtl"` ارسال می‌شود؛ پیامک همیشه متن ساده است.

نمونه جایگزین‌ها:

| باکس | نمونه |
|------|--------|
| مشتری | `{{customer_first_name}}` `{{customer_last_name}}` `{{customer_full_name}}` `{{customer_mobile}}` |
| سرویس | `{{product_name}}` `{{subscription_number}}` `{{username}}` `{{password}}` `{{service_domain}}` `{{service_panel_url}}` `{{service_ip}}` |
| فاکتور | `{{invoice_issue_date}}` `{{invoice_paid_at}}` `{{invoice_subtotal}}` `{{invoice_tax_total}}` `{{invoice_total}}` `{{invoice_status}}` `{{invoice_description}}` |

ایمیل فعال‌سازی هاست (cPanel / DirectAdmin و …)

بعد از موفق بودن Provision (`subscription.activated`):

نام کاربری، رمز، دامنه، آدرس پنل کنترل، IP (در صورت وجود)

تمپلیت پیش‌فرض سیستم این فیلدها را دارد؛ اگر روی دسته تمپلیت سفارشی بسته‌اید، همان جایگزین‌ها را در متن بگذارید

رویداد جدا `subscription.info` فقط وقتی روی دسته به تمپلیت وصل شده باشد هم ارسال می‌شود

تنظیم کانال‌ها

وارد **پنل شرکت** (`/panel`) شوید

**تنظیمات → کانال‌های اعلان**

کانال‌های پیش‌فرض Demo:

- **ایمیل** — درایور `mail`
- **پیامک** — درایور `kavenegar` (Sandbox)

کاوه نگار (Production)

کانال SMS را ویرایش کنید

Sandbox را خاموش کنید

در تنظیمات:

- `api_key` = کلید API کاوه نگار
- `sender` = شماره فرستنده

مشاهده لاگ

**تنظیمات → لاگ اعلان‌ها**

وضعیت‌ها:
| وضعیت | معنی |
|--------|------|
| `simulated` | شبیه‌سازی (Sandbox یا MAIL_MAILER=log) |
| `sent` | ارسال واقعی |
| `failed` | خطا |

رویدادها (نمونه)

| کلید | توضیح |
|------|--------|
| `order.placed` | ثبت سفارش |
| `subscription.activated` | فعال‌سازی سرویس |
| `subscription.suspended` | تعلیق سرویس |
| `subscription.collected` | جمع‌آوری سرویس |
| `invoice.purchase_issued` | فاکتور خرید |
| `invoice.renewal_issued` | فاکتور تمدید |
| `invoice.paid` | فاکتور پرداخت‌شده |
| `invoice.cancelled` | فاکتور کنسل‌شده |
| `invoice.payment_warning` | اخطار عدم پرداخت |
| `subscription.info` | اطلاعات سرویس |
| `ticket.created` | تیکت ثبت شد |
| `ticket.replied` | پاسخ پشتیبانی |
| `ticket.status_changed` | ورود تیکت به وضعیت مسیر (فقط اگر روی وضعیت قالب ایمیل/SMS انتخاب شده باشد) |