دستاویزات

کنٹینٹ گیٹ

ویجٹ پر آنے والے گمنام (غیر تصدیق شدہ) وزیٹرز کے لیے مخصوص موضوعات محدود کر دیں۔ تصدیق شدہ شناخت رکھنے والے صارفین کو پورا جواب ملتا ہے۔

جائزہ#

کنٹینٹ گیٹ سے آپ ایسے موضوعات طے کر سکتے ہیں جن پر بات صرف تصدیق شدہ صارفین سے ہو۔ جب کوئی گمنام وزیٹر محدود موضوع کے بارے میں پوچھے تو AI اصل جواب کے بجائے آپ کا لکھا ہوا پیغام دیتا ہے۔

یہ حساس معلومات کی حفاظت کے لیے کارآمد ہے، مثلاً:

  • قیمتوں کی تفصیل اور رعایت کا ڈھانچہ
  • Enterprise کی خصوصیات یا اندرونی روڈ میپ
  • API دستاویزات یا تکنیکی تفصیلات
  • شراکت داروں سے متعلق مخصوص معلومات

سیٹ اپ#

موضوعات کی گیٹنگ فی الحال ایجنٹ سیٹنگز کے API سے ترتیب دی جاتی ہے۔ اپنے ایجنٹ کو تین settings کلیدوں کے ساتھ اپ ڈیٹ کریں:

  • gated_enabled (boolean) — موضوعات کی گیٹنگ آن یا آف کرتا ہے
  • gated_topics (سٹرنگز کا array) — محدود کیے جانے والے موضوعات۔ مخصوص رہیں — مثلاً غلط مطابقتوں سے بچنے کے لیے صرف "pricing" کے بجائے "enterprise pricing tiers" لکھیں۔
  • gated_message (string) — وہ پیغام جو گمنام صارفین کو محدود موضوع کے بارے میں پوچھنے پر نظر آتا ہے۔ خالی ہو تو طے شدہ یہ ہے: "This information is available to registered users. Please sign in or contact us for details."
API کے ذریعے کنٹینٹ گیٹ کی ترتیبbash
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."
    }
  }'

کنٹینٹ گیٹ کو تصدیق شدہ اور گمنام وزیٹرز میں فرق کرنے کے لیے صارف کی شناخت بھی درکار ہے۔ ترتیب دینے کی ہدایات کے لیے صارف کی شناخت کی دستاویزات دیکھیں۔

اسے ویجٹ چینل کے Appearance ٹیب والے Content gate ٹوگل سے خلط ملط نہ کریں — وہ ایک الگ خصوصیت ہے: وہ چیٹ شروع کرنے سے پہلے وزیٹرز سے ای میل مانگتا ہے (لیڈ کیپچر) اور موضوعات کو محدود نہیں کرتا۔

یہ کیسے کام کرتا ہے#

جب ویجٹ سے کوئی پیغام آتا ہے تو سسٹم جانچتا ہے کہ صارف کی شناخت تصدیق شدہ ہے یا نہیں:

صارف کی قسمشناخت کے خانےمحدود موضوعات
تصدیق شدہuserId یا email موجود (جب identity_secret مقرر ہو تو HMAC سے تصدیق شدہ)پورے جواب — کوئی پابندی نہیں
گمنامصرف visitorId، یا شناخت بالکل نہیںمحدود موضوع کا جوابی پیغام دیکھتا ہے
HMAC ناکامuserId موجود مگر userHash غلطگمنام شمار ہوتا ہے — محدود موضوع کا جواب دیکھتا ہے
identity_secret مقرر نہ ہو تو identify() کو دیا گیا کوئی بھی userId/email بغیر جانچ کے تصدیق شدہ شمار ہوتا ہے — وزیٹر براؤزر کنسول سے خود کو شناخت کر کے محدود موضوعات کھول سکتا ہے۔ تصدیق کو قابلِ جانچ بنانے کے لیے identity_secret مقرر کریں اور userHash بھیجیں؛ دیکھیں شناخت کی تصدیق (HMAC)۔ اوپر والی "HMAC ناکام" قطار صرف اُس وقت لاگو ہوتی ہے جب identity_secret مقرر ہو۔
کنٹینٹ گیٹ، AI کو دی جانے والی ہدایات کی سطح پر کام کرتا ہے۔ جب کوئی گمنام صارف محدود موضوع کے بارے میں پوچھے تو AI کو ہدایت ملتی ہے کہ آپ کا لکھا ہوا پیغام دے۔ باقی موضوعات کے جواب سب کو معمول کے مطابق ملتے ہیں۔
کنٹینٹ گیٹ حتی الوسع کوشش ہے، خفیہ نگاری پر مبنی رسائی کا نظام نہیں۔ کبھی کبھار غیر معمولی سوالوں پر AI ادھورا جواب دے سکتا ہے۔ سخت ڈیٹا سیکیورٹی کے لیے حساس مواد کو بالکل الگ ایجنٹ میں رکھنے پر غور کریں۔

شناخت کی شرط#

کنٹینٹ گیٹ کے کام کرنے کے لیے ویجٹ شروع کرتے وقت صارف کی شناخت بھیجنا ضروری ہے۔ یہ سب سے سادہ مثال ہے:

شناخت کے ساتھ ویجٹ کی ابتداhtml
<!-- For authenticated users -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Required if identity_secret is set
  });
</script>

<!-- For anonymous visitors — just init without identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // No identify() call — user is anonymous, gated topics will be restricted
</script>

HMAC کی تصدیق ترتیب دینے کے لیے دیکھیں شناخت کی تصدیق (HMAC)۔

کنٹینٹ گیٹ بمقابلہ Topics to Avoid

Topics to Avoid موضوعات کو تمام صارفین کے لیے روکتا ہے — تصدیق شدہ اور گمنام، دونوں۔ اسے اُن موضوعات کے لیے استعمال کریں جن پر ایجنٹ کو کبھی بات نہیں کرنی چاہیے (مثلاً حریفوں سے موازنہ، قانونی مشورہ)۔

Content Gate موضوعات صرف گمنام صارفین کے لیے روکتا ہے۔ تصدیق شدہ صارفین کو پورا جواب ملتا ہے۔ اسے اُن معلومات کے لیے استعمال کریں جو آپ گاہکوں کو تو دینا چاہتے ہیں مگر عام لوگوں کو نہیں (مثلاً قیمتیں، اندرونی خصوصیات)۔