پرش به مطلب اصلی

سرویس فلش‌کال (Flash Call)

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

مزیت اصلی

هزینه فلش‌کال معمولاً یک‌ششم پیامک است و سرعت تحویل آن (Delivery) بسیار بالاتر است.

ساختار درخواست

برای استفاده از این سرویس، در متد /send باید مقدار پارامتر action را برابر با flashcall قرار دهید.

آبجکت بدنه

در این سرویس، آبجکت payload تنها یک پارامتر اجباری دارد:

پارامترنوعاجباریتوضیحات
codestringکد احراز هویت (OTP) که می‌خواهید اعتبارسنجی شود.
نکته بسیار مهم درباره طول کد

تعداد ارقام کدی که در اینجا ارسال می‌کنید (code)، باید دقیقاً با تنظیمات سرویس در پنل برابر باشد.

  • اگر در پنل تنظیم کرده‌اید که کد ۴ رقمی باشد، باید اینجا مثلاً "1234" بفرستید.
  • مغایرت در تعداد ارقام باعث دریافت خطای 400 (Bad Request) خواهد شد.
FlashCall Request Structure
{
"token": "YOUR_ACCESS_TOKEN",
"destination": "989123456789",
"action": "flashcall",
"payload": {
"code": "12345",
}
}

سناریوی پیشنهادی سمت کلاینت (UX)

برای تجربه کاربری بهتر، پیشنهاد می‌کنیم در اپلیکیشن خود:

  1. به کاربر بگویید: «منتظر تماس باشید و به آن پاسخ ندهید.»
  2. به محض زنگ خوردن گوشی (با دسترسی به Call Log در اندروید)، شماره تماس‌گیرنده را بخوانید.
  3. اگر دسترسی ندارید، از کاربر بخواهید ۴ رقم آخر شماره‌ای که تماس گرفته را وارد کند.