tencent cloud

即时通信 IM

动态与公告
产品动态
公告
产品简介
产品概述
基本概念
应用场景
功能介绍
账号系统
用户资料与关系链
消息管理
群组相关
公众号系统
音视频通话 Call
使用限制
购买指南
计费概述
价格说明
购买指引
续费指引
停服说明
退费说明
开发指引
Demo 专区
开通服务
体验 Demo
快速跑通
下载中心
SDK & Demo 源码
更新日志
聊天互动(含 UI)
TUIKit 组件介绍
快速开始
全功能接入
单功能接入
AI 集成
构建基础界面
更多特性
定义外观
国际化界面语言
推送服务(Push)
服务概述
名词解释
开通服务
快速跑通
厂商通道
数据统计
排查工具
客户端 API
服务端 API
推送回调
高级功能
更新日志
错误码
常见问题
智能客服
功能概述
快速入门
集成指引
管理员操作手册
客服操作手册
更多实践
直播间搭建
AI 聊天机器人方案
超大娱乐协作社群
Discord 实现指南
游戏内集成 Chat 指南
类 WhatsApp Channel 搭建方案
发送红包
Chat 应对防火墙限制相关
无 UI 集成
快速开始
集成 SDK
初始化
登录登出
消息相关
会话相关
群组相关
社群话题
用户管理
离线推送
云端搜索
本地搜索
公众号
客户端 API
JavaScript
Android
iOS & macOS
Swift
Flutter
Electron
Unity
React Native
C 接口
C++
服务端 API
生成 UserSig
REST API
第三方回调
控制台指南
新版控制台介绍
创建并升级应用
基本配置
功能配置
账号管理
群组管理
公众号管理
回调配置
用量统计
资源包查看指南
实时监控
开发辅助工具
访问管理
高级功能
常见问题
uni-app 常见问题
购买相关问题
SDK 相关问题
账号鉴权相关问题
用户资料与关系链相关问题
消息相关问题
群组相关问题
直播群相关问题
昵称头像相关问题
协议与认证
服务等级协议
安全合规认证
IM 政策
隐私政策
数据隐私和安全协议
平滑迁移方案
平滑迁移完整版
平滑迁移简化版
错误码
联系我们

功能配置

PDF
聚焦模式
字号
最后更新时间: 2025-12-08 17:12:39

登录与消息

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Login and Message,在顶部选择目标应用,您可以根据实际业务需求管理登录与消息相关配置。




登录设置

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



2. 在弹出的登录设置对话框中,选择多端登录类型,设置 Web 端以及其他平台实例同时在线数量。
说明:
专业版、专业版Plus、企业版选择多平台登录时,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及以上版本开启。该功能仅支持专业版、专业版Plus、企业版使用,您可以 单击升级




消息扩展设置

登录与消息页面,在消息扩展设置区域可以开启功能开关。
说明:
消息扩展可以为消息增加 key/value 状态标识,基于此功能可实现投票、接龙、问卷调查等功能,详情请参见 功能文档。该功能仅对专业版、专业版Plus、企业版客户开放,并且仅支持终端 SDK 增强版 6.7.3184 及以上版本,低版本用户请升级 SDK 版本。




全员推送设置

登录与消息页面,在全员推送设置区域可以开启功能开关。
说明:
全员推送,是用户运营利器,不仅支持全员发送特定内容,还可根据标签、属性,针对特定用户群体发送个性化内容,如会员活动、区域通知等,助力拉新、转化、促活等各个阶段运营工作的有效进行,详情请参见 全员推送




会话列表拉取个数配置

登录与消息页面,在会话列表拉取个数配置区域可以配置从云端拉取的会话个数,客户端默认可从云端拉取100个会话,可配置从云端拉取最多500个会话。
说明:
会话列表拉取个数配置仅支持专业版、专业版Plus、企业版使用,非专业版、专业版Plus、企业版用户请升级后使用。
会话列表拉取个数配置仅支持终端 SDK 5.1.1,Web SDK 2.0以上版本,低版本用户如需配置请升级 SDK 版本。




黑名单检查

登录与消息页面,在黑名单检查区域可以选择开启或关闭发送消息后展示发送成功:
启用:若对方已将您的账号加入黑名单,您向对方发送单聊消息时将提示消息发送成功,实际对方不会收到消息。默认为启用。
关闭:若对方已将您的账号加入黑名单,您向对方发送单聊消息时将提示消息发送失败。




