From e243f56fb99e9f36f5d7d43331fe3367a2846c6d Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 16 Oct 2026 04:01:19 +0000 Subject: [PATCH] docs(console): explain why pairing approval can be unavailable Describe the Pairing inbox states where Approve stays off, what the operator should fix for each, and that approval rechecks the channel. Refs nextlevelbuilder/dewee#1433 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01BYfQbHRQu7VC6uwM2JiTKr --- src/content/docs/en/console/channels-and-contacts.md | 9 +++++++++ src/content/docs/vi/console/channels-and-contacts.md | 9 +++++++++ 2 files changed, 18 insertions(+) diff --git a/src/content/docs/en/console/channels-and-contacts.md b/src/content/docs/en/console/channels-and-contacts.md index eeb324a..b733535 100644 --- a/src/content/docs/en/console/channels-and-contacts.md +++ b/src/content/docs/en/console/channels-and-contacts.md @@ -65,6 +65,15 @@ With pairing on, an unknown sender who messages the agent directly gets a short 2. Select **Approve** to let the sender talk to the agent, or **Deny** to refuse. 3. To cut off someone later, find them under **Connected senders** and select **Revoke**, then **Revoke access**. They must request pairing again before the agent replies to them directly. +**Approve** stays turned off when the request cannot be approved here, and hovering it tells you why: + +- The request's channel no longer exists in this workspace, was renamed, or is turned off. Fix the channel, then ask the sender to message again for a new code. +- The channel's agent was removed, so approved messages would have nowhere to go. Assign an agent to the channel first. +- The code has expired. The sender needs a new one. +- The request comes from a browser session. Only the gateway operator can approve those. + +Approval checks the channel again at the moment you select **Approve**, so a request that changed in the meantime is refused and stays in the list. You can still **Deny** any request. + The **Pairing policy** sets how long a new approval lasts. Under **Scope**, choose **Workspace** for the whole workspace or **Per channel** for one channel. The card shows the policy in effect and where it comes from. - Set **Expiry** in days, or turn on **Never expire**, then select **Save policy**. diff --git a/src/content/docs/vi/console/channels-and-contacts.md b/src/content/docs/vi/console/channels-and-contacts.md index b418294..a9f739e 100644 --- a/src/content/docs/vi/console/channels-and-contacts.md +++ b/src/content/docs/vi/console/channels-and-contacts.md @@ -65,6 +65,15 @@ Khi bật ghép nối, một người gửi lạ nhắn trực tiếp cho agent 2. Chọn **Phê duyệt** để cho người gửi trò chuyện với agent, hoặc **Từ chối** để từ chối. 3. Muốn ngắt kết nối một người sau này, tìm họ trong **Người gửi đã kết nối**, chọn **Thu hồi**, rồi **Thu hồi quyền truy cập**. Họ phải yêu cầu ghép nối lại trước khi agent trả lời trực tiếp. +Nút **Phê duyệt** bị tắt khi yêu cầu không thể phê duyệt tại đây, và khi rê chuột lên nút bạn sẽ thấy lý do: + +- Kênh của yêu cầu không còn tồn tại trong workspace, đã bị đổi tên hoặc đang tắt. Hãy sửa kênh, rồi nhờ người gửi nhắn lại để nhận mã mới. +- Agent của kênh đã bị xoá, nên tin nhắn được phê duyệt sẽ không có nơi nhận. Hãy gán agent cho kênh trước. +- Mã đã hết hạn. Người gửi cần một mã mới. +- Yêu cầu đến từ một phiên trình duyệt. Chỉ người vận hành gateway mới phê duyệt được loại này. + +Lúc bạn chọn **Phê duyệt**, hệ thống kiểm tra lại kênh một lần nữa, nên yêu cầu nào đã thay đổi trong lúc đó sẽ bị từ chối và vẫn nằm trong danh sách. Bạn vẫn luôn có thể **Từ chối** mọi yêu cầu. + **Chính sách ghép nối** quyết định một lượt phê duyệt mới có hiệu lực bao lâu. Trong **Phạm vi**, chọn **Workspace** cho cả workspace hoặc **Theo kênh** cho một kênh. Thẻ chính sách cho biết chính sách đang áp dụng và nguồn của nó. - Đặt **Thời hạn** theo số ngày, hoặc bật **Không hết hạn**, rồi chọn **Lưu chính sách**.