Tài liệu

Cổng nội dung

Hạn chế các chủ đề cụ thể đối với khách truy cập widget ẩn danh (chưa xác thực). Người dùng đã xác thực với danh tính đã được kiểm chứng sẽ thấy câu trả lời đầy đủ.

Tổng quan#

Cổng nội dung cho phép bạn định nghĩa các chủ đề chỉ nên được thảo luận với người dùng đã xác thực. Khi khách ẩn danh hỏi về một chủ đề bị chặn, AI phản hồi bằng một thông báo tùy chỉnh thay vì câu trả lời thực tế.

Điều này hữu ích để bảo vệ thông tin nhạy cảm như:

  • Chi tiết định giá và cơ cấu chiết khấu
  • Tính năng doanh nghiệp hoặc lộ trình nội bộ
  • Tài liệu API hoặc thông số kỹ thuật
  • Thông tin dành riêng cho đối tác

Thiết lập#

Việc chặn chủ đề hiện được cấu hình qua API cài đặt agent. Cập nhật agent của bạn với ba khóa cài đặt:

  • gated_enabled (boolean) — bật hoặc tắt chặn chủ đề
  • gated_topics (mảng chuỗi) — các chủ đề cần hạn chế. Hãy cụ thể — ví dụ, dùng "enterprise pricing tiers" thay vì chỉ "pricing" để tránh nhận diện sai.
  • gated_message (chuỗi) — thông báo người dùng ẩn danh thấy khi hỏi về một chủ đề bị chặn. Khi để trống, mặc định là: "This information is available to registered users. Please sign in or contact us for details."
Cấu hình Cổng nội dung qua 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."
    }
  }'

Cổng nội dung cũng yêu cầu nhận diện người dùng để phân biệt khách đã xác thực với khách ẩn danh. Xem tài liệu Nhận diện người dùng để biết hướng dẫn thiết lập.

Đừng nhầm lẫn tính năng này với công tắc Content gate trên tab Giao diện của kênh widget — đó là một tính năng khác: nó yêu cầu khách truy cập cung cấp email trước khi có thể chat (thu thập khách hàng tiềm năng) và không chặn chủ đề.

Cách hoạt động#

Khi một tin nhắn đến từ widget, hệ thống kiểm tra xem người dùng có danh tính đã được kiểm chứng hay không:

Loại người dùngTrường danh tínhChủ đề bị chặn
Đã xác thựcCó userId hoặc email (được xác minh HMAC khi identity_secret được cấu hình)Câu trả lời đầy đủ — không hạn chế
Ẩn danhChỉ có visitorId, hoặc không có danh tính nàoThấy thông báo phản hồi chặn
HMAC thất bạiCó userId nhưng userHash không hợp lệĐược coi là ẩn danh — thấy phản hồi chặn
Khi không cấu hình identity_secret, bất kỳ userId/email nào được truyền vào identify() đều được tính là đã xác thực mà không cần kiểm chứng — một khách truy cập có thể tự nhận danh tính từ console trình duyệt và mở khóa các chủ đề bị chặn. Hãy đặt identity_secret và truyền userHash để việc xác thực có thể kiểm chứng được; xem Xác minh danh tính (HMAC). Hàng "HMAC thất bại" ở trên chỉ áp dụng khi identity_secret đã được đặt.
Cổng nội dung hoạt động ở mức chỉ dẫn AI. Khi người dùng ẩn danh hỏi về một chủ đề bị chặn, AI được chỉ dẫn phản hồi bằng thông báo tùy chỉnh của bạn. Các chủ đề không bị chặn được trả lời bình thường cho tất cả mọi người.
Cổng nội dung là nỗ lực tốt nhất, không phải là kiểm soát truy cập bằng mã hóa. AI đôi khi có thể cung cấp câu trả lời một phần cho các câu hỏi biên. Để bảo mật dữ liệu nghiêm ngặt, hãy cân nhắc tách nội dung nhạy cảm sang một agent hoàn toàn khác.

Yêu cầu về danh tính#

Để Cổng nội dung hoạt động, bạn cần truyền danh tính người dùng khi khởi tạo widget. Dưới đây là một ví dụ tối giản:

Khởi tạo widget với danh tínhhtml
<!-- Cho người dùng đã xác thực -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Bắt buộc nếu identity_secret được đặt
  });
</script>

<!-- Cho khách ẩn danh — chỉ init mà không identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Không gọi identify() — người dùng ẩn danh, các chủ đề bị chặn sẽ bị hạn chế
</script>

Để thiết lập xác minh HMAC, xem Xác minh danh tính (HMAC).

Cổng nội dung so với Chủ đề cần tránh

Chủ đề cần tránh chặn các chủ đề cho tất cả người dùng — cả đã xác thực và ẩn danh. Dùng nó cho những chủ đề agent không bao giờ nên thảo luận (ví dụ, so sánh với đối thủ, tư vấn pháp lý).

Cổng nội dung chỉ chặn các chủ đề cho người dùng ẩn danh. Người dùng đã xác thực thấy câu trả lời đầy đủ. Dùng nó cho thông tin bạn muốn chia sẻ với khách hàng nhưng không phải với công chúng (ví dụ, định giá, tính năng nội bộ).