Geliştiriciler için
Kallina ile bugün koddan neleri bağlayabilirsiniz
Kallina'nın henüz belgelenmiş herkese açık bir REST API'si yok. Çalışan dört bağlantı noktası var: görüşme sırasında ajan tarafından çağrılan webhook araçları, akışları başlatan adresler, sesli buton için betik ve bir MCP sunucusu. Özel durumlar için API erişimini talep üzerine görüşürüz.
Bağlantı noktaları
Arama sırasında webhook araçları
Ajan fişinde bir araç tanımlarsınız: ad, açıklama, adres, yöntem, alan şeması ve en uzun bekleme süresi. Konuşma bunu gerektirdiğinde ajan onu çağırır ve yanıtı cümle içinde kullanır.
Akışları başlatan adresler
Kurucudaki bir akışın kendi tetikleme adresi olabilir. Sizin sisteminiz bir istek gönderir ve akış alınan verilerle başlar.
Sitedeki sesli buton
Sayfada tek bir betik. Sesli oturum geçici bir adres alır, böylece ajan kimliği sayfa kodunda görünmez.
MCP sunucusu
MCP uyumlu asistanlar, ajanları, aramaları ve leadleri okumak ya da arama başlatmak için OAuth ile Kallina hesabına bağlanabilir.
Sesli buton: eklenecek kod
Betik modül olarak değil ve bundler üzerinden değil, basitçe yüklenir.
<script src="https://app.kallina.info/embed.js" data-widget="WIDGET_ID"></script>
<script>
window.KallinaVoice.on("state", (s) => console.log(s)); // idle | connecting | listening | speaking
window.KallinaVoice.on("message", (m) => console.log(m.source, m.text));
// window.KallinaVoice.start() / window.KallinaVoice.stop()
</script>| Öznitelik | Ne yapar |
|---|---|
| data-widget | Widget'ın herkese açık kimliği. Zorunlu. |
| data-mode | „button” butonu gösterir; „inline” hiçbir şey göstermez ve başlatmayı kodunuza bırakın. |
| data-position | Buton köşesi: sağ alt veya sol alt. |
| data-color | Buton rengi. |
| data-label | Butonun erişilebilir etiketi. |
Akış adreslerinin kimlik doğrulaması
| Yöntem | Ne zaman kullanılır |
|---|---|
| Kimlik doğrulama yok | Yalnızca testler için, kişisel verilere dokunmayan akışlarda. |
| Temel | Kullanıcı adı ve parola, başka bir şey bilmeyen sistemler için. |
| Özel başlık | Sizin belirlediğiniz gizli bir değer içeren bir başlık. |
| Bearer | Yetkilendirme başlığında bir token. |
Kullanılabilir MCP araçları
Aşağıdaki adlar sunucudakilerle aynıdır. Erişim, yetkilendirmeden sonra hesap bazında verilir.
- list_agents
- get_agent
- update_agent_prompt
- list_phone_numbers
- list_calls
- get_call_transcript
- list_leads
- export_leads
- start_outbound_call
- list_campaigns
- start_campaign
- account_status
Sıkça sorulan sorular
Anahtarlarla bir REST API'niz var mı?
Genel değil. Aramaları başlatmanız veya kendi sisteminizden sonuçları okumanız gerekiyorsa, bize durumu yazın ve erişimi ile biçimini belirleriz.
Her aramadan sonra sonucu bir webhook olarak alıyor muyum?
Standart hizmet olarak değil. Sonuç, akışlar üzerinden veya mevcut entegrasyonlar aracılığıyla gönderilir; sabit bir biçim için projede bunu konuşuruz.
Dokümantasyon var mı?
Sesli düğme ve webhook araçları için, bu sayfadaki açıklama ve uygulamadaki yardım. Herhangi bir ek erişim için, dokümantasyonu proje başlangıcında alırsınız.
Webhook araçlarının hızlı yanıt vermesi gerekir mi?
Evet. Her aracın maksimum bir bekleme süresi vardır; yavaş bir yanıt, konuşmada bir duraklama demektir, bu yüzden istekleri kısa tutun.
Bağlamak istediğiniz şeyi bize anlatın
Hangi sistem, hangi veriler ve aramanın hangi anında. Mevcut olanla nelerin yapılabildiğini ve neyin inşa edilmesi gerektiğini size yanıtlarız.