در این راهنما، اطلاعات اتصال، الگوها، متغیرها و خطاهای کاوه‌نگار را بررسی می‌کنیم. برای انتخاب روش و اتصال مشترک، انتخاب پنل، برای تنظیم اعلان سفارش، مدیریت رویدادها و برای تشخیص خطاهای عمومی، عیب‌یابی پیامک را ببینید.
با اتصال کاوه‌نگار به مرکز پیامک جم پک می‌توانید اعلان‌های سفارش ووکامرس، هشدارهای موجودی و پیام‌های دستی را از حساب کاوه‌نگار ارسال کنید. این اتصال دو مسیر ارسال دارد:
- ارسال مستقیم: متن کامل پیام از سایت به متد Send کاوه‌نگار فرستاده می‌شود؛
- ارسال Pattern (الگویی): نام الگوی تأییدشده و مقدار متغیرها از طریق سرویس Lookup کاوه‌نگار ارسال می‌شوند.
در روش مستقیم می‌توانید شماره فرستنده را در تنظیمات وارد کنید یا آن را خالی بگذارید تا کاوه‌نگار فرستنده پیش‌فرض حساب را انتخاب کند. در Lookup شماره فرستنده از سایت ارسال نمی‌شود و انتخاب مسیر مناسب بر عهده کاوه‌نگار است.
این قابلیت در سطح Pro قرار دارد. پیش از ادامه، راهنمای راه‌اندازی مرکز پیامک ووکامرس را مطالعه کنید؛ تنظیم رویدادها، متن پیام‌ها، تاریخچه و ارسال گروهی در آن راهنما توضیح داده شده‌اند.
این راهنما چه مواردی را پوشش می‌دهد؟
- آماده‌سازی حساب کاوه‌نگار؛
- دریافت و نگهداری امن API Key؛
- انتخاب کاوه‌نگار در مرکز پیامک؛
- ثبت شماره فرستنده اختیاری؛
- آزمون ارسال مستقیم؛
- ساخت Template در کاوه‌نگار؛
- انتخاب روش Pattern در جم پک؛
- نگاشت ترتیبی پنج Token؛
- مدیریت مقادیر دارای فاصله؛
- آزمون Pattern با سفارش واقعی؛
- تشخیص خطاهای حساب، اعتبار، گیرنده، فرستنده و الگو؛
- بررسی تفاوت «پذیرفته‌شدن درخواست» و «تحویل به گوشی»؛
- نکات امنیتی و حریم خصوصی.
این صفحه نحوه ثبت‌نام، خرید بسته، تعرفه یا قراردادهای کاوه‌نگار را جایگزین نمی‌کند؛ این موارد ممکن است تغییر کنند و باید در پنل یا مستندات رسمی سرویس بررسی شوند.
اطلاعات موردنیاز اتصال
در نسخه بررسی‌شده، اتصال کاوه‌نگار فقط دو فیلد دارد:
| فیلد | اجباری | کاربرد |
|---|---|---|
| API Key | بله | احراز هویت همه درخواست‌های Send و Lookup |
| شماره فرستنده | خیر | فرستنده پیام‌های Direct |
نام کاربری، رمز ورود پنل و API Key یکسان نیستند. برای اتصال فقط API Key را در فیلد مخصوص وارد کنید و رمز ورود حساب را در سایت قرار ندهید.
دریافت API Key
API Key را از حساب کاوه‌نگار و بخش مربوط به API یا توسعه‌دهندگان دریافت کنید. لینک دریافت کلید در مستند رسمی نیز به کنسول کاوه‌نگار ارجاع می‌دهد.
هنگام ساخت یا انتخاب کلید:
- کلید متعلق به همان حسابی باشد که اعتبار و خطوط روی آن قرار دارند؛
- کلید کامل را بدون فاصله ابتدا و انتها کپی کنید؛
- آن را در پیام‌رسان، تیکت عمومی یا تصویر آموزشی نمایش ندهید؛
- برای محیط آزمایشی و اصلی، در صورت امکان کلیدهای جداگانه داشته باشید؛
- پس از افشای احتمالی، کلید را در پنل باطل و کلید تازه‌ای جایگزین کنید.
در پیاده‌سازی نسخه بررسی‌شده، API Key بخشی از URL درخواست کاوه‌نگار است:
https://api.kavenegar.com/v1/{API-KEY}/...به همین دلیل باید گزارش‌های Proxy، فایروال، خطای سرور و ابزار مانیتورینگ را نیز از نظر ثبت URL کامل کنترل کنید.
انتخاب کاوه‌نگار در مرکز پیامک
برای اتصال:
- وارد پیشخوان وردپرس شوید.
- از منوی جم پک، «اعلان‌های پیامکی» را باز کنید.
- وارد «تنظیمات عمومی» شوید.
- مرکز پیامک را فعال کنید.
- در فهرست پنل‌ها، «کاوه‌نگار» را انتخاب کنید.
- تنظیمات را ذخیره کنید.
- صفحه را دوباره باز یا تازه‌سازی کنید.
- API Key را وارد کنید.
- در صورت نیاز، شماره فرستنده را ثبت کنید.
- تنظیمات را دوباره ذخیره کنید.
مسیر فنی صفحه:
/wp-admin/admin.php?page=gempack#sms-settingsذخیره انتخاب پنل پیش از تنظیم Pattern مهم است؛ توضیحات و جایگاههای متغیر براساس پنل ذخیره‌شده نمایش داده می‌شوند.
شماره فرستنده در ارسال مستقیم
«شماره فرستنده» همان خطی است که پیام Direct با آن ارسال می‌شود. این فیلد اختیاری است.
اگر فیلد را خالی بگذارید، پارامتر sender به کاوه‌نگار ارسال نمی‌شود و سرویس از فرستنده پیش‌فرض حساب استفاده می‌کند. مستند رسمی Send نیز فرستنده را اختیاری معرفی می‌کند.
اگر شماره مشخصی وارد می‌کنید:
- خط باید در همان حساب موجود و برای وب‌سرویس مجاز باشد؛
- مقدار را دقیقاً مطابق پنل وارد کنید؛
- فاصله یا نشانه اضافی نگذارید؛
- خط تبلیغاتی و خدماتی را با هم اشتباه نگیرید؛
- محدودیت ارسال به شماره‌های مسدودشده را بررسی کنید.
نمونه قالب پذیرفته‌شده در مستند رسمی:
10004346در Lookup، جم پک پارامتر Sender ارسال نمی‌کند. بنابراین خالی یا پر بودن این فیلد، فرستنده Pattern کاوه‌نگار را تعیین نمی‌کند.
ارسال مستقیم چگونه انجام می‌شود؟
برای Direct، نسخه بررسی‌شده درخواست POST را به این Endpoint می‌فرستد:
https://api.kavenegar.com/v1/{API-KEY}/sms/send.jsonپارامترهای استفاده‌شده:
| پارامتر | مقدار |
|---|---|
receptor | شماره موبایل نرمال‌شده گیرنده |
message | متن نهایی پس از جایگزینی متغیرها |
sender | شماره فرستنده، فقط اگر در تنظیمات خالی نباشد |
مهلت انتظار درخواست در نسخه بررسی‌شده ۳۰ ثانیه است. اگر WordPress خطای شبکه برگرداند، متن همان خطا به مرکز پیامک منتقل می‌شود.
جم پک پاسخ JSON را بررسی می‌کند و تنها زمانی ارسال را موفق می‌داند که مقدار زیر 200 باشد:
return.statusدر غیر این صورت، مقدار return.message به‌عنوان خطا نمایش داده یا ثبت می‌شود.
Endpointهایی مانند SendArray، زمان‌بندی ارسال، Tag، Policy، Hide و LocalId در اتصال فعلی استفاده نمی‌شوند. ارسال گروهی مرکز پیامک، سفارش‌ها را در سطح خود افزونه پردازش می‌کند و از متد send.json بهره می‌برد.
آزمون اولیه Direct
پیش از فعال‌کردن اعلان‌های سفارش:
- API Key را ذخیره کنید.
- شماره فرستنده را وارد کنید یا برای استفاده از فرستنده پیش‌فرض خالی بگذارید.
- در بخش پیام آزمایشی، یک شماره موبایل معتبر وارد کنید.
- متن کوتاه و غیرتبلیغاتی بنویسید.
- ارسال را اجرا کنید.
- نتیجه کنار فرم را بررسی کنید.
- ورود پیام به گوشی و گزارش پنل کاوه‌نگار را کنترل کنید.
نمونه متن:
این یک پیام آزمایشی از مرکز پیامک فروشگاه است.پیام آزمایشی از Direct استفاده می‌کند و در تاریخچه مرکزی جم پک ثبت نمی‌شود. بنابراین برای عیب‌یابی این مرحله، نتیجه فرم و گزارش خود کاوه‌نگار را بررسی کنید.
موفقیت این تست فقط اتصال Direct را تأیید می‌کند؛ Lookup، Template، متغیرها و رویداد سفارش باید جداگانه آزمایش شوند.
Lookup در کاوه‌نگار
ارسال Pattern کاوه‌نگار از سرویس Verify/Lookup استفاده می‌کند:
https://api.kavenegar.com/v1/{API-KEY}/verify/lookup.jsonاین سرویس متن آماده و تأییدشده را با مقادیر متغیر ترکیب می‌کند. براساس مستند رسمی، برای استفاده از Lookup ابتدا باید الگو در پنل تعریف و تأیید شود. جزئیات رسمی در بخش Lookup مستندات کاوه‌نگار آمده است.
Lookup برای اعلان‌های ضروری مناسب‌تر است، اما نوع سرویس حساب، تأیید Template و قوانین جاری کاوه‌نگار تعیین می‌کنند که پیام به چه شماره‌هایی و با چه شرایطی تحویل شود.
ساخت Template در کاوه‌نگار
برای هر پیام ضروری، در پنل کاوه‌نگار یک Template بسازید. متن دقیق منوهای پنل ممکن است تغییر کند، اما الگو باید این ویژگی‌ها را داشته باشد:
- نام انگلیسی و بدون فاصله داشته باشد؛
- متن آن روشن و خدماتی باشد؛
- حداقل
%tokenرا شامل شود؛ - Tokenها دقیقاً با نیاز پیام تعریف شوند؛
- نام فروشگاه یا هویت فرستنده در متن مشخص باشد؛
- پس از ثبت، وضعیت الگو به تأیید نهایی برسد.
نمونه نام:
woocommerceorderstatusنمونه متن الگو:
سفارش %token شما در %token10 با وضعیت %token20 ثبت شد.در فیلد «شناسه Pattern» جم پک باید نام Template را وارد کنید:
woocommerceorderstatusشناسه عددی یا متن کامل الگو را در این فیلد قرار ندهید.
پنج جایگاه متغیر کاوه‌نگار
نگاشت یعنی تعیین کنید هر متغیر الگو با کدام داده پر شود. در کاوه‌نگار، ترتیب ردیف‌ها مهم است و حداکثر پنج مقدار ارسال می‌شود. هر ردیف جم پک به یکی از جایگاههای زیر می‌رود:
| ردیف نگاشت در جم پک | پارامتر کاوه‌نگار | فاصله مجاز | کاربرد پیشنهادی |
|---|---|---|---|
| ۱ | %token | خیر | شماره سفارش، کد یا مقدار کوتاه |
| ۲ | %token2 | خیر | شناسه کوتاه دوم |
| ۳ | %token3 | خیر | مقدار کوتاه سوم |
| ۴ | %token10 | بله | نام مشتری، وضعیت یا عنوان چندکلمه‌ای |
| ۵ | %token20 | بله | نام فروشگاه، مبلغ یا متن چندکلمه‌ای |
مقدار سه متغیر نخست نباید فاصله داشته باشد. در نسخه بررسی‌شده، فاصله معمولی داخل مقادیر ردیف‌های اول تا سوم به زیرخط تبدیل می‌شود:
در حال انجامبه این شکل ارسال می‌شود:
در_حال_انجاماین تبدیل به معنی تضمین پذیرش مقدار نیست؛ مستند رسمی کاوه‌نگار، زیرخط را نیز در توضیح خطای 431 نامعتبر می‌داند. در نتیجه، برای سه جایگاه نخست، عدد، کد یا شناسه‌ای انتخاب کنید که از ابتدا فاصله و زیرخط نداشته باشد.
ردیف چهارم و پنجم به %token10 و %token20 می‌روند و فاصله معمولی آن‌ها حفظ می‌شود.
مستند رسمی کاوه‌نگار برای %token، %token2 و %token3 فضای خالی را غیرمجاز می‌داند. %token10 و %token20 برای مقدارهای دارای فاصله در نظر گرفته شده‌اند؛ تعداد و طول فاصله‌های مجاز نیز محدود است.
بیش از پنج ردیف تعریف نکنید. اتصال نسخه بررسی‌شده فقط همین پنج جایگاه را ارسال می‌کند و مقدار ششم وارد درخواست Lookup نمی‌شود.
طراحی Template و نگاشت صحیح سفارش
فرض کنید Template کاوه‌نگار را به این شکل ساخته‌اید:
سفارش %token متعلق به %token10 اکنون %token20 است.اگر فقط سه ردیف زیر را در جم پک ثبت کنید، نتیجه با Template هماهنگ نخواهد بود:
| ردیف | مقدار انتخابی | جایگاه واقعی در درخواست |
|---|---|---|
| ۱ | {order_number} | %token |
| ۲ | {customer_name} | %token2 |
| ۳ | {order_status} | %token3 |
ردیف‌های ذخیره‌شده به‌ترتیب به جایگاههای الگو می‌روند؛ نمی‌توانید با سه ردیف، جایگاههای دوم و سوم را رد کنید و به چهارم و پنجم برسید. به همین دلیل، نگاشت سه‌ردیفی بالا با این الگو هماهنگ نیست.
طراحی صحیح این است که Template و داده‌ها را از ابتدا با پنج جایگاه هماهنگ کنید. برای مثال:
سفارش %token با %token2 قلم و کد %token3 اکنون %token10 است. مشتری: %token20نگاشت:
| ردیف | جایگاه | مقدار |
|---|---|---|
| ۱ | %token | {order_number} |
| ۲ | %token2 | {order_items_count} |
| ۳ | %token3 | یک کد یا شناسه کوتاه و همیشه موجود |
| ۴ | %token10 | {order_status} |
| ۵ | %token20 | {customer_name} |
اگر فقط سه متغیر نیاز دارید و دو مقدار چندکلمه‌ای‌اند، محدودیت ترتیب کاوه‌نگار باعث می‌شود نتوانید بدون پرکردن جایگاههای دوم و سوم مستقیماً به جایگاه چهارم برسید. بهترین راه این است که:
- متغیرهای کوتاه و بدون فاصله را در سه جایگاه نخست قرار دهید؛
- مقدارهای چندکلمه‌ای را به جایگاه چهارم و پنجم منتقل کنید؛
- برای جایگاههای میانی متغیر معنادار و همیشه موجود مانند تعداد اقلام یا یک کد کوتاه در نظر بگیرید؛
- متن Template را پس از طراحی نگاشت نهایی ثبت کنید.
نمونه پنج‌متغیره مناسب:
سفارش %token با %token2 قلم، کد رهگیری %token3، وضعیت %token10، فروشگاه %token20| ردیف | مقدار |
|---|---|
| ۱ | {order_number} |
| ۲ | {order_items_count} |
| ۳ | {tracking_number} |
| ۴ | {order_status} |
| ۵ | {shop_name} |
پیش از ثبت Template مطمئن شوید هر متغیر در رویداد موردنظر مقدار دارد. برای مثال کد رهگیری در زمان ثبت سفارش معمولاً هنوز ایجاد نشده است.
فعال‌سازی Pattern در جم پک
مراحل مشترک انتخاب مخاطب، رویداد، روش ارسال و ذخیره در مدیریت رویدادها و الگوهای پیامکی آمده است. در اجرای این مراحل، نکته اختصاصی این پنل را رعایت کنید:
نام Template کاوه‌نگار را در شناسه الگو وارد کنید و ردیف‌ها را به ترتیب Tokenهای همان الگو بچینید.
تنظیمات Pattern برای هر پنل مستقل ذخیره می‌شوند. اگر مدتی پنل دیگری را فعال و دوباره به کاوه‌نگار برگردید، مقادیر قبلی کاوه‌نگار باقی می‌مانند؛ بااین‌حال تأییدشدن Template و اعتبار API Key را دوباره کنترل کنید.
هشدار: اگر Pattern انتخاب شده باشد ولی نام Template همان رویداد خالی باشد، مرکز پیامک نسخه بررسی‌شده به ارسال Direct برمی‌گردد. برای جلوگیری از ارسال متن آزاد، همه Patternهای فعال را پیش از استفاده عمومی کامل کنید.
آزمون Pattern با سفارش واقعی
تست عمومی مرکز پیامک فقط Direct است. برای آزمون Lookup باید رویداد واقعی بسازید:
- یک Template ساده و تأییدشده برای وضعیت آزمایشی انتخاب کنید.
- نام آن را بدون فاصله در تنظیمات وارد کنید.
- فقط یک اعلان مشتری را فعال کنید.
- شماره مشتری آزمایشی را با ارقام انگلیسی در سفارش قرار دهید.
- سفارش را به وضعیت هدف منتقل کنید.
- دریافت پیام را بررسی کنید.
- تاریخچه مرکز پیامک را براساس شماره سفارش فیلتر کنید.
- گزارش ارسال کاوه‌نگار را نیز بازبینی کنید.
- مقادیر Token را با متن دریافت‌شده مقایسه کنید.
برای جلوگیری از پیام اضافی، هنگام آزمون فقط یک رویداد و یک گیرنده را فعال نگه دارید.
وضعیت موفق در جم پک چه معنایی دارد؟
اگر return.status کاوه‌نگار برابر 200 باشد، اتصال ارسال را موفق ثبت می‌کند. این پاسخ یعنی درخواست توسط API پذیرفته شده است؛ تحویل نهایی به گوشی می‌تواند وضعیت جداگانه‌ای داشته باشد.
مستند رسمی کاوه‌نگار برای بررسی Delivery، متد Status را براساس messageid معرفی می‌کند. اتصال نسخه بررسی‌شده messageid را در مسیر عمومی نگهداری و برای دریافت خودکار Delivery فراخوانی نمی‌کند. بنابراین:
- وضعیت
sentدر تاریخچه را پذیرش API در نظر بگیرید؛ - برای تحویل نهایی به گزارش پنل کاوه‌نگار مراجعه کنید؛
- وضعیت خط، اپراتور و بلک‌لیست مقصد را در پنل بررسی کنید.
خطاهای رایج کاوه‌نگار
پیام خطای API معمولاً از فیلد return.message به مرکز پیامک منتقل می‌شود. کدهای زیر در مستند رسمی کاوه‌نگار آمده‌اند:
| کد | معنی رایج | اقدام پیشنهادی |
|---|---|---|
400 | پارامتر ناقص | شماره، متن، Template و Tokenها را بررسی کنید |
401 | حساب غیرفعال | وضعیت حساب را از کاوه‌نگار پیگیری کنید |
403 | API Key نامعتبر | کلید، فاصله اضافی یا ابطال کلید را بررسی کنید |
404 | متد پیدا نشد | Endpoint و سلامت سرویس را بررسی کنید |
409 | سرویس موقتاً پاسخگو نیست | وضعیت سرویس را ببینید و بعداً دوباره تلاش کنید |
411 | شماره گیرنده نامعتبر | شماره موبایل و ارقام انگلیسی را کنترل کنید |
412 | شماره فرستنده نامعتبر | خط ثبت‌شده در تنظیمات را اصلاح یا خالی کنید |
413 | متن خالی یا بیش از حد مجاز | متن نهایی و متغیرهای خالی را بررسی کنید |
418 | اعتبار حساب کافی نیست | حساب را شارژ کنید |
422 | کاراکتر نامناسب در Token | مقدارهای Pattern را ساده و معتبر کنید |
424 | Template پیدا نشد یا تأیید نشده | نام و وضعیت تأیید Template را بررسی کنید |
426 | سطح سرویس Lookup کافی نیست | سرویس لازم را در کاوه‌نگار فعال کنید |
431 | ساختار Token نادرست | فاصله، خط جدید، زیرخط یا جداکننده نامجاز را بررسی کنید |
432 | Token در متن Template وجود ندارد | %token را در الگوی کاوه‌نگار قرار دهید |
جدول کامل و بروزشده را در کدهای بازگشتی کاوه‌نگار بررسی کنید.
عیب‌یابی مرحله‌ای
خطای «API Key تنظیم نشده است»
- مطمئن شوید کاوه‌نگار به‌عنوان پنل فعال ذخیره شده است؛
- API Key را در فیلد کاوه‌نگار وارد و ذخیره کنید؛
- صفحه را تازه‌سازی و مقدار مخفی‌شده فیلد را کنترل کنید؛
- پس از درون‌ریزی تنظیمات، اطلاعات محرمانه اتصال را دوباره وارد کنید.
خطای «شماره موبایل نامعتبر است»
- شماره را با ارقام انگلیسی وارد کنید؛
- برای شماره ایران از قالب
09xxxxxxxxxاستفاده کنید؛ - فاصله، خط تیره و نویسه اضافی را حذف کنید؛
- شماره صورتحساب سفارش را بررسی کنید؛
- مطمئن شوید تعداد ارقام صحیح است.
خطای 403 یا نامعتبر بودن حساب
- API Key را دوباره از پنل کپی کنید؛
- فاصله ابتدا و انتها را حذف کنید؛
- فعال‌بودن کلید و حساب را بررسی کنید؛
- از ترکیب کلید حساب دیگر با خطوط این حساب خودداری کنید؛
- در صورت افشای کلید، کلید تازه بسازید.
خطای فرستنده نامعتبر
- شماره فرستنده را دقیقاً مطابق پنل وارد کنید؛
- دسترسی وب‌سرویس خط را بررسی کنید؛
- برای آزمون، فیلد را خالی بگذارید تا فرستنده پیش‌فرض انتخاب شود؛
- تفاوت خط Direct با مسیر Lookup را در نظر بگیرید.
Direct موفق است اما Lookup خطا می‌دهد
- فعال‌بودن سرویس لازم برای Lookup را بررسی کنید؛
- نام Template را به‌جای شناسه عددی وارد کنید؛
- وضعیت Template باید تأییدشده باشد؛
%tokenباید در متن Template وجود داشته باشد؛- ترتیب نگاشت را با
%tokenتا%token20تطبیق دهید؛ - Tokenهای اول تا سوم نباید مقدار چندکلمه‌ای نامناسب داشته باشند؛
- رویداد را با سفارش واقعی آزمایش کنید، نه فرم تست Direct.
فاصله‌ها به زیرخط تبدیل شده‌اند
این رفتار برای سه جایگاه نخست عمدی است، زیرا کاوه‌نگار Space را در %token، %token2 و %token3 نمی‌پذیرد. مقدار چندکلمه‌ای را به ردیف چهارم یا پنجم و در نتیجه %token10 یا %token20 منتقل کنید و Template را متناسب با آن تغییر دهید.
Pattern انتخاب شده ولی پیام Direct ارسال می‌شود
برای تشخیص این وضعیت، مراحل رفع خطاهای اتصال و ارسال پیامک را دنبال کنید. برای بررسی کلید، خط فرستنده و الگو، به بخش مربوط در همین راهنما مراجعه کنید.
پیام در تاریخچه sent است اما دریافت نشده
برای تشخیص این وضعیت، مراحل رفع خطاهای اتصال و ارسال پیامک را دنبال کنید. برای بررسی کلید، خط فرستنده و الگو، به بخش مربوط در همین راهنما مراجعه کنید.
خطای شبکه یا Timeout
برای تشخیص این وضعیت، مراحل رفع خطاهای اتصال و ارسال پیامک را دنبال کنید. برای بررسی کلید، خط فرستنده و الگو، به بخش مربوط در همین راهنما مراجعه کنید.
امنیت و حریم خصوصی
API Key اختیار ارسال از حساب شما را دارد و باید مانند رمز محرمانه نگهداری شود.
- کلید را در تصویر آموزشی نمایش ندهید؛
- از قرار دادن کلید در تیکت عمومی یا متن سفارش خودداری کنید؛
- دسترسی به تنظیمات جم پک را محدود کنید؛
- گزارش‌های HTTP و Proxy را از نظر ثبت URL شامل کلید بررسی کنید؛
- پس از تغییر اعضای تیم، کلیدها را بازبینی کنید؛
- شماره و متن مشتری را فقط برای هدف مرتبط با سفارش ارسال کنید؛
- در سیاست حریم خصوصی، انتقال شماره و متن لازم به کاوه‌نگار را توضیح دهید؛
- دوره نگهداری تاریخچه مرکز پیامک را محدود کنید؛
- هنگام ارسال تصویر خطا، API Key و شماره مشتری را محو کنید.
مقدار API Key در فرم مانند رمز عبور پنهان می‌شود و جزو اطلاعات محرمانه اتصال است. دسترسی به تنظیمات را محدود کنید و اگر کلید افشا شد، آن را تعویض کنید.
چک‌لیست نهایی کاوه‌نگار
- [ ] حساب کاوه‌نگار فعال است.
- [ ] وب‌سرویس حساب قابل استفاده است.
- [ ] API Key معتبر و محرمانه ثبت شده است.
- [ ] کاوه‌نگار به‌عنوان پنل فعال ذخیره شده است.
- [ ] شماره فرستنده Direct صحیح است یا عمداً خالی مانده است.
- [ ] اعتبار کافی در حساب وجود دارد.
- [ ] تست Direct موفق است.
- [ ] گزارش تست در خود پنل کاوه‌نگار دیده می‌شود.
- [ ] Template با نام انگلیسی و بدون فاصله ساخته شده است.
- [ ] Template تأیید نهایی شده است.
- [ ] نام Template در فیلد Pattern وارد شده است.
- [ ] ترتیب
%token،%token2،%token3،%token10و%token20رعایت شده است. - [ ] مقدارهای چندکلمه‌ای در جایگاه چهارم یا پنجم قرار دارند.
- [ ] بیش از پنج مقدار نگاشت نشده است.
- [ ] Pattern با رویداد واقعی سفارش آزمایش شده است.
- [ ] Direct و Pattern برای مدیر و مشتری جداگانه بررسی شده‌اند.
- [ ] نتیجه تاریخچه با گزارش کاوه‌نگار مقایسه شده است.
- [ ] API Key و شماره‌ها در تصاویر محو شده‌اند.
پیوندهای داخلی پیشنهادی
- راه‌اندازی مرکز پیامک ووکامرس
- آشنایی با محیط جم پک و مدیریت ماژول‌ها
- مرکز پیامک ووکامرس
- اتصال پنل قاصدک به مرکز پیامک
پیوند قاصدک پس از ایجاد مستند بعدی فعال شود.
منابع
جمع‌بندی
برای راه‌اندازی کاوه‌نگار ابتدا API Key و ارسال Direct را آزمایش کنید. سپس Template تأییدشده بسازید و نام آن را در Pattern وارد کنید. مهم‌ترین بخش اتصال، هماهنگی ترتیب ردیف‌ها با پنج جایگاه %token، %token2، %token3، %token10 و %token20 است.
سه جایگاه نخست برای مقدارهای کوتاه و بدون فاصله‌اند؛ مقدارهای چندکلمه‌ای را در جایگاه چهارم و پنجم قرار دهید. پس از هر تغییر، Pattern را با سفارش واقعی کنترل‌شده آزمایش و نتیجه را هم در تاریخچه مرکز پیامک و هم در پنل کاوه‌نگار بررسی کنید.