好友关系检查

登录与消息页面,在好友关系检查区域可以选择开启或关闭发送单聊消息检查关系链:
开启:发起单聊时会先检查好友关系,仅允许好友之间发送单聊消息,陌生人发送单聊消息时 SDK 会收到 错误码 20009
关闭:发起单聊时无需检查好友关系,允许用户和好友、陌生人之间发送单聊消息。默认为关闭。




接收被踢离线回调

在登录与消息页面,在接收被踢离线回调区域可以选择开启或关闭被踢离线回调,按钮分为断网重连与主动登录:
同时启用断网重连时触发,主动登录时触发时,在任何情况下重连登录,均会收到 错误码 6208
仅启用断网重连时触发,不开启主动登录时触发时,在除主动登录的情况下,会收到 错误码 6208
说明:
此功能仅对 Native SDK 生效,Web SDK 不会返回6208。




用户资料变更订阅

登录与消息页面,在好友关系检查区域可以选择开启或关闭是否订阅用户资料变更。详情请参见 用户资料变更通知
根据用户类型的不同,用户资料变更可以分为如下三种:
自己的资料变更。
好友的资料变更。
订阅用户(非好友)的资料变更。
注意:
该功能默认关闭,此时客户端订阅用户资料变更会收到错误码 72012
默认只支持订阅 200 个用户,当超过限制后,会淘汰掉最早订阅的用户。




好友与关系链

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Friends and Relationship,在顶部选择目标应用,您可以根据实际业务需求管理好友与关系链相关配置。




设置添加好友验证方式

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



2. 选择合适的默认加好友验证方式,单击确定进行保存。

拉黑配置

1. 拉黑配置功能卡片右侧单击编辑



2. 选择把好友拉黑后的处理方式,单击确定进行保存。

关注 / 粉丝功能设置

1. 关注 / 粉丝功能设置功能卡片右侧单击编辑



2. 选择开启或关闭关注 / 粉丝功能配置状态,单击确定进行保存。

好友自定义字段

说明:
最多可添加20个好友自定义字段,该字段不支持修改字段名与字段类型且不支持删除,请根据业务需求合理规划该字段。
1. 单击好友自定义字段功能卡片右侧的新增



2. 在弹出的好友自定义字段对话框中,输入自定义字段名,设置字段类型。
说明:
字段名必须是英文字母,且长度不能超过8个字符。

用户自定义字段

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Custom User Field,在顶部选择目标应用,您可以根据实际业务需求管理用户自定义字段。
注意:
最多可添加20个用户自定义字段,该字段不支持修改字段名与字段类型且不支持删除,请根据业务需求合理规划该字段。




添加用户自定义字段

1. 用户自定义字段页面,单击右侧新增按键。
2. 在弹出的用户自定义字段对话框中,输入自定义字段名,设置字段类型,设置读写权限。
说明:
字段名必须是英文字母,且长度不能超过8个字符。
需至少设置一种读权限和一种写权限。



3. 单击确定保存设置

修改用户自定义字段权限

1. 用户自定义字段页面,单击目标自定义字段所在行的修改权限
2. 在弹出的用户自定义字段对话框中,修改读写权限。



3. 单击确定保存配置。

群组配置

群成员自定义字段

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Custom User Field,在顶部选择目标应用,选择 Custom Group Member Field 标签栏,您可以根据实际业务需求管理群成员自定义字段。
注意:
最多可添加5个群成员自定义字段,该字段仅支持修改群组类型及其对应的读写权限且不支持删除,请根据业务需求合理规划该字段。




添加群成员自定义字段

1. 群成员自定义字段页面,右侧单击新增按键。
2. 在弹出的群成员维度自定义字段对话框中,输入字段名称,设置群组类型及其对应的读写权限。
说明:
字段名称只能由字母、数字以及下划线(_)组成,不能以数字开头,且长度不能超过16个字符。
群成员自定义字段名称不允许与群自定义字段名称一致。
单击添加群组类型可新增一组群组类型参数,群组类型不可重复。
单击目标群组类型参数组所在行的删除可删除该组群组类型参数,需至少保留一组群组类型参数。



