Dokumentasyon

Harang sa Nilalaman

Limitahan ang ilang paksa para sa mga anonymous (hindi naka-authenticate) na bisita ng widget. Nakikita ng mga naka-authenticate na user na may napatunayang pagkakakilanlan ang buong sagot.

Pangkalahatang-ideya#

Sa Harang sa Nilalaman, puwede ninyong itakda ang mga paksang dapat lang talakayin kasama ang mga naka-authenticate na user. Kapag nagtanong ang anonymous na bisita tungkol sa naka-gate na paksa, sumasagot ang AI ng custom na mensahe sa halip na ang tunay na sagot.

Kapaki-pakinabang ito sa pagprotekta ng sensitibong impormasyon tulad ng:

  • Detalye ng presyo at istruktura ng diskuwento
  • Mga tampok na Enterprise o panloob na roadmap
  • Dokumentasyon ng API o teknikal na espesipikasyon
  • Impormasyong para lang sa mga partner

Pag-setup#

Kasalukuyang isinasaayos ang paghaharang ng paksa sa pamamagitan ng agent settings API. I-update ang ahente ninyo gamit ang tatlong settings key:

  • gated_enabled (boolean) — ino-on o ino-off ang paghaharang ng paksa
  • gated_topics (array ng string) — ang mga paksang lilimitahan. Maging tiyak — halimbawa, gamitin ang "enterprise pricing tiers" sa halip na "pricing" lang para maiwasan ang maling pagtukoy.
  • gated_message (string) — ang mensaheng nakikita ng mga anonymous na user kapag nagtanong tungkol sa naka-gate na paksa. Kapag walang laman, ito ang default: "This information is available to registered users. Please sign in or contact us for details."
I-configure ang Harang sa Nilalaman sa pamamagitan ng 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."
    }
  }'

Kailangan din ng Harang sa Nilalaman ang pagkilala sa user para maibukod ang mga naka-authenticate sa mga anonymous na bisita. Tingnan ang dokumentasyon ng Pagkilala sa user para sa mga tagubilin sa pag-set up.

Huwag itong ipagkamali sa toggle na Content gate sa tab na Appearance ng widget channel — ibang tampok iyon: humihingi ito ng email sa mga bisita bago sila makapag-chat (lead capture) at hindi ito naghaharang ng mga paksa.

Paano Ito Gumagana#

Kapag dumating ang mensahe mula sa widget, tinitingnan ng sistema kung may napatunayang pagkakakilanlan ang user:

Uri ng userMga field ng pagkakakilanlanMga naka-gate na paksa
Naka-authenticateMay userId o email (napapatunayan sa HMAC kapag nakatakda ang identity_secret)Buong sagot — walang limitasyon
AnonymousvisitorId lang, o wala talagang pagkakakilanlanNakikita ang mensahe para sa naka-gate na paksa
Bigong HMACMay userId pero maling userHashItinuturing na anonymous — nakikita ang sagot para sa naka-gate na paksa
Kapag hindi nakatakda ang identity_secret, anumang userId/email na ipinasa sa identify() ay binibilang na naka-authenticate nang walang pagpapatunay — puwedeng magpakilala ang bisita mula sa console ng browser at mabuksan ang mga naka-gate na paksa. Itakda ang identity_secret at ipasa ang userHash para maging mapapatunayan ang authentication; tingnan ang Pagpapatunay ng Identity (HMAC). Ang hilerang "Bigong HMAC" sa itaas ay nalalapat lang kapag nakatakda ang identity_secret.
Gumagana ang Harang sa Nilalaman sa antas ng tagubilin sa AI. Kapag nagtanong ang anonymous na user tungkol sa naka-gate na paksa, inuutusan ang AI na sumagot gamit ang custom na mensahe ninyo. Karaniwang nasasagot para sa lahat ang mga paksang hindi naka-gate.
Pinakamahusay na pagsisikap ang Harang sa Nilalaman, hindi kriptograpikong kontrol sa akses. Puwedeng minsan magbigay ang AI ng bahagyang sagot sa mga pambihirang tanong. Para sa mahigpit na seguridad ng datos, isaalang-alang ang paghihiwalay ng sensitibong nilalaman sa ibang ahente.

Kinakailangang Identity#

Para gumana ang Harang sa Nilalaman, kailangan ninyong ipasa ang pagkakakilanlan ng user kapag ini-initialize ang widget. Narito ang pinakasimpleng halimbawa:

Pag-initialize ng widget kasama ang pagkakakilanlanhtml
<!-- Para sa mga naka-authenticate na user -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Kailangan kung nakatakda ang identity_secret
  });
</script>

<!-- Para sa mga anonymous na bisita — init lang, walang identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Walang tawag na identify() — anonymous ang user, malilimitahan ang mga naka-gate na paksa
</script>

Para sa pag-set up ng pagpapatunay gamit ang HMAC, tingnan ang Pagpapatunay ng pagkakakilanlan (HMAC).

Harang sa Nilalaman kumpara sa Mga Ipinagbabawal na Paksa

Hinaharangan ng Mga Ipinagbabawal na Paksa ang mga paksa para sa lahat ng user — naka-authenticate man o anonymous. Gamitin ito para sa mga paksang hindi dapat kailanman pag-usapan ng ahente (halimbawa, paghahambing sa kakumpitensya, payong legal).

Hinaharangan ng Harang sa Nilalaman ang mga paksa para lang sa mga anonymous na user. Nakikita ng mga naka-authenticate na user ang buong sagot. Gamitin ito para sa impormasyong gusto ninyong ibahagi sa mga customer pero hindi sa publiko (halimbawa, presyo, panloob na tampok).