اتصال پنل SMS.ir به مرکز پیامک

در این راهنما، اطلاعات اتصال، الگوها، متغیرها و خطاهای SMS.ir را بررسی می‌کنیم. برای انتخاب روش و اتصال مشترک، انتخاب پنل، برای تنظیم اعلان سفارش، مدیریت رویدادها و برای تشخیص خطاهای عمومی، عیب‌یابی پیامک را ببینید.

اتصال SMS.ir در مرکز پیامک جم پک امکان ارسال اعلان‌های سفارش ووکامرس، هشدارهای موجودی و پیام‌های دستی را از حساب SMS.ir فراهم می‌کند. این اتصال دو مسیر مستقل دارد:

• Direct: متن کامل پیام با شماره خط اختصاصی از Endpoint ارسال گروهی فرستاده می‌شود؛
• Pattern: قالب تأییدشده با templateId عددی و پارامترهای نام‌دار از Endpoint Verify ارسال می‌شود.

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

برای تنظیم رویدادها، پیام مدیر و مشتری، هشدار موجودی، ارسال دستی، تاریخچه و حریم خصوصی، ابتدا راه‌اندازی مرکز پیامک ووکامرس را مطالعه کنید. این صفحه فقط تفاوت‌ها و تنظیمات اختصاصی SMS.ir را پوشش می‌دهد.

این راهنما چه مواردی را پوشش می‌دهد؟

• دریافت و ثبت API Key؛
• تعیین شماره خط Direct؛
• انتخاب SMS.ir در مرکز پیامک؛
• آزمون ارسال معمولی؛
• ساخت قالب در بخش ارسال سریع؛
• دریافت templateId عددی؛
• ثبت متغیرها بدون علامت #؛
• رعایت محدودیت ۲۵ کاراکتری هر مقدار؛
• آزمون Verify با سفارش واقعی؛
• تفسیر کدهای وضعیت SMS.ir؛
• تشخیص خطاهای خط، اعتبار، کلید، موبایل و Template؛
• تفکیک پذیرش API از Delivery؛
• نکات امنیت و حریم خصوصی.

اطلاعات موردنیاز اتصال

در نسخه بررسی‌شده، اتصال SMS.ir دو فیلد دارد:

فیلد	وضعیت	کاربرد
API Key	همیشه اجباری	احراز هویت با هدر x-api-key
شماره فرستنده	برای Direct اجباری	مقدار lineNumber

شماره فرستنده در تعریف عمومی فیلد اختیاری نمایش داده می‌شود، زیرا Pattern به آن نیاز ندارد. اما اگر Direct، پیام آزمایشی یا ارسال دستی را اجرا کنید و این فیلد خالی باشد، جم پک پیش از تماس با API خطا می‌دهد.

Pattern شماره فرستنده این بخش را نادیده می‌گیرد و از خط مرتبط با قالب تأییدشده SMS.ir استفاده می‌کند.

دریافت API Key

پس از ورود به حساب SMS.ir، از بخش برنامه‌نویسان یا مدیریت کلیدهای خصوصی، API Key مربوط به وب‌سرویس را دریافت کنید.

نکات پیشنهادی:

• برای سایت آزمایشی و اصلی کلید جداگانه داشته باشید؛
• کلید را بدون فاصله ابتدا و انتها کپی کنید؛
• کلید فعال و متعلق به حساب دارای اعتبار باشد؛
• اگر محدودیت IP برای کلید فعال کرده‌اید، IP خروجی سرور را درست ثبت کنید؛
• کلید را در Screenshot، ویدئو یا تیکت عمومی نمایش ندهید؛
• در صورت افشا، کلید را غیرفعال و کلید تازه‌ای ایجاد کنید.

در اتصال نسخه بررسی‌شده، کلید داخل Header فرستاده می‌شود:

x-api-key: YOUR_API_KEY

