Content gate

Content Gate ti permette di definire argomenti che dovrebbero essere discussi solo con utenti autenticati. Quando un visitatore anonimo chiede di un argomento riservato, l’IA risponde con un messaggio personalizzato invece della risposta effettiva.

Questo è utile per proteggere informazioni sensibili come:

• Dettagli sui prezzi e strutture di sconto
• Funzionalità enterprise o roadmap interna
• Documentazione API o specifiche tecniche
• Informazioni specifiche per i partner

Il gating degli argomenti si configura attualmente tramite l’API delle impostazioni dell’agente. Aggiorna il tuo agente con tre chiavi di impostazione:

• gated_enabled (boolean) — attiva o disattiva il gating degli argomenti
• gated_topics (array di stringhe) — gli argomenti da limitare. Sii specifico — per esempio, usa "enterprise pricing tiers" invece del semplice "pricing" per evitare falsi positivi.
• gated_message (string) — il messaggio che gli utenti anonimi vedono quando chiedono di un argomento riservato. Se vuoto, il default è: "This information is available to registered users. Please sign in or contact us for details."

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

Content Gate richiede inoltre l’identificazione utente per distinguere i visitatori autenticati da quelli anonimi. Consulta la documentazione Identificazione utente per le istruzioni di configurazione.

Quando arriva un messaggio dal widget, il sistema verifica se l’utente ha un’identità verificata:

Perché Content Gate funzioni, devi trasmettere l’identità dell’utente durante l’inizializzazione del widget. Ecco un esempio minimo:

<!-- Per utenti autenticati -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Richiesto se identity_secret è impostato
  });
</script>

<!-- Per visitatori anonimi — basta init senza identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Nessuna chiamata identify() — l'utente è anonimo, gli argomenti riservati saranno limitati
</script>

Per la configurazione della verifica HMAC, consulta Verifica dell’identità (HMAC).