即时通信 IM 功能配置

二、登录设置

1. 在登录与消息页面，单击登录设置右侧的编辑。

2. 在弹出的登录设置对话框中，选择多端登录类型，设置 Web 端以及其他平台实例同时在线数量。

注意：说明：

注意：旗舰版或企业版选择多平台登录时，Web 端可同时在线个数最多为10个；Android、iPhone、iPad、Windows、Mac、Linux 平台，每种平台可同时在线设备个数最多为3个。

3. 单击确定保存设置。

三、历史消息存储时长配置

历史消息默认存储7天，延长历史消息存储时长为增值服务，具体计费说明请参见 价格说明。每个自然月仅支持更改一次配置。

1. 在登录与消息页面，单击历史消息存储时长配置右侧的编辑。

2. 在弹出的历史消息存储时长配置对话框中，设置延长历史消息存储时长。

3. 单击确定保存配置，该配置即刻生效。

四、消息撤回设置

1. 在登录与消息页面，单击消息撤回设置右侧的编辑。

2. 在弹出的消息撤回设置对话框中，设置消息可撤回时长。

3. 单击确定保存配置。

五、多端同步设置

在登录与消息页面，在多端同步设置区域可以选择开启或关闭删除会话后多端同步：

·开启：如果多端同时在线，删除会话会同步至各端，同步删除会话。

·关闭：如果多端同时在线，一端删除会话后不同步至其它端。默认为关闭。

注意：说明：

注意：删除会话后多端同步仅支持终端 SDK 5.1.1，Web SDK 2.14.0及以上版本，低版本用户如需开启同步请升级 SDK 版本。

六、用户状态查询及状态变更通知配置

在登录与消息页面，在用户状态查询及状态变更通知配置区域可以开启用户状态查询及状态变更通知开关。

注意：说明：

注意：用户状态查询及状态变更通知默认关闭，此时客户端查询/订阅/取消订阅用户状态会收到 72001 错误码。支持终端 SDK 6.3及以上版本开启。该功能仅支持旗舰版或企业版使用，如需升级请参见 升级应用。

七、消息扩展设置

在登录与消息页面，在消息扩展设置区域可以开启功能开关。

注意：说明：

注意：消息扩展可以为消息增加 key/value 状态标识，基于此功能可实现投票、接龙、问卷调查等功能，详情请参见功能说明。请使用终端 SDK 增强版 6.7.3184 及以上版本。该功能仅支持旗舰版或企业版使用，如需升级请参见 升级应用。

八、会话列表拉取个数配置

在登录与消息页面，在会话列表拉取个数配置区域可以配置从云端拉取的会话个数，客户端默认可从云端拉取100个会话，可配置从云端拉取最多500个会话。

注意：说明：

九、黑名单检查

在登录与消息页面，在黑名单检查区域可以选择开启或关闭发送消息后展示发送成功：

·启用：若对方已将你的账号加入黑名单，你向对方发送单聊消息时将提示消息发送成功，实际对方不会收到消息。默认为启用。

·关闭：若对方已将你的账号加入黑名单，你向对方发送单聊消息时将提示消息发送失败。

十、接收被踢离线状态

在登录与消息页面，在接收被踢离线状态区域可以选择开启或关闭被踢离线状态，按钮分断网重连与主动登录：

·同时启用断网重连时触发，主动登录时触发，在任何情况下重连登录，均会收到 错误码 6208。

·仅启用断网重连时触发，不开启主动登录时触发，在除主动登录的情况下，会收到 错误码 6208 。

·此功能仅对 Native SDK 生效，Web SDK 不会返回6208。

十一、好友关系检查

在登录与消息页面，在好友关系检查区域可以选择开启或关闭发送单聊消息检查关系链：

·开启：发起单聊时会先检查好友关系，仅允许好友之间发送单聊消息，陌生人发送单聊消息时 SDK 会收到 错误码 20009。

·关闭：发起单聊时无需检查好友关系，允许用户和好友、陌生人之间发送单聊消息。默认为关闭。

十二、好友与关系链

在好友与关系链模块下，你可以进行默认加好友验证方式设置、好友自定义字段设置以及拉黑配置。

十三、默认加好友验证方式设置

1. 登录 即时通信 IM 控制台 ，在左侧导航栏选择功能配置 > 好友与关系链。

2. 在默认加好友验证方式设置功能卡片右侧单击编辑。

3. 选择适合你业务场景的验证方式，单击确定即可。