رمز ورود پنل، Secret Key نسخه‌های قدیمی یا Token موقت را در این فیلد وارد نکنید. این اتصال برای REST API نسخه ۱ و API Key جدید طراحی شده است.

دریافت شماره خط

شماره خط را از فهرست خطوط فعال حساب بردارید. این مقدار باید:

• متعلق به همان حساب API باشد؛
• برای ارسال وب‌سرویس فعال باشد؛
• با ارقام انگلیسی و بدون فاصله ثبت شود؛
• برای نوع پیام و مقصد موردنظر مجاز باشد.

نمونه ساختاری:

3000XXXXXXXX

مستند رسمی SMS.ir، lineNumber را برای Endpoint Direct اجباری معرفی می‌کند. اگر خط غیرفعال، نامعتبر یا متعلق به حساب دیگری باشد، ارسال رد می‌شود.

انتخاب SMS.ir در مرکز پیامک

برای اتصال:

1. وارد پیشخوان وردپرس شوید.
2. از منوی جم پک، «اعلان‌های پیامکی» را باز کنید.
3. وارد «تنظیمات عمومی» شوید.
4. مرکز پیامک را فعال کنید.
5. «SMS.ir» را از فهرست پنل‌ها انتخاب کنید.
6. تنظیمات را ذخیره کنید.
7. صفحه را تازه‌سازی کنید.
8. API Key را وارد کنید.
9. شماره فرستنده Direct را ثبت کنید.
10. تنظیمات را دوباره ذخیره کنید.

مسیر فنی صفحه:

/wp-admin/admin.php?page=gempack#sms-settings

پیش از تنظیم الگو، انتخاب پنل را ذخیره کنید تا فرم نگاشت متغیرها متناسب با SMS.ir نمایش داده شود.

ارسال Direct چگونه انجام می‌شود؟

نسخه بررسی‌شده درخواست POST با بدنه JSON را به Endpoint زیر می‌فرستد:

https://api.sms.ir/v1/send/bulk

بدنه استفاده‌شده:

{
  "lineNumber": "3000XXXXXXXX",
  "messageText": "متن نهایی پیام",
  "mobiles": ["09120000000"]
}

هدرهای اصلی:

x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: application/json

افزونه حداکثر ۳۰ ثانیه منتظر پاسخ می‌ماند. اگر وردپرس خطای اتصال برگرداند، متن آن برای عیب‌یابی ثبت می‌شود.

جم پک پاسخ JSON را بررسی می‌کند و فقط مقدار زیر را موفق می‌داند:

status = 1

موفق‌بودن HTTP به‌تنهایی کافی نیست؛ status داخلی پاسخ باید برابر ۱ باشد.

اتصال فعلی پارامتر زمان‌بندی ارسال را تنظیم نمی‌کند و از Endpointهای Like-to-Like یا ارسال URL استفاده نمی‌کند.

آزمون اولیه Direct

پیش از فعال‌کردن پیام‌های سفارش:

1. API Key و شماره خط را ذخیره کنید.
2. در فرم پیام آزمایشی، شماره مقصد را با ارقام انگلیسی وارد کنید.
3. یک متن کوتاه و غیرتبلیغاتی بنویسید.
4. ارسال را اجرا کنید.
5. نتیجه کنار فرم را یادداشت کنید.
6. گزارش ارسال را در پنل SMS.ir بررسی کنید.
7. دریافت پیام در گوشی را کنترل کنید.

نمونه متن:

این یک پیام آزمایشی از مرکز پیامک فروشگاه است.

پیام آزمایشی از Direct استفاده می‌کند و در تاریخچه مرکزی جم پک ثبت نمی‌شود. بنابراین نتیجه فرم و گزارش پنل SMS.ir را مبنا قرار دهید.

موفقیت Direct، قالب Verify و پارامترهای آن را تأیید نمی‌کند. Pattern را جداگانه و با رویداد واقعی آزمایش کنید.

