ارسال پیامک خودکار از نرم افزار؛ راهنمای اتصال به وب‌سرویس و بررسی خطاها

ارسال پیامک خودکار از نرم افزار؛ راهنمای اتصال به وب‌سرویس و بررسی خطاها

برای ارسال پیامک خودکار از نرم افزار، ابتدا یک رویداد دقیق مثل تأیید پرداخت را انتخاب کنید، اتصال وب سرویس را با شمارهٔ خودتان آزمایش کنید و سپس ارسال را به همان رویداد وصل کنید. شناسهٔ هر پیام و نتیجهٔ آن را نگه دارید تا هنگام نرسیدن پیامک، بدانید مشکل از اطلاعات ورودی، اتصال یا مسیر تحویل بوده…

انتشار
به روزرسانی
تحریریه سایت 0 نظر
فهرست مطلب 23 بخش

برای ارسال پیامک خودکار از نرم افزار، ابتدا یک رویداد دقیق مثل تأیید پرداخت را انتخاب کنید، اتصال وب سرویس را با شمارهٔ خودتان آزمایش کنید و سپس ارسال را به همان رویداد وصل کنید. شناسهٔ هر پیام و نتیجهٔ آن را نگه دارید تا هنگام نرسیدن پیامک، بدانید مشکل از اطلاعات ورودی، اتصال یا مسیر تحویل بوده است.

پیام موردنیاز زمان مناسب اجرا شرطی که باید بررسی شود
تأیید خرید پس از تأیید پرداخت سفارش واقعاً پرداخت شده باشد
اطلاع رسانی ارسال کالا پس از تحویل به شرکت حمل کد رهگیری معتبر ثبت شده باشد
یادآوری مراجعه پیش از زمان نوبت نوبت همچنان فعال باشد
آماده شدن خدمت پس از تأیید مسئول مربوط مشتری امکان مراجعه یا پیگیری داشته باشد

اتصال را با یک پیام مشخص شروع کنید

برای شروع، فقط پیام تأیید پرداخت را فعال کنید. هم زمان روشن کردن همهٔ اعلان ها باعث می شود هنگام بروز مشکل، تشخیص ندهید کدام تنظیم یا رویداد ایراد دارد. بعد از موفقیت این مسیر، پیام ارسال سفارش یا یادآوری نوبت را اضافه کنید.

شرط اجرا را روی کاغذ بنویسید: «وقتی پرداخت سفارش تأیید شد، یک پیام برای شمارهٔ خریدار ساخته شود.» حالا بررسی کنید نرم افزار این اتفاق را از کجا تشخیص می دهد. بازشدن صفحهٔ تشکر یا کلیک روی دکمهٔ پرداخت، جای تأیید معتبر پرداخت را نمی گیرد.

برای انتخاب بهترین روش خودکارسازی پیامک، از همین جزئیات شروع کنید: چه اتفاقی افتاده، چه کسی باید خبردار شود و پیام تا چه زمانی ارزش ارسال دارد. مثلاً یادآوری نوبتِ گذشته نباید پس از برطرف شدن اختلال، تازه برای مشتری ارسال شود.

اطلاعات لازم را از پنل و مستندات بردارید

پیش از تغییر کد، مطمئن شوید حساب پیامکی امکان ارسال از وب سرویس را دارد. مجوز فرستنده، اعتبار حساب و وضعیت قالب را در پنل بررسی کنید. داشتن نام کاربری پنل لزوماً به معنی آماده بودن دسترسی API نیست.

اطلاعات اتصال را یک جا آماده کنید:

  • نشانی دقیق عملیات ارسال و روش درخواست طبق مستندات سرویس.
  • کلید دسترسی و محل قرارگرفتن آن در هدر یا بخش تعیین شده.
  • شماره یا شناسهٔ فرستندهٔ مجاز.
  • شناسهٔ قالب و نام متغیرها در ارسال قالبی.
  • روش دریافت شناسهٔ پیام و استعلام نتیجه.

این اطلاعات را از نمونه های پراکندهٔ اینترنتی کنار هم نچینید. اگر سرویس دو مسیر «متن آزاد» و «قالب آماده» دارد، نمونهٔ درخواست همان مسیری را بردارید که استفاده می کنید. فیلدهای این دو مسیر ممکن است یکسان نباشند.

