یکی از امکانات ضروری هر وب‌سایت بزرگ، وبسرویس پیامک است. وب‌سایت‌ها و اپلیکیشن‌ها برای ارسال پیامک‌های اطلاع‌رسانی مختلف مانند ثبت‌نام و ورود کاربران، ارسال کد تأیید (OTP)، بازیابی رمز عبور، ثبت و تغییر وضعیت سفارش‌ها، تکمیل فرم‌ها و اطلاع‌رسانی حمل و نقل از وبسرویس پیامکی استفاده می‌کنند. در این فرآیند، برنامه‌نویسان و توسعه‌دهندگان کسب‌وکارها هنگام پیاده‌سازی و استفاده از وبسرویس و API پیامک با خطاهایی مواجه میشوند. در این مقاله از پنل پیامکی آذرخش انواع خطاها و روش برطرف کردن خطاهای وبسرویس پنل پیامکی را معرفی می کنیم.
برای مشاوره جهت خرید پنل پیامکی با ما تماس بگیرید
همکاران ما در تیم پشتیبانی منتظر تماس شما هستند.
021-
91035156
وبسرویس و API چیست؟
وب سرویس (API) یک رابط برنامه‌نویسی است و بین نرم‌افزارها و وب‌سایت‌ها تعامل برقرار میکند. این رابط‌ها با استفاده از پروتکل‌هایی مانند HTTP و HTTPS، خدمات مختلفی را در اختیار توسعه‌دهندگان قرار می‌دهند. وب سرویس پیامکی یکی از همین سرویس‌ها است تا به صورت خودکار و برنامه‌ریزی شده، پیامک‌های تبلیغاتی، اطلاع‌رسانی یا تراکنش را به مشتریان خود ارسال کنید.
این سرویس‌ها مانند یک پل ارتباطی عمل کرده تا نرم‌افزار یا وب‌سایت خود را به یک سامانه پیامکی قدرتمند مانند پنل پیامکی آذرخش متصل کنید. با استفاده از وب سرویس به سادگی پیامک‌های خود را مدیریت کرده و از ارسال پیامک‌های زمان‌بندی شده، دریافت گزارش‌های دقیق و استفاده از دفترچه تلفن استفاده کنید.
این مطلب را نیز بخوانید: پنل پیامکی برای باشگاه مشتریان
لیست خطاهای وبسرویس پنل پیامکی
برخی از رایج‌ترین خطاها در هنگام استفاده از وب سرویس ارسال پیامک (اعم از خطوط اختصاصی و خدماتی) و وب سرویس ارسال پیامک بر اساس الگو (وب سرویس خدماتی) را توضیح میدهیم. قبل از بررسی خطاها تفاوت بین خطوط اختصاصی و خدماتی را توضیح میدهیم:
خط اختصاصی: هر پنل پیامکی یک یا چند خط اختصاصی دارد که برای ارسال پیام‌های تبلیغاتی استفاده میشوند. این خطوط به دلیل ماهیت تبلیغاتی‌شان، امکان ارسال پیام به افرادی که پیام‌های تبلیغاتی را مسدود کرده‌اند (لیست سیاه مخابرات) را ندارند.
خط خدماتی: این خطوط برای ارسال پیام‌های غیرتبلیغاتی مانند پیام‌های اطلاع‌رسانی، تاییدیه تراکنش‌ها و … استفاده میشوند. برای دریافت خط خدماتی، نیاز به ارائه مدارک خاصی به اپراتور است. با خطوط خدماتی به افرادی که پیام‌های تبلیغاتی را مسدود کردند پیام ارسال کنید.
خطاهای وب سرویس ارسال پیامک
پس از استفاده از وبسرویس پنل پیامکی آذرخش سامانه یک عدد را به عنوان پاسخ درخواست وبسرویس و API به شما ارسال میکند که هر یک از این اعداد معنای خاصی دارند.
- رشته اعداد چند رقمی recId
این عدد یک شناسه منحصر به فرد برای هر ارسال پیامک موفق است. اگر recId دریافتی بیش از 15 رقم باشد، یعنی ارسال پیامک با موفقیت انجام شده و برای پیگیری گزارش و وضعیت ارسال، می‌توانید از متد GetDeliveries استفاده کنید.
کدهای خطای مختلف عبارتند از:
1-: خطای نامشخص رخ داده است. لطفاً با پشتیبانی تماس بگیرید.
0: پنل اس ام اس قادر به اتصال به وبسرویس نیست یا نام کاربری و رمز عبور وارد شده صحیح نمی‌باشد.
1: ارسال پیامک با موفقیت انجام شده است.
2: موجودی و اعتبار پنل اس ام اس کافی نیست.
3: محدودیت در تعداد ارسال پیامک‌های روزانه.
4: محدودیت در حجم و تعداد ارسال پیامک‌ها.
5: شماره فرستنده یا سرشماره پیامکی معتبر نمی‌باشد.
6: سامانه در حال بروزرسانی است.
7: متن پیامک شامل کلمات فیلتر شده است.
8: حداقل تعداد پیامک ارسال نشده است.
9: ارسال از خطوط عمومی از طریق وبسرویس امکان‌پذیر نمی‌باشد.
10: پنل اس ام اس کاربر غیرفعال یا مسدود شده است.
11: ارسال پیامک انجام نشده؛ شماره موبایل گیرنده در لیست سیاه مخابرات قرار دارد.
12: مدارک پنل اس ام اس کاربر تکمیل نیست.
14: سرشماره فرستنده پیامک اجازه ارسال لینک ندارد.
15: در صورتی که بیش از یک شماره موبایل در رکورد درخواست ارسال پیامک وارد کنید و عبارت «لغو11» را در انتهای متن ننویسید، با این خطا مواجه خواهید شد.
35: هنگام استفاده از REST، این کد به معنای قرار گرفتن شماره موبایل گیرنده در لیست سیاه مخابرات است.
خطاهای وبسرویس پنل پیامکی بر اساس پترن (الگو)
یکی دیگر از متدهای محبوب ارسال پیامک در سامانه پنل پیامکی آذرخش ارسال از طریق پترن (الگو) است تا از خطوط خدماتی سامانه به‌صورت اشتراکی استفاده کنید. همانند دیگر متدها، وبسرویس در این روش با ارسال پاسخ عددی به شما کمک کرده تا مشکلات احتمالی را رفع کنید. این خطاهای عددی به شرح زیر هستند:
- رشته اعداد چند رقمی recId
این عدد یک شناسه یکتا برای هر ارسال موفق است. اگر recId دریافتی بیشتر از 15 رقم باشد، به این معناست که ارسال پیامک با موفقیت انجام شده و برای پیگیری گزارش و وضعیت ارسال از متد GetDeliveries استفاده کنید.
- کدهای خطای احتمالی
7-: خطایی در شماره فرستنده پیامک رخ داده است. لطفاً با پشتیبانی فنی تماس بگیرید.
6-: خطای داخلی رخ داده است. لطفاً با پشتیبانی فنی تماس بگیرید. (ممکن است الگو یا پترن به درستی وارد نشده باشد، مانند استفاده اشتباه از کاراکترها یا ترتیب نادرست متغیرها)
این مطلب را نیز بخوانید: شارژ پنل پیامک
5-: تعداد اندیس‌های آرایه پارامتر text با تعداد متغیرهای پترن شما مطابقت ندارد. (مثلاً اگر پترن شما 3 متغیر دارد، تعداد اندیس‌های پارامتر text باید دقیقاً 3 باشد.)
4-: کد متن یا همان کد پترن وارد شده صحیح نیست یا تایید نشده است.
3-: سرشماره فرستنده پیامک‌ها در سیستم تعریف نشده است. لطفاً با پشتیبانی فنی تماس بگیرید. همچنین، تعداد شماره‌های موبایل گیرنده مجاز نیست.
2-: محدودیت تعداد شماره موبایل گیرنده. در هر بار ارسال، تنها یک شماره موبایل مجاز است.
1-: دسترسی به این وبسرویس غیرفعال است. لطفاً با پشتیبانی تماس بگیرید.
0: پنل اس ام اس امکان اتصال به وبسرویس را ندارد یا نام کاربری و رمز عبور وارد شده صحیح نیست.
1: ارسال پیامک با موفقیت انجام شده است.
2: موجودی و اعتبار پنل اس ام اس کافی نیست.
6: سامانه در حال بروزرسانی است.
7: متن پیامک شامل کلمات فیلتر شده است.
10: پنل اس ام اس کاربر غیرفعال یا مسدود شده است.
11: ارسال پیامک انجام نشده؛ شماره موبایل گیرنده در لیست سیاه پنل اس ام اس قرار دارد.
12: مدارک پنل اس ام اس کاربر تکمیل نیست.
دلایل عمده عدم کارکرد وب سرویس
دلایل عمده عدم کارکرد وب سرویس در سامانه پنل پیامکی آذرخش و راه‌های رفع آن عبارتند از:
| دلیل عدم کارکرد وب سرویس | توضیح هر علت | راه‌حل رفع مشکل |
| انقضای سامانه | سامانه‌های ارسال پیامک نیاز به تمدید سالانه دارند. در صورت عدم تمدید، ارسال پیامک قطع خواهد شد. | درخواست تمدید و فعال‌سازی سامانه قبل از انقضای اشتراک. این کار باید نهایتاً 15 دقیقه طول بکشد. |
| انقضای خط ارسال‌کننده | خط اختصاصی ارسال پیامک اگر منقضی شود، ارسال و دریافت پیامک‌ها متوقف میشود. | درخواست تمدید خط ارسال‌کننده پیش از انقضا. تمدید خط در عرض 5 دقیقه انجام میشود. |
| اتمام شارژ سامانه | اگر موجودی حساب کاربری تمام شود، امکان ارسال پیامک وجود ندارد. | بررسی موجودی حساب با استفاده از تابع بررسی شارژ پیش از هر ارسال و شارژ حساب در صورت نیاز. |
| خطای عدم ارتباط | اگر ارتباط بین درخواست‌دهنده و پاسخ‌دهنده قطع یا دچار اختلال شود، ارسال پیامک انجام نخواهد شد. | بررسی و رفع مشکلات ارتباطی با استناد به لیست خطاهای موجود در سامانه برای تشخیص و رفع مشکلات ارتباطی. |
آگاهی از خطاهای وبسرویس پنل پیامکی آذرخش و نحوه رفع آن‌ها به شما کمک کرده تا فرآیند ارسال پیامک‌ها را به طور مؤثر و بدون مشکل پیش ببرید. این خطاها به دلایل مختلفی مانند تنظیمات نادرست، مشکلات فنی یا محدودیت‌های حساب کاربری ایجاد میشود. با استفاده از راهکارهایی مانند بررسی تنظیمات پنل، اطمینان از موجودی کافی و تماس با پشتیبانی فنی در صورت بروز مشکلات پیچیده پیامک‌های شما به درستی ارسال میشوند. با پنل پیامکی آذرخش وضعیت ارسال‌ها را از طریق گزارش‌ها پیگیری و مشکلات را شناسایی و رفع نمایید تا ارسال پیامک‌ها به صورت روان و بدون دغدغه ارسال شود.
تعرفه خرید پنل پیامکی آذرخش را نیز بررسی کنید و با دیگر شرکت ها مقایسه کرده و بهترین انتخاب را داشته باشید.
برای مشاوره جهت خرید پنل پیامکی با ما تماس بگیرید
همکاران ما در تیم پشتیبانی منتظر تماس شما هستند.
021-
91035156