Pattern یا Verify در SMS.ir

ارسال Pattern از Endpoint زیر انجام می‌شود:

https://api.sms.ir/v1/send/verify

ساختار درخواست:

{
  "mobile": "09120000000",
  "templateId": 123456,
  "parameters": [
    { "name": "Order", "value": "1052" },
    { "name": "Status", "value": "آماده ارسال" }
  ]
}

سه بخش اجباری‌اند:

• شماره موبایل؛
• شناسه عددی Template؛
• آرایه‌ای غیرخالی از پارامترهای نام‌دار.

براساس راهنمای رسمی Verify، این روش برای پیام‌های اولویت‌بالا مانند کد تأیید، فاکتور و اطلاع‌رسانی وضعیت سفارش طراحی شده است و پیش از استفاده باید قالب در بخش ارسال سریع پنل تعریف شود.

ساخت قالب ارسال سریع

در پنل SMS.ir یک قالب برای رویداد موردنظر ایجاد کنید. قالب باید:

• متن خدماتی و روشن داشته باشد؛
• متغیرها را با نام‌های کوتاه و مشخص تعریف کند؛
• برای رویداد واقعی فروشگاه مناسب باشد؛
• تأیید و فعال شود؛
• شناسه عددی قابل استفاده داشته باشد.

نمونه متن قالب:

#Name# عزیز، سفارش #Order# در #Shop# اکنون #Status# است.

نمونه نام متغیرها:

• Name
• Order
• Shop
• Status

پس از تأیید، شناسه عددی Template را از پنل بردارید. برای مثال:

123456

در فیلد Pattern ID جم پک، فقط همین عدد را وارد کنید. نام قالب یا متن پیام قابل قبول نیست. نسخه بررسی‌شده مقدار را به عدد تبدیل می‌کند و شناسه صفر یا منفی را پیش از ارسال رد می‌کند.

نگاشت متغیرهای نام‌دار

در SMS.ir ترتیب ردیف‌ها معیار تطبیق نیست؛ نام پارامتر تعیین می‌کند هر مقدار در کجای قالب قرار بگیرد.

برای قالب زیر:

#Name# عزیز، سفارش #Order# در #Shop# اکنون #Status# است.

نگاشت صحیح:

کلید در نگاشت جم پک	متغیر انتخابی
Name	{customer_name}
Order	{order_number}
Shop	{shop_name}
Status	{order_status}

علامت # را وارد نکنید. برای متغیر #Order#، این مقدار درست است:

Order

این مقدار نادرست است:

#Order#

نام‌ها همان‌طور که تایپ شده‌اند به SMS.ir می‌روند. بزرگی و کوچکی حروف، املای نام و نویسه‌ها را دقیقاً با قالب پنل تطبیق دهید.

آیا ترتیب ردیف‌ها مهم است؟

خیر. هر ردیف به‌صورت جفت name و value ارسال می‌شود. بااین‌حال حفظ ترتیب ظاهری قالب، نگهداری تنظیمات را ساده‌تر می‌کند.

آیا باید نگاشت متغیرها را مشخص کنم؟

برای هر قالب، نام و داده همه متغیرها را در نگاشت مشخص کنید. اگر نگاشت خالی باشد، افزونه نام متغیرها را از متن ذخیره‌شده استخراج می‌کند. این روش فقط وقتی کار می‌کند که نام متغیرهای قالب دقیقاً با نام متغیرهای جم پک یکسان باشد؛ بنابراین بهتر است به آن تکیه نکنید.

اگر ردیف‌های نگاشت ساخته شده باشند ولی نام آن‌ها خالی باشد، ردیف بدون نام کنار گذاشته می‌شود. اگر هیچ پارامتری باقی نماند، جم پک پیش از تماس با API خطای توضیحی نمایش می‌دهد.

محدودیت ۲۵ کاراکتری

SMS.ir مقدار هر پارامتر Verify را به حداکثر ۲۵ کاراکتر محدود می‌کند. طول بیش از این مقدار با خطای 114 رد می‌شود.

مناسب:

• شماره سفارش؛
• نام کوتاه مشتری؛
• وضعیت کوتاه سفارش؛
• تعداد اقلام؛
• مبلغ کوتاه‌شده؛
• SKU کوتاه.

مقدارهایی که ممکن است از سقف مجاز عبور کنند:

• {order_items} شامل فهرست محصولات؛
• عنوان بسیار بلند محصول؛
• نام و نام خانوادگی طولانی؛
• نشانی کامل؛
• URL بلند؛
• متن توضیحی چندجمله‌ای.

در نسخه بررسی‌شده، اگر افزونه mbstring روی PHP فعال باشد، طول بر مبنای تعداد کاراکتر بررسی می‌شود و نام پارامترهای طولانی پیش از ارسال اعلام می‌گردد. اگر mbstring در دسترس نباشد، کنترل طول به خود SMS.ir واگذار می‌شود.

متن فارسی چندبایتی است؛ شمارش بایت با شمارش کاراکتر یکسان نیست. به همین دلیل برای کاهش احتمال خطا، مقدارهایی انتخاب کنید که طولشان کمتر از سقف ۲۵ کاراکتر باشد.

نمونه‌های پیشنهادی Pattern

سفارش جدید برای مدیر

قالب:

سفارش #Order# با مبلغ #Total# ثبت شد. #Shop#

نگاشت:

کلید	متغیر	کنترل طول
Order	{order_number}	معمولاً کوتاه
Total	{order_total}	با واحد پول آزمایش شود
Shop	{shop_name}	باید کمتر از ۲۶ کاراکتر باشد

تغییر وضعیت برای مشتری

قالب:

#Name# عزیز، سفارش #Order# اکنون #Status# است.

نگاشت:

کلید	متغیر	کنترل طول
Name	{billing_first_name}	از نام کامل کوتاه‌تر است
Order	{order_number}	معمولاً کوتاه
Status	{order_status}	وضعیت سفارشی را آزمایش کنید

استفاده از {billing_first_name} به‌جای {customer_name} احتمال عبور نام طولانی از سقف را کمتر می‌کند.

هشدار موجودی

قالب:

موجودی SKU #Sku# به #Stock# رسید.

نگاشت:

کلید	متغیر
Sku	{product_sku}
Stock	{stock}

عنوان محصول ممکن است طولانی باشد؛ برای Pattern موجودی، SKU کوتاه انتخاب مطمئن‌تری است. اگر SKU خالی است، پیش از فعال‌سازی آن را برای محصولات هدف تکمیل کنید.

فعال‌سازی Pattern در مرکز پیامک

مراحل مشترک انتخاب مخاطب، رویداد، روش ارسال و ذخیره در مدیریت رویدادها و الگوهای پیامکی آمده است. در اجرای این مراحل، نکته اختصاصی این پنل را رعایت کنید:

شناسه عددی templateId را ثبت کنید؛ نام هر متغیر و سقف ۲۵ کاراکتری مقدار را طبق همین راهنما بررسی کنید.

تنظیمات Pattern هر پنل مستقل ذخیره می‌شوند. تغییر پنل، شناسه‌ها و نگاشت‌های SMS.ir را حذف نمی‌کند؛ اما پس از بازگشت باید کلید، خط، قالب و پلن را دوباره آزمایش کنید.

اگر Pattern انتخاب شود ولی templateId همان رویداد خالی باشد، نسخه بررسی‌شده به Direct برمی‌گردد. از آنجا که Direct به شماره خط نیاز دارد، این بازگشت می‌تواند به ارسال متن آزاد یا خطای «شماره فرستنده تنظیم نشده است» منجر شود.

آزمون Pattern با سفارش واقعی

فرم تست عمومی فقط Direct را اجرا می‌کند. برای آزمون Verify:

