دروازهٔ محتوا

دروازهٔ محتوا به شما امکان می‌دهد موضوع‌هایی را تعریف کنید که فقط باید با کاربران احراز هویت‌شده دربارهٔ آن‌ها گفت‌وگو شود. وقتی بازدیدکننده‌ای ناشناس دربارهٔ یک موضوع محدودشده می‌پرسد، هوش مصنوعی به‌جای پاسخ واقعی، پیامی سفارشی می‌دهد.

این کار برای محافظت از اطلاعات حساس به کار می‌آید، مانند:

• جزئیات قیمت‌گذاری و ساختار تخفیف‌ها
• قابلیت‌های سازمانی یا نقشهٔ راه داخلی
• مستندات API یا مشخصات فنی
• اطلاعات ویژهٔ شرکا

گیت موضوعی فعلاً از راه API تنظیمات عامل پیکربندی می‌شود. عاملتان را با سه کلید تنظیمات به‌روز کنید:

• gated_enabled (boolean) — گیت موضوعی را روشن یا خاموش می‌کند
• gated_topics (آرایه‌ای از رشته‌ها) — موضوع‌هایی که باید محدود شوند. دقیق باشید — برای نمونه به‌جای «قیمت‌گذاری» بنویسید «سطح‌های قیمت‌گذاری سازمانی» تا هشدارهای نادرست پیش نیاید.
• gated_message (رشته) — پیامی که کاربران ناشناس هنگام پرسیدن دربارهٔ یک موضوع محدودشده می‌بینند. اگر خالی باشد، پیش‌فرض این است: "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."
    }
  }'

دروازهٔ محتوا همچنین برای تشخیص بازدیدکنندگان احراز هویت‌شده از ناشناس به شناسایی کاربر نیاز دارد. دستورالعمل راه‌اندازی در مستندات شناسایی کاربر آمده است.

وقتی پیامی از ویجت می‌رسد، سامانه بررسی می‌کند که آیا کاربر هویت راستی‌آزمایی‌شده دارد یا نه:

برای اینکه دروازهٔ محتوا کار کند، باید هنگام مقداردهی اولیهٔ ویجت هویت کاربر را بفرستید. نمونه‌ای کمینه:

<!-- برای کاربران احراز هویت‌شده -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // اگر identity_secret تنظیم شده باشد، الزامی است
  });
</script>

<!-- برای بازدیدکنندگان ناشناس — فقط init بدون identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // فراخوانی identify() نیست — کاربر ناشناس است و موضوع‌های محدودشده بسته می‌مانند
</script>

برای راه‌اندازی راستی‌آزمایی HMAC، به راستی‌آزمایی هویت (HMAC) نگاه کنید.