> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Temel kavramlar
> Platformdaki her şeyin haritası: her nesnenin ne yaptığı, kontrol panelinde nerede bulunduğu ve hangi API’nin ona eriştiği.
ThunderPhone, sesli AI ajanları oluşturmak, çalıştırmak ve geliştirmek için eksiksiz bir platformdur. Bu sayfa bir haritadır: karşılaşacağınız her kavram, her biri kısa bir bölümde, pano yüzeyi ve onu destekleyen API ile birlikte sunulur. Bir kez göz gezdirin; ardından bir terimin açıklanması gerektiğinde buraya dönün.
Pano kenar çubuğu bu yapıyı yansıtır:
[Ajanlar](#agents), [telefon numaraları](#phone-numbers),
[web bileşenleri](#web-widgets), [aramalar](#calls),
[bilgi tabanları](#knowledge-bases).
[Canlı izleme](#live-monitoring) ve giden
[kampanyalar](#campaigns).
Ajanlarınızın kullanabileceği [uygulamalar, API'ler, MCP sunucuları ve VoIP sağlayıcıları](#connections).
[Simülasyonlar](#simulations), [deneyler](#experiments),
[sorunlar](#issues), [raporlar](#reports),
[gözlemlenebilirlik](#observability).
[Ekip ve roller](#team-and-roles), [API anahtarları](#organizations),
[uyarılar](#alerts), [faturalandırma](#billing).
Kendi kodunuz için [webhook'lar](#webhooks) ve [fonksiyon araçları](#function-tools).
***
## Kuruluşlar
Bir **kuruluş**, kiracılık birimidir. Ajanlar, telefon numaraları, aramalar ve anahtarlar dahil diğer tüm kaynaklar tam olarak bir kuruluşa aittir. Hesabınız birçok kuruluşa ait olabilir; her birinin kendi bakiyesi, kendi anahtarları ve kendi üye listesi vardır.
**Kuruluş → Anahtarlar** altında oluşturduğunuz `sk_live_` API anahtarı tek bir kuruluşa bağlıdır. REST API'nin bu kadar düz olmasını sağlayan bu bağlantıdır: anahtarınız kuruluşu zaten tanımladığı için URL yollarına hiçbir zaman kuruluş kimliği eklemezsiniz.
**Panoda:** kuruluş seçici (kenar çubuğu alt bilgisi) ve **Kuruluş** ayarları — Genel, Anahtarlar, Uyarılar, Faturalandırma Ayarları ve Faturalandırma Geçmişi sekmeleri.
**API'de:** [`/v1/orgs`](/api-reference/organizations),
[`/v1/developer/api-keys`](/api-reference/developer-api-keys).
***
## Ajanlar
Bir **ajan**, bir aramayı çalıştıran yapay zeka yapılandırmasıdır. Şunları içerir:
* Ajanın ne söyleyeceğini ve nasıl davranacağını belirleyen bir **istem** — aktarımlar, tuş takımı basışları ve aramayı sonlandırma gibi arama eylemleri de ayrı yapılandırmalar yerine düz istem satırlarıdır.
* Bir **motor katmanı** (`spark`, `bolt`, `storm-*`): Spark maliyet için, Bolt hız için, Storm ise karmaşık istemlerde zeka için optimize edilmiştir.
* Bir **sesin** yanı sıra bir **birincil dil** ve isteğe bağlı **ek diller** — arayan kişi dil değiştirdiğinde ajan otomatik olarak geçiş yapar. [Desteklenen diller](/tr/guides/supported-languages) bölümüne bakın.
* Bağlı yetenekler: [bağlı uygulamalar](#connections),
[API bağlantıları](#connections), [bilgi tabanları](#knowledge-bases),
[MCP sunucuları](#connections) ve satır içi
[fonksiyon araçları](#function-tools).
* Davranış ayarları: konuşma sırası, onay modu, arka plan parçası,
bekletme zaman aşımı.
Oluşturucudaki düzenlemeler **otomatik olarak taslağa kaydedilir**; **Yayınla**'ya tıklayana kadar hiçbir şey yayına alınmaz. Her yayınlama, oluşturucunun **Geçmiş** sekmesinde anlık görüntü olarak kaydedilir; böylece önceki herhangi bir sürümü inceleyebilir ve geri yükleyebilirsiniz.
**Panoda:** **Sesli AI Ajanları** → ajan oluşturucu
(`/dashboard/agents`). [İlk sesli AI ajanınızı oluşturun](/tr/guides/build-an-agent) bölümüne bakın.
**API'de:** [`/v1/agents`](/api-reference/agents) — CRUD,
çoğaltma, aktarma, sürüm geçmişi ve istem yardımcıları.
***
## Telefon numaraları
Bir **telefon numarası** bir kuruluşa aittir ve gelen aramaları bir
yapay zeka ajanına yönlendirir (ayrıca giden aramaları da
taşıyabilir). İki kaynak vardır:
* **Demo numaraları** — ThunderPhone havuzundan sağlanan gerçek ABD
numaralarıdır ve saniyeler içinde kullanıma hazır olur. Yalnızca gelen
aramaları destekler, kısa bir sesli bilgilendirmeyle yanıt verir ve
pano bir kuruluşu bunlardan en fazla 10 tanesiyle sınırlar. İlk test
için idealdir; üretim için değildir.
* **VoIP numaraları** — kendi sağlayıcınızdan bir
[VoIP bağlantısı](#connections) aracılığıyla getirilir. Twilio ve
Telnyx doğrudan bağlanır (Telnyx'te rehberli kurulum vardır);
SignalWire ve Vonage yakında eklenecektir — bugün bunlara, herhangi
bir SIP trunk'ı kabul eden manuel SIP yapılandırması üzerinden
ulaşabilirsiniz. İçe aktarıldıktan ve doğrulandıktan sonra VoIP
numaraları gelen ve giden aramaları destekler.
Her numara satırında bir yönlendirme modu belirleyebilir, gelen aramalar
için ajanı seçebilir ve numarayı etiketleyebilirsiniz.
**Panoda:** **Telefon Numaraları** (`/dashboard/phone-numbers`).
[Birkaç telefon numarası alın](/tr/guides/get-a-phone-number) bölümüne bakın.
**API'de:** [`/v1/phone-numbers`](/api-reference/phone-numbers),
[`/v1/voip-connections`](/api-reference/voip-connections),
[`/v1/phone-number-labels`](/api-reference/phone-number-labels).
***
## Aramalar
Her gelen arama, giden arama, simülasyon ve widget oturumu bir
**arama kaydına** dönüşür. Bir arama; rollerle etiketlenmiş tam dökümü,
yapılandırılmış sıra geçmişini (araç çağrıları dahil), kaydı,
faturalandırma toplamını ve isteğe bağlı AI derecelendirme ile sorun
raporlarını içerir.
Bir arama **canlıyken**, aramayı açıp **dinleyebilirsiniz** — sessizce
katılırsınız ve aramadaki hiç kimse sizi duymaz. Dinlemeye başladıktan
sonra **fısıldayabilirsiniz**: arama sırasında doğrudan ajanınıza giden
bir talimat yazın; arayan kişi bunu asla duymaz ve ajan talimatı canlı
olarak uygular.
**Panoda:** Arşiv ve arama başına ayrıntılar için **Arama Geçmişi**
(`/dashboard/call-history`); devam eden aramalar için **Canlı**.
[Aramalarınızı inceleyin, dinleyin ve yönlendirin](/tr/guides/review-calls)
bölümüne bakın.
**API'de:** [`/v1/calls`](/api-reference/calls) — liste, döküm,
geçmiş, ses, derecelendirme, dışa aktarma;
[`/v1/issue-reports`](/api-reference/issue-reports).
***
## Web widget'ları
**Web widget'ı**, site ziyaretçilerinize bir ajanla mikrofon tabanlı
konuşma olanağı sunar — telefon numarası gerekmez. İzin verilen
alan adlarınıza kaynak kilidi uygulanmış bir **yayımlanabilir anahtarla**
(`pk_live_...`) kimlik doğrular; bu nedenle istemci tarafı kodlarda
güvenle kullanılabilir.
Anahtarlar iki moddan birinde çalışır: `agent` (tek bir ajana statik
olarak bağlı) veya `webhook` (sunucunuz her ziyaretçi için yapılandırmayı
seçer — bkz.
[Arama başına dinamik yapılandırma](/tr/guides/dynamic-call-config)).
Widget oturumları, telefon aramalarıyla aynı arama altyapısını kullanır.
**Panoda:** **Web Widget'ları** (`/dashboard/web-widgets`) — widget
oluşturun, modu ve ajanı belirleyin, izin verilen alan adlarını yönetin
ve yerleştirme kod parçacığını kopyalayın.
[Web widget'ı oluşturun](/tr/guides/embed-a-web-widget-dashboard) bölümüne
bakın.
**API'de:** [`/v1/publishable-key`](/api-reference/publishable-keys),
[`/v1/mic-session`](/api-reference/mic-sessions) ve
[Widget SDK belgeleri](/tr/widget/overview).
***
## Bilgi tabanları
Bir **bilgi tabanı**, yapay zeka ajanınızın yanıtlarını temellendirmek
için arama sırasında arayabileceği bir belge kümesidir — dosyaları
doğrudan yükleyin veya Google Drive'dan içe aktarın, ardından bilgi
tabanını oluşturucuda bir ajana bağlayın. Ajan, konuşma gerektirdiğinde
yerleşik bir arama aracıyla bilgi tabanını sorgular.
**Panoda:** Belge kitaplığı için **Bilgi** (`/dashboard/knowledge`);
bir ajana bağlamak için oluşturucudaki **Bilgi** bölümü.
[Ajanınıza bilgi tabanı ekleyin](/tr/guides/knowledge-base) bölümüne bakın.
***
## Bağlantılar
Bağlantılar, ajanların dış dünyaya ulaşmasını sağlar. Dört tür, kenar
çubuğunda tek grup:
* **Uygulamalar** (`/dashboard/app-connections`) — Slack, HubSpot,
Salesforce, Google Calendar, Google Sheets ve Cal.com için OAuth
bağlantıları. Bir kez bağlayın, ardından işlem bazındaki araçları
(Slack mesajı gönderme, HubSpot kişisi ekleme veya güncelleme,
Cal.com zaman dilimi ayırtma…) herhangi bir ajan için açın. Bkz.
[Uygulamaları bağlama](/tr/guides/connect-apps).
* **API'ler** (`/dashboard/api-connections`) — herhangi bir HTTP API'sini
bir ajan eylemine dönüştürün. Bir cURL komutu yapıştırın; yapay zeka
sihirbazı araç tanımını taslak olarak oluştursun veya manuel olarak
oluşturun. **İsteği Test Et** düğmesi, yayına almadan önce korumalı
alan çağrısı yapar. Bkz.
[API bağlantıları](/tr/guides/api-connections) — panodaki karşılığı
[`/v1/integrations`](/api-reference/integrations).
* **MCP** (`/dashboard/mcp-connections`) — URL ile bir Model Context
Protocol sunucusu ekleyin ve ajanın sunduğu araçları kullanmasına
izin verin. Bkz. [MCP sunucusu ekleme](/tr/guides/mcp-servers).
* **VoIP** (`/dashboard/voip-connections`) — [kendi telefon
numaralarınızı getirme](#phone-numbers) için sağlayıcı kimlik
bilgileri. Bkz. [VoIP sağlayıcısı bağlama](/tr/guides/voip-providers).
**API'de:** [`/v1/integrations`](/api-reference/integrations) ve
[`/v1/voip-connections`](/api-reference/voip-connections); ayrıca bkz.
[Araç entegrasyonu oluşturma](/tr/guides/build-tool-integration).
***
## Kampanyalar
Bir **kampanya**, büyük ölçekte giden aramalar yapar: kişilerin yer
aldığı bir CSV yükleyin, ajanı ve arayan numarayı seçin, ardından
arama zaman aralığını (günler ve saatler, saat dilimine duyarlı),
eşzamanlılık ayarını ve yeniden deneme politikasını (maksimum deneme
sayısı ve hangi sonuçların — yanıt yok, sesli mesaj, başarısız —
yeniden deneneceği) belirleyin. Kampanya listedeki kişileri sırayla
arar ve her aramayı Arama Geçmişi'ne kaydeder.
**Panoda:** **Kampanyalar** (`/dashboard/campaigns`). Bkz.
[Giden arama kampanyası yürütme](/tr/guides/outbound-campaigns).
**Tek seferlik programatik aramalar için:** [giden aramalar
API'si](/tr/guides/place-outbound-calls).
***
## Canlı izleme
**Canlı**, kuruluş genelinde devam eden tüm aramaları gösterir ve
bunlardan herhangi birini gerçek zamanlı olarak [dinlemenizi ve
fısıldamanızı](#calls) sağlar. Bu, denetim alanınızdır: yeni bir
istemin ilk gerçek trafiğini izleyin veya devam eden bir kampanyayı
takip edin.
**Panoda:** **Canlı** (`/dashboard/live`). Bkz.
[Canlı aramaları izleme ve denetleme](/tr/guides/monitor-live-calls).
***
## Simülasyonlar
Bir **simülasyon**, yapay zeka arayanın ajanınızla gerçek bir
konuşma yapmasıdır — aynı telefon altyapısı yolu, gerçek transkript,
gerçek değerlendirme — böylece yayına almadan önce (ve sonra) test
edebilirsiniz. Bunu bir ajana veya telefon numarasına yöneltin,
arayan senaryosunu kendiniz yazın ya da ajanın isteminden **yapay
zekayla senaryolar oluşturun** (isterseniz uç durumlar da dahil) ve
aramayı canlı izleyin.
Senaryolar, minimum başarı oranını sabitleyen ve CI'da sürümleri
engelleyebilen **paketler** halinde gruplandırılır; kabul edilen temel
çizgiye göre gerilemeler her senaryo için raporlanır.
**Panoda:** **Simülasyonlar** (`/dashboard/simulations`) ve ayrıca
ajan oluşturucudaki **Simülasyon** düğmesi. Bkz.
[Arama simüle etme](/tr/guides/simulate-a-call).
**API'de:** [`/v1/test-calls`](/api-reference/test-calls) ve paket
çalıştırıcısı — bkz. [Bir ajanı uçtan uca test etme](/tr/guides/test-agents).
***
## Deneyler
Bir **deney**, canlı trafikte ajan yapılandırmalarını A/B testine tabi
tutar: varyantları (farklı istemler, motorlar veya ayarlar) tanımlayın,
trafiği bunlar arasında bölüştürün ve sonuçları varyant bazında
karşılaştırın. Webhook içinde segmentleme mantığını kendiniz
oluşturmak yerine bunu kullanın.
**Panoda:** **Deneyler** (`/dashboard/experiments`) ve ajan
oluşturucudaki **A/B** sekmesi. Bkz.
[Deneyler (A/B testi)](/tr/guides/experiments-ab-testing).
***
## Sorunlar
Bir **sorun**, belirli bir çağrıda işaretlenmiş bir problemdir — bir
insan inceleyici tarafından bildirilir veya yapay zeka değerlendirmesiyle tespit edilir. Sorunlar önem derecesi,
kaynak ve durum bilgilerini içerir; Sorunlar sayfası ise önceliklendirme kuyruğudur: filtreleyin,
sorunlu çağrıyı inceleyin ve düzeltmeleri takip edin.
**Kontrol panelinde:** **Sorunlar** (`/dashboard/issues`) ve Çağrı Geçmişi'nde
çağrı bazında işaretleme. Bkz. [Sorun önceliklendirme](/tr/guides/issues).
**API'de:** [`/v1/issue-reports`](/api-reference/issue-reports).
***
## Raporlar
Bir **rapor**, çağrı verilerinizle ilgili doğal dilde sorulmuş bir soruyu
("Geçen hafta arayanların bir insana aktarılmayı istemesinin en yaygın üç nedeni neydi?")
yapay zeka tarafından yazılmış bir analizle yanıtlar ve seçtiğiniz
ajanlar ile tarih aralığıyla sınırlandırılır.
**Kontrol panelinde:** **Raporlar** (`/dashboard/reports`). Bkz.
[Raporlar](/tr/guides/reports).
***
## Gözlemlenebilirlik
**Gözlemlenebilirlik**, metrikler alanıdır: çağrı hacmi, sonuçlar ve
zaman içindeki kalite; ajan ve zaman aralığına göre filtrelenebilir ve
sonraki analizler için dışa aktarma sunar.
**Kontrol panelinde:** **Gözlemlenebilirlik** (`/dashboard/observability`).
Bkz. [Gözlemlenebilirlik](/tr/guides/observability).
***
## Uyarılar
Bir **uyarı kuralı**, bir zaman aralığında bir metriği (başarı oranı, başarısızlık oranı,
ortalama puan, çağrı hacmi, paket regresyonları) izler ve
eşiğinizi aştığında tetiklenir. Bildirimler e-posta ve Slack'e gönderilir,
ayrıca [webhook uç noktalarınıza](/tr/webhooks/endpoints)
bir `alert.triggered` olayı gönderilir.
**Kontrol panelinde:** **Organizasyon → Uyarılar**. Bkz.
[Uyarılar](/tr/guides/alerts).
***
## Webhook'lar
ThunderPhone, çağrı sırasında ve sonrasında gerçekleşen durumlarda
sunucunuza **HTTP POST webhook'ları** gönderir. İki teslim modeli vardır:
* **Webhook uç noktaları** (önerilir): birçok URL'yi,
uç nokta başına gizli anahtarlar ve uç nokta başına olay abonelikleriyle
[`/v1/developer/webhook-endpoints`](/tr/webhooks/endpoints) adresinden yönetin.
* **Eski tek URL webhook'u**: organizasyon başına bir URL. Şu adresten yönetilir:
[`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook)
veya **Organizasyon → Genel** altında. Geriye dönük uyumluluk için korunur.
Olaylar iki sınıfa ayrılır:
* **Engelleyici olaylar**, sunucunuzun devam eden çağrıyı şekillendiren
yapılandırmayla yanıt vermesini bekler — bunlar
[gelen çağrı olaylarıdır](/tr/webhooks/call-incoming)
(`telephony.incoming` / `web.incoming`). Yanıt vermek için en fazla 10 saniyeniz
vardır; süre aşımında statik olarak atanmış ajan çağrıyı yönetir.
* **Engelleyici olmayan olaylar**, üstel geri çekilmeyle yeniden denenen
gönder-ve-unut bildirimleridir — bkz.
[teslim semantiği](/tr/webhooks/overview).
Her istek, `X-ThunderPhone-Signature` içinde bir HMAC-SHA256 imzası taşır. Bkz.
[İmza doğrulama](/tr/webhooks/overview).
***
## Fonksiyon araçları
Bir **fonksiyon aracı**, ajanınızın görüşme sırasında çağırabileceği bir HTTP
uç noktasıdır. ThunderPhone'a OpenAI tarzı bir fonksiyon şeması ve bir
uç nokta URL'si sağlarsınız; ajan ne zaman çağıracağına karar verir ve
ThunderPhone imzalı HTTP isteğini kendi sunucularından göndererek sonucu
ajana geri iletir.
Ajanlar ayrıca çağrıyı aktarma, tuş takımı (DTMF) girişi gönderme,
çağrıyı sonlandırma ve bekletmede bekleme gibi **yerleşik çağrı yetenekleri** sunar;
bunları araç tanımları yerine düz istem satırlarıyla etkinleştirirsiniz.
**Kontrol panelinde:** oluşturucudaki **API bağlantıları** bölümü (bkz.
[Bağlantılar](#connections)).
**API'de:** [`/v1/integrations`](/api-reference/integrations) ve
[Function Tools belirtimi](/tr/tools/overview).
***
## Ekip ve roller
Her organizasyonun iki rollü bir üye listesi vardır: **Üyeler** ajanları oluşturur
ve işletir; **Yöneticiler** ayrıca ekibi ve faturalandırmayı yönetir.
E-posta ile davet edin — davetlerin süresi 7 gün sonra dolar ve iptal edilebilir;
üye satırındaki ⋯ menüsü rolleri değiştirir veya birini kaldırır. Tekli
oturum açma, organizasyon genelinde yapılandırılabilir — bkz. [SSO](/tr/guides/sso).
**Kontrol panelinde:** **Organizasyon → Genel**. Bkz.
[Ekibinizi davet edin](/tr/guides/invite-your-team).
**API'de:** [`/v1/members`](/api-reference/members),
[`/v1/invites`](/api-reference/invites).
***
## Faturalandırma
ThunderPhone **ön ödemelidir**. Her organizasyonun USD bakiyesi bulunur; çağrılar, ajanın dakika başına ücreti üzerinden bu bakiyeden düşülür (altyapı katmanı ve ek ücretler —
ayarları değiştirdikçe oluşturucu toplam ücreti canlı olarak gösterir ve
[premium diller](/tr/guides/supported-languages) dakika başına 2¢ ekler). Bakiye sıfıra ulaştığında gelen çağrılar reddedilir, giden çağrılar ise
`402 Payment Required` döndürür.
Bakiyeyi manuel olarak yükleyin veya bakiye eşiği, yükleme tutarı ve
isteğe bağlı aylık harcama limitiyle **otomatik bakiye yüklemeyi** etkinleştirin — böylece bir çağrı hiçbir zaman cümle ortasında kesilmez.
**Kontrol panelinde:** **Organizasyon → Faturalandırma Ayarları** ve
**Faturalandırma Geçmişi**. Bkz.
[Bakiye ekleme ve otomatik bakiye yüklemeyi açma](/tr/guides/billing-and-topups).
**API'de:** [`/v1/billing`](/api-reference/billing).
***
## Uygulama içi yardımcı pilot
Kontrol panelinde yerleşik bir **yardımcı pilot** bulunur — ona "X'i nasıl yaparım" diye sorun;
bu dokümanlardan yanıt verir, gerçek kontrolleri öne çıkaran adım adım
yol gösterimleri sunar ve rehberli turların herhangi birini yeniden oynatabilir. Bu sayfanın bahsettiği bir kontrolü bulmanın en hızlı yoludur.
Bkz. [Uygulama içi yardımcı pilota sorun](/tr/guides/ask-the-copilot).
***
## Hepsini bir araya getirme
Beş adımlı sihirbaz: ajan → faturalandırma → numara → simülasyon → inceleme.
Aynı ilk çağrıyı dört REST çağrısıyla yapın.
Bir ajan oluşturun, bakiye yükleyin, numara alın, simülasyon yapın ve çağrıları inceleyin.
OAuth uygulamaları, özel API'ler, MCP sunucuları ve VoIP sağlayıcıları.
Raporlar, gözlemlenebilirlik, deneyler, sorunlar ve uyarılar.
Davetler ve roller, API anahtarları, güvenlik ve SSO.
API tarifleri: gelen, giden, dinamik yapılandırma, araçlar, test.
HMAC denetimini bir kez doğru yapın ve her yerde yeniden kullanın.