«وبهوک دریافت وضعیت پیامک» در دسته پیامک و رمز یکبار مصرف فینوتک یک مسیر بازگشتی است که خود شما آن را منتشر میکنید؛ پس از ارسال پیامک، فینوتک وضعیت تحویل هر پیام را همراه شناسه یکتای پیام، شماره فرستنده و گیرنده، تعداد بخشهای پیامک و زمان دریافت وضعیت به همین مسیر ارسال میکند. با این داده میتوانید بدون استعلام دورهای بفهمید پیام به مشترک رسیده است یا باید ارسال دوباره و مسیر جایگزین اطلاعرسانی را فعال کنید.
وبهوک دریافت وضعیت پیامک چه مشکلی را حل میکند؟
این مسیر یک API نیست که شما فراخوانی کنید؛ نشانیای در سامانه خودتان است که در اختیار فینوتک قرار میدهید تا وضعیت پیامها به آن ارسال شود. کسبوکارهایی که اطلاعرسانی پیامکی را در جریان مالی خود گذاشتهاند، برای دانستن سرنوشت هر پیام معمولاً دو راه بد در پیش دارند: یا وضعیت را نمیدانند و هنگام شکایت مشتری دستشان خالی است، یا برای هر دسته ارسال، بهصورت دورهای استعلام میزنند و منطق پیچیدهای برای زمانبندی، تکرار و کنار گذاشتن دستههای قدیمی مینویسند. هر دو حالت یعنی تأخیر در واکنش: وقتی یادآوری سررسید قسط به دست بدهکار نرسیده، تا چند ساعت بعد کسی متوجه نمیشود و فرصت اقدام از دست میرود.
با این مسیر بازگشتی، جهت جریان داده برمیگردد: بهجای اینکه شما دنبال وضعیت بروید، وضعیت تحویل به سامانه شما میرسد. هر بار که وضعیتی برای یکی از پیامهای ارسالی مشخص شود، درخواستی به نشانی شما فرستاده میشود که وضعیت پیام، شناسه یکتای همان پیام، شناسه استعلام، شمارههای فرستنده و گیرنده، تعداد بخشهای پیامک و زمان دریافت وضعیت را در خود دارد. شما همین داده را به شناسه پیگیری ارسال خود گره میزنید و وضعیت را روی سابقه مشتری یا تراکنش مالی مینشانید؛ سپس تصمیم بعدی — ارسال دوباره، تماس، یا علامتگذاری شماره نامعتبر — بهصورت خودکار گرفته میشود.
کاربردهای وبهوک دریافت وضعیت پیامک
- بانکداری و پرداخت — وضعیت تحویل پیامهای اعلام تراکنش روی سابقه همان تراکنش ثبت میشود و در بررسی اختلافها قابل استناد است.
- وصول مطالبات و اقساط — نرسیدن یادآوری سررسید همان لحظه در سامانه ثبت میشود و مرحله بعدی پیگیری بدون تأخیر آغاز میگردد.
- جریان ورود و تأیید کاربر — نرسیدن پیام تأیید بهسرعت تشخیص داده میشود و میتوانید پیش از خروج کاربر از فرم، ارسال دوباره را پیشنهاد کنید.
- بیمه و خدمات مدتدار — تحویل اطلاعیه پایان اعتبار بیمهنامه ثبت میشود تا مشخص باشد اطلاعرسانی انجام شده است.
- بهبود کیفیت پایگاه داده مخاطبان — شمارههایی که پیامشان بهطور مکرر تحویل نمیشود علامت میخورند و از فهرست ارسالهای بعدی کنار گذاشته میشوند.
- داشبوردهای عملیاتی — نسبت پیامهای تحویلشده در هر بازه بهصورت پیوسته و بدون استعلام دستی محاسبه و پایش میشود.
مزایای وبهوک دریافت وضعیت پیامک
- دریافت وضعیت بدون استعلام دورهای — لازم نیست برای هر دسته ارسال، زمانبندی و منطق تکرار استعلام بنویسید.
- واکنش نزدیک به لحظه رخداد — وضعیت بهمحض مشخص شدن به سامانه شما میرسد و قاعدههای خودکار همان زمان اجرا میشوند.
- گره خوردن وضعیت به پیام مشخص — شناسه یکتای پیام و شماره گیرنده در داده دریافتی هست، پس وضعیت را دقیقاً روی همان رکورد ارسال مینشانید.
- پایش مصرف در سطح پیام — تعداد بخشهای هر پیامک در داده وضعیت میآید و میتوانید آن را در گزارشهای مصرف خود لحاظ کنید.
- احراز هویت درخواست ورودی — درخواستهای ارسالی به نشانی شما با هدر
Basicساختهشده از شناسه و کلید کلاینت شما احراز میشوند و میتوانید درخواستهای نامعتبر را رد کنید.
چه چیزی از وبهوک دریافت وضعیت پیامک دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار وبهوک دریافت وضعیت پیامک
- ۱. آمادهسازی نشانی بازگشتی — یک مسیر در سامانه خود بسازید که درخواست ورودی وضعیت پیامک را بپذیرد و آن را در اختیار فینوتک قرار دهید.
- ۲. بستن احراز هویت مسیر — درخواستهای ورودی را بر اساس هدر
Basicساختهشده از شناسه و کلید کلاینت خود بررسی کنید و درخواست بدون اعتبار را رد کنید. - ۳. ارسال پیامک — پیامها را با فینوتکست یا ارسال پیامک کد تأیید (OTP) بفرستید و شناسه پیگیری هر ارسال را ذخیره کنید.
- ۴. تطبیق وضعیت با رکورد ارسال — با شناسه یکتای پیام و شماره گیرنده، وضعیت دریافتی را به همان رکورد ارسال و تراکنش کسبوکاری خود وصل کنید.
- ۵. اعمال قاعده و نگهداری سابقه — بر اساس وضعیت، ارسال دوباره یا مسیر جایگزین را اجرا کنید و وضعیت و زمان آن را برای ممیزی ذخیره کنید.
نحوه شروع وبهوک دریافت وضعیت پیامک
این مسیر با توکن OAuth فراخوانی نمیشود؛ شما نشانی بازگشتی را منتشر میکنید و درخواستهای ورودی با هدر Basic ساختهشده از شناسه و کلید کلاینت شما احراز هویت میشوند. اسکوپ مورد نیاز: facility:finnotext-notification:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات وبهوک دریافت وضعیت پیامک
- این مسیر را شما پیادهسازی میکنید، نه فینوتک؛ تا زمانی که نشانی بازگشتی شما در دسترس و پاسخده نباشد، وضعیتی دریافت نمیکنید.
- احراز هویت درخواست ورودی بر پایه هدر
Basicبرگرفته از شناسه و کلید کلاینت شما است؛ کلید کلاینت را محرمانه نگه دارید و مسیر را فقط روی اتصال امن منتشر کنید. - داده وضعیت شناسه یکتای پیام و شماره گیرنده را همراه دارد؛ اگر شناسه ارسالهای خود را ذخیره نکرده باشید، تطبیق وضعیت با تراکنش کسبوکاری ممکن نیست.
- ممکن است برای یک پیام بیش از یک بار وضعیت دریافت کنید؛ پردازش خود را طوری بنویسید که دریافت تکراری، رکورد را خراب یا قاعدهها را دوباره اجرا نکند.
- پاسخ سریع بدهید و پردازشهای سنگین را به صف داخلی بسپارید تا دریافت وضعیتهای بعدی معطل نشود.
- شماره گیرنده داده شخصی مشتری است؛ آن را در لاگهای عمومی ثبت نکنید و مدت نگهداری آن را مشخص کنید.
- برای بررسی موردی یا جبران دورهای که مسیر شما از دسترس خارج بوده است، از استعلام فینوتکست استفاده کنید.
سوالات متداول وبهوک دریافت وضعیت پیامک
«وبهوک دریافت وضعیت پیامک» چیست؟
یک مسیر بازگشتی در سامانه خود شما است که در اختیار فینوتک قرار میگیرد تا وضعیت تحویل پیامکهای ارسالی، همراه شناسه یکتای پیام، شمارههای فرستنده و گیرنده، تعداد بخشهای پیامک و زمان دریافت وضعیت، به آن ارسال شود.
آیا این سرویس را من فراخوانی میکنم؟
نه. برخلاف بقیه سرویسها، این مسیر را شما منتشر میکنید و فینوتک آن را فراخوانی میکند؛ نقش شما پذیرش درخواست، بررسی اعتبار آن و پردازش داده وضعیت است.
تفاوت آن با استعلام فینوتکست چیست؟
در استعلام فینوتکست شما وضعیت را در زمان دلخواه استعلام میکنید؛ در این مسیر وضعیت به سامانه شما ارسال میشود و برای پایش پیوسته مناسبتر است.
چه تفاوتی با وبهوک دریافت پیامک دارد؟
این مسیر وضعیت تحویل پیامهای ارسالی شما را میآورد؛ وبهوک دریافت پیامک متن پیامکهایی را میآورد که کاربران به سرشماره شما فرستادهاند.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
این مسیر توکن OAuth نمیگیرد؛ درخواست ورودی با هدر Basic ساختهشده از شناسه و کلید کلاینت شما احراز میشود. جزئیات در مستندات فنی و راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این مسیر رضایت پیامکی کاربر ندارد؛ فراخوانی از سمت فینوتک به نشانی شما انجام میشود.
مستندات فنی وبهوک دریافت وضعیت پیامک
مشاهده مستندات فنی «وبهوک دریافت وضعیت پیامک» — endpoint، پارامترها، نمونه درخواست و پاسخ.