3. 勾选我已知道“群成员自定义字段”添加后,仅可修改已添加群组类型的读写权限;无法删除该字段,无法重新选择也无法删除已添加的群组类型。
4. 单击确定保存设置。

编辑群成员自定义字段

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



3. 勾选我已知道“群成员自定义字段”添加后,仅可修改已添加群组类型的读写权限;无法删除该字段,无法重新选择也无法删除已添加的群组类型。
4. 单击确定保存设置。

群自定义字段

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Group configuration,在顶部选择目标应用,选择 Custom Group Field 标签栏,您可以根据实际业务需求管理群自定义字段。
注意:
最多可添加10个群自定义字段,该字段仅支持修改群组类型及其对应的读写权限且不支持删除,请根据业务需求合理规划该字段。




添加群自定义字段

1. 在群自定义字段页面,单击添加群维度自定义字段。
2. 在弹出的群维度自定义字段对话框中,输入字段名称,设置群组类型及其对应的读写权限。
说明:
字段名称只能由字母、数字以及下划线(_)组成,不能以数字开头,且长度不能超过16个字符。
群自定义字段名称不允许与群成员自定义字段名称一致。
单击添加群组类型可新增一组群组类型参数,群组类型不可重复。
单击目标群组类型参数组所在行的删除可删除该组群组类型参数,需至少保留一组群组类型参数。



3. 勾选我已知道“群成员自定义字段”添加后,仅可修改已添加群组类型的读写权限;无法删除该字段,无法重新选择也无法删除已添加的群组类型。
4. 单击确定保存设置。

编辑群自定义字段

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



3. 勾选我已知道“群成员自定义字段”添加后,仅可修改已添加群组类型的读写权限;无法删除该字段,无法重新选择也无法删除已添加的群组类型。
4. 单击确定保存设置。

群消息配置

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Group configuration,在顶部选择目标应用,选择 Group message configuration 标签栏,您可以根据实际业务需求进行群消息配置。




拉取入群前漫游消息

1. 在拉取入群前漫游消息页面,针对不同的群组类型,单击编辑
2. 在弹出的拉取入群前漫游消息配置对话框中,选择业务所需的配置项。
说明:
配置修改后约十分钟生效。请耐心等待。
直播群(AVChatRoom)不支持配置拉取入群前漫游消息。




群系统通知配置

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Group configuration,在顶部选择目标应用,选择 Group system notification configuration 标签栏,您可以根据实际业务需求进行群系统通知配置。




群成员变更通知

1. 在群成员变更通知页面,针对不同的群组类型,单击编辑
2. 在弹出的群成员变更通知对话框中,选择业务所需的配置项。
说明:
配置修改后约十分钟生效。请耐心等待。
直播群(AVChatRoom)不支持配置群成员变更通知。




群资料变更通知

1. 在群资料变更通知页面,针对不同的群组类型,单击编辑
2. 在弹出的群资料变更通知对话框中,选择业务所需的配置项。
说明:
配置修改后约十分钟生效。请耐心等待。
直播群(AVChatRoom)不支持配置群资料变更通知。




群成员资料变更通知

1. 在群成员资料变更通知页面,针对不同的群组类型,单击编辑
2. 在弹出的群成员资料变更通知对话框中,选择业务所需的配置项。
说明:
配置修改后约十分钟生效。请耐心等待。




群功能配置

登录 即时通信 Chat 控制台,在左侧导航栏选择 Chat > Configuration > Group configuration,在顶部选择目标应用,选择 Group feature configuration 标签栏,您可以根据实际业务需求进行群功能配置。




社群

社群,是可容纳10万人的超大群组,创建后可随意进出,支持历史消息存储。开通社群开关默认关闭,开启后可创建社群并使用社群相关功能。
如果需要使用话题功能,请在开通社群后,打开开通话题开关。同一社群下可创建多个话题,多个话题共享一套社群成员关系,但不同话题内独立收发消息、互不干扰。
说明:
社群功能仅支持终端 SDK 5.8.1668增强版,Web SDK 2.17.0及以上版本使用,低版本用户如需使用社群功能请升级 SDK 版本。
该功能仅支持专业版、专业版Plus、企业版使用,您可以 单击升级

直播群在线成员列表