کلید دسترسی را در تنظیمات امن سرور نگه دارید. آن را داخل کد مرورگر، اپلیکیشن قابل دریافت یا تصویر ارسالی برای پشتیبانی قرار ندهید. اگر دسترسی به IP وابسته است، IP خروجی سرور عملیاتی را بررسی کنید؛ اینترنت رایانهٔ شما مسیر متفاوتی دارد.

اولین درخواست را از همان سرور اصلی آزمایش کنید

یک متن ساده، یک گیرندهٔ آزمایشی و فرستندهٔ مجاز انتخاب کنید. درخواست را پیش از اتصال به سفارش ها، با ابزار آزمایش API یا برنامه ای کوچک اجرا کنید. متن اولیه می تواند این باشد: «آزمایش اتصال نرم افزار انجام شد. این پیام نیاز به اقدام ندارد.»

اگر درخواست روی رایانهٔ شما موفق است ولی روی سرور خطا می دهد، ابتدا دسترسی شبکه، نام دامنه، گواهی ارتباط امن و محدودیت IP را بررسی کنید. در این وضعیت، تغییر متن پیام یا قالب معمولاً مسئلهٔ اتصال را حل نمی کند.

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

بعد از پذیرش درخواست، شناسهٔ پیام را بردارید و نتیجه را در پنل یا عملیات استعلام پیدا کنید. دریافت روی گوشی آزمایشی را هم بررسی کنید. این آزمایش را با همان تنظیماتی انجام دهید که قرار است در محیط واقعی استفاده شوند.

شماره مشتری، شناسه سفارش و داده های سفارش به گیرنده و متغیرهای پیامک

فیلدهای نرم افزار را به درخواست ارسال وصل کنید

برای هر متغیر مشخص کنید مقدارش از کجا می آید. در پیام سفارش، شمارهٔ سفارش از رکورد سفارش و شمارهٔ گیرنده از اطلاعات تماس همان خریدار برداشته شود. شمارهٔ مدیر یا شمارهٔ پیش فرض آزمایش نباید در تنظیمات عملیاتی باقی بماند.

شماره ها را پیش از ارسال یکدست کنید. ارقام فارسی را تبدیل کنید، فاصله های اضافه را بردارید و پیش شماره را مطابق قالب مورد پذیرش سرویس تنظیم کنید. سپس اعتبارسنجی انجام دهید؛ تبدیل یک شمارهٔ ناقص به رشته ای از ارقام، آن را معتبر نمی کند.

برای متغیر خالی هم تصمیم داشته باشید. اگر کد رهگیری ثبت نشده، پیام رهگیری ساخته نشود. اگر نام مشتری اختیاری است، متن بدون نام هم خوانا بماند. خروجی نهایی را پیش نمایش بگیرید تا عباراتی مثل «سلام undefined» به دست مشتری نرسد.

جدا کردن پردازش پیامک از عملیات اصلی با ذخیره پایدار کار ارسال و پیگیری نتیجه

سفارش را معطل پاسخ پیامک نگذارید

پس از ثبت موفق عملیات اصلی، کار ارسال را برای پردازش پس زمینه ذخیره کنید. برای مثال، سفارش پرداخت شده باید در نرم افزار ثبت شود و اعلانش جداگانه پیگیری شود. اختلال پیامک نباید مشتری را وادار کند دوباره پرداخت کند.

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

اگر چند پردازشگر صف دارید، مطمئن شوید یک کار را هم زمان برنمی دارند. این موضوع را با اجرای هم زمان آزمایش کنید. صرف تغییر وضعیت رکورد پس از ارسال کافی نیست؛ ممکن است پردازشگر دوم پیش از آن، همان پیام را برداشته باشد.

هنگام قطع ارتباط فوری دوباره ارسال نکنید

فرض کنید پیام تأیید خرید ارسال شده، اما نرم افزار به دلیل پایان مهلت انتظار پاسخی نگرفته است. در این لحظه هنوز نمی دانید سرویس درخواست را پذیرفته یا نه. اگر بدون بررسی دوباره بفرستید، مشتری ممکن است دو پیام یکسان دریافت کند.

همانطور که در builder.aws.com گفته شده: «A timeout or failure doesn’t necessarily mean that side effects haven’t happened.» (منبع نقل قول)

ترجمهٔ فارسی: پایان مهلت انتظار یا بروز خطا، لزوماً به معنی انجام نشدن اثر درخواست نیست. در ارسال پیامک، کاربرد این نکته روشن است: پیش از تکرار، نتیجهٔ درخواست قبلی را تا حدی که سرویس اجازه می دهد بررسی کنید.

