راهنمای تنظیم ملی پیامک برای ارسال پیامک سفارشات ووکامرس
📲 راهنمای ارسال پیامک با قالب (پترن) ملی پیامک
با این روش، متن پیامک را یک بار در پنل ملی پیامک تعریف می‌کنید و افزونه به‌صورت خودکار اطلاعات سفارش را در آن جایگذاری می‌کند.
مرحله ۱: ساخت قالب (پترن) در پنل ملی پیامک
۱. وارد پنل ملی پیامک شوید.
۲. بروید: ابزارهای ویژه ← سرویس خدماتی (الگو)
۳. روی درج پترن (الگو) کلیک کنید.
۴. متن پیامک مورد نظر خود را بنویسید.
۵. برای هر اطلاعاتی که می‌خواهید از سفارش جایگذاری شود، از {0}، {1}، {2} و … استفاده کنید.
۶. قالب را ذخیره کنید و منتظر بمانید تا تأیید شود (معمولاً چند ساعت تا یک روز کاری طول می‌کشد).
۷. بعد از تأیید، یک کد عددی به قالب اختصاص داده می‌شود (مثلاً 98765). این کد را یادداشت کنید.
💡 متغیرها در پنل ملی پیامک با
{} و شماره داخلشان مشخص می‌شوند. شماره‌گذاری از 0 شروع می‌شود.📝 مثال قالب در پنل ملی پیامک:
کاربر گرامی {0}
سفارش شماره {1} با موفقیت ثبت شد.
وضعیت: {2}
مبلغ: {3} تومان
{4}
سفارش شماره {1} با موفقیت ثبت شد.
وضعیت: {2}
مبلغ: {3} تومان
{4}
✅ در این قالب:
{0}= نام مشتری{1}= شماره سفارش{2}= وضعیت سفارش{3}= مبلغ کل{4}= نام سایت
مرحله ۲: تنظیم در افزونه دیجیتس مرسا وب
وارد تنظیمات افزونه دیجیتس شوید ← پیامک ووکامرس
1. اطلاع به مدیر هنگام سفارش جدید:
- گزینه “اطلاع به مدیر هنگام سفارش جدید” را فعال کنید
- نوع ارسال = الگو
- کد الگو = کدی که از ملی پیامک کپی کردید
- متن پیامک = در هر ردیف متغییر مورد نظر خود را وارد کنید
2. اطلاع‌رسانی به مشتری:
- در بخش “اطلاع‌رسانی وضعیت سفارش به مشتری” وضعیت‌های مورد نظر را فعال کنید
- نوع ارسال = الگو
- کد الگو = کدی که از ملی پیامک کپی کردید
- متن پیامک = در هر ردیف متغییر مورد نظر خود را وارد کنید
⚠️ نکته مهم: در حالت پترن، آنچه در فیلد «متن پیامک» می‌نویسید به مشتری ارسال نمیشود. این فیلد فقط برای مشخص کردن ترتیب متغیرها استفاده می‌شود.
مرحله ۳: نوشتن متغیرها در فیلد متن پیامک
در فیلد متن پیامک، متغیرهایی که می‌خواهید ارسال شوند را بنویسید:
- هر متغیر را در یک خط جداگانه بنویسید
- ترتیب متغیرها باید دقیقاً با ترتیب
{0}،{1}،{2}، … در قالب پنل یکی باشد
🔴 قانون طلایی: اگر در قالب پنل ۵ متغیر دارید (
{0} تا {4})، باید دقیقاً ۵ خط در فیلد متن پیامک بنویسید — نه بیشتر، نه کمتر!📝 مثال — ادامه مثال مرحله ۱:
📋 قالب در پنل ملی پیامک
کاربر گرامی {0}
سفارش شماره {1} ثبت شد.
وضعیت: {2}
مبلغ: {3} تومان
{4}
سفارش شماره {1} ثبت شد.
وضعیت: {2}
مبلغ: {3} تومان
{4}
⬅️ ۵ متغیر در قالب
⚙️ فیلد «متن پیامک» در افزونه
{customer_name}
{order_id}
{order_status}
{total}
{site_name}
{order_id}
{order_status}
{total}
{site_name}
⬅️ ۵ خط = ۵ متغیر
📱 پیامکی که مشتری دریافت می‌کند:
کاربر گرامی علی رضایی
سفارش شماره ۱۰۴۲ ثبت شد.
وضعیت: در حال پردازش
مبلغ: ۷۵۰,۰۰۰ تومان
فروشگاه من
سفارش شماره ۱۰۴۲ ثبت شد.
وضعیت: در حال پردازش
مبلغ: ۷۵۰,۰۰۰ تومان
فروشگاه من
مرحله ۴: متغیرهای قابل استفاده در افزونه
در فیلد متن پیامک می‌توانید از هر کدام از این متغیرها استفاده کنید:
| متغیر | توضیح |
|---|---|
{customer_name} | نام و نام خانوادگی مشتری |
{customer_first_name} | نام مشتری |
{customer_last_name} | نام خانوادگی مشتری |
{order_id} | شماره سفارش |
{order_number} | شماره سفارش (قالب‌بندی‌شده) |
{order_status} | وضعیت سفارش (مثلاً: در حال پردازش) |
{total} | مبلغ کل سفارش |
{payment_method} | روش پرداخت |
{shipping_method} | روش ارسال |
{products} | لیست محصولات |
{products_with_qty} | محصولات به همراه تعداد |
{products_with_variation} | محصولات با ویژگی‌ها |
{customer_phone} | شماره موبایل مشتری |
{customer_email} | ایمیل مشتری |
{billing_city} | شهر (آدرس فاکتور) |
{billing_address_1} | آدرس (فاکتور) |
{shipping_city} | شهر (آدرس ارسال) |
{order_date} | تاریخ ثبت سفارش |
{tracking_code} | کد رهگیری پستی (فقط برای کد رهگیری) |
{site_name} | نام سایت |
💡 لیست کامل متغیرها را می‌توانید در ستون کناری صفحه تنظیمات افزونه ببینید و با کلیک روی هر متغیر آن را کپی کنید.
🔴 توجه: متغیر
{payment_url} حاوی لینک است و در حالت پترن ملی‌پیامک ارسال نمیشود. برای اطلاع‌رسانی پرداخت از متغیرهای دیگر استفاده کنید.❌ خطاهای رایج و راه‌حل
اگر پیامک ارسال نشد، ممکن است یکی از این خطاها رخ داده باشد:
| کد خطا | توضیح | راه‌حل |
|---|---|---|
| -5 | تعداد متغیرهای ارسالی با قالب پنل همخوانی ندارد | تعداد خطوط فیلد متن را با تعداد متغیرهای قالب مقایسه کنید |
| -10 | متغیر حاوی لینک است | متغیر {payment_url} را از فیلد متن حذف کنید |
| -4 | کد قالب اشتباه است یا تأیید نشده | از صحت کد قالب و تأیید شدن آن در پنل مطمئن شوید |
| 0 | نام کاربری یا رمز عبور اشتباه است | تنظیمات ملی پیامک را در افزونه بررسی کنید |
| 2 | اعتبار پنل کافی نیست | حساب خود را در پنل ملی پیامک شارژ کنید |
| 10 | کاربر فعال نیست | با پشتیبانی ملی پیامک تماس بگیرید |
| 18 | شماره گیرنده نامعتبر است | شماره موبایل مشتری را بررسی کنید |
| 19 | از محدودیت ساعتی فراتر رفته‌اید | در ساعت دیگری ارسال را امتحان کنید |
| 6 | ارسال از طریق خط معمولی انجام نمیشود | با پشتیبانی ملی پیامک تماس بگیرید تا خط خدماتی بدهند |
⚠️ شایع‌ترین خطا (-5): اگر در قالب پنل ۵ متغیر دارید (
{0} تا {4})، باید دقیقاً ۵ خط در فیلد متن پیامک افزونه بنویسید — نه بیشتر، نه کمتر.✅ اگر پیامک با موفقیت ارسال شود، کد recId (یک عدد بیش از ۱۵ رقم) دریافت می‌کنید که یعنی ارسال موفق بوده است.
📌 نکات مهم
✅ هر وضعیت سفارش (در حال پردازش، تکمیل شده، لغو شده و …) می‌تواند قالب جداگانه داشته باشد. برای هر وضعیت یک قالب در پنل بسازید و کد آن را در تنظیمات همان وضعیت وارد کنید.
📌 اگر می‌خواهید از متن آزاد (بدون پترن) استفاده کنید، نوع ارسال را روی «متن آزاد» بگذارید و هر متغیری را می‌توانید مستقیم در متن پیامک استفاده کنید، مثلاً:
سفارش شماره
سفارش شماره
{order_id} شما توسط {site_name} ثبت شد.🔴 قالب‌های پترن باید قبل از استفاده توسط تیم ملی پیامک تأیید شوند. این فرآیند معمولاً چند ساعت تا یک روز کاری طول می‌کشد. تا قبل از تأیید، پیامک‌ها ارسال نمی‌شوند.
💡 برای تست، ابتدا یک قالب ساده با ۱ یا ۲ متغیر بسازید و بعد از تأیید، آن را تست کنید. سپس قالب‌های پیچیده‌تر را اضافه کنید.