十四、好友自定义字段设置

1. 登录 即时通信 IM 控制台 ，在左侧导航栏选择功能配置 > 好友与关系链。

2. 单击好友自定义字段设置功能卡片右侧的新增。

注意：说明：

注意：最多可添加20个好友自定义字段，该字段不支持修改字段名与字段类型且不支持删除，请根据业务需求合理规划该字段。

3. 在弹出的好友自定义字段对话框中，输入自定义字段名、选择字段类型，单击确定即可。

注意：说明：

注意：字段名必须是英文字母，且长度不能超过8个字符。

十五、拉黑配置

1. 登录 即时通信 IM 控制台 ，在左侧导航栏选择功能配置 > 好友与关系链。

2. 单击拉黑配置功能卡片右侧的编辑。

3. 选择把好友拉黑后的处理方式，单击确定即可。

十六、用户自定义字段

登录 即时通信 IM 控制台 ，单击目标应用卡片，在左侧导航栏选择功能配置 > 用户自定义字段，你可以根据实际业务需求管理用户自定义字段。

注意：最多可添加20个用户自定义字段，该字段不支持修改字段名与字段类型且不支持删除，请根据业务需求合理规划该字段。

十七、添加用户自定义字段

1. 在用户自定义字段页面，单击右侧新增按键。

2. 在弹出的用户自定义字段对话框中，输入自定义字段名，设置字段类型，设置读写权限。

注意：说明：

3. 单击确定保存配置。

十八、修改用户自定义字段权限

1. 在用户自定义字段页面，单击目标自定义字段所在行的修改权限。

2. 在弹出的用户自定义字段对话框中，修改读写权限。

3. 单击确认保存配置。

4. 单击确定保存配置。

20、群成员自定义字段

登录 即时通信 IM 控制台 ，单击目标应用卡片，在左侧导航栏选择功能配置 > 群组配置 > 群成员自定义字段，你可以根据实际业务需求管理群成员自定义字段。

注意：最多可添加5个群成员自定义字段，该字段仅支持修改群组类型及其对应的读写权限且不支持删除，请根据业务需求合理规划该字段。

21、添加群成员自定义字段

1. 在群成员自定义字段页面，右侧单击新增按键。

2. 在弹出的群成员维度自定义字段对话框中，输入字段名称，设置群组类型及其对应的读写权限。

注意：说明：

·单击添加群组类型可新增一组群组类型参数，群组类型不可重复。

·单击目标群组类型参数组所在行的删除可删除该组群组类型参数，需至少保留一组群组类型参数。

22、编辑群成员自定义字段

1. 在群成员自定义字段页面，单击目标群成员自定义字段所在行的编辑。

2. 在弹出的群成员维度自定义字段对话框中，修改已选群组类型的读写权限，或单击添加群组类型新增群组类型并设置其参数，群组类型不可重复。

3. 勾选我已知道“群成员自定义字段”添加后，仅可修改已添加群组类型的读写权限；无法删除该字段，无法重新选择也无法删除已添加的群组类型。

4. 单击确定保存设置。

23、群自定义字段

登录 即时通信 IM 控制台 ，单击目标应用卡片，在左侧导航栏选择 功能配置 > 群组配置 > 群自定义字段，你可以根据实际业务需求管理群自定义字段。

注意：最多可添加10个群自定义字段，该字段仅支持修改群组类型及其对应的读写权限且不支持删除，请根据业务需求合理规划该字段。

24、添加群自定义字段

1. 在群自定义字段页面，单击添加群维度自定义字段。

2. 在弹出的群维度自定义字段对话框中，输入字段名称，设置群组类型及其对应的读写权限。

注意：说明：

·单击添加群组类型可新增一组群组类型参数，群组类型不可重复。

·单击目标群组类型参数组所在行的删除可删除该组群组类型参数，需至少保留一组群组类型参数。

3. 勾选我已知道“群成员自定义字段”添加后，仅可修改已添加群组类型的读写权限；无法删除该字段，无法重新选择也无法删除已添加的群组类型。

4. 单击确定保存设置。

25、编辑群自定义字段

1. 在群自定义字段页面，单击目标群自定义字段所在行的编辑。

2. 在弹出的群维度自定义字段对话框中，修改已选群组类型的读写权限，或单击添加群组类型新增群组类型并设置其参数，群组类型不可重复。

3. 勾选我已知道“群成员自定义字段”添加后，仅可修改已添加群组类型的读写权限；无法删除该字段，无法重新选择也无法删除已添加的群组类型。

