نیاز مشاغل سامانه ثبت آگهی رایگان | درج آگهی رایگان | ثبت شغل | تبلیغات مشاغل
نیاز مشاغل سامانه ثبت آگهی رایگان | درج آگهی رایگان | ثبت شغل | تبلیغات مشاغل
خودکارسازی پیامک تأیید سفارش و یادآوری بر اساس رویداد ثبت‌شده

چطور کسب و کارها پیامک های تراکنشی و اطلاع رسانی را خودکار کنند؟

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

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

برای خودکارسازی پیامک کدام روش را انتخاب کنیم

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

وضعیت کسب وکار

روش مناسب

اولین اقدام

چیزی که باید بررسی کنید

فروشگاه وردپرسی

افزونه سازگار با فروشگاه و سامانه پیامکی

تنظیم پیام وضعیت سفارش

پشتیبانی از وضعیت های موردنیاز و کنترل تکرار

سایت یا اپلیکیشن اختصاصی

اتصال API از بخش سرور

پیاده سازی پیام تأیید پرداخت

احراز هویت و ثبت نتیجه ارسال

نرم افزار CRM دارای اتصال آماده

اتصال داخلی نرم افزار

تعریف قاعده برای رویداد مشتری

شرایط اجرا و ثبت گزارش

سرویس دارای وب هوک

دریافت رویداد در سرور و فراخوانی API

ساخت مسیر دریافت اعلان

اصالت رویداد و جلوگیری از پردازش دوباره

یادآوری نوبت یا تمدید

اجرای زمان بندی شده در سرور

تعیین زمان اعلان

لغو یا تغییر وضعیت پیش از ارسال

انتخاب سریع: اگر افزونه یا اتصال آماده دقیقاً رویداد شما را پوشش می دهد، همان مسیر را آزمایش کنید. برای منطق اختصاصی، مانند ارسال فقط پس از تأیید پرداخت و بررسی نوع سفارش، اتصال API کنترل بیشتری می دهد.

از کدام پیامک شروع کنیم تا نتیجه آن مشخص باشد

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

برای فروشگاه، پیام تأیید سفارش مناسب است. برای مرکز خدمات، تأیید و یادآوری نوبت اهمیت دارد.

پیام

زمان درست ارسال

نمونه متن قابل استفاده

تأیید سفارش

پس از تأیید پرداخت در سرور

فروشگاه سپید؛ سفارش ۸۴۲۱ ثبت شد. وضعیت را در حساب کاربری پیگیری کنید.

ارسال کالا

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

سفارش ۸۴۲۱ به شرکت حمل تحویل شد. کد پیگیری: [کد واقعی]

یادآوری نوبت

طبق زمان تعیین شده و پس از بررسی رزرو

یادآوری نوبت شما در مرکز سپید؛ فردا ساعت ۱۰. برای تغییر نوبت تماس بگیرید.

تمدید اشتراک

پیش از پایان اشتراک و پس از بررسی تمدید

اشتراک شما در [تاریخ] پایان می یابد. برای تمدید وارد حساب کاربری شوید.

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

قبل از شروع اتصال چه اطلاعاتی بگیریم

برای راه اندازی وب سرویس ارسال پیامک، این اطلاعات را از حساب و مستندات سرویس تهیه کنید:

  • اطلاعات احراز هویت مانند کلید API.

  • خط فرستنده یا قالب تأییدشده برای کاربرد موردنظر.

  • مسیر ارسال و ساختار دقیق درخواست و پاسخ.

  • روش استعلام وضعیت یا دریافت گزارش تحویل.

  • سقف درخواست ها و شرایط ارسال خدماتی.

  • اعتبار کافی و شماره های آزمایشی مجاز.

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

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

پیام تأیید سفارش را در شش مرحله پیاده سازی کنید

فرض کنید مشتری سفارش ۸۴۲۱ را پرداخت کرده است. می خواهیم وب سرویس ارسال پیامک فقط یک اعلان تأیید برای این سفارش ایجاد کند و در صورت اختلال، امکان پیگیری داشته باشیم.

مرحله اول ارسال را به تأیید واقعی پرداخت وصل کنید

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

قاعده اجرا را این طور تعریف کنید: پس از تأیید پرداخت توسط سرور و ثبت وضعیت پرداخت شده، اعلان تأیید سفارش ساخته شود.

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

مرحله دوم شماره و متن نهایی را کنترل کنید

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

قالب پیشنهادی:

فروشگاه سپید
سفارش شما با شماره {order_number} ثبت شد.
وضعیت سفارش را در حساب کاربری پیگیری کنید.

متغیر را با شماره واقعی سفارش جایگزین کنید. اگر داده ضروری خالی است، ارسال را متوقف کنید. عبارت خام {order_number} نباید به گوشی مشتری برسد.

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

