（以下內容均翻譯自英文版文件，最新資訊及內容敬請切換至英文語系參考原文）

為了維護聊天室的安全和尊重他人的環境，BlendVision 提供了關鍵字篩選器功能。該功能會自動隱藏包含不適當的單字或短句的訊息。作為直播的管理者，您可以自定義關鍵字篩選器，以對應特定的活動和客群。

關鍵字過濾器是通過使用字典和字組實現的。聊天室可以定義並啟用多個字典，每個字典包含多個字組。字組是過濾文字的規則。目前，我們只支援不區分大小寫的精確比對模式。如果使用者發送的訊息裡含有跟已定義的字組完全一致的文字，就會被過濾。

取得一個訪問令牌

在使用 API 管理字典和字組之前，您需要取得訪問令牌：

POST /bv/chatroom/v1/chatrooms/{id}/tokens

有關訪問令牌的更多資訊，請參照 為聊天室建立訪問令牌 。

建立一個字典

要建立字典，請向以下 API 發送 POST 請求：

POST /bv/chatroom/v1/dictionaries

該請求的主體裡應包含以下參數：

• name: 要建立的字典的名稱。
• description: (可選）要建立的字典的描述。

管理字典

您可以使用以下 API 管理字典：

• 取得字典： GET /bv/chatroom/v1/dictionaries/{id}
• 刪除字典： DELETE /bv/chatroom/v1/dictionaries/{id}
• 更新字典： PUT /bv/chatroom/v1/dictionaries/{id}
• 字典列表： GET /bv/chatroom/v1/dictionaries

請將 {id} 替換為您的字典 ID。

建立一個字組

建立字典後，您可以使用以下 API 在字典中建立字組：

POST /bv/chatroom/v1/dictionaries/{id}/patterns

該請求的主體裡應包含以下參數：

• text: 要建立的字組的文字。

管理字組

您可以使用以下 API 管理字組：

• 刪除字組： DELETE /bv/chatroom/v1/patterns/{id}
• 更新字組： PUT /bv/chatroom/v1/patterns/{id}
• 字組列表： GET /bv/chatroom/v1/dictionaries/{id}/patterns

請將 {id} 替換為您的字組 ID。

控制字典

除了為聊天室中的關鍵字過濾器建立和管理字典與字組之外，BlendVision 還允許您啟用或禁用特定字典。這樣，您就可以根據特定活動的需要，更好的控制關鍵字過濾器。

要啟用/禁用聊天室中的特定字典，請向以下 API 發送 POST 請求：

• POST /bv/chatroom/v1/chatrooms/dictionaries/{id}:enable
• POST /bv/chatroom/v1/chatrooms/dictionaries/{id}:disable

請將 {id} 替換為您希望要啟用/禁用的字典 ID。