Temel kavramlar

Platformdaki her şeyin haritası: her nesnenin ne yaptığı, kontrol panelinde nerede bulunduğu ve hangi API

ThunderPhone, sesli AI ajanları oluşturmak, çalıştırmak ve geliştirmek için tam kapsamlı bir platformdur. Bu sayfa bir haritadır: karşılaşacağınız her kavram, her biri kısa bir bölümle, kontrol panelindeki yeri ve onu destekleyen API ile birlikte sunulur. Bir kez göz gezdirin, ardından bir terimin açıklanması gerektiğinde buraya dönün.

Kontrol paneli 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ğlılıktır: anahtarınız kuruluşu zaten tanımladığı için URL yollarına hiçbir zaman kuruluş kimliği eklemezsiniz.

Kontrol panelinde: kuruluş seçici (kenar çubuğu alt bilgisi) ve Kuruluş ayarları — Hesabım, Genel, Anahtarlar, Uyarılar, Faturalandırma Ayarları ve Faturalandırma Geçmişi sekmeleri. Bkz. Kuruluş ayarları başvurusu.

API'de: /v1/orgs, /v1/developer/api-keys.

Ajanlar#

Bir yapay zeka ajanı, bir aramayı çalıştıran AI yapılandırmasıdır. Şunları bir araya getirir:

• Ajanın ne söylediğini ve nasıl davrandığını belirleyen bir istem — bir insana aktarma, tuş takımı basımları ve aramayı sonlandırma gibi arama eylemleri dahil; bunlar ayrı yapılandırmalar yerine istemde yer alan düz satırlardı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 ses, ayrıca bir birincil dil ve isteğe bağlı ek diller — arayan kişi dil değiştirdiğinde ajan otomatik olarak geçiş yapar. Bkz. Desteklenen diller.
• Ekli 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ı, onaylama modu, arka plan parçası, bekletme zaman aşımı.

Oluşturucudaki düzenlemeler otomatik olarak taslağa kaydedilir; Yayınla seçeneğine 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.

Kontrol panelinde: Sesli AI Ajanları → ajan oluşturucu (/dashboard/agents). Bkz. İlk sesli AI ajanınızı oluşturun.

API'de: /v1/agents — CRUD, çoğaltma, aktarma, sürüm geçmişi ve istem yardımcıları.

Sesler#

Ses kitaplığı, bir ajanın kullanabileceği sesleri, oynatılabilir örneklerini, uyumlu dilleri, cinsiyet ve aksan gruplarını ve tüm premium ses/dil ek ücretlerini içerir. Ücretli örnekleme aracı, seçim yapmadan önce kendi 1–500 karakterlik ifadenizi sentezleyebilir.

Uygun kuruluşlar, kısa bir WAV veya MP3 örneğinden özel sesler de oluşturabilir. Özel seslerin bir kotası ve eşzamansız oluşturma durumu vardır; hazır olduklarında, kitaplık sesleriyle aynı ajan seçicide görünürler.

Kontrol panelinde: Sesler (/dashboard/voices). Bkz. Ses kitaplığı ve özel sesler.

API'de: /v1/voices, ses örnekleri ve özel sesler.

Telefon numaraları#

Bir telefon numarası bir kuruluşa aittir ve gelen aramaları bir ajana yönlendirir (giden aramalar için de kullanılabilir). İki kaynak vardır:

• ThunderPhone numaraları — ThunderPhone havuzundan sağlanan gerçek ABD numaralarıdır; saniyeler içinde etkinleşir ve aylık $1 artı dakika başına 1¢ ek ücret uygulanır. Başlangıçta yalnızca gelen aramalara açıktır. Bir kuruluş yöneticisi, Telefon Numaraları sayfasından giden arama talebinde bulunabilir; ThunderPhone her talebi manuel olarak inceler ve onaylanan numaralar arama yapabilir ve kampanyalar yürütebilir. Bir kuruluş varsayılan olarak 25 numara bulundurabilir.
• VoIP numaraları — kendi sağlayıcınızdan bir VoIP bağlantısı aracılığıyla getirilir. Twilio ve Telnyx, bir API anahtarıyla doğrudan bağlanır (Telnyx ayrıca rehberli yeni hesap kurulumu da sunar); SignalWire, Vonage, Plivo ve diğer tüm SIP trunk'ları SIP kurulumu, manuel bir SIP yapılandırması aracılığıyla bağlanır. İç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 ayarlayabilir, gelen aramalar için ajanı seçebilir ve numarayı etiketleyebilirsiniz.