直播群在线成员列表开关默认关闭,可开启。
说明:
开启之后,直播群成员将保存最新入群并且在线的1000人,客户端可以拉取该列表。
该功能仅支持终端 SDK 6.3及以上版本使用,低版本用户如需使用请升级 SDK 版本。
该功能仅支持专业版、专业版Plus、企业版使用,您可以 单击升级

直播群广播消息

是否开启直播群广播消息功能开关默认关闭,可开启。
说明:
直播群广播消息功能默认关闭,支持终端 SDK 6.5及以上版本开启。
开启该功能后可配置直播群广播消息调用频率,默认1条/秒,最高可配置为5条/秒。
该功能仅支持专业版、专业版Plus、企业版使用,您可以 单击升级

直播群封禁

开启后,可对直播群成员进行封禁。成员封禁后无法接收消息,且封禁时间内无法再进群。
说明:
该功能仅支持终端SDK 6.6,Web SDK 2.22及以上版本使用,低版本用户如需使用请升级SDK版本。
该功能仅支持专业版、专业版Plus、企业版使用,您可以 单击升级

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

直播群新成员查看入群前消息,提升直播间用户粘性的重要功能,可帮助用户了解“前情提要”,迅速融入互动讨论中,让用户更有参与感,无论何时进入直播间都可获得高沉浸式体验,进而提升直播间用户停留时长。
1. 登录与消息页面,单击直播群新成员查看入群前消息配置右侧的编辑
2. 在弹出的直播群新成员查看入群前消息配置对话框中,设置新成员可查看的消息数。
3. 单击确定保存配置。

群消息已读回执配置

群消息已读回执,高效沟通必备功能。作为一种强反馈工具,支持查看已读/未读已发送消息的人数和成员,尤其在商务、办公场景下,可帮助团队构建更加及时、高效的沟通氛围。
1. 登录与消息页面,单击群消息已读回执配置右侧的编辑。
2. 在弹出的群消息已读回执配置对话框中,设置支持消息回执的群类型。
3. 单击确定保存配置。
说明:
该功能仅对专业版、专业版Plus、企业版用户开放,非专业版、专业版Plus、企业版用户 请升级 后使用。群消息已读回执功能支持终端 SDK 6.1.2155及以上版本,适用于群容量200以内的好友工作群(Work)、陌生人社交群(Public)、临时会议群(Meeting)。

服务端 API 调频

登录 Chat 控制台,在左侧导航 Chat > 功能管理 > 服务端 API 调频,您可以根据实际业务需求进行服务端 API 调频配置。
1. 单击需要调频的服务端 API 右侧的编辑
2. 滑动滑杆至所需的频率大小,并单击保存
3. 在弹出的保存当前配置对话框中,单击确认保存配置。
说明:
服务端 API 调频是收费服务仅对专业版 Plus 和企业版开放。每个调频项按当日配置的最高数值计算,仅针对超出默认限频的部分收费,计费说明详见Chat 套餐外计费说明 > 服务端 API 调用频率
支持调整的服务端 API:
功能说明
接口
默认限频
单个叠加包大小
v4/openim/batchsendmsg
12000条/分钟,
200次/秒
6000条/分钟,
可免费提升至1000次/秒
v4/openim/sendmsg
200条/秒
100条/秒
v4/group_open_http_svc/send_group_msg
200条/秒
100条/秒
v4/group_open_http_svc/send_group_system_notification
200条/秒
100条/秒
v4/openim/get_c2c_unread_msg_num
200次/秒
100次/秒
v4/group_open_http_svc/add_group_member
200次/秒
100次/秒
v4/group_open_http_svc/delete_group_member
200次/秒
100次/秒
v4/group_open_http_svc/create_group
200次/秒
100次/秒
v4/group_open_http_svc/destroy_group
200次/秒
100次/秒
v4/group_open_http_svc/get_group_info
200次/秒
100次/秒
v4/group_open_http_svc/get_group_member_info
200次/秒
100次/秒
v4/group_open_http_svc/get_joined_group_list
200次/秒
100次/秒
v4/group_open_http_svc/get_role_in_group
200次/秒
100次/秒
v4/group_open_http_svc/group_msg_get_simple
200次/秒
100次/秒
v4/profile/portrait_set
200次/秒
100次/秒
v4/profile/portrait_get
200次/秒
100次/秒
v4/openim/query_online_status
200次/秒
100次/秒
v4/sns/black_list_get
200次/秒
100次/秒

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