بلٹ اِن ٹولز

ThunderPhone ایجنٹس کو کالز ختم کرنے، کال کرنے والوں کو منتقل کرنے، کی پیڈز پر نیویگیٹ کرنے، ہولڈ پر انتظار کرنے، نالج تلاش کرنے، آوازیں چلانے اور ای میل بھیجنے کے لیے prompt دیں۔

بلٹ اِن ٹولز ایجنٹ کو آپ کا اپنا API منسلک کیے بغیر عام کال کارروائیاں انجام دینے دیتے ہیں۔ زیادہ تر خودکار طور پر دستیاب ہوتے ہیں؛ ای میل، آوازیں، اور نالج تلاش صرف متعلقہ ترتیب یا ذریعہ کنفیگر کرنے کے بعد ظاہر ہوتے ہیں۔ ایجنٹ کو اس کے prompt میں بتائیں کہ ہر کارروائی کب استعمال کرنی ہے۔

end_call#

جب prompt ماڈل کو ایسا کرنے کا کہے تو موجودہ کال ختم کرتا ہے۔ یہ بطور ڈیفالٹ دستیاب ہے اور اس کے لیے ایجنٹ کی کوئی ترتیب نہیں ہے۔

شرط اور مطلوبہ الوداعی پیغام prompt میں لکھیں:

When the caller confirms they need nothing else, say goodbye and end the call.

ماڈل کی جانب سے ختم کی گئی عام کال کا end_reason: "ai_hangup" ہوتا ہے۔ مدت یا بیلنس کی وجہ سے بندش اس کے بجائے زیادہ مخصوص اختتامی وجہ استعمال کر سکتی ہے۔

transfer_call#

ماڈل کی فراہم کردہ مقررہ نمبر پر فون کالر کو منتقل کرتا ہے۔ کولڈ ٹرانسفر فوری ہوتا ہے۔ اسکرین شدہ وارم ٹرانسفر فریقین کو ملانے سے پہلے نجی طور پر منزل کو کال کرتا ہے۔ وارم ٹرانسفر کے لیے ایک تصدیق شدہ، درآمد کردہ VoIP نمبر درکار ہوتا ہے جو آؤٹ باؤنڈ کالز کر سکتا ہو۔

منزل کا نمبر اور روٹنگ کی درست شرط prompt میں رکھیں:

If the caller asks for billing, transfer them to +15551234567.

کامیاب کولڈ ٹرانسفر کا end_reason: "ai_transfer" ہوتا ہے؛ مکمل وارم ہینڈ آف کا end_reason: "ai_warm_transfer" ہوتا ہے۔ ناکام وارم کوشش کنٹرول واپس ایجنٹ کو دے دیتی ہے، اس لیے کال کا بعد میں ختم ہونا اس کی اختتامی وجہ طے کرتا ہے۔ غیر فون سیشنز میں، ٹرانسفر کی درخواست اس کے بجائے سیشن ختم کر دیتی ہے۔

ڈیش بورڈ اور API سیٹ اپ، روٹنگ، اسکریننگ، ناکامی سے نمٹنے، حدود، اور جانچ کے لیے کالز منتقل کرنا دیکھیں۔

send_keypad_input#

فون لائن پر DTMF (فون کی پیڈ) ہندسے 0–9، *، اور # بھیجتا ہے۔ ماڈل اسے IVR میں نیویگیٹ کرنے کے لیے استعمال کرتا ہے، یعنی وہ خودکار مینو جو کالرز سے کلیدیں دبانے کو کہتا ہے۔ یہ بطور ڈیفالٹ دستیاب ہے اور اس کے لیے ایجنٹ کی کوئی ترتیب نہیں ہے۔

ماڈل کو بتائیں کہ وہ کن مینوز میں نیویگیٹ کر سکتا ہے اور مطلوبہ قدریں کہاں سے آتی ہیں۔ اسے مینو کے اختیارات کا اندازہ لگانے کو نہ کہیں:

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

