Barreira de conteúdo

A Barreira de conteúdo permite que você defina tópicos que só devem ser discutidos com usuários autenticados. Quando um visitante anônimo pergunta sobre um tópico com barreira, a IA responde com uma mensagem personalizada em vez da resposta real.

Isso é útil para proteger informações sensíveis, como:

• Detalhes de preços e estruturas de descontos
• Funcionalidades empresariais ou roadmap interno
• Documentação da API ou especificações técnicas
• Informação específica de parceiros

Atualmente, a barreira de tópicos é configurada através da API de configurações do agente. Atualize o seu agente com três chaves de configuração:

• gated_enabled (boolean) — liga ou desliga a barreira de tópicos
• gated_topics (array de strings) — os tópicos a restringir. Seja específico — por exemplo, use "escalões de preços empresariais" em vez de apenas "preços" para evitar falsos positivos.
• gated_message (string) — a mensagem que os usuários anônimos veem ao perguntar sobre um tópico com barreira. Quando vazia, o padrão é: "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."
    }
  }'

A Barreira de conteúdo também requer identificação do usuário para distinguir visitantes autenticados de anônimos. Consulte a documentação de Identificação do usuário para instruções de configuração.

Quando uma mensagem chega do widget, o sistema verifica se o usuário tem uma identidade verificada:

Para que a Barreira de conteúdo funcione, você precisa passar a identidade do usuário ao inicializar o widget. Aqui está um exemplo mínimo:

<!-- Para usuários autenticados -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Obrigatório se identity_secret estiver definido
  });
</script>

<!-- Para visitantes anônimos — basta inicializar sem identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Sem chamada a identify() — o usuário é anônimo, os tópicos com barreira serão restringidos
</script>

Para a configuração da verificação HMAC, consulte Verificação de identidade (HMAC).