Kontrol panelinde: Telefon Numaraları (/dashboard/phone-numbers). Bkz. Telefon numarası alma.

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ı olur. Bir arama; rollerle etiketlenmiş tam dökümü, yapılandırılmış tur geçmişini (araç çağrıları dahil), bir kaydı, toplam faturalandırma tutarını ve isteğe bağlı yapay zeka değerlendirmesi ile sorun raporlarını içerir.

Bir arama canlıyken, açabilir ve 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.

Kontrol panelinde: Arşiv ve arama başına ayrıntılar için Arama Geçmişi (/dashboard/call-history); devam eden aramalar için Canlı. Bkz. Aramalarınızı inceleme, dinleme ve yönlendirme.

API'de: /v1/calls — liste, döküm, geçmiş, ses, değerlendirme, dışa aktarma; /v1/issue-reports.

Müşteri portalları#

Bir müşteri portalı, harici bir müşteri için markalı, salt okunur bir arama geçmişi görünümüdür. Kuruluş yöneticileri, aramaları görüntülenecek ajanları seçer, onaylı görüntüleyici e-posta adreslerini ekler, bir logo ve vurgu rengi yükler ve isteğe bağlı olarak özel bir alan adını doğrular. Portal görüntüleyicileri, kontrol paneli erişimi almadan arama ayrıntılarını, dökümleri ve kullanılabilir kayıtları inceleyebilir.

Kontrol panelinde: Müşteri portalları (/dashboard/client-portals). Bkz. Müşteri portalları.

API'de: Yönetici yönetim yüzeyi için /v1/client-portals.

Web bileşenleri#

Web widget, site ziyaretçilerinize bir ajanla mikrofon tabanlı konuşma olanağı sunar — telefon numarası gerekmez. Tarayıcıların yalnızca izin verilen alan adlarınızdan kullanabildiği bir yayınlanabilir anahtar (pk_live_...) ile kimlik doğrular; bu nedenle istemci tarafı kodlarda güvenle kullanılabilir. Alan adı listesi kimlik doğrulama değildir ve bir sayfanın gönderebileceği oturum ayarları, anahtarda izin verene kadar devre dışıdır.

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. Çağrı başına dinamik yapılandırma). Bileşen oturumları, telefon çağrılarıyla aynı çağrı altyapısından geçer.

Kontrol panelinde: Web Bileşenleri (/dashboard/web-widgets) — bileşenler oluşturun, modu ve ajanı ayarlayın, izin verilen alan adlarını yönetin ve yerleştirme kod parçacığını kopyalayın. Bkz. Web bileşeni oluşturma.

API'de: /v1/publishable-key, /v1/mic-session ve Bileşen SDK dokümantasyonu.

Bilgi tabanları#

Bilgi tabanı, ajanın yanıtlarını temellendirmek için çağrı sırasında arayabileceği bir belge kümesidir — dosya yükleyin, metin yapıştırın veya web sayfalarını URL ile içe aktarın; ardından oluşturucuda bilgi tabanını bir ajana ekleyin. Ajan, görüşme gerektirdiğinde yerleşik arama aracını kullanarak bilgi tabanında sorgu yapar.

Kontrol panelinde: belge kitaplığı için Bilgi (/dashboard/knowledge); bir ajana eklemek için oluşturucudaki Bilgi bölümü. Bkz. Ajanınıza bilgi tabanı ekleme.

Bağlantılar#

Bağlantılar, ajanların dış dünyaya ulaşmasını sağlar. Dört tür, tek kenar çubuğu grubu:

• 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 başına araçları (Slack mesajı gönderme, HubSpot kişisi ekleme veya güncelleme, Cal.com zaman dilimi ayarlama…) herhangi bir ajanda açıp kapatı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şturur veya aracı manuel olarak oluşturun. Test İsteği düğmesi, yayına almadan önce bir korumalı alan çağrısı başlatır. Bkz. API bağlantıları — bunun kontrol panelindeki karşılığı /v1/integrations.
• MCP (/dashboard/mcp-connections) — URL ile bir Model Context Protocol sunucusu ekleyin ve ajanın sunduğu araçları kullanmasını sağlayın. 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.