پلیٹ فارم غیر معاون حروف ہٹا دیتا ہے اور درست ہندسے ترتیب سے بھیجتا ہے۔ اگر کوئی درست ہندسہ باقی نہ رہے یا کال کی پیڈ اِن پٹ نہ بھیج سکے، تو ناکامی ایجنٹ کو واپس کر دی جاتی ہے تاکہ وہ بحالی کر سکے۔

no_response#

جب خودکار نظام ابھی بول رہا ہو یا سننے جاری رکھنے کو کہے تو ایجنٹ کو خاموش رکھتا ہے۔ یہ کسی حقیقی شخص کے سلام، سوال، یا حقیقی ہولڈ قطار کے لیے نہیں ہے۔ یہ بطور ڈیفالٹ دستیاب ہے اور اس کے لیے ایجنٹ کی کوئی ترتیب نہیں ہے۔

عموماً بلٹ اِن وضاحت کافی ہوتی ہے۔ IVR پر زیادہ انحصار والی کالز کے لیے، prompt میں حد کو مزید واضح کریں:

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

یہ کارروائی کال ختم نہیں کرتی۔

wait_on_hold#

کسی آؤٹ باؤنڈ ایجنٹ کو اس وقت تک خاموش ہولڈ حالت میں رکھتا ہے جب تک کوئی حقیقی شخص واپس نہ آ جائے۔ ماڈل اسے صرف اس وقت استعمال کرتا ہے جب دوسرا فریق واضح طور پر کہے کہ ایجنٹ کو ہولڈ پر رکھا جا رہا ہے۔ یہ آؤٹ باؤنڈ کالز پر خودکار طور پر دستیاب ہوتا ہے اور اس کے لیے ڈیش بورڈ میں کوئی ترتیب موجود نہیں ہے۔

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

IVR کے "please wait" پیغام کے لیے ایجنٹ کو اسے استعمال کرنے کی ہدایت نہ دیں۔ بطور ڈیفالٹ ہولڈ 15 منٹ تک برقرار رہتا ہے۔ عام آؤٹ باؤنڈ کالز کے لیے، POST /v1/call ایک مثبت صحیح عدد max_hold_seconds قبول کرتا ہے؛ ان لائن Realtime میں max_hold_seconds 10 سے 900 سیکنڈ تک محدود ہے۔ اگر شخص واپس آ جائے تو ایجنٹ کال کے اختتامی سبب کو تبدیل کیے بغیر دوبارہ شروع ہو جاتا ہے۔ اگر حد ختم ہو جائے تو پلیٹ فارم end_reason: "ai_hangup" کے ساتھ کال ختم کر دیتا ہے۔

search_knowledge_base#

ایجنٹ کے ساتھ منسلک دستاویزات تلاش کرتا ہے اور متعلقہ اقتباسات واپس کرتا ہے۔ اسے فعال کرنے کے لیے نالج بیس یا انفرادی نالج دستاویزات منسلک کریں، پھر ماڈل کو بتائیں کہ کون سے جوابات انہی ذرائع سے آنے چاہییں:

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

اگر تلاش ناکام ہو جائے تو نتیجہ ایجنٹ کو واپس کر دیا جاتا ہے۔ ڈیش بورڈ اور API سیٹ اپ کے لیے نالج بیس دیکھیں۔

play_sound#

اسی ٹرن میں کسی بھی گفتگو کے بعد ایجنٹ کی ترتیب شدہ اطلاعی آواز چلاتا ہے۔ ڈیش بورڈ میں ایڈوانسڈ → ٹول ساؤنڈ کو چائم، ڈِنگ، یا بیپ پر سیٹ کریں، پھر ایجنٹ کو تعینات کریں۔ کوئی نہیں ٹول کو ہٹا دیتا ہے۔

Agents API کے ساتھ، play_sound_asset کو "chime"، "ding"، یا "beep" کے طور پر سیٹ کریں، پھر تعینات کریں۔ ٹول کو غیر فعال کرنے کے لیے اسے "" پر سیٹ کریں۔

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

پلے بیک کی ناکامی ایجنٹ کو واپس کر دی جاتی ہے اور کال ختم نہیں ہوتی۔

send_email#