1. یک قالب ساده و تأییدشده انتخاب کنید.
2. فقط یک اعلان مشتری یا مدیر را فعال کنید.
3. شناسه عددی Template را وارد کنید.
4. نگاشت همه پارامترها را بسازید.
5. مقدار آزمایشی هر پارامتر را زیر ۲۶ کاراکتر نگه دارید.
6. شماره موبایل مشتری را با ارقام انگلیسی در سفارش ثبت کنید.
7. رویداد هدف را اجرا کنید.
8. تاریخچه مرکز پیامک را براساس سفارش فیلتر کنید.
9. گزارش SMS.ir را با زمان و شماره مقصد تطبیق دهید.
10. مقدار متغیرها را در پیام دریافتی کنترل کنید.

ترتیب پیشنهادی آزمون:

1. Direct با متن کوتاه؛
2. Verify با یک پارامتر؛
3. Verify کامل سفارش؛
4. آزمون یک مقدار نزدیک به سقف طول؛
5. آزمون مقصد دارای محدودیت تبلیغاتی، در صورت مجازبودن قالب خدماتی.

پاسخ موفق و Delivery

مدل عمومی پاسخ SMS.ir شامل status، message و data است. در ارسال موفق:

status = 1

داده پاسخ Direct می‌تواند Pack ID و Message IDها و پاسخ Verify می‌تواند Message ID و هزینه را شامل شود. اتصال نسخه بررسی‌شده فقط موفق یا ناموفق بودن را به مرکز برمی‌گرداند و شناسه پیام را برای استعلام خودکار Delivery ذخیره نمی‌کند.

بنابراین:

• sent در تاریخچه یعنی API ارسال را موفق اعلام کرده است؛
• برای رسیدن به گوشی، گزارش پیام را در پنل SMS.ir ببینید؛
• وضعیت بلک‌لیست، خط و اپراتور را جداگانه بررسی کنید.

کدهای خطای مهم

کدهای زیر در مستند رسمی SMS.ir آمده‌اند و برای این اتصال کاربرد بیشتری دارند:

Status	معنی	اقدام پیشنهادی
0	خطای داخلی سامانه	بعداً دوباره آزمایش و با پشتیبانی پیگیری کنید
10	API Key نامعتبر	کلید را دوباره ثبت کنید
11	API Key غیرفعال	کلید را در پنل فعال یا تعویض کنید
12	کلید به IPهای مشخص محدود است	IP خروجی سایت را در محدودیت کلید بررسی کنید
13	حساب غیرفعال	وضعیت حساب را پیگیری کنید
14	حساب معلق	علت تعلیق را از پنل یا پشتیبانی بررسی کنید
20	تعداد درخواست بیش از حد	نرخ ارسال را کاهش دهید و بعداً تلاش کنید
101	شماره خط نامعتبر	خط Direct را اصلاح کنید
102	اعتبار ناکافی	حساب را شارژ کنید
103	متن خالی	متن و متغیرهای رویداد را بررسی کنید
104	موبایل نامعتبر	قالب شماره و ارقام انگلیسی را کنترل کنید
113	Template پیدا نشد	templateId را با پنل تطبیق دهید
114	مقدار پارامتر بیش از ۲۵ کاراکتر	متغیر کوتاه‌تری انتخاب کنید
115	شماره در لیست سیاه	نوع خط و قالب خدماتی را بررسی کنید
116	نام پارامتر خالی	برای هر ردیف، کلید بدون # وارد کنید
117	متن تأیید نشده	وضعیت و متن قالب را کنترل کنید
119	پلن برای قالب شخصی کافی نیست	پلن حساب را ارتقا دهید
123	خط فرستنده نیاز به فعال‌سازی دارد	فعال‌بودن خط را از SMS.ir پیگیری کنید

فهرست بروزشده در جدول کدهای وضعیت SMS.ir قرار دارد.

