Türkçe Dokümantasyon Yayında: 31 Başlıkta Sesli Yapay Zekâ

Sesli yapay zekâ alanının teknik kaynakları neredeyse tamamen İngilizce. Bir asistanı telefona bağlamak, SIP trunk tanımlamak ya da webhook kurmak isteyen Türk geliştirici, çoğu zaman İngilizce dokümanı okuyup terimleri kafasında çevirerek ilerliyor. Bu hem yavaşlatıyor hem de yanlış anlamaya açık kapı bırakıyor.

Bugün 31 başlıklık Türkçe dokümantasyonu yayına aldık. İçerik İngilizce sayfaların çevirisi değil: her başlık platformun çalışan koduna bakılarak yazıldı, bazı yerlerde İngilizce doküman bayat kaldığı için doğrusu Türkçe tarafta yazıldı. Bu yazıda dokümantasyonun nasıl düzenlendiğini ve nereden başlamanız gerektiğini anlatıyoruz.

Yedi kategori, 31 başlık

Dokümantasyon, birbirini takip eden yedi kategoriye ayrıldı. Sırayla okumanız gerekmiyor; her kategori kendi başına bir işi çözüyor:

• Başlangıç (3 başlık) — hesap açmaktan ilk gerçek aramaya kadar. Hızlı başlangıç, kimlik doğrulama, demo numarası.
• Temel (8 başlık) — asistanı yapılandırma, bilgi tabanı, ses kalitesi, aramalar, kampanyalar, planlı aramalar, arama sonrası işlemler, ses kataloğu.
• Kanallar (7 başlık) — telefon numaraları, SIP trunk, tarayıcıdan arama, sohbet, widget, canlı tercüman, sunucusuz sesli oturum.
• Faturalama (2 başlık) — dakika ve mesaj ücretleri, cüzdan ve otomatik tahsilat.
• Geliştirici (7 başlık) — API referansı, webhook, fonksiyonlar, olaylar, hata ve hız sınırları, vCon dışa aktarma, geçici token.
• Operasyon (3 başlık) — güvenlik ve KVKK, bayilik, üye yönetimi.
• Genel (1 başlık) — STT, TTS, SIP, trunk gibi terimlerin Türkçe karşılıkları.

Nereden başlamalı?

Hedefinize göre üç farklı giriş noktası var.

Telefonu açan bir asistan istiyorsanız

Hızlı başlangıç sayfasıyla açın: hesap açma, asistan kurma, numara bağlama ve ilk aramayı yapma adımlarını sırayla anlatıyor. Ardından Asistanlar sayfası ayarların tamamını (talimat, model, ses, aktarma hedefi, kayıt, telesekreter) tek tek açıklıyor. Asistanın kendi içeriğinizden cevap vermesini istiyorsanız Bilgi Tabanı sayfası devreye giriyor.

Kendi yazılımınıza entegre edecekseniz

Kimlik doğrulama sayfası API anahtarı üretmeyi ve salt-okuma anahtarlarını anlatıyor. API referansı uçların tamamını listeliyor. Asistanın konuşma sırasında sizin sisteminizi çağırmasını istiyorsanız — randevu oluşturma, stok sorgulama, sipariş durumu — Fonksiyonlar sayfası bunun nasıl tanımlandığını gösteriyor. Arama bittiğinde kendi sunucunuza veri düşmesi için Webhook sayfası.

Kendi markanızla satacaksanız

Bayilik sayfası white-label kurulumunu anlatıyor: kendi alan adınız, kendi logonuz, kendi fiyatınız. Üyeler sayfası müşterilerinizi nasıl yöneteceğinizi — kredi dağıtma, marj belirleme, hızlı giriş bağlantısı gönderme — adım adım gösteriyor.

Türkiye’ye özgü konular

İngilizce dokümanların hiç değinmediği, Türkiye’de çalışırken doğrudan karşınıza çıkan konuları ayrıca yazdık:

• NetGSM ile BYOC — mevcut numaranızı taşımadan, şu anki operatörünüzle asistanı devreye alma. Panelden Türkiye numarası satın alma regülasyon nedeniyle kapalı olduğu için Türkiye’de asıl yol budur.
• İYS onayı — toplu giden arama ve planlı aramalarda hangi izne ihtiyacınız olduğu.
• KVKK — çağrı kaydı, bilgi tabanı içeriği ve arama sonrası çıkarım alanlarının kişisel veri açısından ne anlama geldiği.
• Yerel format numara — 08501234567 gibi girişlerin otomatik olarak uluslararası formata çevrilmesi.
• Türkçede araya girme (barge-in) ayarı — Türkçenin cümle yapısı nedeniyle asistanın sözü kesme eşiğinin nasıl ayarlanması gerektiği.

Fiyatlar dokümanda değil, canlı sistemde

Fiyatlandırma sayfasındaki rakamlar platformun canlı fiyat yapılandırmasından alındı: taban ücret dakika başına $0,10; telefon hattı bacak başına +$0,01; giden arama bacak başına +$0,03; kayıt +$0,005; sohbet mesaj başına $0,01.

Bir telefon aramasının iki PSTN bacağı kullandığını da açıkça yazdık — faturayı okurken en çok şaşırtan kalem bu. Pratikte gelen bir telefon araması dakika başına yaklaşık $0,12, giden bir arama $0,18, tarayıcıdan yapılan test ise $0,10 tutuyor.

Sözlük: terim karmaşasına son

Bu alanın terimleri İngilizce kısaltmalarla dolaşıyor ve çoğu kaynak bunları açıklamadan kullanıyor. Sözlük sayfası STT, TTS, LLM, SIP, trunk, BYOC, DID, barge-in, backchannel, webhook, latency gibi terimlerin ne anlama geldiğini tek tek yazıyor. Diğer sayfalarda geçen her terimin karşılığı burada.

Sürekli güncelleniyor

Her sayfanın altında son güncelleme tarihi var. Platform değiştikçe dokümanlar da değişiyor; eksik ya da yanlış bulduğunuz bir yer olursa bize yazın, düzeltelim.