...

آموزش برنامه Read در Dialplan استریسک — دریافت ورودی عددی از کاربر

استریسک Read

فهرست مطالب

زمان مطالعه: < 1 دقیقه

معرفی دستور Read در استریسک

دستور Read() یکی از دستورات کلیدی و پرکاربرد در Dialplan استریسک است که به شما امکان می‌دهد ورودی کاربر (مثل عدد، کد ملی، شماره موبایل و…) را از طریق DTMF دریافت کرده و در یک متغیر ذخیره کنید. این دستور معمولاً در سناریوهای تعاملی مثل IVR، ثبت اطلاعات یا احراز هویت استفاده می‌شود.

نحوه استفاده

فرم کلی استفاده از دستور Read به شکل زیر است:

exten => 1000,1,Answer()
exten => 1000,2,Read(userinput,please-enter-your-id,10,,3,5)
exten => 1000,3,Playback(you-entered)
exten => 1000,4,SayDigits(${userinput})
exten => 1000,5,Hangup()

پارامترهای دستور Read:

  1. متغیر مقصد (مثلاً userinput) — عدد یا رشته واردشده در آن ذخیره می‌شود.

  2. فایل صوتی راهنما (مثلاً please-enter-your-id) — پیغامی که به کاربر برای ورود پخش می‌شود.

  3. طول ورودی — حداکثر تعداد کاراکترهای قابل‌قبول (مثلاً ۱۰ رقم).

  4. تایم‌اوت بین هر رقم — مدت‌زمان انتظار برای هر رقم (برحسب ثانیه).

  5. تعداد تلاش مجدد — اگر کاربر وارد نکند، چند بار مجاز به تلاش است.

  6. تایم‌اوت کل ورودی — در صورت عدم پاسخ، چند ثانیه صبر شود.

مثال‌های کاربردی:

ثبت کد ملی:

exten => 3000,1,Answer()
exten => 3000,2,Read(nationalid,enter-your-national-id,10,,3,10)
exten => 3000,3,Playback(you-entered)
exten => 3000,4,SayDigits(${nationalid})
exten => 3000,5,Hangup()

ثبت شماره موبایل:

exten => 3001,1,Answer()
exten => 3001,2,Read(mobile,enter-your-mobile,11,,3,10)
exten => 3001,3,Playback(thank-you)
exten => 3001,4,Hangup()

لینک‌های داخلی پیشنهادی:

برای درک بهتر از دستور Read پیشنهاد می‌کنیم این مقالات را نیز بخوانید:

0 0 رای ها
امتیازدهی به مقاله
اشتراک در
اطلاع از

0 نظرات
قدیمی‌ترین
تازه‌ترین بیشترین رأی
بازخورد (Feedback) های اینلاین
مشاهده همه دیدگاه ها