عیب‌یابی

خطای «API Key تنظیم نشده است»

• SMS.ir را انتخاب و ذخیره کنید؛
• کلید را در فیلد مخصوص وارد کنید؛
• تنظیمات را دوباره ذخیره کنید؛
• پس از درون‌ریزی تنظیمات یا انتقال سایت، اطلاعات محرمانه اتصال را دوباره وارد کنید.

خطای «شماره فرستنده تنظیم نشده است»

این خطا مربوط به Direct است.

• شماره خط فعال را وارد کنید؛
• مطمئن شوید روش ارسال واقعاً Direct است؛
• اگر Pattern ناقص است، احتمال بازگشت خودکار به Direct را بررسی کنید؛
• پیام دستی و پیام آزمایشی همیشه به خط Direct نیاز دارند.

خطای 101 یا 123

• شماره خط را دقیقاً از پنل کپی کنید؛
• از ارقام انگلیسی استفاده کنید؛
• فاصله و علامت اضافه را حذف کنید؛
• مالکیت خط و دسترسی وب‌سرویس را بررسی کنید؛
• فعال‌سازی خط را از پشتیبانی SMS.ir پیگیری کنید.

خطای 10، 11 یا 12

• در 10 کلید نادرست یا متعلق به حساب دیگری است؛
• در 11 کلید در پنل غیرفعال شده است؛
• در 12 IP خروجی سرور با محدودیت‌های کلید تطابق ندارد؛
• پس از اصلاح، ابتدا Direct را دوباره آزمایش کنید.

Direct موفق است اما Verify خطا می‌دهد

• templateId باید عدد مثبت باشد؛
• قالب باید تأیید و فعال باشد؛
• آرایه پارامترها نباید خالی باشد؛
• کلیدها را بدون # وارد کنید؛
• املا و بزرگی حروف را با قالب تطبیق دهید؛
• طول هر مقدار را زیر ۲۶ کاراکتر نگه دارید؛
• وضعیت پلن را در صورت خطای 119 بررسی کنید؛
• Verify را با سفارش واقعی، نه فرم تست Direct، اجرا کنید.

خطای 114

یکی از مقدارهای Pattern بیش از ۲۵ کاراکتر است.

• متغیر بلند را شناسایی کنید؛
• {order_items} را از Pattern حذف کنید؛
• نام کامل را با نام کوچک جایگزین کنید؛
• عنوان محصول را با SKU جایگزین کنید؛
• نام فروشگاه یا وضعیت سفارشی را کوتاه کنید؛
• دوباره با طول واقعی داده سفارش آزمایش کنید.

خطای 116

نام یک پارامتر خالی است.

• همه ردیف‌های نگاشت را باز کنید؛
• برای هر ردیف کلید وارد کنید؛
• علامت # را حذف کنید؛
• ردیف ناقص و بلااستفاده را پاک کنید؛
• نگاشت را ذخیره و رویداد را دوباره اجرا کنید.

Pattern انتخاب شده ولی Direct اجرا می‌شود

برای تشخیص این وضعیت، مراحل رفع خطاهای اتصال و ارسال پیامک را دنبال کنید. برای بررسی کلید، خط فرستنده و قالب، به بخش مربوط در همین راهنما مراجعه کنید.

پیام sent است ولی دریافت نشده

برای تشخیص این وضعیت، مراحل رفع خطاهای اتصال و ارسال پیامک را دنبال کنید. برای بررسی کلید، خط فرستنده و قالب، به بخش مربوط در همین راهنما مراجعه کنید.

خطای شبکه، 401 یا 429

• دسترسی HTTPS سرور به api.sms.ir را بررسی کنید؛
• DNS و Firewall خروجی هاست را کنترل کنید؛
• API Key و محدودیت IP را بررسی کنید؛
• در 429 سرعت یا تعداد درخواست را کاهش دهید؛
• پس از رفع مشکل، ارسال را کنترل‌شده تکرار کنید.

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

