Content Gate

Met Content Gate kun je onderwerpen definiëren die alleen met geauthenticeerde gebruikers mogen worden besproken. Wanneer een anonieme bezoeker naar een afgeschermd onderwerp vraagt, reageert de AI met een aangepast bericht in plaats van het eigenlijke antwoord.

Dit is handig om gevoelige informatie te beschermen, zoals:

• Prijsdetails en kortingsstructuren
• Enterprise-functies of interne roadmap
• API-documentatie of technische specificaties
• Partnerspecifieke informatie

Onderwerpafscherming wordt momenteel geconfigureerd via de agentinstellingen-API. Werk je agent bij met drie instellingssleutels:

• gated_enabled (boolean) — zet onderwerpafscherming aan of uit
• gated_topics (array van strings) — de te beperken onderwerpen. Wees specifiek — gebruik bijvoorbeeld "enterprise-prijsniveaus" in plaats van alleen "prijzen" om valse positieven te vermijden.
• gated_message (string) — het bericht dat anonieme gebruikers zien wanneer ze naar een afgeschermd onderwerp vragen. Indien leeg is de standaardwaarde: "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 vereist daarnaast gebruikersidentificatie om geauthenticeerde van anonieme bezoekers te onderscheiden. Zie de documentatie over Gebruikersidentificatie voor installatie-instructies.

Wanneer een bericht vanuit de widget binnenkomt, controleert het systeem of de gebruiker een geverifieerde identiteit heeft:

Om Content Gate te laten werken, moet je gebruikersidentiteit doorgeven bij het initialiseren van de widget. Hier is een minimaal voorbeeld:

<!-- Voor geauthenticeerde gebruikers -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Vereist als identity_secret is ingesteld
  });
</script>

<!-- Voor anonieme bezoekers — alleen init zonder identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Geen identify()-aanroep — gebruiker is anoniem, afgeschermde onderwerpen worden beperkt
</script>

Voor het instellen van HMAC-verificatie, zie Identiteitsverificatie (HMAC).