معرفی دستور 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:
-
متغیر مقصد (مثلاً
userinput
) — عدد یا رشته واردشده در آن ذخیره میشود. -
فایل صوتی راهنما (مثلاً
please-enter-your-id
) — پیغامی که به کاربر برای ورود پخش میشود. -
طول ورودی — حداکثر تعداد کاراکترهای قابلقبول (مثلاً ۱۰ رقم).
-
تایماوت بین هر رقم — مدتزمان انتظار برای هر رقم (برحسب ثانیه).
-
تعداد تلاش مجدد — اگر کاربر وارد نکند، چند بار مجاز به تلاش است.
-
تایماوت کل ورودی — در صورت عدم پاسخ، چند ثانیه صبر شود.
مثالهای کاربردی:
ثبت کد ملی:
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 پیشنهاد میکنیم این مقالات را نیز بخوانید: