---
title: "Yerleşik araçlar"
description: "ThunderPhone yapay zeka ajanlarını aramaları sonlandırmaya, arayanları aktarmaya, tuş takımlarında gezinmeye, hatta beklemeye, bilgi aramaya, ses çalmaya ve e-posta göndermeye yönlendirin."
---

Yerleşik araçlar, kendi API'nizi bağlamadan ajanın yaygın çağrı işlemlerini gerçekleştirmesini sağlar. Çoğu otomatik olarak kullanılabilir; e-posta, sesler ve bilgi araması yalnızca ilgili ayarı veya kaynağı yapılandırdıktan sonra görünür. Ajana, isteminde her işlemi ne zaman kullanacağını belirtin.

| Araç | Kullanım amacı | Nasıl etkinleştirilir | Desteklenen çağrılar |
| --- | --- | --- | --- |
| `end_call` | Tamamlanan bir görüşmeyi sonlandırmak | Her zaman kullanılabilir | Telefon, tarayıcı Talk, widget, simülasyon ve Realtime |
| `transfer_call` | Telefon arayanını yönlendirmek | Yönlendirmeyi istemde yapılandırın | Normal telefon çağrıları; `call_events` içeren satır içi Realtime soğuk aktarımı kullanabilir. Kaydedilmiş ajan Realtime bunu içermez. |
| `send_keypad_input` | Telefon menüsünde tuşlara basmak | Normal telefon çağrılarında her zaman kullanılabilir | Telefon çağrıları; `call_events` içeren satır içi giden Realtime. Kaydedilmiş ajan Realtime bunu içermez. |
| `no_response` | Otomatik bir menü konuşurken veya arayan sesli düşünürken dinlemeyi sürdürmek; yapay zeka ajanından beklemesini isteyen arayan yalnızca "Elbette." yanıtını alır | Her zaman kullanılabilir | Tüm çağrı türleri |
| `wait_on_hold` | Bir kişinin geri dönmesini sessizce beklemek | Giden çağrılara dahildir | Giden telefon ve giden satır içi Realtime oturumları |
| `search_knowledge_base` | Eklenmiş kaynaklardan yanıt vermek | Ajana bilgi ekleyin | Eklenmiş bilgiye sahip kaydedilmiş ajan çağrıları |
| `play_sound` | Yapılandırılmış bir bildirim sesi çalmak | **Gelişmiş → Araç sesi** | Kaydedilmiş ajan çağrıları |
| `send_email` | Tek bir sabit alıcıya e-posta göndermek | **Gelişmiş → E-posta gönder** | Kaydedilmiş ajan çağrıları |

## `end_call`

İstem modele bunu yapmasını söylediğinde mevcut çağrıyı sonlandırır. Varsayılan olarak kullanılabilir ve ajan ayarı yoktur.

Koşulu ve gerekli vedayı isteme yazın:

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

Model tarafından sonlandırılan bir aramanın `end_reason: "ai_hangup"` değeri olur; buna arama süresi sınırı uyarısından sonra sonlanan aramalar da dahildir. Arama yalnızca süre sınırına önce ulaşılırsa `max_duration` ile, ön ödemeli bakiye tükendiğinde ise `balance_exhausted` ile sonlanır.

## `transfer_call`

Bir telefon arayanını model tarafından sağlanan sabit bir numaraya aktarır. Soğuk aktarım anında gerçekleşir. Kontrollü sıcak aktarım, tarafları bağlamadan önce hedefi özel olarak arar. Sıcak aktarım, giden çağrı yapabilen doğrulanmış içe aktarılmış bir VoIP numarası gerektirir.

Hedef numarayı ve kesin yönlendirme koşulunu isteme yazın:

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

Başarılı bir soğuk aktarımda `end_reason: "ai_transfer"` bulunur; tamamlanmış bir sıcak aktarımda `end_reason: "ai_warm_transfer"` bulunur. Başarısız bir sıcak aktarım denemesi kontrolü ajana geri verir; bu nedenle çağrının sonraki sonlanması, sonlandırma nedenini belirler. Telefon dışı oturumlarda ise aktarım isteği oturumu sonlandırır.

Kontrol paneli ve API kurulumu, yönlendirme, tarama, hata yönetimi, sınırlar ve test hakkında bilgi için [Çağrıları aktarma](/tr/guides/call-transfers) bölümüne bakın.

## `send_keypad_input`

DTMF (telefon tuş takımı) rakamlarını `0`–`9`, `*` ve `#` bir telefon hattına gönderir. Model bunu, arayanlardan tuşlara basmalarını isteyen otomatik menü olan IVR'de gezinmek için kullanır. Varsayılan olarak kullanılabilir ve ajan ayarı yoktur.

Modele hangi menülerde gezinebileceğini ve istenen değerlerin nereden geleceğini belirtin. Menü seçeneklerini tahmin etmesini istemeyin:

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

Platform, desteklenmeyen karakterleri kaldırır ve geçerli rakamları sırayla gönderir. Geçerli rakam kalmazsa veya çağrı tuş takımı girdisi gönderemezse, ajanın durumu düzeltebilmesi için hata ajana döndürülür.

## `no_response`

Otomatik bir sistem hâlâ konuşurken veya dinlemeye devam etmesini istediğinde, ayrıca arayan kişi sesli düşünürken ("şey, bir bakayım") ya da başka biriyle konuşmak için döndüğünde ajanı sessiz tutar. Arayan kişi bir şey yaparken ajandan beklemesini istediğinde ("bir saniye", "bir bakayım", "bir saniye bekler misiniz?") ve yanıtlanacak başka bir şey söylemediğinde, ajan yalnızca "Elbette." der ("Acele etmeyin." demez) ve arayanın yeniden konuşmasını bekler. Hatta sessizlik sürerse ajanın sessizlik yoklamaları çalışmaya devam eder ve her zaman sesli olarak yapılır. Bu özellik, canlı bir kişinin selamlaması, bir soru veya gerçek bir bekletme sırası için değildir. Varsayılan olarak kullanılabilir ve ajana yönelik bir ayarı yoktur.

İsteminiz, arayan kişi biraz zaman istediğinde ajanın ne söyleyeceğini belirtiyorsa istem önceliklidir.

Genellikle yerleşik açıklama yeterlidir. IVR ağırlıklı çağrılarda, sınırı istemde pekiştirin:

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

Bu işlem çağrıyı sonlandırmaz.

## `wait_on_hold`

Giden aramadaki ajanı, gerçek bir kişi dönene kadar sessiz bekletme durumuna alır.
Model bunu yalnızca karşı taraf açıkça ajanın beklemeye alındığını söylediğinde
kullanır. Giden aramalarda otomatik olarak kullanılabilir ve pano ayarı yoktur.

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

Ajanı, bir IVR'ın "lütfen bekleyin" mesajı için bunu kullanmaya yönlendirmeyin. Bekletme
varsayılan olarak en fazla 15 dakika sürer. Normal giden aramalarda, `POST /v1/call`
pozitif tamsayı olan `max_hold_seconds` değerini kabul eder; satır içi Realtime,
`max_hold_seconds` değerini 10–900 saniye ile sınırlar. Kişi
geri dönerse, ajan aramanın bitiş nedenini değiştirmeden devam eder. Sınır
dolarsa platform aramayı `end_reason: "ai_hangup"` ile sonlandırır.

## `search_knowledge_base`

Ajana eklenmiş belgelerde arama yapar ve ilgili bölümleri döndürür. Etkinleştirmek
için bir bilgi bankası veya ayrı bilgi belgelerini ekleyin; ardından modele hangi
yanıtların bu kaynaklardan gelmesi gerektiğini söyleyin:

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

Arama başarısız olursa sonuç ajana döndürülür. Pano ve API kurulumu için
[Bilgi bankası](/tr/guides/knowledge-base) bölümüne bakın.

## `play_sound`

Aynı turdaki herhangi bir konuşmadan sonra ajanın yapılandırılmış bildirim sesini
çalır. Panoda **Gelişmiş → Araç sesi** ayarını **Çan**, **Ding**
veya **Bip** olarak belirleyin, ardından ajanı yayınlayın. **Yok** aracı kaldırır.

[Agents API](/api-reference/agents) ile `play_sound_asset` değerini
`"chime"`, `"ding"` veya `"beep"` olarak ayarlayın, ardından yayınlayın. Aracı
devre dışı bırakmak için `""` olarak ayarlayın.

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

Çalma hatası ajana döndürülür ve aramayı sonlandırmaz.

## `send_email`

Ajan sahibinin yapılandırdığı tek alıcıya düz metin e-posta gönderir.
Model konuyu ve gövdeyi sağlar. Alıcı parametresini hiçbir zaman görmez
ve adresi seçemez veya değiştiremez.

Panoda **Gelişmiş → E-posta gönder** seçeneğini etkinleştirin, bir alıcı adresi
kaydedin, ardından ajanı yayınlayın. [Agents API](/api-reference/agents) ile hem
`send_email_enabled: true` hem de boş olmayan bir `send_email_recipient` değeri
ayarlayın, ardından yayınlayın. Tetikleyiciyi ve gerekli içerikleri istemde tanımlayın:

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

Bir arama en fazla üç e-posta göndermeyi deneyebilir. Her konu 300
karakterle, her gövde ise 20.000 karakterle sınırlıdır. Eksik yapılandırma, geçersiz
içerik, arama başına sınır ve teslimat hataları ajana döndürülür.
Başarısız bir teslimat yine de üç denemeden birini kullanır.

Geniş çapta yayınlamadan önce kontrollü bir alıcıyla test edin. Tarayıcı Talk ve
simülasyonlar gerçek e-posta gönderir; deneme çalıştırması modu yoktur.

## Uyumluluk notu

**Gelişmiş → Kesintiye uğratılamayan bilgilendirmeler** ayarı ve eski
`speak_uninterruptible_enabled` alanı uyumluluk için korunur, ancak bunları
etkinleştirmenin etkisi yoktur. Ayarı kapalı bırakın; hiçbir istem bu aracı etkinleştiremez.

Zorunlu arama başlangıcı bilgilendirmesi için **Onay duyurusu** kullanın. Bu duyuru
normal konuşmadan önce aynen oynatılır ve kesintiye uğratılamaz. [Arama kaydı
onay yasaları](/tr/guides/recording-consent-laws) bölümüne bakın.

## Yerleşik araçları test edin ve izleyin

İstemleri, bilgi aramasını, sesleri ve e-postayı kontrol etmek için tarayıcı Talk
veya simülasyon kullanın. Bu ortamlar telefon ağı davranışını yeniden üretemez.
Tuş takımıyla gezinmeyi ve bekletmeyi giden bir telefon aramasında test edin; uygun
içe aktarılmış bir VoIP numarası kullanarak gerçek bir aramada eksiksiz sıcak aktarımı
test edin. Realtime desteği yukarıdaki tabloda gösterildiği şekilde sınırlıdır.

## Aramalar, fiyatlandırma ve webhook'lar

Yerleşik eylemler için kullanım başına araç ücreti alınmaz. Normal arama ve sağlayıcı ücretleri
geçerliliğini korur; bkz. [Fiyatlandırma](/tr/guides/pricing). Aramaları ve sonuçları
tamamlanan transkriptte görünebilir, ancak `telephony.tool` veya `web.tool` olaylarını
tetiklemezler. Bu olaylar [kullanıcı tanımlı işlevler](/tr/tools/overview) içindir. Yalnızca tamamlanan bir
arama sonlandırma veya aktarma, aramanın `end_reason` değerini değiştirir; diğer hatalar yapay zeka ajanına
iletilir. Arama kaydı için [Tamamlama webhook'ları](/tr/webhooks/call-complete) bölümüne bakın.