功能介绍


社区版与企业版的区别

社区版:100以内的注册用户,免费使用; 企业版是注册用户无上限限制; 提升REST API请求秒频上限;提升群组、聊天室创建上限 参考链接


注册、发消息等调用Rest接口调用次数限制多少?

社区版:10/秒,企业版:30/秒,旗舰版:50/秒,尊享版:200/秒; 当rest接口超限时可过一会再试,或者联系商务提升REST接口限流 参考链接


注册用户数限制多少?

社区版:注册用户数100,当大于100时注册时会报错429超限提醒,企业版、旗舰版、尊享版注册用户数量不受限制,无上限;如您是社区版可直接通过console账号自助升级企业版服务;


聊天历史存储时间是多久?

历史聊天消息默认保存社区版:3天,企业版:3天,旗舰版:90天,尊享版:360天; 如存储时间不够,可开通增值功能“聊天历史存储”或者“实时回调”


群组、聊天室数量限制是多少?

社区版:2万,企业版:10万,旗舰版、尊享版:无上限;如您的(群组/聊天室)数量不足可与商务联系,提高上限数量。


好友数上限是多少?

社区版:1000,企业版:2000,旗舰版:5000,尊享版:10000;如需要扩充与商务联系提高上限数量。


单个用户可以加入群组是多少?

社区版:200,企业版:500,旗舰版:1000,尊享版:2000;如需要扩充与商务联系提高上限数量。

说明:如达到版本上限限制后,该用户将无法加入新的群组


离线消息存储时间是多长?

社区版:7天,企业版:7天,旗舰版:90天,尊享版:180天;如需要扩充与商务联系提高上限数量。


什么是漫游消息?

同一用户移动端的所有已登录设备都可以获取该用户在所有设备上的历史消息;

用户可从服务器获取全部历史消息,也可以根据本地数据库存储的消息有选择的获取服务器历史消息;

消息漫游支持以会话为单位获取历史消息;

漫游消息的存储不限制条数和消息类型,时间限制分为3个月和6个月两种。

说明:此功能属于增值功能,如需要此功能请与商务同事联系开通。


什么是消息撤回?

用户可以在消息发出后的撤回时限内从客户端发起消息撤回操作;

被撤回的消息将会从服务器的离线队列中删除,如果应用已开通消息漫游,则所有已登录客户端均撤回或不再接收此消息;

消息撤回时限默认2分钟,可根据开发者需求以AppKey为单位进行单独设置;(如需要其他时间请与商务申请)

端消息撤回由用户在各客户端上主动进行消息撤回操作;

REST消息撤回赋予了APP管理员对消息进行撤回的能力,可以对不良消息进行人工的处理;

不包括通过REST接口发送的消息;

说明:此功能属于端消息撤回是增值功能,如需要此功能可与商务同事联系开通。(目前分:端消息撤回 REST消息撤回)


什么是实时回调?

实时消息回调经常用在应用需要针对用户发送的消息进行处理的场景。比如:

针对客户消息的内容进行自动回复

在 APP 自己的服务端实时保存聊天历史

注:如果您对聊天消息没有实时性需求,可以直接通过免费的聊天记录拉取 REST API 获取聊天记录,无需使用实时消息回调。

说明:此功能属于增值功能,如需要此功能可与商务同事联系开通,或者直接通过console账号自助付费开通。。


什么是多端多设备

多端多设备是指允许用户使用同一个环信ID在不同的平台终端同时登录(手机端、web端、桌面端)、以及在每个终端的多台设备同时登录;两个服务可单独开启。

说明:此功能属于增值功能,如需要此功能可与商务同事联系开通


什么是多设备同步

多设备是指用户在同一终端可同时登录;允许登录的设备数的上限最大为10台;默认开通设备为2台,如果需要自定义设备数请联系商务设置。

说明:此功能属于增值功能,如需要此功能可与商务同事联系开通


什么是多终端同步

是指允许用户使用同一个环信ID在多个终端同时登录(手机端、web端、桌面端)。

说明:此功能属于增值功能,如需要此功能可与商务同事联系开通


上传语音/图片文件有要求吗?

上传文件大小不能超过 10M,超过会上传失败


常见FAQ问题


即时通讯云如何收费?

目前即时通讯云分2种模式,一种充值模式,一种约定模式。

充值模式属于先预存后扣费模式—每月5号扣除上个月产生的费用,详情见Console后台扣费明细,约定模式模式是约定一次性交费,具体请与商务同事洽谈;


Console账户密码遗忘怎么办?

如密码遗忘可以通过Console后台忘记密码找回,密码重置邮件会直接发生到注册邮箱,根据邮箱内容进行操作即可。


Console账户密码有要求吗?

密码是8-22位,大写字母,小写字母,数字,符号至少包含两种


Console后台的注册应用是否可以删除?

注册应用不支持删除,如不使用无需理会即可;


已付费的appkey是否可以变更及关停等业务呢?

一般情况下已付费的appkey不支持变更业务,具体请您联系商务同事进行洽谈;


环信DEMO下载地址是什么?

各端请从官网下载最新SDK 参考链接


回调地址如何修改?

如果您是充值用户,Console后台–实时回调–可自行修改; 如无法修改的用户请联系商务同事进行回调地址的变更及修改。

注:回调名称不能为空和中文格式


回调地址最多可配置几个?

每个appkey目前最多可配置2个地址;



回调被禁怎么办?

一般是自己服务器出现异常,环信这边在1分钟内回调消息失败超过180次,回调就会被封禁,被封禁后可以联系环信技术解除封禁,也可以联系对接的环信商务,开通回调被封禁后短信通知的功能。


回调地址支持什么格式?

回调地址http,https均支持。参考链接


聊天记录如何导出?

1) 调用环信rest api,导出环信历史记录,保存到本地,建议用户在取得历史记录时要间隔一个小时(免费、不实时) 参考链接

2) 开通实时回调功能,有上行消息时会主动将消息推到您自己配置的服务器地址,然后实现拉取展示(增值、实时) 参考链接


注册用户时报错429是什么原因?

当接口返回429时是请求接口超过调用频率限制,即接口被限流。 当rest接口超限时可过一会再试,或者联系商务提升REST接口限流 参考链接


环信如何进行跨应用通讯?

应用之间使用相同的appkey即可


环信聊天室消息记录如何获取?

环信聊天室记录是环信服务端配置下发的 目前可以免费配置10条消息记录 如果需要开通可以提交工单说明需要开通的appkey找环信人员开通


服务器端的聊天记录是否支持删除?

服务器端的记录是不支持删除的,在线消息默认都是保存3天,三天之后自动删除,离线消息保存7天,7天之后自动删除


如何查询群组是公开群还是私有群?

通过rest获取群组详情: 获取群组详情

public字段,true:公开群,false:私有群


某个ID加群失败的原因?

环信默认单用户ID只能加入500个群,如贵司单独修改过某个ID加入上限已修改后为准,当遇到某个ID加群失败可自行先判断此id加群是否达到上限限制

获取一个用户参与的所有群组: 参考链接


环信聊天室消息记录如何获取?

环信聊天室记录是环信服务端配置下发的 目前可以免费配置10条消息记录 如果需要开通可以提交工单说明需要开通的appkey找环信人员开通


历史记录如何持久化保存

持久化是需要客户自己来做 将历史消息保存到自己的服务器 目前这块没有什么文档 因为都是需要保存在用户服务器的

1.我们有提供实时回调增值服务 将消息实时推送到客户自己的服务器 由客户自己去维护数据 需要开通请联系商务

2.我们有提供免费的接口去下载历史文件

获取聊天记录文件


环信有没有自己的推送?怎么实现给用户批量推送消息?

离线推送是借助于第三方厂商的,可以调用rest给用户去发消息,只要APP端集成的离线推送,用户不在线就会收到离线推送通知,在线的可以在消息监听里去发送本地通知。rest发消息可以设置一个固定的from,在APP端给这个from的会话显示系统通知或者其他名称


非好友之间是否可以发消息?

环信不限制非好友之间发消息,只有知道对方的环信id就可以发。


IM发送图片有鉴黄功能吗?

环信使用阿里云鉴黄系统,增值服务,需要联系商务同事开通。


app能做到和微信一样一直在后台一直运行吗?

因为国内手机厂商对 android rom 进行了定制,对后台服务以及运行在后台的程序进行了严格的限制,微信等这些大厂商的 app 都已经通过和设备厂商合作在安装时都已经加入了系统的白名单,因此设备并不会限制对方 app 在后台运行,app进程杀死可以通过集成第三方离线推送接收消息。


实时消息回调中的eventType是什么意思,为什么会出现两条消息一样?

这个官方文档有相关说明 实时消息回调


如何获取历史记录?

1、可以调用restapi接口免费获取历史记录,每次获取一个小时之内所有历史记录,这个接口有延迟具体看文档获取聊天记录文件

2、可以开通消息漫游功能,直接从服务器端拉取消息属于增值服务具体参考,消息漫游


已读回执可以回调到我们服务器上吗?

不可以,目前是没有的。


服务器端存储离线消息数量限制

正常单个用户存的离线消息数是500,单个群组是200,总数是1200(7天)。


常见报错码


服务器端 REST API 常见错误码

服务器端 REST API 常见错误码参考链接


Android API 常见错误码 Android API 常见错误码参考链接


iOS API 常见错误码

iOS API 常见错误码参考链接


Web IM API 常见错误码

Web IM API 常见错误码参考链接


桌面端 API 常见错误码

桌面端 API 常见错误码参考链接


音视频常见错误码


Answer