Voice OTP

OTP صوتی ویکی‌پیام

OTP صوتی برای ارسال کد تأیید از طریق تماس تلفنی استفاده می‌شود و به‌عنوان مسیر پشتیبان برای زمانی مناسب است که پیامک به‌موقع به کاربر نمی‌رسد یا کسب‌وکار به احراز هویت پایدارتر نیاز دارد.

Endpoint رسمی OTP صوتی

POST https://wikipayam.ir/api/v1/voice-otp/send
Authorization: Bearer YOUR_AUTH_TOKEN_HERE
Accept: application/json
Content-Type: application/json

OTP صوتی چیست و کجا کاربرد دارد؟

این مسیر برای سرویس‌هایی مناسب است که احراز هویت نباید فقط به رسیدن پیامک وابسته باشد.

مسیر پشتیبان OTP

در کنار OTP پیامکی برای افزایش پایداری ورود کاربران.

سرویس‌های حساس

مناسب ورود، تراکنش، بازیابی دسترسی و عملیات مهم.

کد تولیدشده توسط شما

کد را سامانه شما تولید می‌کند و در فیلد code می‌فرستد.

اتصال سمت سرور

توکن فقط باید در backend و فایل‌های امن مثل .env نگهداری شود.

نمونه Body

{
  "receiver": "09123456789",
  "code": "123456",
  "track_id": "ORDER-1001"
}

نمونه پاسخ موفق

{
  "data": {
    "message": "Voice OTP queued successfully",
    "id": "6a02f05a3492873a9e086e86",
    "track_id": "ORDER-1001"
  }
}

نمونه cURL

curl --location --request POST 'https://wikipayam.ir/api/v1/voice-otp/send' \
  --header 'Authorization: Bearer YOUR_AUTH_TOKEN_HERE' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "receiver": "09123456789",
    "code": "123456",
    "track_id": "ORDER-1001"
  }'

توکن واقعی را هرگز در JavaScript عمومی، URL، مخزن Git یا ابزارهای قابل مشاهده کاربر قرار ندهید.

پرسش‌های متداول OTP صوتی

OTP صوتی چیست؟

OTP صوتی روشی برای ارسال کد تأیید از طریق تماس تلفنی است و در سناریوهای حساس می‌تواند مسیر پشتیبان OTP پیامکی باشد.

چه زمانی بهتر است از OTP صوتی استفاده شود؟

زمانی که رسیدن پیامک به‌موقع برای کاربر حیاتی است یا سرویس شما به مسیر جایگزین برای احراز هویت نیاز دارد.

آیا OTP صوتی جایگزین OTP پیامکی است؟

معمولاً مکمل OTP پیامکی است؛ می‌توانید ابتدا پیامکی بفرستید و در صورت نیاز از تماس صوتی به‌عنوان مسیر پشتیبان استفاده کنید.

آیا برای OTP صوتی token جدا لازم است؟

بسته به تنظیمات پنل و نوع سرویس، token عملیاتی از پنل/پشتیبانی ویکی‌پیام دریافت و فقط سمت سرور استفاده می‌شود.

آیا کد OTP توسط ویکی‌پیام ساخته می‌شود یا سامانه من؟

در نمونه API، کد OTP توسط سامانه شما تولید و در فیلد code به API ارسال می‌شود.

OTP صوتی را به مسیر احراز هویت خود اضافه کنید

برای دریافت token، بررسی سناریو و اتصال امن API با تیم ویکی‌پیام هماهنگ کنید.