AgenticCX, platformla doğrudan konuşması gereken Sestek'in kendi servisleri için intra-api adında, yalnızca dahili kullanıma açık ayrı bir API yüzeyi sunar. Bugün bu, aramaları karşılayan ve yöneten yapay zeka ajanı (Virtual Agent) demektir; ileride telefon santralının kendisi de buraya katılacak.
Neden Üçüncü Bir Yüzey
AgenticCX'te zaten iki API katmanı vardır: Müşteri Temsilcisi Arayüzü ve yönetim ekranlarının kullandığı dahili uygulama API'si (oturum tabanlı, giriş yapmış kullanıcılar için) ve müşterilerin kendi sistemlerini bağlaması için yayımlanan ext-api (bkz. External API). intra-api ise üçüncü, ayrı bir güven sınırıdır: onu yalnızca Sestek'in kendi işlettiği servisler çağırabilir. Ayrımı URL yolu değil, belirtecin audience (hedef kitle) değeri yapar. ext-api için verilmiş bir belirteç (audience AgenticCXExternal) burada reddedilir, intra-api için verilmiş bir belirteç (audience AgenticCXIntra) de başka hiçbir yerde kabul edilmez.
Bu, müşterilerin kullanacağı bir entegrasyon yüzeyi değildir. AgenticCX'in kendi yapay zeka ajanının, görüşme başlamadan önce çağrı bağlamını okuyabilmesi, çağrı bittiğinde ürettiği sonucu geri yazabilmesi ve bir çağrıyı insan temsilciye devretmeden önce kuyruk müsaitliğini kontrol edebilmesi için vardır.
Kimlik Doğrulama
client_credentials OAuth akışı, audience AgenticCXIntra, rol AiAgent. Her kiracıya kendi istemci kimliği (client id) ve gizli anahtarı (secret) verilir. Kiracı, imzalı belirteçten çözülür; hiçbir zaman başlıktan veya sorgu parametresinden alınmaz.
POST /connect/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&client_id=<kiracının intra-api istemci kimliği>
&client_secret=<gizli anahtar>
&scope=AgenticCXIntra
Dönen belirteci her istekte Authorization: Bearer <token> olarak gönderin.
Oturum API'si: Çağrı Bağlamını Okuma ve Yazma
GET intra-api/v1/session/{sessionId} ve PATCH intra-api/v1/session/{sessionId} aynı kimlikle adreslenir: çağrının kendi SIP Call-ID başlığı, URL kodlamalı biçimde.
GET, görüşme başlarken çağrılır ve yapay zeka ajanının ihtiyaç duyduğunu okur: seçebileceği sonuç (kapanış) kodları, kişinin kim olduğu ve çağrının ait olduğu görüşmenin kısa bir özeti. Hangi parçaların döneceğini include parametresi belirler. Varsayılan küme (wrapUpCodes, contactInfo, conversationShortInfo) otomatik döner; daha önce yazılmış bir not ise yalnızca isteğe bağlıdır (?include=note), çünkü onu okumak ek bir sorgu demektir.
PATCH, görüşme bittikten sonra çağrılır ve yapay zeka ajanının ürettiğini geri yazar: bir sonuç kodu ve serbest metin bir not. Yanıt, her alan için ayrı ayrı, tam olarak neyin applied (uygulandı) ve neyin rejected (reddedildi) olduğunu ve nedenini bildirir. Böylece hatalı bir sonuç kodu, geçerli bir notun kaydedilmesini hiçbir zaman engellemez.
Kuyruk API'si: Devir Kapasitesini Okuma
GET intra-api/v1/queues, kiracının tüm kuyruklarını ve her kuyruğa atanmış temsilcilerden şu anda oturum açmış ve Uygun durumda olanların (çağrıda değil, çağrı sonrası çalışmada değil, çevrimdışı değil) sayısını döndürür. Yapay zeka ajanı, bir görüşmeyi insan temsilciye devretmeden hemen önce hangi kuyruğa devredeceğine karar vermek için bunu çağırır.
Bu Belge Kimler İçin
intra-api burada eksiksiz olsun diye belgelenmiştir; platformun gerçek ve sürümlü bir API yüzeyidir, ancak bir müşterinin doğrudan entegre olacağı bir şey değildir. Bir projenin yapay zeka ajanı dışında birinci taraf bir servisin AgenticCX ile bu şekilde konuşmasına ihtiyacı olursa izleyeceği örüntü budur.