ایجنٹ کے مالک کی ترتیب کردہ ایک وصول کنندہ کو سادہ متن کی ای میل بھیجتا ہے۔ ماڈل موضوع اور متن فراہم کرتا ہے۔ اسے کبھی وصول کنندہ کا پیرامیٹر نظر نہیں آتا اور وہ پتا منتخب یا تبدیل نہیں کر سکتا۔

ڈیش بورڈ میں ایڈوانسڈ → ای میل بھیجیں فعال کریں، وصول کنندہ کا پتا محفوظ کریں، پھر ایجنٹ کو تعینات کریں۔ Agents API کے ساتھ، دونوں send_email_enabled: true اور ایک غیر خالی send_email_recipient سیٹ کریں، پھر تعینات کریں۔ prompt میں ٹرگر اور مطلوبہ مواد کی وضاحت کریں:

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

ایک کال زیادہ سے زیادہ تین ای میلز کی کوشش کر سکتی ہے۔ ہر موضوع 300 حروف تک اور ہر متن 20,000 حروف تک محدود ہے۔ غائب ترتیب، غیر درست مواد، فی کال حد، اور ترسیل کی ناکامیاں ایجنٹ کو واپس کر دی جاتی ہیں۔ ناکام ترسیل بھی تین کوششوں میں سے ایک استعمال کرتی ہے۔

وسیع پیمانے پر تعیناتی سے پہلے ایک کنٹرول شدہ وصول کنندہ کے ساتھ آزمائش کریں۔ براؤزر ٹاک اور سیمولیشنز حقیقی ای میل بھیجتے ہیں؛ ڈرائی رن موڈ موجود نہیں ہے۔

مطابقت کا نوٹ#

ایڈوانسڈ → ناقابلِ مداخلت انکشافات کی ترتیب اور پرانا speak_uninterruptible_enabled فیلڈ مطابقت کے لیے برقرار ہیں، مگر انہیں فعال کرنے کا کوئی اثر نہیں ہوتا۔ ترتیب کو بند رکھیں؛ کوئی prompt اس ٹول کو فعال نہیں کر سکتا۔

کال شروع ہونے پر لازم انکشاف کے لیے رضامندی کا اعلان استعمال کریں۔ یہ عام گفتگو سے پہلے لفظ بہ لفظ چلتا ہے اور اس میں مداخلت نہیں کی جا سکتی۔ کال ریکارڈنگ رضامندی کے قوانین دیکھیں۔

بلٹ اِن ٹولز کی جانچ اور نگرانی کریں#

prompting، نالج تلاش، آوازوں، اور ای میل کی جانچ کے لیے براؤزر ٹاک یا سیمولیشن استعمال کریں۔ یہ ماحول فون نیٹ ورک کے رویے کو دوبارہ پیدا نہیں کر سکتے۔ آؤٹ باؤنڈ فون کال پر کی پیڈ نیویگیشن اور ہولڈ کی جانچ کریں، اور اہل درآمد شدہ VoIP نمبر استعمال کرتے ہوئے حقیقی کال پر ایک مکمل وارم ہینڈ آف کی جانچ کریں۔ Realtime سپورٹ اوپر دی گئی جدول کے مطابق محدود ہے۔

کالز، قیمتیں، اور ویب ہکس#

بلٹ اِن ایکشنز کے لیے فی استعمال کوئی ٹول فیس نہیں ہے۔ معمول کے کال اور فراہم کنندہ کے چارجز بدستور لاگو ہوتے ہیں؛ قیمتیں دیکھیں۔ ان کی کالز اور نتائج مکمل شدہ ٹرانسکرپٹ میں ظاہر ہو سکتے ہیں، لیکن وہ telephony.tool یا web.tool خارج نہیں کرتے۔ یہ ایونٹس صارف کی متعین کردہ فنکشنز کے لیے ہیں۔ صرف مکمل شدہ کال ختم کرنا یا ٹرانسفر کال کے end_reason کو تبدیل کرتا ہے؛ دیگر ناکامیاں ایجنٹ کو واپس کی جاتی ہیں۔ کال ریکارڈ کے لیے تکمیل ویب ہکس دیکھیں۔