در این راهنما، اطلاعات اتصال، الگوها، متغیرها و خطاهای رایگان اس‌ام‌اس را بررسی می‌کنیم. برای انتخاب روش و اتصال مشترک، انتخاب پنل، برای تنظیم اعلان سفارش، مدیریت رویدادها و برای تشخیص خطاهای عمومی، عیب‌یابی پیامک را ببینید.
اتصال رایگان اس‌ام‌اس در جم پک دو روش ارسال دارد: پیامک مستقیم و پیامک الگویی. اطلاعات ورود این دو روش یکسان نیست. برای ارسال مستقیم، نام کاربری و رمز پنل لازم است؛ برای ارسال الگویی، «کد دسترسی» استفاده می‌شود. شماره فرستنده در هر دو روش ضروری است.
در پیام‌های الگویی، علاوه بر کد دسترسی، باید شناسه الگو و ترتیب داده‌های آن را درست ثبت کنید. جایگاه‌های الگو در این اتصال از [token1] شروع می‌شوند و حداکثر ۹ مقدار ارسال می‌شود.
این راهنما مخصوص گزینه RayganSMS در جم پک است. «رایگان اس‌ام‌اس» نام سرویس است و نباید آن را به معنی بی‌هزینه‌بودن ارسال پیام‌ها در نظر گرفت. اعتبار و هزینه ارسال را در حساب خود بررسی کنید.
برای تنظیم رویدادهای مدیر، مشتری و موجودی، راهنمای مرکز پیامک ووکامرس را هم در کنار این آموزش داشته باشید.
این راهنما چه مواردی را پوشش می‌دهد؟
- تشخیص اطلاعات لازم برای هر روش ارسال؛
- انتخاب رایگان اس‌ام‌اس در جم پک؛
- ثبت خط فرستنده و آزمون مستقیم؛
- ثبت کد دسترسی و شناسه الگو؛
- نگاشت داده‌های سفارش به جایگاه‌های الگو؛
- آزمون پیام الگویی با یک سفارش؛
- بررسی خطاهای اتصال، اعتبار، شماره‌ها و متن؛
- حفظ اطلاعات محرمانه هنگام تهیه گزارش و رسانه آموزشی.
چه اطلاعاتی را در کدام فیلد وارد کنیم؟
| عنوان فیلد در جم پک | مقدار موردنیاز | روش استفاده |
|---|---|---|
| کد دسترسی (Access Hash) | کد دسترسی صادرشده در پنل | ارسال الگویی |
| نام کاربری | نام کاربری حساب رایگان اس‌ام‌اس | ارسال مستقیم و تست عمومی |
| رمز عبور | رمز حساب مورد استفاده برای اتصال | ارسال مستقیم و تست عمومی |
| شماره فرستنده | خط مجاز حساب | مستقیم و الگویی |
| شناسه الگو | شناسه همان الگوی موردنظر در پنل | اعلان الگویی مربوط به یک رویداد |
چهار مورد اول در تنظیمات اتصال قرار دارند. شناسه الگو در تنظیمات پیام و رویداد مربوط ثبت می‌شود؛ یک شناسه عمومی برای تمام پیام‌های فروشگاه نیست.
کد دسترسی و شناسه الگو را جابه‌جا نکنید. کد دسترسی برای اجازه استفاده از سرویس است؛ شناسه الگو مشخص می‌کند کدام متن استفاده شود.
اختیاری‌بودن بعضی فیلدها در فرم، به معنی غیرضروری‌بودن آن‌ها در همه روش‌ها نیست. اتصال هنگام ارسال، اطلاعات موردنیاز همان روش را کنترل می‌کند.
آماده‌کردن حساب و اطلاعات اتصال
- وارد حساب رایگان اس‌ام‌اس شوید.
- خط مجاز ارسال را مشخص کنید.
- برای ارسال مستقیم، اطلاعات ورود صحیح حساب را آماده کنید.
- برای ارسال الگویی، کد دسترسی موردنیاز وب‌سرویس را از پنل دریافت کنید.
- اگر برای کد دسترسی محدودیت آی‌پی تعیین کرده‌اید، آی‌پی خروجی سرور سایت را بررسی کنید.
- وضعیت الگو و شناسه آن را برای استفاده در ارسال بررسی کنید.
- اعتبار حساب و مجازبودن خط برای روش موردنظر را کنترل کنید.
محل دقیق منوهای پنل در این راهنما تأیید نشده است. برای دریافت کد دسترسی، تأیید الگو و مجوز خط، از راهنمای داخل حساب یا پشتیبانی رایگان اس‌ام‌اس استفاده کنید.
آی‌پی خروجی سرور لزوماً همان آی‌پی دامنه، CDN یا رایانه مدیر نیست. اگر محدودیت آی‌پی دارید، مقدار صحیح را از هاست بپرسید و پس از جابه‌جایی هاست دوباره بررسی کنید.
انتخاب رایگان اس‌ام‌اس در جم پک
- وارد پیشخوان وردپرس شوید.
- در جم پک، «اعلان‌های پیامکی» را باز کنید.
- وارد «تنظیمات اصلی» شوید.
- «فعال‌سازی پیامک» را روشن کنید.
- در «درگاه پیامک»، گزینه
RayganSMSرا انتخاب کنید. - تنظیمات را ذخیره و صفحه را دوباره باز کنید.
- «شماره فرستنده» را وارد کنید.
- اطلاعات روش موردنیاز را تکمیل کنید:
- برای مستقیم: نام کاربری و رمز عبور؛
- برای الگویی: کد دسترسی؛
- برای هر دو: هر سه فیلد بالا.
- دوباره تنظیمات را ذخیره کنید.
پیش از تنظیم الگوها، انتخاب درگاه را ذخیره کنید. نگاشت یعنی تعیین کنید هر متغیر الگو با کدام داده پر شود. راهنمای آن بر اساس درگاه ذخیره‌شده نمایش داده می‌شود.
برای آزمون اولیه فقط یک رویداد را فعال کنید. با این کار تشخیص پیام ارسالی و کنترل هزینه ساده‌تر می‌شود.
ارسال مستقیم و الگویی چه تفاوتی دارند؟
پیامک مستقیم
جم پک متن نهایی را می‌سازد و آن را با نام کاربری، رمز عبور و خط فرستنده ارسال می‌کند. در این روش، شناسه الگو و کد دسترسی الگویی استفاده نمی‌شوند.
نمونه متن اعلان سفارش در جم پک:
سفارش {order_number} شما ثبت شد.
جم پک شماره سفارش را جای متغیر می‌گذارد و متن کامل را برای سرویس می‌فرستد. پذیرش متن و امکان ارسال از خط، به شرایط حساب و سرویس وابسته است.
الگو/قالب
جم پک شناسه الگو و مقدار جایگاه‌های آن را همراه کد دسترسی و شماره فرستنده ارسال می‌کند. نام کاربری و رمز پنل در درخواست الگویی این اتصال قرار نمی‌گیرند.
متن پایه باید در پنل برای استفاده آماده باشد. نوشتن یک متن در جم پک به‌تنهایی الگو را در سرویس ایجاد یا تأیید نمی‌کند.
برخلاف اتصال پیام‌رسان، شماره فرستنده در ارسال الگویی رایگان اس‌ام‌اس هم لازم است. این مقدار را با شماره مشتری اشتباه نگیرید.
آزمون اولیه ارسال مستقیم
پس از ذخیره اطلاعات:
- در «تنظیمات اصلی»، بخش تست پیامک را پیدا کنید.
- شماره متعلق به خودتان را در «شماره موبایل تست» وارد کنید.
- برای کاهش ابهام، از رقم‌های انگلیسی و قالب معمول شماره همراه ایران استفاده کنید.
- روی «ارسال پیامک تست» بزنید.
- تا اعلام نتیجه، دکمه را دوباره نزنید.
- نتیجه کادر تست، پنل سرویس و دریافت پیام در گوشی را بررسی کنید.
این تست از نام کاربری، رمز و شماره فرستنده استفاده می‌کند. کد دسترسی یا شناسه الگو را نمی‌آزماید و متن آن، پیام آماده جم پک است.
اگر فقط ارسال الگویی می‌خواهید، شکست تست مستقیم به‌دلیل نداشتن نام کاربری یا رمز ذخیره‌شده، به‌تنهایی خرابی مسیر الگویی را ثابت نمی‌کند. الگو را با رویداد سفارش آزمایش کنید.
پیامک تست در تاریخچه معمول اعلان‌ها ثبت نمی‌شود. برای بررسی نتیجه، پاسخ کادر تست، گزارش پنل و گوشی را ببینید.
آماده‌کردن الگو در پنل
برای شروع، یک متن ساده انتخاب کنید. نمونه آموزشی:
سفارش [token1] شما ثبت شد.
در این نمونه، اولین جایگاه باید شماره سفارش را دریافت کند. این متن صرفاً مثال است و به معنی وجود یا تأیید آن در حساب شما نیست.
- متن موردنظر را طبق راهنمای پنل آماده کنید.
- جایگاه‌ها را طبق روش الگوی رایگان اس‌ام‌اس تنظیم کنید؛ اتصال جم پک از
[token1]تا[token9]استفاده می‌کند. - وضعیت آماده‌بودن و مجازبودن الگو برای ارسال را بررسی کنید.
- شناسه همان الگو را بردارید.
- مشخص کنید هر جایگاه چه داده‌ای دریافت می‌کند.
- خط و کد دسترسی مجاز برای استفاده از آن را کنترل کنید.
شناسه الگو را کامل و بدون تغییر از پنل بردارید. آن را با شماره ردیف یک فهرست، شناسه پنل دیگر یا کد دسترسی جایگزین نکنید.
برای این اتصال حداکثر ۹ مقدار تعریف کنید. مقدار دهم و بعد از آن ارسال نمی‌شوند و ممکن است خطای مشخصی هم نمایش داده نشود.
ثبت شناسه و نگاشت الگو در جم پک
مراحل مشترک انتخاب مخاطب، رویداد، روش ارسال و ذخیره در مدیریت رویدادها و الگوهای پیامکی آمده است. در اجرای این مراحل، نکته اختصاصی این پنل را رعایت کنید:
شناسه الگو را ثبت کنید و ترتیب ردیف‌ها را با جایگاه‌های پنل تطبیق دهید.
برای نمونه تک‌متغیره، ردیف اول باید مقدار شماره سفارش را بگیرد. لازم نیست token1 را به‌عنوان داده سفارش بنویسید؛ جم پک شماره‌گذاری پارامترها را انجام می‌دهد.
روش ارسال مدیر و مشتری جداست. شناسه و نگاشت هر رویداد فعال را کنترل کنید؛ تکمیل یک الگو به معنی آماده‌شدن تمام اعلان‌ها نیست.
ترتیب متغیرهای الگو
فرض کنید متن پنل چنین باشد:
[token1] عزیز، سفارش [token2] شما در وضعیت [token3] قرار گرفت.
نگاشت موردنیاز:
| ترتیب ردیف | داده انتخابی در جم پک | جایگاه متن پنل |
|---|---|---|
| اول | نام مشتری — customer_name | [token1] |
| دوم | شماره سفارش — order_number | [token2] |
| سوم | وضعیت سفارش — order_status | [token3] |
با داده‌های فرضی «سارا احمدی»، «1250» و «در حال انجام»، پیام موردانتظار چنین است:
سارا احمدی عزیز، سفارش 1250 شما در وضعیت در حال انجام قرار گرفت.
این نمونه برای توضیح ترتیب است، نه گزارش ارسال واقعی.
در این اتصال، ترتیب ردیف‌ها تعیین می‌کند هر مقدار کجا قرار بگیرد. نوشتن یک نام دلخواه برای جایگاه، ترتیب را عوض نمی‌کند.
ردیف ناقص یا متغیر نامعتبر می‌تواند هنگام ساخت مقدارها کنار گذاشته شود و جایگاه داده‌های بعدی را تغییر دهد. نگاشت را بدون ردیف خالی یا نامعتبر ذخیره کنید.
اگر نگاشت خالی باشد، مسیر اعلان سفارش می‌تواند داده‌ها را از متغیرهای متن ذخیره‌شده استخراج کند. برای کنترل دقیق ترتیب داده‌ها، ردیف‌های نگاشت را مشخص و کامل کنید تا ترتیب به متن قدیمی وابسته نماند.
سه نام مشابه را اشتباه نگیرید
- «کد دسترسی» مجوز اتصال الگویی است.
- «شناسه الگو» متن موردنظر در پنل را مشخص می‌کند.
[token1]جایگاه یک مقدار در همان متن است.
متغیر جم پک مانند order_number نیز منبع داده را مشخص می‌کند. این نام را از فهرست نگاشت انتخاب می‌کنید؛ کد دسترسی یا شناسه الگو نباید جای آن قرار بگیرد.
آزمون پیام الگویی با سفارش
تست عمومی برای تأیید مسیر الگویی کافی نیست. یک رویداد واقعی آزمایشی را اجرا کنید:
- کد دسترسی و شماره فرستنده ذخیره‌شده را کنترل کنید.
- فقط اعلان موردنظر را فعال کنید.
- شناسه الگو و نگاشت همان رویداد را بازبینی کنید.
- در صورت نیاز به تاریخچه، ثبت گزارش پیامک را فعال کنید.
- شماره آزمایشی را در محل دریافت‌کننده قرار دهید: شماره صورتحساب برای مشتری یا شماره مدیر برای اعلان مدیر.
- برای اعلان ثبت سفارش، خرید آزمایشی تازه‌ای انجام دهید.
- برای اعلان تغییر وضعیت، سفارش آزمایشی را به وضعیت دارای اعلان ببرید.
- پیام گوشی، گزارش پنل و تاریخچه جم پک را مقایسه کنید.
- نام، شماره سفارش و سایر مقدارها را با داده واقعی همان سفارش تطبیق دهید.
در تاریخچه پیام الگویی، ممکن است خلاصه شناسه الگو و مقدارهای ارسالی را ببینید، نه متن کامل نهایی. برای دیدن متن نهایی، پیام دریافتی را هم بررسی کنید.
اگر نتیجه نامشخص بود، پیش از تکرار رویداد، پنل و گوشی را بررسی کنید. پایان زمان انتظار همیشه ثابت نمی‌کند که سرویس هیچ پیامی نپذیرفته است.
پس از موفقیت یک نمونه، رویدادهای مهم دیگر و گروه دریافت‌کننده دیگر را جدا آزمایش کنید.
موفقیت درخواست به معنی تحویل قطعی نیست
جم پک پاسخ‌های شناخته‌شده سرویس را تفسیر می‌کند و بر اساس آن‌ها نتیجه درخواست را گزارش می‌دهد. این نتیجه، تأیید دریافت پیام توسط گوشی نیست.
در اتصال بررسی‌شده، استعلام خودکار وضعیت نهایی تحویل وجود ندارد. برای اطمینان از نتیجه، دریافت واقعی و گزارش پنل را هم ببینید. موفقیت کلی یک درخواست چندگیرنده‌ای را نیز تأیید مستقل تحویل به تک‌تک شماره‌ها تلقی نکنید.
خطاهای رایج و روش بررسی
تنظیمات درگاه کامل نیست
در مسیر مستقیم، این پیام می‌تواند ناشی از خالی‌بودن نام کاربری، رمز عبور یا شماره فرستنده باشد. هر سه را بررسی و ذخیره کنید.
وجود کد دسترسی الگویی این خطا را در ارسال مستقیم برطرف نمی‌کند. ابتدا مشخص کنید خطا از تست عمومی است یا اعلان سفارش.
کد دسترسی تنظیم نشده است
این پیام مربوط به مسیر الگویی است. فیلد «کد دسترسی (Access Hash)» را با مقدار صحیح پنل تکمیل کنید؛ رمز ورود و شناسه الگو جایگزین آن نیستند.
اگر مقدار وارد شده ولی سرویس ارسال را نمی‌پذیرد، فعال‌بودن کد و محدودیت‌های احتمالی آی‌پی را در حساب بررسی کنید. کد خطای ویژه برای این وضعیت را بدون مشاهده پاسخ سرویس فرض نکنید.
شماره فرستنده تنظیم نشده یا نامعتبر است
شماره فرستنده در هر دو روش لازم است. خط مجاز حساب را وارد کنید، نه شماره مشتری.
اگر خطا از خود سرویس برمی‌گردد، مجوز استفاده از خط برای روش موردنظر را هم کنترل کنید. یک خط قابل‌استفاده در ارسال مستقیم، بدون بررسی لزوماً برای هر الگو آماده نیست.
کدهای عددی شناخته‌شده
این جدول از نگاشت خطاهای موجود در اتصال جم پک تهیه شده است. تمام شرایط سرویس به این شش کد محدود نیست.
| کد پاسخ | معنی در اتصال | اقدام پیشنهادی |
|---|---|---|
-1 | نام کاربری یا رمز اشتباه | در مسیر مستقیم، اطلاعات حساب را بررسی کنید؛ در مسیر الگویی، نوع درخواست و پاسخ را برای بررسی کد دسترسی به پشتیبانی بدهید |
-2 | اعتبار کافی نیست | اعتبار قابل‌استفاده حساب را بررسی کنید |
-3 | شماره فرستنده نامعتبر | خط را با خطوط مجاز حساب تطبیق دهید |
-4 | شماره گیرنده نادرست | شماره و قالب آن را کنترل کنید |
-5 | متن پیام خالی | متن یا داده‌های پیام موردنظر را بررسی کنید |
-6 | متن بیش از حد مجاز | متن و طول داده‌های متغیر را بررسی و حد مجاز را از سرویس تأیید کنید |
برای خطاهای نامشخص، عدد یا متن کامل پاسخ را نگه دارید. جدول خطای نیازپرداز، پیام‌رسان یا پنل دیگر را به این اتصال تعمیم ندهید.
تست مستقیم موفق است اما الگو کار نمی‌کند
تست مستقیم کد دسترسی یا شناسه الگو را بررسی نکرده است. موارد زیر را جدا کنترل کنید:
- کد دسترسی صحیح و قابل‌استفاده باشد.
- شماره فرستنده مجاز باشد.
- شناسه متعلق به همان الگوی آماده استفاده باشد.
- روش ارسال گروه موردنظر «الگو/قالب» باشد.
- شناسه همان رویداد تکمیل شده باشد.
- ترتیب و تعداد مقدارها با الگو مطابقت داشته باشد.
- محدودیت احتمالی آی‌پی کد دسترسی رعایت شده باشد.
الگو تنظیم شده ولی پیام مستقیم می‌رود
در مسیر اعلان سفارش، اگر شناسه الگوی رویداد خالی باشد، ارسال می‌تواند به مستقیم برگردد. شناسه تمام رویدادهای فعال گروه را تکمیل کنید.
اگر نام کاربری و رمز مستقیم را ذخیره نکرده باشید، همین بازگشت ممکن است به پیام «تنظیمات کامل نیست» منجر شود. انتخاب روش الگویی به‌تنهایی جای تکمیل شناسه هر رویداد را نمی‌گیرد.
مقدارها جابه‌جا یا ناقص‌اند
متن پنل را کنار فهرست نگاشت بگذارید و از ردیف اول بررسی کنید. ردیف اول برای [token1] است.
ردیف ناقص، متغیر نامعتبر و بیش از ۹ مقدار را بررسی کنید. مقدار دهم و بعد از آن در کد اتصال فرستاده نمی‌شوند. افزودن یک ردیف بیشتر راه‌حل تکمیل الگوی بزرگ‌تر نیست.
خطای شبکه یا پاسخ نامشخص دریافت می‌کنم
زمان رخداد و پاسخ نمایش‌داده‌شده را ثبت کنید. از هاست بخواهید دسترسی خروجی HTTPS به smspanel.trez.ir را بررسی کند.
این اتصال در همه حالت‌ها کد HTTP و شناسه پیگیری شبکه را به پیام خطا اضافه نمی‌کند. نبودن آن‌ها در پیام به معنی نبودن خطای شبکه نیست؛ بررسی بیشتر ممکن است به گزارش سمت سرور نیاز داشته باشد.
پیش از تکرار ارسال، پنل را بررسی کنید. برای رفع خطا، نشانی اتصال را به HTTP تبدیل نکنید و بررسی امنیت گواهی را خاموش نکنید.
امنیت اطلاعات اتصال
- رمز عبور و کد دسترسی را در تصویر یا ویدئو نمایش ندهید.
- آن‌ها را در متن پیام یا شناسه الگو قرار ندهید.
- گزارش فنی ممکن است بدنه درخواست و اطلاعات ورود را داشته باشد؛ پیش از اشتراک‌گذاری پاک‌سازی کنید.
- شماره مشتری، متن سفارش و داده‌های شخصی را از گزارش عمومی حذف کنید.
- در صورت افشای رمز یا کد دسترسی، مقدار مربوط را در پنل تغییر دهید و تنظیمات جم پک را به‌روز کنید.
- پس از تغییر رمز، ارسال مستقیم و پس از تغییر کد دسترسی، ارسال الگویی را دوباره بررسی کنید.
- پس از آزمون، شماره‌ها و اعلان‌های موقت را بازبینی کنید.
چک‌لیست پایان راه‌اندازی
- رایگان اس‌ام‌اس به‌عنوان درگاه ذخیره شده است.
- اطلاعات ورود موردنیاز هر روش، جداگانه و درست وارد شده‌اند.
- شماره فرستنده مجاز برای روش موردنظر ثبت شده است.
- شناسه الگوی هر رویداد فعال تکمیل شده است.
- ترتیب نگاشت با
[token1]به بعد هماهنگ است. - تعداد مقدارها از ۹ بیشتر نیست.
- آزمون مستقیم و الگویی با هم اشتباه گرفته نشده‌اند.
- یک سفارش آزمایشی اجرا و متن دریافتی کنترل شده است.
- موفقیت درخواست با تحویل قطعی یکسان فرض نشده است.
- اطلاعات محرمانه از رسانه و گزارش حذف شده‌اند.
جمع‌بندی
برای رایگان اس‌ام‌اس، ابتدا روش ارسال را مشخص کنید و اطلاعات همان روش را وارد کنید. شماره فرستنده در هر دو مسیر لازم است؛ ارسال الگویی علاوه بر آن، کد دسترسی، شناسه الگو و نگاشت مرتب تا ۹ مقدار می‌خواهد.
پس از تنظیم، مسیر مستقیم و الگوی سفارش را جدا آزمایش کنید و داده‌های پیام دریافتی را با سفارش مقایسه کنید.