ThunderPhone ayrıca kendi MCP uç noktasını sunar; böylece harici bir MCP istemcisi ajanları listeleyebilir, çağrıları ve transkriptleri inceleyebilir ve çağrı başlatabilir. Bkz. ThunderPhone'u MCP sunucusu olarak kullanma.

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

Kampanyalar#

Bir kampanya, geniş ölçekte giden çağrılar gerçekleştirir: kişi içeren 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ığı ve yeniden deneme ilkesini (maksimum deneme sayısı ve hangi sonuçların — yanıt yok, sesli mesaj, başarısız — yeniden deneneceği) ayarlayın. Kampanya listedeki kayıtları işler ve her çağrıyı Çağrı Geçmişi'ne kaydeder.

Kontrol panelinde: Kampanyalar (/dashboard/campaigns). Bkz. Giden arama kampanyası yürütme.

Tek seferlik programatik çağrılar için: giden çağrılar API'si.

Canlı izleme#

Canlı, kuruluş genelinde devam eden tüm çağrıları gösterir ve bunlardan herhangi birini gerçek zamanlı olarak dinlemek ve fısıldamak için açmanıza olanak tanır. Bu, denetim alanıdır: yeni bir istemin ilk gerçek trafiğini izleyin veya devam eden bir kampanyayı takip edin.

Panoda: Canlı (/dashboard/live). Bkz. Canlı çağrıları 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. Bir ajana veya telefon numarasına yönlendirin, arayan senaryosunu kendiniz yazın ya da ajanın isteminden AI ile senaryolar oluşturun (isterseniz uç durumlar da dahil edilir) ve çağrıyı canlı izleyin.

Senaryolar, minimum geçme oranını sabitleyen ve CI'da sürüm yayınlarını engelleyebilen paketler halinde gruplanır; kabul edilen temel çizgiye göre gerilemeler senaryo bazında raporlanır.

Panoda: Simülasyonlar (/dashboard/simulations) ve ajan oluşturucu içindeki Simülasyon düğmesi. Bkz. Bir çağrıyı simüle etme.

API'de: /v1/test-calls ve paket çalıştırıcısı — bkz. Bir ajanı uçtan uca test etme.

Doğrulama kümeleri#

Bir doğrulama kümesi, gerçek çağrı anlarını tekrarlanabilir, tek turlu gerileme kontrollerine dönüştürür. Her örnek; konuşma bağlamını, ilgili arayan sesini, özgün yanıtı ve beklenen davranışı dondurur. Yeniden oynatmalar, başka bir çağrı yapmadan mevcut yapay zeka ajanı taslağına karşı çalışır ve yayına alma iletişim kutusu, son çalıştırmanın hâlâ bu taslakla eşleşip eşleşmediğini gösterebilir.

Panoda: kuruluş veri kümesi için Doğrulama kümeleri (/dashboard/validation) ve çalıştırmalar için ajan oluşturucudaki Doğrulama sekmesi. Bkz. Doğrulama kümeleri.

API'de: /v1/validation-sets ve aynı referans sayfasındaki ajan/örnek yeniden oynatma uç noktaları.

Deneyler#

Bir deney, canlı trafikte ajan yapılandırmalarını A/B testiyle karşılaştırır: varyantları tanımlayın (farklı istemler, motorlar veya ayarlar), trafiği bunlar arasında bölün ve sonuçları varyant bazında karşılaştırın. Webhook içinde paket mantığını elle 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 — insan inceleyici tarafından bildirilir veya AI değerlendirmesiyle tespit edilir. Sorunlar önem derecesi, kaynak ve durum bilgilerini taşır; Sorunlar sayfası ise önceliklendirme kuyruğudur: filtreleyin, sorunlu çağrıyı inceleyin ve düzeltmeleri takip edin.

Panoda: Sorunlar (/dashboard/issues) ve Çağrı Geçmişi'ndeki çağrı bazlı işaretleme. Bkz. Sorun önceliklendirmesi.

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?") seçtiğiniz ajanlar ve tarih aralığıyla sınırlı, AI tarafından yazılmış bir analizle yanıtlar.

Panoda: Raporlar (/dashboard/reports). Bkz. Raporlar.

Gözlemlenebilirlik#