4. 单击确定保存设置。

26、群消息配置

登录 即时通信 IM 控制台，单击目标应用卡片，在左侧导航栏选择功能配置>群组配置>群消息配置，你可以根据实际业务需求进行群消息配置。

27、拉取入群前漫游消息

1. 在拉取入群前漫游消息页面，针对不同的群组类型，单击编辑。

2. 在弹出的拉取入群前漫游消息配置对话框中，选择业务所需的配置项。

注意：说明：

28、群系统通知配置

登录 即时通信 IM 控制台，单击目标应用卡片，在左侧导航栏选择功能配置>群组配置>群系统通知配置，你可以根据实际业务需求进行群系统通知配置。

29、群成员变更通知

1. 在群成员变更通知页面，针对不同的群组类型，单击编辑。

2. 在弹出的群成员变更通知对话框中，选择业务所需的配置项。

注意：说明：

30、群资料变更通知

1. 在群资料变更通知页面，针对不同的群组类型，单击编辑。

2. 在弹出的群资料变更通知对话框中，选择业务所需的配置项。

注意：说明：

31、群成员资料变更通知

1. 在群成员资料变更通知页面，针对不同的群组类型，单击编辑。

2. 在弹出的群成员资料变更通知对话框中，选择业务所需的配置项。

注意：说明：

注意：配置修改后约十分钟生效。请耐心等待。

32、群功能配置

登录 即时通信 IM 控制台，单击目标应用卡片，在左侧导航栏选择功能配置 > 群组配置 > 群功能配置，你可以根据实际业务需求进行群功能配置。

33、社群

社群，是可容纳10万人的超大群组，创建后可随意进出，支持历史消息存储。集成指引详见 社群文档。开通社群开关默认关闭，开启后可创建社群并使用社群相关功能。

如果需要使用话题功能，请在开通社群后，打开开通话题开关。同一社群下可创建多个话题，多个话题共享一套社群成员关系，但不同话题内独立收发消息、互不干扰。

注意：说明：

34、直播群在线成员列表

直播群在线成员列表开关默认关闭，可开启。

注意：说明：

35、直播群广播消息

是否开启直播群广播消息功能开关默认关闭，可开启。

注意：说明：

36、直播群封禁

开启后，可对直播群成员进行封禁。成员封禁后无法接收消息，且封禁时间内无法再进群。

注意：说明：

37、直播群新成员查看入群前消息配置

直播群新成员查看入群前消息，提升直播间用户粘性的重要功能，可帮助用户了解“前情提要”，迅速融入互动讨论中，让用户更有参与感，无论何时进入直播间都可获得高沉浸式体验，进而提升直播间用户停留时长。

1. 单击直播群新成员查看入群前消息配置右侧的编辑。

2. 在弹出的直播群新成员查看入群前消息配置对话框中，设置新成员可查看的消息数。

3. 单击确定保存配置。

注意：说明：

38、群消息已读回执配置

群消息已读回执，高效沟通必备功能。作为一种强反馈工具，支持查看已读/未读已发送消息的人数和成员，尤其在商务、办公场景下，可帮助团队构建更加及时、高效的沟通氛围。

1. 单击群消息已读回执配置右侧的编辑。

2. 在弹出的群消息已读回执配置对话框中，设置支持消息回执的群类型。

3. 单击确定保存配置。

注意：说明：

注意：该功能仅支持旗舰版或企业版使用，如需升级请参考升级应用。群消息已读回执功能支持终端 SDK 6.1.2155及以上版本，适用于群容量200以内的好友工作群（Work）、陌生人社交群（Public）、临时会议群（Meeting）。

39、服务端 API 调频

登录 即时通信 IM 控制台，单击目标应用卡片，在左侧导航栏选择功能配置 > 服务端 API 调频，你可以根据实际业务需求进行服务端 API 调频配置。

1. 单击需要调频的服务端 API 右侧的编辑。

2. 滑动滑杆至所需的频率大小，并单击保存。

3. 在弹出的保存当前配置对话框中，单击确认保存配置。

注意：说明：

注意：服务端 API 调频是收费服务，仅支持专业版、旗舰版或企业版套餐应用进行调整。每个调频项按当日配置的最高数值计算，仅针对超出默认限频的部分收费，计费说明详见基础服务计费说明-服务端 API 调用频率叠加包。

40、支持调整的服务端 API