مقایسه ثبت جداگانه سفارش و اعلان با ثبت هر دو در یک تراکنش برای کاهش گم‌شدن رویداد

 

مرحله سوم سفارش و درخواست اعلان را با هم ذخیره کنید

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

این روش، پایه الگوی Outbox است. پردازشگر پس زمینه بعداً رکوردهای آماده را می خواند و ارسال می کند.

به نقل از Microsoft Learn:

This pattern prevents event loss when you create or modify business objects.

ترجمه: این الگو مانع ازدست رفتن رویداد هنگام ایجاد یا تغییر اشیای کسب وکار می شود.

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

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

مرحله چهارم برای هر اعلان کلید یکتا بسازید

برای پیام تأیید سفارش ۸۴۲۱، از کلیدی مانند order-paid:8421:customer استفاده کنید. روی آن قید یکتای پایگاه داده بگذارید.

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

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

مرحله پنجم درخواست را از سرور بفرستید

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

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

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

مرحله ششم نتیجه را قابل پیگیری کنید

پشتیبانی باید بتواند با شماره سفارش ببیند اعلان ساخته شده، پذیرفته شده یا به خطا خورده است. نمایش یک برچسب کلی «ارسال شد» برای همه این مراحل کافی نیست.

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

شماره را در لاگ ماسک کنید و کلید API را ننویسید. برای نتیجه نامشخص هم وضعیت مستقل داشته باشید تا بررسی آن فراموش نشود.

وقتی پیام ارسال نمی شود چه اقدامی انجام دهیم

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

مشکل

اقدام عملی

ارسال دوباره

شماره یا متغیر نامعتبر

اصلاح داده و بررسی قالب

پس از اصلاح

کلید نامعتبر یا دسترسی ناکافی

بررسی تنظیمات و مجوز حساب

پس از رفع مشکل

اعتبار ناکافی

هشدار به مسئول حساب

پس از تأمین اعتبار

محدودیت تعداد درخواست

کاهش نرخ و رعایت زمان انتظار سرویس

با تأخیر مجاز

اختلال موقت

بررسی ایمن بودن تکرار و تعیین سقف تلاش

محدود و با فاصله

قطع ارتباط پس از ارسال درخواست

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

پس از روشن شدن نتیجه

قطع ارتباط به معنی ارسال نشدن نیست. ممکن است پیام پذیرفته شده باشد اما پاسخ آن به سرور شما نرسیده باشد.

به نقل از AWS Prescriptive Guidance:

Operations should be idempotent when you use the retry with backoff pattern.

ترجمه: برای تلاش مجدد با تأخیر افزایشی باید عملیات idempotent باشد.

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

برای خطای موقت و قابل تکرار، می توانید مثلاً سه تلاش با فاصله های ۵، ۱۵ و ۴۵ ثانیه تعریف کنید. این اعداد پیشنهادی اند و باید با مستندات و فوریت پیام تطبیق داده شوند.

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

بررسی فعال‌بودن رزرو و توقف یا به‌روزرسانی یادآوری پس از لغو یا تغییر زمان

 

یادآوری نوبت را بعد از لغو رزرو متوقف کنید

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

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

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

برای تمدید اشتراک، همین قاعده کاربرد دارد. پیش از اعلان پایان اعتبار بررسی کنید مشتری قبلاً تمدید نکرده باشد.

مسیر با اولویت مناسب برای کد ورود و حذف کد منقضی از صف ارسال

 

کد ورود را پشت پیام های عادی معطل نگذارید

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

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

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

پیش از انتشار چه آزمایش هایی انجام دهیم

قبل از فعال کردن وب سرویس ارسال پیامک برای همه کاربران، این سناریوها را با شماره های آزمایشی بررسی کنید:

  1. پرداخت موفق انجام شود و یک اعلان ساخته شود.

  2. رویداد پرداخت دوبار برسد و اعلان تکراری ساخته نشود.

  3. دو پردازشگر هم زمان اجرا شوند و یک رکورد را هم زمان برندارند.

  4. شماره نامعتبر و متغیر خالی، پیش از ارسال شناسایی شوند.

  5. ارتباط هنگام ارسال قطع شود و نتیجه نامشخص قابل پیگیری بماند.

  6. نوبت لغو شود و یادآوری آن ارسال نشود.

  7. گزارش تحویل تکراری، وضعیت اعلان را خراب نکند.

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

سوالات متداول

بعد از پرداخت دو پیام تأیید می رود چه چیزی را بررسی کنم

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

API موفق بوده اما مشتری پیام را نگرفته است چه کنم

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

برای تعداد کم سفارش هم صف لازم است

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

بعد از قطع سرویس پیام های قدیمی را بفرستیم

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

اتصال را با پیام تأیید سفارش شروع کنید

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

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

5/5 - (4 امتیاز)
اشتراک گذاری

دیدگاه خود را بیان کنید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *