开通配置环信即时通讯 IM 服务使用教程（详细）

IM即时通讯

简介/价格/文档

文档简介：

前提条件：配置环信即时通讯 IM 服务前，请确保已经具备以下条件：创建一个环信开发者账号。创建应用：参照以下步骤在环信即时通讯云控制台创建应用和购买即时通讯 IM 服务。登录环信即时通讯云控制台 (opens new window)，在首页的应用列表区域点击添加应用按钮，创建即时通讯 IM 应用。

*此产品及展示信息均由环信官方提供。免费试用咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！微信咨询

免费试用、价格特惠

文档详情

前提条件

配置环信即时通讯 IM 服务前，请确保已经具备以下条件：

创建一个环信开发者账号。

#创建应用

参照以下步骤在环信即时通讯云控制台创建应用和购买即时通讯 IM 服务。

登录环信即时通讯云控制台open in new window，在首页的应用列表区域点击添加应用按钮，创建即时通讯 IM 应用。

在创建应用对话框中，输入新应用的相关信息，点击创建按钮创建应用。新建应用的服务版本默认为免费版。

提示

appname：你设置的应用名称，用于生成 App Key。该参数的值只能包含小写字母、数字和连字符，不能超过 32 个字符。
Appkey：即时通讯服务分配给每个应用的唯一标识，由 orgname 和 appname 参数的值组成，生成后无法修改。
数据中心：设置后无法修改。

#购买服务

创建应用后，在应用列表中点击所创建应用的操作栏中的查看按钮，进入应用详情页面。

开通或升级版本。

你可以通过以下方法开通或升级版本。

在页面左侧的导航栏，选择即时通讯 > 功能配置 > 版本开通，查看各种套餐的详情，选择需要的版本，点击立即开通。

在页面左侧的导航栏，选择即时通讯 > 服务概览，在服务版本区域中单击升级版本，进入即时通讯 IM 服务版本购买页面。

在页面左侧的导航栏，选择即时通讯 > 功能配置 > 功能配置总览，点击各功能的操作一栏中的升级或增值服务。

在即时通讯IM 服务版本页面，根据业务实际需求选择所需的服务版本和可选增值服务。该页面的配置参数说明如下表所示：

参数项	描述
选择要开通服务的 Appkey	请确认 App Key 是否选择正确，购买后无法修改。
请选择服务版本	服务版本的选择如下： - 当 App Key 为免费版时，可购买专业版、旗舰版或尊享版，不可单独购买增值服务。 - 当 App Key 为专业版时，可购买旗舰版、尊享版或单独购买增值服务。 - 当 App Key 为旗舰版时，可购买尊享版或单独购买增值服务。 - 当 App Key 为尊享版时，仅支持单独购买增值服务。
可选增值服务	请根据实际需求选择增值功能： - 单个群成员数上限和单个用户可加入群组数上限：不支持叠加购买；以单个群成员数上限举例说明，如果旗舰版购买了 8000 人/群的增值服务，则表示单个群成员上限配置提升至 8000 人/群。 - 消息云存储时长和 REST API 接口调用频率上限：支持可叠加购买，即支持多倍购买；以消息云存储时长举例说明，如购买时选择了 10 份，则表示消息云存储时长延长 300 天（30 天*10）。

提示

服务购买页显示的预估费用仅用于做参考，预估费用仅包含基础费用，具体费用以每月账单为准。

勾选我已阅读并同意《环信云服务购买协议》。
核对所选服务信息，单击立即购买即生成订单。

购买成功后即刻生效，当天开始计费，每月 1 号自动扣除上月总消耗费用。

#获取环信即时通讯 IM 的信息

在环信即时通讯云控制台，你可以查看你的环信即时通讯 IM 服务的如下信息：

#查看和配置功能

创建应用后，参照以下步骤在环信即时通讯云控制台上查看环信即时通讯 IM 服务的详情以及进行配置。

在环信即时通讯云控制台的首页的应用列表中，点击目标应用的操作栏中的查看按钮，在左侧导航栏选择即时通讯 > 功能配置 > 功能配置总览，您可以查看到当前 App Key 的服务配置并根据实际业务需求管理相关配置，具体操作说明如下：

免费开通：指该功能当前服务版本里已包含，可根据实际业务需求选择是否开通；点击免费开通，则可立即开通该功能；
设置：指该功能已开通且有需要设置的配置项，点击设置，即可进入对应设置页配置；
升级：功能如果当前服务版本中不包含、或需要提高功能状态中的参数值，则可点击升级，购买升级至符合业务需求的服务版本即可；
增值服务：点击增值服务，进入增值服务购买页面，根据实际需求选择购买。

#设置消息撤回（REST & 客户端）

在环信即时通讯云的左侧导航栏中，选择即时通讯 > 功能配置 > 功能配置总览。在功能配置总览页面的基础功能页签下，搜索找到消息撤回（REST&客户端），单击右侧的设置（已开通状态下）。
在弹出的消息撤回时间设置对话框中，设置消息可撤回时长。端消息撤回时长和 REST 消息撤回时长均不能超过 7 天。
单击确定保存配置。

#配置推送证书

使用离线推送通知之前，需完成各平台的证书配置。当前支持以下平台：苹果 APNs、谷歌 FCM、华为、小米、OPPO、VIVO 和魅族。

开启环信即时通讯 IM 服务后，按照以下步骤添加消息推送证书：

在环信即时通讯云控制台首页的应用列表中，在目标应用的操作栏中，点击查看。

在左侧导航栏，选择即时通讯 > 功能配置 > 消息推送 > 证书管理，进入证书管理页面。

点击添加推送证书按钮，打开添加推送证书对话框。

在添加推送证书对话框中，填写各厂商平台的相关推送信息，点击保存按钮，完成证书配置。

#配置消息回调

环信即时通讯 IM 提供消息回调服务。配置回调后，应用服务器会收到所选类型的消息和事件。

购买环信即时通讯 IM 服务后，按照以下步骤添加消息回调证书：

在环信即时通讯云控制台首页的应用列表中，在目标应用的操作栏中点击查看。

在左侧导航栏，选择即时通讯 > 功能配置 > 消息回调，进入消息回调页面。

点击添加回调地址按钮，打开回调配置对话框。

在回调配置对话框中，填写回调相关配置信息，点击保存按钮，完成回调配置，具体配置内容说明见回调配置。

#敏感词设置

在环信即时通讯云的左侧导航栏中，选择即时通讯 > 功能配置 > 功能配置总览。在功能配置总览页面的基础功能页签中搜索找到敏感词，单击右侧的设置（已开通状态下），打开敏感词配置页面。
在敏感词配置页面，单击服务设置旁边的编辑，在弹出的敏感词服务对话框中，按需求选择对应设置。
单击确定保存配置。

#REST-IP 白名单设置

#添加 IP 白名单

在环信即时通讯云的左侧导航栏中，选择即时通讯 > 功能配置 > 功能配置总览。在功能配置总览页面的基础功能页签中搜索找到 REST-IP 白名单，单击右侧的设置（已开通状态下），打开安全配置页面。
在安全配置页面，单击添加IP，在弹出的添加 IP 对话框中，输入 IP 地址。

提示

每次只能输入 1 个 IP 地址，最多可添加 8 个。
添加 IP 地址成功后 10 分钟后生效。
若白名单列表为空，则所有 IP 地址均可发 REST 消息。

单击保存完成配置。

#删除 IP 白名单

如果你不再允许某个 IP 地址继续发送 REST 消息，可以在 IP 白名单中将其删除。如果你删除了 IP 白名单中所有 IP，即白名单列表为空，则默认所有 IP 地址均可发送 REST 消息。

在环信即时通讯云的左侧导航栏中，选择即时通讯 > 功能配置 > 安全配置。
在 IP白名单列表中，单击目标 IP 右侧的删除。

单击确认，则删除该 IP 地址。

#账户中心

登录环信即时通讯云控制台，选择费用中心 > 账户中心，可查看你当前的账户余额和支出明细。

#查看订单记录

登录环信即时通讯云控制台，选择费用中心 > 订单中心，可查看你当前的所有订单记录。

订单中心页面上的订单状态说明如下：

开通中：用户生成订单后，需要 3-5 分钟完成功能配置。此时订单显示为开通中状态，表示购买的服务正在配置；配置完成后，订单变为服务中状态。
服务中：表示当前订单中购买的服务在使用中。同一 App Key 同时仅能有 1 个服务版本的订单状态为服务中。
已完结：表示当前订单中购买的服务已关闭。当客户升级新服务后，原服务版本订单和相关增值服务订单均会自动关闭，变为已完结状态。

点击操作栏中的详情，可查看订单详情。

#查看账单记录

登录环信即时通讯云控制台，选择费用中心 > 消费账单，可查看你当前的已生成的账单记录。

相似文档

环信IM即时通讯 - 请求质量概览
请求质量概览模块提供质量数据的阶段性分析，帮助你掌握用量变化趋势、跟踪产品质量情况：自动采集、处理和存储多个用量和质量指标的数据，数据延时为 1 小时。支持查看终端 SDK API 和服务器端 RESTful API 调用的请求次数、请求成功率和平均时延等。
什么是环信MQTT消息云服务？及其应用场景
环信MQTT消息云，是一款面向移动互联网、物联网领域的公有云服务。基于MQTT订阅/发布模型、QoS等级、保活机制、持久化等消息协议特性，提供一种低延迟、高并发、高可靠的通用消息传递服务。开发者只需要在自身应用或设备中搭建MQTT客户端，即可快速连接环信MQTT消息云，轻松实现消息通信。
环信MQTT消息云服务的功能
千万级设备接入：支撑千万级设备在线连接，消息毫秒级到达，为端、云提供快速稳定的双向通讯能力。标准规范传输协议：支持包含 MQTT、MQTT over TCP、MQTT over TLS、MQTT over WS、MQTT over WSS在内的多种通信协议接入，覆盖各类行业应用。
环信MQTT消息云服务的优势
全语言平台：采用标准开放的消息协议，支持30多种开发语言，10余种SDK（SDK大小可压缩至100K），标准的REST API 接口，任何应用/设备/服务器5分钟即可快速连接环信MQTT消息云实现消息传递。性能稳定：弹性集群部署，无上限用户数量，支持千万级消息实时送达，云服务集群保障SLA可达99.9%，确保业务稳定运行。
环信MQTT消息云服务 - 新功能发布记录
本文介绍了每次发布涉及的新增功能、功能优化、重要问题修复及对应的文档，帮助您了解服务的发布动态。 2022-03-07，优化文档内容：优化各端demo获取token流程（原有获取方式仍支持），优势： 1、没有注册100个用户限制； 2、新获取到token位数较短，适用于有token字符限制的设备使用；