İçerik Kapısı

Belirli konuları anonim (kimliği doğrulanmamış) widget ziyaretçilerinden kısıtlayın. Kimliği doğrulanmış, doğrulanmış kimliğe sahip kullanıcılar tam yanıtları görür.

Genel Bakış#

İçerik Kapısı, yalnızca kimliği doğrulanmış kullanıcılarla tartışılması gereken konuları tanımlamanıza olanak tanır. Anonim bir ziyaretçi kapılı bir konu hakkında soru sorduğunda, yapay zeka gerçek yanıt yerine özel bir mesajla karşılık verir.

Bu, aşağıdaki gibi hassas bilgileri korumak için kullanışlıdır:

Fiyatlandırma ayrıntıları ve indirim yapıları
Enterprise özellikleri veya dahili yol haritası
API dokümantasyonu veya teknik özellikler
Ortağa özel bilgiler

Kurulum#

Konu kapılama şu anda ajan ayarları API’si üzerinden yapılandırılır. Ajanınızı üç ayar anahtarıyla güncelleyin:

gated_enabled (boolean) — konu kapılamayı açar veya kapatır
gated_topics (dize dizisi) — kısıtlanacak konular. Belirgin olun — örneğin, yanlış pozitiflerden kaçınmak için yalnızca "fiyatlandırma" yerine "enterprise fiyatlandırma kademeleri" kullanın.
gated_message (dize) — anonim kullanıcıların kapılı bir konu hakkında soru sorduğunda gördüğü mesaj. Boş bırakılırsa varsayılanı şudur: "This information is available to registered users. Please sign in or contact us for details."

İçerik Kapısı’nı API üzerinden yapılandırmabash

curl -X PATCH https://api.respondo.ai/api/v1/agents/<agent-uuid> \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "gated_enabled": true,
      "gated_topics": ["enterprise pricing tiers", "internal roadmap"],
      "gated_message": "This information is available to registered users. Please sign in or contact our sales team for details."
    }
  }'

İçerik Kapısı ayrıca kimliği doğrulanmış ziyaretçileri anonim olanlardan ayırt etmek için kullanıcı kimliği gerektirir. Kurulum talimatları için Kullanıcı Kimliği dokümanına bakın.

Bunu, widget kanalının Görünüm (Appearance) sekmesindeki Content gate anahtarıyla karıştırmayın — o farklı bir özelliktir: sohbetten önce ziyaretçilerden e-posta ister (potansiyel müşteri toplama) ve konuları kapılamaz.

Nasıl Çalışır#

Widget’tan bir mesaj geldiğinde, sistem kullanıcının doğrulanmış bir kimliği olup olmadığını kontrol eder:

Kullanıcı Türü	Kimlik Alanları	Kapılı Konular
Kimliği doğrulanmış	`userId` veya `email` içerir (`identity_secret` yapılandırıldığında HMAC ile doğrulanır)	Tam yanıtlar — kısıtlama yok
Anonim	Yalnızca `visitorId` veya hiç kimlik yok	Kapılı yanıt mesajını görür
Başarısız HMAC	`userId` içerir ancak geçersiz `userHash`	Anonim olarak ele alınır — kapılı yanıtı görür

identity_secret yapılandırılmadan, identify()’a geçirilen herhangi bir userId/e-posta doğrulama olmaksızın kimliği doğrulanmış sayılır — bir ziyaretçi tarayıcı konsolundan kendini tanımlayıp kapılı konuların kilidini açabilir. Kimliği doğrulanabilir kılmak için identity_secret ayarlayın ve userHash geçirin; bkz. Kimlik Doğrulama (HMAC). Yukarıdaki "Başarısız HMAC" satırı yalnızca identity_secret ayarlıyken geçerlidir.

İçerik Kapısı yapay zeka talimat düzeyinde çalışır. Anonim bir kullanıcı kapılı bir konu hakkında soru sorduğunda, yapay zekaya özel mesajınızla yanıt vermesi talimatı verilir. Kapılı olmayan konular herkes için normal şekilde yanıtlanır.

İçerik Kapısı bir kriptografik erişim denetimi değil, en iyi çaba ilkesine dayalıdır. Yapay zeka, sınır durumdaki sorulara zaman zaman kısmi yanıtlar verebilir. Katı veri güvenliği için, hassas içeriği tamamen ayrı bir ajana ayırmayı düşünün.

Kimlik Gereksinimi#

İçerik Kapısı’nın çalışması için, widget’ı başlatırken kullanıcı kimliğini iletmeniz gerekir. İşte minimal bir örnek:

Kimlikle widget başlatmahtml

<!-- Kimliği doğrulanmış kullanıcılar için -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // identity_secret ayarlıysa gereklidir
  });
</script>

<!-- Anonim ziyaretçiler için — identify olmadan sadece init -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // identify() çağrısı yok — kullanıcı anonimdir, kapılı konular kısıtlanır
</script>

HMAC doğrulama kurulumu için bkz. Kimlik Doğrulama (HMAC).

İçerik Kapısı ve Kaçınılacak Konular

Kaçınılacak Konular konuları tüm kullanıcılar için engeller — hem kimliği doğrulanmış hem de anonim. Bunu, ajanın asla tartışmaması gereken konular için kullanın (ör. rakip karşılaştırmaları, hukuki tavsiye).

İçerik Kapısı konuları yalnızca anonim kullanıcılar için engeller. Kimliği doğrulanmış kullanıcılar tam yanıtları görür. Bunu, müşterilerle paylaşmak isteyip kamuoyuyla paylaşmak istemediğiniz bilgiler için kullanın (ör. fiyatlandırma, dahili özellikler).