Bramka treści

Ograniczaj określone tematy dla anonimowych (nieuwierzytelnionych) odwiedzających widget. Uwierzytelnieni użytkownicy o zweryfikowanej tożsamości widzą pełne odpowiedzi.

Przegląd#

Bramka treści pozwala zdefiniować tematy, które powinny być omawiane wyłącznie z uwierzytelnionymi użytkownikami. Gdy anonimowy odwiedzający zapyta o temat objęty bramką, AI odpowiada niestandardowym komunikatem zamiast rzeczywistej odpowiedzi.

Przydaje się to do ochrony wrażliwych informacji, takich jak:

Szczegóły cenowe i struktury rabatów
Funkcje dla przedsiębiorstw lub wewnętrzny plan rozwoju
Dokumentacja API lub specyfikacje techniczne
Informacje specyficzne dla partnerów

Konfiguracja#

Bramkowanie tematów konfiguruje się obecnie przez API ustawień agenta. Zaktualizuj swojego agenta trzema kluczami ustawień:

gated_enabled (boolean) — włącza lub wyłącza bramkowanie tematów
gated_topics (tablica ciągów znaków) — tematy do ograniczenia. Bądź konkretny — na przykład użyj "poziomy cenowe dla przedsiębiorstw" zamiast po prostu "ceny", aby uniknąć fałszywych trafień.
gated_message (string) — komunikat, który anonimowi użytkownicy widzą, pytając o temat objęty bramką. Gdy jest pusty, domyślnie brzmi: "This information is available to registered users. Please sign in or contact us for details."

Konfiguracja Bramki treści przez APIbash

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."
    }
  }'

Bramka treści wymaga też identyfikacji użytkownika, aby odróżnić uwierzytelnionych od anonimowych odwiedzających. Instrukcje konfiguracji znajdziesz w dokumentacji Identyfikacja użytkownika.

Nie myl tego z przełącznikiem Content gate na karcie Wygląd kanału widgetu — to inna funkcja: prosi odwiedzających o e-mail, zanim będą mogli czatować (pozyskiwanie leadów), i nie bramkuje tematów.

Jak to działa#

Gdy z widgetu nadejdzie wiadomość, system sprawdza, czy użytkownik ma zweryfikowaną tożsamość:

Typ użytkownika	Pola tożsamości	Tematy objęte bramką
Uwierzytelniony	Ma `userId` lub `email` (weryfikowane HMAC, gdy skonfigurowano `identity_secret`)	Pełne odpowiedzi — bez ograniczeń
Anonimowy	Tylko `visitorId` lub brak tożsamości w ogóle	Widzi komunikat odpowiedzi bramki
Nieudany HMAC	Ma `userId`, ale nieprawidłowy `userHash`	Traktowany jako anonimowy — widzi odpowiedź bramki

Bez skonfigurowanego identity_secret dowolny userId/email przekazany do identify() liczy się jako uwierzytelniony bez weryfikacji — odwiedzający może zidentyfikować się samodzielnie z konsoli przeglądarki i odblokować tematy objęte bramką. Ustaw identity_secret i przekazuj userHash, aby uwierzytelnienie było weryfikowalne; zobacz Weryfikacja tożsamości (HMAC). Wiersz "Nieudany HMAC" powyżej dotyczy tylko sytuacji, gdy identity_secret jest ustawiony.

Bramka treści działa na poziomie instrukcji AI. Gdy anonimowy użytkownik zapyta o temat objęty bramką, AI otrzymuje instrukcję, aby odpowiedzieć Twoim niestandardowym komunikatem. Tematy nieobjęte bramką są dla wszystkich odpowiadane normalnie.

Bramka treści działa na zasadzie największej staranności, a nie kryptograficznej kontroli dostępu. AI może czasami udzielić częściowych odpowiedzi na pytania graniczne. Dla ścisłej ochrony danych rozważ całkowite wydzielenie wrażliwej treści do osobnego agenta.

Wymóg tożsamości#

Aby Bramka treści działała, musisz przekazać tożsamość użytkownika podczas inicjalizacji widgetu. Oto minimalny przykład:

Inicjalizacja widgetu z tożsamościąhtml

<!-- Dla uwierzytelnionych użytkowników -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Wymagane, jeśli ustawiono identity_secret
  });
</script>

<!-- Dla anonimowych odwiedzających — po prostu init bez identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Brak wywołania identify() — użytkownik jest anonimowy, tematy objęte bramką będą ograniczone
</script>

Konfigurację weryfikacji HMAC znajdziesz w Weryfikacja tożsamości (HMAC).

Bramka treści a Tematy do unikania

Tematy do unikania blokują tematy dla wszystkich użytkowników — zarówno uwierzytelnionych, jak i anonimowych. Używaj tego dla tematów, których agent nigdy nie powinien poruszać (np. porównania z konkurencją, porady prawne).

Bramka treści blokuje tematy wyłącznie dla anonimowychużytkowników. Uwierzytelnieni użytkownicy widzą pełne odpowiedzi. Używaj tego dla informacji, którymi chcesz dzielić się z klientami, ale nie z opinią publiczną (np. ceny, funkcje wewnętrzne).