单聊用户白名单概述

单聊用户白名单服务可以限制用户之间发送单聊消息。单聊用户白名单服务一般用于满足强好友关系的业务需求，即只允许白名单中的用户向当前用户发送消息。两个用户要在单聊会话中互发消息，必须在各自的用户白名单中。

单聊用户白名单服务开启成功后，可使用以下接口：

• 添加用户到白名单
• 移除白名单中用户
• 获取用户白名单列表

单聊用户白名单服务要点：

• 单聊用户白名单人数存在上限。详见 IM 尊享版、IM 旗舰版功能对照表。
• 单聊用户白名单服务与用户黑名单服务不能同时使用。默认情况下，App Key 下所有用户仅开启用户黑名单服务。如果需要使用开启单聊用户白名单服务，方式如下：
  • 为指定单个或多个用户开启单聊用户白名单服务。您可以直接调用 API 进行设置，详见开启用户白名单。如果为指定用户开启白名单服务，该用户的黑名单服务失效。
  • 在融云控制台，通过应用配置>IM 服务>免费基础功能>单群聊>单聊用户白名单，为 App Key 下所有用户均启用单聊用户白名单。注意：如果为 App Key 全部用户开启白名单服务，所有用户的黑名单服务失效。
• 在即时通讯服务端建立单聊用户白名单关系的同时，需要应用的后端服务中维护一份单聊用户白名单关系，以方便自己对业务数据的处理。