نکات امنیتی و حریم خصوصی

• API Key را مانند رمز عبور نگهداری کنید؛
• کلید را در تصویر، ویدئو یا گزارش عمومی نمایش ندهید؛
• دسترسی کاربران به تنظیمات مرکز پیامک را محدود کنید؛
• برای محیط آزمایشی و اصلی کلیدهای جداگانه داشته باشید؛
• محدودیت IP کلید را پس از مهاجرت هاست بازبینی کنید؛
• از ارسال داده حساس در پارامترهای Verify خودداری کنید؛
• شماره و متن مشتری را فقط برای هدف مرتبط با سفارش استفاده کنید؛
• انتقال اطلاعات لازم به SMS.ir را در سیاست حریم خصوصی توضیح دهید؛
• دوره نگهداری تاریخچه را متناسب با نیاز واقعی تنظیم کنید؛
• پس از افشای احتمالی، کلید را فوراً تعویض کنید.

مقدار API Key در فرم مانند رمز عبور پنهان می‌شود و جزو اطلاعات محرمانه اتصال است. بااین‌حال، دسترسی کاربران به تنظیمات را هم باید محدود کنید.

چک‌لیست نهایی SMS.ir

• [ ] حساب و API فعال‌اند.
• [ ] API Key معتبر ثبت شده است.
• [ ] محدودیت IP کلید با سرور تطابق دارد.
• [ ] SMS.ir به‌عنوان پنل فعال ذخیره شده است.
• [ ] شماره خط Direct صحیح و فعال است.
• [ ] اعتبار کافی در حساب وجود دارد.
• [ ] پیام آزمایشی Direct موفق بوده است.
• [ ] نتیجه Direct در پنل SMS.ir دیده می‌شود.
• [ ] قالب ارسال سریع تأیید شده است.
• [ ] templateId عددی مثبت ثبت شده است.
• [ ] همه کلیدهای نگاشت بدون # وارد شده‌اند.
• [ ] نام کلیدها با Template تطابق کامل دارد.
• [ ] هیچ ردیف نگاشت ناقص نیست.
• [ ] مقدار هر پارامتر حداکثر ۲۵ کاراکتر است.
• [ ] Verify با سفارش واقعی آزمایش شده است.
• [ ] نتیجه تاریخچه با پنل SMS.ir مقایسه شده است.
• [ ] تفاوت sent و Delivery برای تیم روشن است.
• [ ] API Key و شماره‌ها در تصاویر محو شده‌اند.

پیوندهای داخلی پیشنهادی

• راه‌اندازی مرکز پیامک ووکامرس
• اتصال پنل قاصدک به مرکز پیامک
• آشنایی با محیط جم پک و مدیریت ماژول‌ها
• مرکز پیامک ووکامرس
• اتصال پنل ملی‌پیامک به مرکز پیامک

پیوند ملی‌پیامک پس از ایجاد مستند بعدی فعال شود.

منابع

• مستند رسمی REST API سامانه SMS.ir
• بخش Verify و مدل پارامترها
• پکیج رسمی Laravel برای SMS.ir

جمع‌بندی

برای اتصال SMS.ir، ابتدا API Key و شماره خط فعال را ثبت و Direct را آزمایش کنید. سپس قالب ارسال سریع را بسازید، templateId عددی آن را وارد کنید و همه پارامترها را با نام خام و بدون علامت # نگاشت کنید.

مهم‌ترین محدودیت Pattern، سقف ۲۵ کاراکتر برای مقدار هر پارامتر است. متغیرهای کوتاه مانند شماره سفارش، نام کوچک، وضعیت کوتاه و SKU انتخاب‌های مناسب‌تری هستند. پس از آزمون واقعی، نتیجه را هم در تاریخچه مرکز پیامک و هم در گزارش SMS.ir بررسی کنید.