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

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

| ٹول | اسے کس لیے استعمال کریں | اسے کیسے فعال کریں | معاون کالز |
| --- | --- | --- | --- |
| `end_call` | مکمل شدہ گفتگو ختم کریں | ہمیشہ دستیاب | فون، براؤزر Talk، وِجٹ، سیمولیشن، اور Realtime |
| `transfer_call` | فون کالر کو منتقل کریں | prompt میں روٹنگ کنفیگر کریں | عام فون کالز؛ `call_events` کے ساتھ اِن لائن Realtime کولڈ ٹرانسفر استعمال کر سکتا ہے۔ محفوظ شدہ ایجنٹ Realtime میں یہ شامل نہیں ہوتا۔ |
| `send_keypad_input` | فون مینو میں کلیدیں دبائیں | عام فون کالز پر ہمیشہ دستیاب | فون کالز؛ `call_events` کے ساتھ اِن لائن آؤٹ باؤنڈ Realtime۔ محفوظ شدہ ایجنٹ Realtime میں یہ شامل نہیں ہوتا۔ |
| `no_response` | خودکار مینو کے بولتے وقت سنتے رہیں | ہمیشہ دستیاب | کال کی تمام اقسام |
| `wait_on_hold` | کسی شخص کے واپس آنے تک خاموشی سے انتظار کریں | آؤٹ باؤنڈ کالز میں شامل | آؤٹ باؤنڈ فون اور آؤٹ باؤنڈ اِن لائن Realtime سیشنز |
| `search_knowledge_base` | منسلک ذرائع سے جواب دیں | ایجنٹ کے ساتھ نالج منسلک کریں | منسلک نالج کے ساتھ محفوظ شدہ ایجنٹ کالز |
| `play_sound` | کنفیگر کردہ اطلاعی آواز چلائیں | **ایڈوانسڈ → ٹول ساؤنڈ** | محفوظ شدہ ایجنٹ کالز |
| `send_email` | ایک مقررہ وصول کنندہ کو ای میل بھیجیں | **ایڈوانسڈ → ای میل بھیجیں** | محفوظ شدہ ایجنٹ کالز |

## `end_call`

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

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

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

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

## `transfer_call`

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

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

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

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

ڈیش بورڈ اور API سیٹ اپ، روٹنگ، اسکریننگ، ناکامی سے نمٹنے، حدود، اور جانچ کے لیے [کالز منتقل کرنا](/ur/guides/call-transfers) دیکھیں۔

## `send_keypad_input`

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

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

```text
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 میں حد کو مزید واضح کریں:

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

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

## `wait_on_hold`

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

```text
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`

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

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

اگر تلاش ناکام ہو جائے تو نتیجہ ایجنٹ کو واپس کر دیا جاتا ہے۔ ڈیش بورڈ اور API سیٹ اپ کے لیے
[نالج بیس](/ur/guides/knowledge-base) دیکھیں۔

## `play_sound`

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

[Agents API](/api-reference/agents) کے ساتھ، `play_sound_asset` کو
`"chime"`، `"ding"`، یا `"beep"` کے طور پر سیٹ کریں، پھر تعینات کریں۔
ٹول کو غیر فعال کرنے کے لیے اسے `""` پر سیٹ کریں۔

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

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

## `send_email`

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

ڈیش بورڈ میں **ایڈوانسڈ → ای میل بھیجیں** فعال کریں، وصول کنندہ کا پتا محفوظ کریں،
پھر ایجنٹ کو تعینات کریں۔ [Agents API](/api-reference/agents) کے ساتھ، دونوں
`send_email_enabled: true` اور ایک غیر خالی `send_email_recipient` سیٹ کریں، پھر تعینات کریں۔
prompt میں ٹرگر اور مطلوبہ مواد کی وضاحت کریں:

```text
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 اس ٹول کو فعال نہیں کر سکتا۔

کال شروع ہونے پر لازم انکشاف کے لیے **رضامندی کا اعلان** استعمال کریں۔ یہ
عام گفتگو سے پہلے لفظ بہ لفظ چلتا ہے اور اس میں مداخلت نہیں کی جا سکتی۔ [کال ریکارڈنگ رضامندی کے قوانین](/ur/guides/recording-consent-laws) دیکھیں۔

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

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

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

بلٹ اِن ایکشنز کے لیے فی استعمال کوئی ٹول فیس نہیں ہے۔ معمول کے کال اور فراہم کنندہ کے چارجز
بدستور لاگو ہوتے ہیں؛ [قیمتیں](/ur/guides/pricing) دیکھیں۔ ان کی کالز اور نتائج
مکمل شدہ ٹرانسکرپٹ میں ظاہر ہو سکتے ہیں، لیکن وہ `telephony.tool` یا `web.tool` خارج نہیں کرتے۔
یہ ایونٹس [صارف کی متعین کردہ فنکشنز](/ur/tools/overview) کے لیے ہیں۔ صرف مکمل شدہ
کال ختم کرنا یا ٹرانسفر کال کے `end_reason` کو تبدیل کرتا ہے؛ دیگر ناکامیاں ایجنٹ کو واپس کی جاتی ہیں۔
کال ریکارڈ کے لیے [تکمیل ویب ہکس](/ur/webhooks/call-complete) دیکھیں۔