راهنمای تنظیم کاوه نگار – ارسال پیامک سفارشات ووکامرس
📲 راهنمای ارسال پیامک با قالب (پترن) کاوه‌نگار
با این روش، متن پیامک را یک بار در پنل کاوه‌نگار تعریف می‌کنید و افزونه به‌صورت خودکار اطلاعات سفارش را در آن جایگذاری می‌کند.
مرحله ۱: ساخت قالب (پترن) در پنل کاوه‌نگار
۱. وارد پنل کاوه‌نگار شوید. kavenegar.com
۲. بروید: سرویس اعتبار سنجی ← مدیریت الگوها
۳. روی ایجاد الگوی جدید کلیک کنید.
۴. متن پیامک مورد نظر خود را بنویسید.
۵. برای هر اطلاعاتی که می‌خواهید از سفارش جایگذاری شود، از %token، %token2، %token3 و … استفاده کنید.
۶. قالب را ذخیره کنید و منتظر بمانید تا تأیید شود (معمولاً چند ساعت تا یک روز کاری طول می‌کشد).
۷. بعد از تأیید، نام الگو را یادداشت کنید (مثلاً order-processing).
💡 متغیرها در پنل کاوه‌نگار با
%token، %token2، %token3 مشخص می‌شوند. کاوه‌نگار فقط این متغیرها را قبول دارد:token، token2، token3، token10، token20📝 مثال قالب در پنل کاوه‌نگار:
همراه گرامی،
وضعیت سفارش شما به %token تغییر یافت.
مبلغ سفارش: %token2 تومان
کد رهگیری: %token3
با تشکر،
وضعیت سفارش شما به %token تغییر یافت.
مبلغ سفارش: %token2 تومان
کد رهگیری: %token3
با تشکر،
✅ در این قالب:
%token= وضعیت سفارش%token2= مبلغ کل%token3= کد رهگیری
⚠️ نکته مهم: نام الگو را حتماً یادداشت کنید. این نام را در تنظیمات افزونه وارد خواهید کرد.
مرحله ۲: تنظیم در افزونه دیجیتس مرسا وب
وارد تنظیمات افزونه دیجیتس شوید ← پیامک ووکامرس
1. اطلاع به مدیر هنگام سفارش جدید:
- گزینه “اطلاع به مدیر هنگام سفارش جدید” را فعال کنید
- نوع ارسال = قالب (پترن)
- کد قالب = نام الگویی که در کاوه‌نگار ساختید (مثلاً
order-processing) - متن پیامک = در هر ردیف متغیر مورد نظر خود را وارد کنید
2. اطلاع‌رسانی به مشتری:
- در بخش “اطلاع‌رسانی وضعیت سفارش به مشتری” وضعیت‌های مورد نظر را فعال کنید
- نوع ارسال = قالب (پترن)
- کد قالب = نام الگویی که در کاوه‌نگار ساختید (مثلاً
order-processing) - متن پیامک = در هر ردیف متغیر مورد نظر خود را وارد کنید
⚠️ نکته مهم: در حالت پترن، آنچه در فیلد «متن پیامک» می‌نویسید به مشتری ارسال نمی‌شود. این فیلد فقط برای مشخص کردن ترتیب متغیرها استفاده می‌شود.
مرحله ۳: نوشتن متغیرها در فیلد متن پیامک
در فیلد متن پیامک، متغیرهایی که می‌خواهید ارسال شوند را بنویسید:
- هر متغیر را در یک خط جداگانه بنویسید
- ترتیب متغیرها باید دقیقاً با ترتیب
%token،%token2،%token3، … در قالب پنل یکی باشد
🔴 قانون طلایی: اگر در قالب پنل ۳ متغیر دارید (
%token، %token2، %token3)، باید دقیقاً ۳ خط در فیلد متن پیامک بنویسید — نه بیشتر، نه کمتر!📝 مثال — ادامه مثال مرحله ۱:
📋 قالب در پنل کاوه‌نگار
همراه گرامی،
وضعیت سفارش شما به %token تغییر یافت.
مبلغ سفارش: %token2 تومان
با تشکر
وضعیت سفارش شما به %token تغییر یافت.
مبلغ سفارش: %token2 تومان
با تشکر
⬅️ ۲ متغیر در قالب
⚙️ فیلد «متن پیامک» در افزونه
{order_status}
{total}
{total}
⬅️ ۲ خط = ۲ متغیر
📱 پیامکی که مشتری دریافت می‌کند:
همراه گرامی،
وضعیت سفارش شما به در حال پردازش تغییر یافت.
مبلغ سفارش: ۲,۸۶۹,۰۰۰ تومان
با تشکر
وضعیت سفارش شما به در حال پردازش تغییر یافت.
مبلغ سفارش: ۲,۸۶۹,۰۰۰ تومان
با تشکر
مثال برای متغیرهای بیشتر:
⭐ متغیر token10 و token20 (با فاصله)
اگر در قالب پنل کاوه‌نگار از متغیرهای %token10 یا %token20 استفاده کرده‌اید،
حتماً باید خطوط خالی (Dummy) بین متغیرها قرار دهید تا متغیر مورد نظر در جایگاه درست قرار بگیرد.
📋 قالب در پنل کاوه‌نگار
سفارش جدید در %token
شماره سفارش: %token2
مبلغ: %token3 تومان
وضعیت: %token10
سایت من
شماره سفارش: %token2
مبلغ: %token3 تومان
وضعیت: %token10
سایت من
⬅️ %token، %token2، %token3، %token10
⚙️ فیلد «متن پیامک» در افزونه
{site_name}
{order_id}
{total}
{dummy1}
{dummy2}
{dummy3}
{dummy4}
{dummy5}
{dummy6}
{order_status}
{order_id}
{total}
{dummy1}
{dummy2}
{dummy3}
{dummy4}
{dummy5}
{dummy6}
{order_status}
⬅️ ۶ خط خالی (Dummy) برای رسیدن به token10
✅ قانون مهم:
token= خط اول در فیلد متنtoken2= خط دوم در فیلد متنtoken3= خط سوم در فیلد متنtoken10= خط دهم در فیلد متن ← باید ۶ خط خالی (dummy) بین token3 و token10 بگذاریدtoken20= خط بیستم در فیلد متن ← باید ۱۶ خط خالی (dummy) بین token3 و token20 بگذارید
⚠️ نکته: خطوط خالی می‌توانند هر نام دلخواهی داشته باشند (مثلاً
{dummy1}، {dummy2} یا {x1}، {x2}) اما باید حتماً تعداد آنها دقیقاً برابر با فاصله بین متغیرها باشد.💡 جداول نگاشت کامل:
| متغیر کاوه‌نگار | خط مورد نیاز | تعداد خطوط خالی (Dummy) قبل از آن |
|---|---|---|
%token |
خط ۱ | ۰ |
%token2 |
خط ۲ | ۱ |
%token3 |
خط ۳ | ۲ |
%token10 |
خط ۱۰ | ۹ خط خالی |
%token20 |
خط ۲۰ | ۱۹ خط خالی |
مرحله ۴: متغیرهای قابل استفاده در افزونه
در فیلد متن پیامک می‌توانید از هر کدام از این متغیرها استفاده کنید:
| متغیر | توضیح |
|---|---|
{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} |
نام سایت |
💡 لیست کامل متغیرها را می‌توانید در ستون کناری صفحه تنظیمات افزونه ببینید و با کلیک روی هر متغیر آن را کپی کنید.
🔗 نگاشت متغیرهای افزونه به کاوه‌نگار
این جدول نشان می‌دهد که هر متغیر افزونه به کدام متغیر کاوه‌نگار نگاشت می‌شود:
| متغیر در افزونه | متغیر در کاوه‌نگار | توضیح |
|---|---|---|
token:{...} |
%token |
متغیر اول |
token2:{...} |
%token2 |
متغیر دوم |
token3:{...} |
%token3 |
متغیر سوم |
token10:{...} |
%token10 |
متغیر چهارم (با فاصله) |
token20:{...} |
%token20 |
متغیر پنجم (با فاصله) |
⚠️ نکته مهم:
token10 و token20 برای متغیرهایی استفاده می‌شوند که ممکن است شامل فاصله باشند (مثل آدرس، توضیحات طولانی و …).
❌ خطاهای رایج و راه‌حل
اگر پیامک ارسال نشد، ممکن است یکی از این خطاها رخ داده باشد:
| کد خطا | توضیح | راه‌حل |
|---|---|---|
| 403 | کد شناسایی (API Key) معتبر نیست | API Key را از پنل کاوه‌نگار کپی و در تنظیمات افزونه جایگزین کنید |
| 431 | ساختار کد صحیح نمی‌باشد | تعداد خطوط فیلد متن را با تعداد متغیرهای قالب مقایسه کنید |
| 424 | الگوی مورد نظر پیدا نشد | نام الگو را در تنظیمات بررسی کنید – باید با نام پنل کاوه‌نگار یکی باشد |
| 418 | اعتبار حساب کافی نیست | حساب خود را در پنل کاوه‌نگار شارژ کنید |
| 426 | سرویس پیشرفته فعال نیست | سرویس اعتبار سنجی (Verify) را در پنل کاوه‌نگار فعال کنید |
| 411 | شماره گیرنده نامعتبر است | شماره موبایل مشتری را بررسی کنید |
| 413 | متن پیام خالی یا طولانی است | متن قالب را در پنل کاوه‌نگار بررسی کنید |
| 422 | داده‌ها دارای کاراکتر نامناسب هستند | از نبود کاراکترهای خاص در متغیرها مطمئن شوید |
⚠️ شایع‌ترین خطا (431): اگر در قالب پنل ۳ متغیر دارید (
%token، %token2، %token3)، باید دقیقاً ۳ خط در فیلد متن پیامک افزونه بنویسید — نه بیشتر، نه کمتر!
📌 نکات مهم
✅ هر وضعیت سفارش (در حال پردازش، تکمیل شده، لغو شده و …) می‌تواند قالب جداگانه داشته باشد. برای هر وضعیت یک قالب در پنل کاوه‌نگار بسازید و نام آن را در تنظیمات همان وضعیت وارد کنید.
📌 اگر می‌خواهید از متن آزاد (بدون پترن) استفاده کنید، نوع ارسال را روی «متن آزاد» بگذارید و هر متغیری را می‌توانید مستقیم در متن پیامک استفاده کنید، مثلاً:
سفارش شماره
سفارش شماره
{order_id} شما توسط {site_name} ثبت شد.🔴 قالب‌های پترن کاوه‌نگار باید قبل از استفاده توسط تیم کاوه‌نگار تأیید شوند. این فرآیند معمولاً چند ساعت تا یک روز کاری طول می‌کشد. تا قبل از تأیید، پیامک‌ها ارسال نمی‌شوند.
💡 برای تست، ابتدا یک قالب ساده با ۱ یا ۲ متغیر بسازید و بعد از تأیید، آن را تست کنید. سپس قالب‌های پیچیده‌تر را اضافه کنید.