Gözlemlenebilirlik, metrikler alanıdır: zaman içinde çağrı hacmi, sonuçlar ve kalite; ajan ve zaman aralığına göre filtrelenebilir ve sonraki analizler için dışa aktarma sunar.

Panoda: 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 gerilemeleri) izler ve eşik değerinizi aştığında tetiklenir. Bildirimler e-posta ve Slack'e gönderilir ve webhook uç noktalarınıza alert.triggered olayı gönderilir.

Panoda: Kuruluş → Uyarılar. Bkz. Uyarılar.

Web kancaları#

ThunderPhone, bir çağrı sırasında ve sonrasında olaylar gerçekleştiğinde sunucunuza HTTP POST web kancaları gönderir. İki teslimat modeli vardır:

• Web kancası uç noktaları (önerilir): birçok URL'yi, uç nokta başına gizli anahtarlar ve uç nokta başına olay abonelikleriyle /v1/developer/webhook-endpoints üzerinden yönetin.
• Eski tek URL'li web kancası: kuruluş başına bir URL. Yönetimi /v1/webhook üzerinden veya Kuruluş → Genel altında yapılır. Geriye dönük uyumluluk için korunur.

Olaylar iki sınıfa ayrılır:

• Engelleyici etkinlikler, sunucunuzun devam eden aramayı şekillendiren bir yapılandırmayla yanıt vermesini bekler — gelen arama etkinlikleri (telephony.incoming / web.incoming). Bir telefon araması, bir yeniden deneme dahil olmak üzere en fazla 13 saniye, bir widget oturumu ise 10 saniye bekler. Yedek bir ajan yoktur: kullanılabilir bir yapılandırma olmadan telefon araması sonlandırılır ve widget oturumu başarısız olur.
• Engelleyici olmayan etkinlikler, çalıştır ve unut bildirimleridir; üstel geri çekilme ile yeniden denenir — teslimat semantiğine bakın.

Her istek, X-ThunderPhone-Signature-V2 içinde zaman damgalı bir HMAC-SHA256 imzası ve eski, yalnızca gövdeye dayalı X-ThunderPhone-Signature imzasını taşır. Bkz. İmza doğrulama.

Fonksiyon araçları#

Bir fonksiyon aracı, yapay zeka 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 uç nokta URL'si verirsiniz; ajan bunu 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, araç tanımları yerine basit istem satırlarıyla etkinleştirdiğiniz yerleşik çağrı yetenekleriyle gelir — çağrıyı aktarma, tuş takımı (DTMF) girdisi gönderme, çağrıyı sonlandırma, bekletmede bekleme.

Panoda: oluşturucunun API bağlantıları bölümü (bkz. Bağlantılar).

API'de: /v1/integrations ve Function Tools belirtimi.

Ekip ve roller#

Her kuruluşun iki role sahip 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; bir üye satırındaki ⋯ menüsü rolleri değiştirmenizi veya birini kaldırmanızı sağlar. Tek oturum açma kuruluş genelinde yapılandırılabilir — bkz. SSO.

Panoda: Kuruluş → Genel. Bkz. Ekibinizi davet edin.

API'de: /v1/members, /v1/invites.

Faturalandırma#

ThunderPhone ön ödemelidir. Her kuruluşun USD bakiyesi vardır; çağrılar bu bakiyeden ajanın dakika başına ücreti üzerinden düşülür (motor katmanı ve ek ücretler — ayarları değiştirdikçe oluşturucu toplam ücreti canlı olarak gösterir ve seçili ek diller 3¢/dk ekler). Bakiye sıfıra ulaştığında gelen çağrılar reddedilir ve giden çağrılar 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 yüklemeyi etkinleştirin — böylece bir çağrı asla cümlenin ortasında kesilmez.

Panoda: Kuruluş → Faturalandırma Ayarları ve Faturalandırma Geçmişi. Ayrıca bkz. Bakiye ekleyin ve otomatik yüklemeyi açın ile eksiksiz fiyatlandırma referansı.

API'de: /v1/billing.

Uygulama içi yardımcı pilot#

Pano, yerleşik bir yardımcı pilot sunar — ona "X'i nasıl yaparım" diye sorun; bu dokümanlardan yanıt verir, gerçek kontrolleri vurgulayan adım adım rehberler sunar ve yönlendirmeli 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#