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