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 صوتی از کجا شروع کنم؟

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

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

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