Zentor App’ta kimlik doğrulama nasıl çalışır
Geliştirici API anahtarı sistemi yoktur — yalnızca gösterge paneli girişi ve bir widget gömme jetonu vardır. İkisi de böyle çalışır.
Son doğrulama: 2026-07-20
Zentor App şu anda geliştiriciler için klasik, kalıcı bir API anahtarı sunmuyor. İki gerçek kimlik doğrulama yolu vardır: gösterge paneli girişi (sizin için oturum tabanlı) ve widget gömme jetonu (sohbet widget’ınızı web sitenize genel olarak gömmek için).
Adım adım
- Gösterge paneli girişini anlayınGiriş yaptıktan sonra 12 saat geçerli bir erişim jetonu ve şifrenizi tekrar girmeden oturum açık kalmanız için 7 gün geçerli bir yenileme jetonu alırsınız. Erişim jetonu her yenilemede döndürülür (tek kullanımlık).
- İsteğe bağlı olarak iki faktörlü kimlik doğrulamayı etkinleştirinHesabınız için TOTP tabanlı iki faktörlü kimlik doğrulamayı (yaygın kimlik doğrulama uygulamalarıyla uyumlu) acil durumlar için yedek kodlar dahil etkinleştirebilirsiniz.
- Tek oturum açma (mevcutsa)Kiracınız için SSO (SAML/OIDC) kurulmuşsa, giriş yalnızca kimlik sağlayıcınız üzerinden zorunlu kılınabilir — normal şifre girişi o zaman devre dışı bırakılır.
- Widget gömme jetonunu anlayınSohbet widget’ınızı oluşturduğunuzda, yalnızca bir kez düz metin olarak gösterilen özel bir jeton oluşturulur. Kesinlikle genel widget uç noktalarıyla (sohbet mesajları, değerlendirme, sesli giriş/çıkış) sınırlıdır ve gösterge paneli veya yönetici işlevlerine erişim sağlamaz. Çağıran alan adı ayrıca bir onay listesine göre kontrol edilir.
Beklenen sonuç
Kullanım durumunuz için iki gerçek mekanizmadan (kendi girişiniz ile widget gömme) hangisinin ilgili olduğunu anlarsınız.
Yaygın hata durumları
Zentor App API’sine karşı kendi betiklerimi çalıştırmak için bir API anahtarı arıyorum.
Neden: Böyle bir geliştirici API anahtarı sistemi şu anda mevcut değildir.
Çözüm: Programatik erişim için tek yol, ardından jeton kullanımı gelen normal giriş uç noktasıdır — açıklanan sınırlamalarla (süre sonu, oturum bağlama). Kalıcı entegrasyonlar için Zentor ile iletişime geçin.
Bir betik çalıştırırken erişim jetonum süresi doluyor.
Neden: Erişim jetonu 12 saatle sınırlıdır ve yenileme uç noktası üzerinden yenilenmelidir.
Çözüm: Yenileme uç noktası üzerinden jeton yenilemeyi uygulayın veya gerektiğinde tekrar giriş yapın.
Widget jetonum yanlışlıkla gösterge paneli verilerini alabilir mi — bu bir güvenlik riski mi?
Neden: Hayır — widget jetonu teknik olarak kesinlikle genel widget uç noktalarıyla sınırlıdır ve bir oturum girişinin yerini tutmaz.
Çözüm: Herhangi bir işlem gerekmez; yine de widget jetonunu gizli tutun, çünkü alan adı kontrolüne ek olarak widget’ınıza erişim sağlar.