سرویس «دریافت پیامک» در دسته پیامک و رمز یکبار مصرف فینوتک، با گرفتن سرشماره دریافتکننده و یک بازه تاریخ شمسی، پیامکهایی که در آن بازه روی همان سرشماره دریافت شده است را برمیگرداند. با این خروجی میتوانید پیامهای ورودی کاربران را بهصورت دورهای به سامانه خود بیاورید، آنها را با مخاطبان پایگاه داده تطبیق دهید و از جا نماندن هیچ درخواستی مطمئن شوید.
دریافت پیامک چه مشکلی را حل میکند؟
سرشماره اختصاصی یک کسبوکار در عمل به صندوق ورودی مشتریان تبدیل میشود: کاربر با پیامک لغو اشتراک میفرستد، به یادآوری قسط پاسخ میدهد یا درخواستی را با متن کوتاه مطرح میکند. اگر مسیری برای آوردن این پیامها به سامانه وجود نداشته باشد، کسی باید آنها را دستی مرور و منتقل کند و همین کار دستی باعث میشود پاسخها دیر دیده شوند، در بازههای پرترافیک از قلم بیفتند و هنگام رسیدگی به شکایت مشتری، سابقهای برای اثبات دریافت پیام او در دست نباشد.
این سرویس همان صندوق ورودی را قابل استعلام میکند: سرشماره و بازه تاریخ شمسی را میفرستید و فهرست پیامهای دریافتی آن بازه را میگیرید. نتیجه را میتوانید در یک کار زمانبندیشده به پایگاه داده خود بیاورید، فرستندهها را با مخاطبان شناختهشده تطبیق دهید و بر اساس متن پیام، درخواستها را به صف پاسخگویی یا قاعدههای خودکار بسپارید. چون ورودی آن یک بازه تاریخ است، برای بازبینی گذشته و جبران پیامهایی هم که در دریافت لحظهای از دست رفتهاند به کار میآید.
کاربردهای دریافت پیامک
- بازبینی دورهای صندوق ورودی سرشماره — پیامهای هر روز کاری در یک کار زمانبندیشده خوانده و در سامانه پشتیبانی ثبت میشود.
- تطبیق و حسابرسی پیامهای ورودی — فهرست پیامهای یک بازه با رکوردهای ثبتشده در سامانه شما مقایسه میشود تا موارد جانمانده مشخص شود.
- مدیریت درخواستهای لغو اشتراک — پیامهای انصراف کاربران در پایان هر بازه جمعآوری و در تنظیمات اطلاعرسانی اعمال میشود.
- رسیدگی به اختلاف با مشتری در خدمات مالی — هنگام ادعای «پاسخ دادم»، پیامهای همان بازه تاریخ بازبینی و سابقه بررسی میشود.
- تحلیل بازخورد کمپین اطلاعرسانی — پاسخهای کاربران به یک اطلاعیه در بازه پس از ارسال جمع میشود و برای بهبود متن پیام به کار میرود.
- پایش چند سرشماره در سازمانهای بزرگ — پیامهای هر سرشماره خدماتی جداگانه استعلام و به تیم مربوط به خودش تحویل میشود.
مزایای دریافت پیامک
- دسترسی به پیامهای یک بازه تاریخ مشخص — میتوانید هر بازه دلخواه را دوباره بخوانید و لازم نیست همه پیامها را در لحظه ذخیره کرده باشید.
- جبران پیامهای از دست رفته — اگر مسیر دریافت لحظهای شما مدتی از دسترس خارج شود، همان بازه با این سرویس بازخوانی میشود.
- تفکیک بر اساس سرشماره — استعلام برای سرشماره دریافتکننده انجام میشود، پس هر سرشماره خدماتی جریان پردازش خودش را دارد.
- بدون نیاز به انتشار نشانی بازگشتی — برای شروع لازم نیست مسیری در سامانه خود منتشر کنید؛ یک فراخوانی با توکن Client Credential کافی است.
- مبنای حسابرسی و تطبیق — خروجی را میتوانید با سوابق سمت خود مقایسه کنید و اختلاف داده را پیش از رسیدن به مرحله شکایت مشتری تشخیص دهید.
چه چیزی از دریافت پیامک دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار دریافت پیامک
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
facility:receive-sms:getتوکن Client Credential بگیرید. - ۲. تعیین سرشماره و بازه — سرشماره دریافتکننده و تاریخ شروع و پایان بازه را به تاریخ شمسی و در قالب
yyyy/mm/ddمشخص کنید. - ۳. فراخوانی سرویس — درخواست را ارسال کنید و برای پیگیری بهتر، یک
trackIdیکتا هم همراه آن بفرستید. - ۴. تطبیق و تفسیر پیامها — فرستنده هر پیام را با مخاطبان پایگاه داده خود تطبیق دهید و متن را با قاعدههای مشخص دستهبندی کنید.
- ۵. ثبت و زمانبندی اجرای بعدی — پیامهای پردازششده را در سابقه مشتری ذخیره کنید و بازه استعلام بعدی را طوری تنظیم کنید که فاصله یا همپوشانی نامطلوب پیش نیاید.
نحوه شروع دریافت پیامک
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: facility:receive-sms:get. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات دریافت پیامک
- تاریخ شروع و پایان بازه باید شمسی و در قالب
yyyy/mm/ddفرستاده شود؛ ارسال تاریخ میلادی یا قالب دیگر پذیرفته نمیشود. - استعلام برای سرشماره دریافتکننده انجام میشود؛ اگر چند سرشماره دارید، برای هر کدام فراخوانی جدا لازم است.
- خروجی مربوط به همان بازه درخواستی است؛ برای پوشش کامل، بازههای متوالی را طوری زمانبندی کنید که پیامی بین دو اجرا جا نماند.
- در صورت همپوشانی بازهها ممکن است یک پیام دو بار خوانده شود؛ در سمت خود منطق تشخیص تکرار داشته باشید تا یک درخواست کاربر دو بار اجرا نشود.
- این سرویس برای بازخوانی دورهای مناسب است، نه واکنش لحظهای؛ اگر به دریافت بیدرنگ نیاز دارید وبهوک دریافت پیامک را فعال کنید.
- ارسال شناسه پیگیری یکتا اختیاری است اما توصیه میشود؛ حداکثر ۴۰ کاراکتر حرف و عدد و به شکل UUID.
- متن پیام و شماره فرستنده داده شخصی مشتری است؛ فقط برای همان هدف کسبوکاری نگه دارید و دسترسی به آن را محدود کنید.
سوالات متداول دریافت پیامک
«دریافت پیامک» چیست؟
سرویسی است که با گرفتن سرشماره دریافتکننده و یک بازه تاریخ شمسی، پیامکهای دریافتشده روی آن سرشماره در همان بازه را برمیگرداند.
تفاوت این سرویس با وبهوک دریافت پیامک چیست؟
در این سرویس شما در زمان دلخواه پیامهای یک بازه را استعلام میکنید؛ وبهوک دریافت پیامک مسیری است که پیامها همان لحظه به آن ارسال میشود، پس برای واکنش بیدرنگ مناسبتر است و این سرویس برای بازبینی و تطبیق دورهای.
تاریخ بازه را در چه قالبی بفرستم؟
تاریخ شمسی در قالب yyyy/mm/dd برای شروع و پایان بازه؛ تبدیل تاریخ را در سمت خود انجام دهید و مقدار نهایی را با همین قالب ارسال کنید.
آیا میتوانم پیامهای چند سرشماره را با یک درخواست بگیرم؟
نه. سرشماره دریافتکننده بخشی از ورودی است و برای هر سرشماره باید فراخوانی جداگانه انجام دهید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی دریافت پیامک
مشاهده مستندات فنی «دریافت پیامک» — endpoint، پارامترها، نمونه درخواست و پاسخ.