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."
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.
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ùng | Trường danh tính | Chủ đề bị chặn |
|---|---|---|
| Đã xác thực | Có 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 danh | Chỉ có visitorId, hoặc không có danh tính nào | Thấy thông báo phản hồi chặn |
| HMAC thất bại | Có userId nhưng userHash không hợp lệ | Được coi là ẩn danh — thấy phản hồi chặn |
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.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:
<!-- 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ộ).