برای هر اعلان یک شناسهٔ ثابت داشته باشید. اگر ارائه دهنده جلوگیری از تکرار با شناسهٔ درخواست را مستند کرده، تلاش مجدد را طبق همان قرارداد انجام دهید. اگر چنین قابلیتی ندارد و نتیجه قابل استعلام نیست، وضعیت را «نامشخص» نگه دارید و برای تطبیق بررسی کنید.

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

خطاهای ارسال را با اقدام مشخص برطرف کنید

مشکل مشاهده شده ابتدا چه چیزی را بررسی کنید اقدام بعدی
درخواست به سرویس نمی رسد شبکه و نشانی وب سرویس اجرای آزمایش از خود سرور
دسترسی رد می شود کلید و محدودیت IP اصلاح دسترسی پیش از تکرار
قالب پذیرفته نمی شود شناسه و متغیرهای قالب تطبیق دقیق با قالب تأییدشده
گیرنده نامعتبر است مقدار نهایی شماره اصلاح دادهٔ مشتری
محدودیت درخواست دارید سرعت ارسال و سهمیه کاهش سرعت پردازش صف
پاسخ ارسال نامشخص است احتمال پذیرش درخواست قبلی تطبیق پیش از ارسال مجدد
پیام پذیرفته شده ولی نرسیده گزارش تحویل و کد خطا پیگیری علت در مسیر تحویل

اگر خطا مربوط به کلید، فرستنده یا قالب است، تلاش خودکار را متوقف کنید تا تنظیمات اصلاح شوند. تکرار یک درخواست نامعتبر فقط گزارش ها را شلوغ می کند. کارهای متوقف شده را با علت مشخص نگه دارید تا بعداً قابل رسیدگی باشند.

اگر سرویس پاسخ HTTP با کد ۴۲۹ می دهد، سرعت درخواست ها را بررسی کنید. طبق RFC 6585 منتشرشده در آوریل ۲۰۱۲، این پاسخ ممکن است هدر Retry-After داشته باشد که زمان انتظار پیش از درخواست بعدی را مشخص می کند. سهمیهٔ واقعی را از مستندات ارائه دهنده بگیرید.

برای خطاهای موقتِ قابل تکرار، بین تلاش ها فاصله بگذارید، سقف تلاش تعیین کنید و مهلت اعتبار پیام را در نظر بگیرید. پیش از اجرای مجدد یادآوری، فعال بودن نوبت را دوباره بررسی کنید. پیام قدیمی را فقط به دلیل باقی ماندن در صف نفرستید.

نتیجهٔ تحویل را در همان پرونده نمایش دهید

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

اگر سرویس گزارش را با وب هوک می فرستد، اصالت آن را طبق مستندات بررسی کنید. گزارش باید با شناسهٔ پیام به رکورد درست متصل شود. دریافت دوبارهٔ یک گزارش هم نباید پیام جدید یا تغییر وضعیت سفارش ایجاد کند.

در مستندات Twilio ترتیب رسیدن گزارش های وضعیت تضمین نشده است. هنگام پیاده سازی، اجازه ندهید گزارش قدیمی نتیجهٔ نهایی جدیدتر را عقب ببرد؛ قواعد تغییر وضعیت را از مستندات سرویس خودتان بگیرید.

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

متن پیام را بعد از جایگذاری متغیرها بررسی کنید

قبل از فعال سازی، متن را با نام طولانی، شمارهٔ سفارش و نشانی واقعی آزمایش کنید. نمونهٔ کوتاه داخل ویرایشگر ممکن است پس از جایگذاری متغیرها چندبخشی شود. شمارندهٔ بخش ها را روی خروجی نهایی بررسی کنید.

در مستندات Twilio دربارهٔ طول پیامک، ظرفیت تک بخشی UCS-2 برابر ۷۰ واحد و ظرفیت معمول هر بخش در پیام چندبخشی ۶۷ واحد ذکر شده است. این صفحه تاریخ انتشار مشخصی ندارد و در ۲۶ اکتبر ۲۰۲۶ بررسی شد. برای هزینهٔ واقعی، شمارنده و تعرفهٔ سرویس منتخب را ملاک قرار دهید.

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

پیام تأیید پرداخت سفارش

«[نام فروشگاه]: پرداخت سفارش [شماره سفارش] تأیید شد. پس از آماده سازی، وضعیت ارسال را اطلاع می دهیم.»

