Temel kavramlar

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:

---

​

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, /v1/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 bölümüne bakın.
• Bağlı yetenekler: bağlı uygulamalar, API bağlantıları, bilgi tabanları, MCP sunucuları ve satır içi fonksiyon araçları.
• 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 bölümüne bakın. API’de: /v1/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ı 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 bölümüne bakın. API’de: /v1/phone-numbers, /v1/voip-connections, /v1/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 bölümüne bakın. API’de: /v1/calls — liste, döküm, geçmiş, ses, derecelendirme, dışa aktarma; /v1/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). 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 bölümüne bakın. API’de: /v1/publishable-key, /v1/mic-session ve Widget SDK belgeleri.

---

​

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 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.
• 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ı — panodaki karşılığı /v1/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.
• VoIP (/dashboard/voip-connections) — kendi telefon numaralarınızı getirme için sağlayıcı kimlik bilgileri. Bkz. VoIP sağlayıcısı bağlama.

API’de: /v1/integrations ve /v1/voip-connections; ayrıca bkz. Araç entegrasyonu oluşturma.

---

​

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. Tek seferlik programatik aramalar için: giden aramalar API’si.

---

​

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

---

​

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. API’de: /v1/test-calls ve paket çalıştırıcısı — bkz. Bir ajanı uçtan uca test etme.

---

​

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

---

​

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. API’de: /v1/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.

---

​

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.

---

​

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 bir alert.triggered olayı gönderilir. Kontrol panelinde: Organizasyon → Uyarılar. Bkz. Uyarılar.

---

​

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 adresinden yönetin.
• Eski tek URL webhook’u: organizasyon başına bir URL. Şu adresten yönetilir: /v1/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 (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.

Her istek, X-ThunderPhone-Signature içinde bir HMAC-SHA256 imzası taşır. Bkz. İmza doğrulama.

---

​

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). API’de: /v1/integrations ve Function Tools belirtimi.

---

​

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. Kontrol panelinde: Organizasyon → Genel. Bkz. Ekibinizi davet edin. API’de: /v1/members, /v1/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 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. API’de: /v1/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.

---

​

Hepsini bir araya getirme