سرویس «استعلام فینوتکست» در دسته پیامک و رمز یکبار مصرف فینوتک، با گرفتن شناسه پیگیری یک فراخوانی ارسال پیامک، فهرست وضعیت هر یک از پیامهای همان دسته را برمیگرداند. با این خروجی میتوانید تشخیص دهید کدام پیام به دست مشترک رسیده، کدام در انتظار ارسال مانده و کدام با خطا مواجه شده است و بر همین اساس ارسال دوباره یا مسیر جایگزین اطلاعرسانی را انتخاب کنید.
وقتی اطلاعرسانی پیامکی بخشی از یک فرآیند مالی است، «ارسال شد» بهتنهایی جواب پشتیبانی و حسابرسی را نمیدهد. مشتری میگوید یادآوری قسط را ندیده، واحد مالی میپرسد اعلام تسویه به فروشنده رسیده است یا نه، و تیم محصول میخواهد بداند چه سهمی از پیامهای یک کمپین اطلاعرسانی واقعاً تحویل شده است. بدون سابقه وضعیت، پاسخ این پرسشها به حدس و گمان و بازگویی روایتهای متناقض تبدیل میشود و در اختلافهای مالی هیچ مستندی برای اثبات اطلاعرسانی وجود ندارد.
«استعلام فینوتکست» چیست؟
سرویسی است که با شناسه پیگیری یک فراخوانی ارسال پیامک، فهرست وضعیت هر یک از پیامهای همان دسته را برمیگرداند تا مشخص شود کدام پیام تحویل شده و کدام با خطا مواجه شده است.
تفاوت این سرویس با وبهوک دریافت وضعیت پیامک چیست؟
در این سرویس شما خودتان وضعیت را استعلام میکنید، در حالی که وبهوک دریافت وضعیت پیامک مسیری است که فینوتک وضعیت تحویل را به آدرس شما ارسال میکند؛ برای دریافت خودکار و پیوسته، وبهوک و برای بررسی موردی، این سرویس مناسب است.
چه چیزی را باید بهعنوان ورودی نگه دارم؟
شناسه پیگیری هر فراخوانی ارسال پیامک؛ بدون آن نمیتوان وضعیت آن دسته را بعداً استعلام کرد، پس آن را در همان تراکنش کسبوکاری خود ذخیره کنید.
آیا وضعیت پیامها بعد از استعلام تغییر میکند؟
بله. پیامهایی که در نوبت ارسال هستند وضعیتشان تغییر میکند؛ برای همین بررسی وضعیت دستههای تازه ارسالشده را بعداً تکرار کنید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.