این متن را پس از تأیید پرداخت بفرستید. اگر زمان آماده سازی مشخص نیست، وعدهٔ تحویل در همان روز را اضافه نکنید.

پیام ثبت سفارش با پرداخت در محل

«[نام فروشگاه]: سفارش [شماره سفارش] ثبت شد. روش پرداخت: هنگام تحویل. نتیجهٔ بررسی سفارش را اطلاع می دهیم.»

برای این سفارش ها قالب جدا داشته باشید تا عبارت «پرداخت تأیید شد» اشتباهی ارسال نشود. متن باید وضعیت واقعی خرید را نشان دهد.

پیام تحویل سفارش به شرکت حمل

«[نام فروشگاه]: سفارش [شماره سفارش] به شرکت حمل تحویل شد. کد رهگیری: [کد رهگیری]»

این رویداد را به تحویل واقعی بسته وصل کنید. ساخت برچسب یا دریافت کد رهگیری، به تنهایی تأیید خروج کالا از فروشگاه نیست.

پیام یادآوری مراجعه

«[نام مرکز]: نوبت شما [تاریخ] ساعت [ساعت] است. برای تغییر یا لغو با [شماره تماس] تماس بگیرید.»

اگر تغییر نوبت از طریق لینک انجام می شود، مسیر قابل استفادهٔ مشتری را جایگزین تماس کنید. فقط راهی را بنویسید که واقعاً پاسخ گو است.

پیام تغییر زمان نوبت

«[نام مرکز]: زمان جدید نوبت شما [تاریخ] ساعت [ساعت] است. برای هماهنگی با [شماره تماس] تماس بگیرید.»

هم زمان با تغییر نوبت، یادآوری قبلی را اصلاح کنید. در غیر این صورت، مشتری بعداً پیام زمان قدیمی را هم دریافت خواهد کرد.

پیام آماده شدن خدمت

«[نام مجموعه]: درخواست [شماره درخواست] آماده است. برای مراجعه در [ساعت کاری] هماهنگ کنید. تماس: [شماره تماس]»

این پیام را زمانی بفرستید که امکان تحویل یا مراجعه وجود دارد. اگر مشتری باید مدرکی همراه بیاورد، همان مورد ضروری را به متن اضافه کنید.

پیش از شروع عمومی این آزمایش ها را انجام دهید

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

  • رویداد پرداخت را دوباره اجرا کنید؛ فقط یک کار ارسال ساخته شود.
  • مقدار ضروری قالب را خالی بگذارید؛ ارسال متوقف و علت ثبت شود.
  • دریافت پاسخ را با شبیه سازی قطع کنید؛ درخواست مبهم بی بررسی تکرار نشود.
  • زمان نوبت را تغییر دهید؛ یادآوری قبلی اجرا نشود.
  • پردازشگر را راه اندازی مجدد کنید؛ کارهای باقی مانده گم نشوند.

یک پیام با شمارهٔ اصلاح شدهٔ مشتری هم آزمایش کنید تا معلوم شود نرم افزار از اطلاعات تازه استفاده می کند. برای اعلان های حساس، دربارهٔ تغییر گیرنده پس از ساخته شدن کار تصمیم مشخصی داشته باشید؛ تغییر شماره نباید بدون کنترل، اطلاعات سفارش را به فرد دیگری برساند.

برای روز بعد از راه اندازی مسئول مشخص کنید

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

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

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

برای اولین اتصال از کجا شروع کنیم

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

چرا ارسال دستی موفق است ولی ارسال نرم افزار خطا دارد

کلید، فرستنده، نوع عملیات، قالب شماره و IP خروجی سرور را مقایسه کنید. ممکن است ارسال دستی از مسیر متفاوتی انجام شود و همان مجوزها را نداشته باشد.

با خطای پایان مهلت انتظار چه کنیم

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

چگونه جلوی پیامک تکراری را بگیریم

برای رویداد و گیرنده، شناسهٔ یکتا ذخیره کنید و برداشتن کار از صف را کنترل کنید. برای ابهام ارتباط با سرویس نیز به سازوکار مستند همان ارائه دهنده نیاز دارید.

پس از لغو نوبت با پیام زمان بندی شده چه کنیم

کار یادآوری را لغو کنید و پیش از اجرای ارسال هم وضعیت نوبت را دوباره بخوانید. با این بررسی، کار قدیمی نباید برای نوبت لغوشده پیام بسازد.