Herhangi bir metni gönderin, geri bir 1–10 duygu puanı alın
Kendi yardım masasını, CRM'ini veya ürününü entegre eden geliştiriciler için tasarlandı: SentiTrack'in /ingest API'sine tek bir olay POST edin ve diğer her kanalla aynı Net Graph, Time Graph, Raporlar ve Uyarılara aksın. Metin ise, SentiTrack onu puanlayabilir.
SentiTrack ingest API'si, kendi yardım masanızdan, CRM'inizden veya ürününüzden herhangi bir metin mesajını kabul edip bir 1–10 duygu olayına dönüştüren, kuruluş başına, API anahtarıyla kimliği doğrulanan bir REST uç noktasıdır (POST /api/v1/ingest/sentiments). Bir çağrı, Net Graph, Time Graph, Raporlar ve Uyarılarınıza akan bir kayıt olur.
En dürüst sinyaliniz özel sistemlerde sıkışıp kalmış
E-posta, aramalar ve sohbet kutudan çıktığı gibi kapsanır — ancak kendi yardım masası taleplerinizdeki, CRM notlarınızdaki ve ürün içi mesajlarınızdaki ton panolarınıza hiç ulaşmaz. Bu mesajları içeri itecek bir yol olmadan, her özel kanal bir kör nokta olarak kalır ve orada biriken sürtüşme yalnızca bir müşteriye veya ekip arkadaşına mal olduktan sonra ortaya çıkar.
Metin olan her şey için tek bir uç nokta
/ingest API'si, geliştiricilere herhangi bir mesajı SentiTrack'e beslemenin kiracıya kapsamlı bir yolunu sunar. Kuruluş başına bir API anahtarıyla kimlik doğrulayın, bir kaynak kanal, kimden, kime ve metinle bir olay POST edin ve SentiTrack onu 1–10 puanlayıp e-posta, ses ve sohbetle aynı analitik hattına yönlendirir. İçerikler puanlanır, ardından silinir — yalnızca puan, katılımcılar, zaman damgası, yön ve bir konu özeti tutulur.
- Kuruluş başına API anahtarı kimlik doğrulaması — her olay kiracınıza kapsamlandırılır, asla istemcinin sağladığı bir org_id'ye değil
- Herhangi bir kaynak kanal seçin: email, phone, slack veya kuruluşunuzun tanımladığı özel bir anahtar
- Güvenli, idempotent yeniden denemeler için bir external_id gönderin — yinelenenler tekilleştirilir, iki kez sayılmaz
- Tek olaylar veya 500'e kadar toplu gruplar, böylece bir geri doldurma binlerce çağrı değil, tek bir iştir
Sisteminizden grafiğinize üç adımda
Ayarlar'da kuruluş başına bir alım anahtarı oluşturun. Düz metin bir kez gösterilir; SentiTrack yalnızca bir önek ve bir özet saklar. Anahtarın kuruluşunuza çözümlendiğini bağlamadan önce doğrulamak için GET /api/v1/ingest/whoami'yi çağırın.
/api/v1/ingest/sentiments'e bir kaynak kanal, kimden, kime (ve isteğe bağlı cc), mesaj metni ve isteğe bağlı bir external_id ile tek bir olay gönderin. SentiTrack metni pakete dahil SentiAI motoruyla 1–10 puanlar ya da zaten hesapladığınız bir puanı iletebilirsiniz.
Olay, bir konu, yön ve katılımcılarla tek bir kayıt olur — Net Graph, Time Graph, Konu kümeleri, zamanlanmış PDF Raporları ve Uyarılarda e-posta, ses ve sohbetle birlikte anında görünür. Ayrı bir pano yok, ekstra kurulum yok.
Yardım masası talepleri, CRM notları, ürün içi mesajlar, yorumlar, destek dökümleri — metinsel olan her şey bir 1–10 duygu olayı olur. Tek bir sözleşme, aklınıza gelebilecek her özel kaynağı kapsar.
Alınan olaylar e-posta, ses ve sohbetle özdeş hattan akar, böylece Net Graph, Time Graph, Konu kümeleri, Raporlar ve Uyarılarınızda sıfır ek yapılandırmayla görünürler.
Kimlik doğrulama kuruluş başına bir API anahtarıdır ve her olay sunucu tarafında o kuruluşa kapsamlandırılır. İstemcinin sağladığı kuruluş tanımlayıcılarına asla güvenilmez, böylece kiracılar arası sızıntı yapısal olarak imkansızdır.
Bir external_id iletin, yeniden denemeler güvenli olsun — tekrar eden bir çağrı, yinelemek yerine mevcut kaydı döndürür. İstek başına 500'e kadar olaydan oluşan toplu gruplarla geçmişi geri doldurun.
Aynı 7 dilli doğal puanlama geçerlidir — İngilizce, Almanca, Fransızca, İtalyanca, İspanyolca, Rusça ve Türkçe, ayrıca Arapça — sizin tarafınızda dil başına kurulum veya yönlendirme olmadan.
İçerikler puanlanır ardından silinir. SentiTrack yalnızca puanı, katılımcıları, zaman damgasını, yönü ve bir konu özetini tutar — gönderdiğiniz mesaj metnini, konuyu veya ekleri asla.
Metni puanlar, sonra atarız
Ingest API, SentiTrack'in platform geneli gizlilik duruşunu devralır. POST ettiğiniz mesaj ne olursa olsun puanlanır ve ardından silinir — asla kalıcı hale getirilmez. Yalnızca 1–10 puanını, katılımcıları, zaman damgasını, yönü, konuyu ve bir konu özetini tutarız, böylece özel kanal verileriniz e-postadan daha fazla risk taşımaz.
- Hiçbir mesaj içeriği, konu metni veya eki saklanmaz — yalnızca puan artı üst veri
- Kuruluş başına API anahtarları durağan halde Fernet ile şifrelenir; oluşturmadan sonra yalnızca bir önek ve özet tutulur
- Yapılandırılabilir saklama (varsayılan 365 gün) ve bir kalıcı silme uç noktası alınan olaylara da uygulanır
- Duyguyu demografik özniteliklerle saklamak GDPR Madde 9 verisi olabilir — DPIA, yasal dayanak ve onay, ToS uyarınca müşterinin sorumluluğunda kalır
Geliştirici ingest API — SSS
SentiTrack'e programatik olarak nasıl duygu verisi gönderirim?
Kuruluş başına bir API anahtarıyla kimliği doğrulanmış olarak /api/v1/ingest/sentiments'e bir JSON olayı POST edin. Bir kaynak kanal, kimden, kime ve mesaj metnini ekleyin ve SentiTrack onu 1–10 puanlayıp panolarınıza yönlendirir. Geçmiş için /ingest/sentiments/bulk, tek bir en iyi çaba grubunda 500'e kadar olay kabul eder.
Ingest API mesaj içeriğini saklar mı?
Hayır. Ingest API, her SentiTrack kanalıyla aynı gizlilik duruşunu izler: metin puanlanır, ardından silinir. Yalnızca 1–10 puanı, katılımcılar, zaman damgası, yön, konu ve bir konu özeti saklanır — gönderdiğiniz mesaj içeriğini, konu metnini veya ekleri asla.
Ingest API'nin kimliği nasıl doğrulanır?
Ayarlar'da oluşturduğunuz kuruluş başına bir API anahtarıyla. Düz metin anahtar oluşturma sırasında bir kez gösterilir; SentiTrack yalnızca bir önek artı bir özet saklar. Her olay sunucu tarafında anahtarın sahibi olan kuruluşa kapsamlandırılır, böylece istemcinin sağladığı bir org_id'ye asla güvenilmez ve kiracılar birbirine sızamaz.
Yinelenenler oluşturmadan bir isteği güvenle yeniden deneyebilir miyim?
Evet. Her olayla bir external_id iletin ve alım idempotent olur: aynı {org, external_id} ile tekrar eden bir çağrı tekilleştirilir ve ikincisini oluşturmak yerine mevcut kaydı döndürür. Bu, kuyruğunuzdan gelen yeniden denemeleri, yeniden yürütmeleri ve en-az-bir-kez teslimi güvenle bağlanabilir kılar.
Ingest API'ye ne tür mesajlar iletebilirim?
Metinsel olan her şey. Yardım masası talepleri, CRM notları, ürün içi sohbet, destek dökümleri, yorumlar ve özel kanalların hepsi çalışır — metin ise, SentiTrack onu puanlayabilir. Net Graph ve Time Graph'ınızda doğru gruplanması için her olayı bir kaynak kanalla (email, phone, slack veya özel bir anahtar) etiketleyin.
Alınan olaylar e-postayla aynı grafiklerde görünür mü?
Evet. Alınan her olay, IMAP e-posta, ses ve sohbetle özdeş hattan akan tek bir kayıt olur. Net Graph, Time Graph, Konu kümeleri, kaydedilmiş görünümler, zamanlanmış PDF Raporları ve Uyarılarda, ayrı bir pano ve sizin tarafınızda ekstra yapılandırma olmadan görünür.
İlk mesajınızı bugün bağlayın
Kuruluş başına bir API anahtarı oluşturun, tek bir olay POST edin ve Net Graph ile Time Graph'ınıza düşmesini izleyin. Ya da alınan mesajlarınızın tam olarak nerede göründüğünü görmek için örnek verilerle canlı demoyu açın — kayıt gerekmez.