应用上线
大约 3 分钟
console
应用上线
测试版应用开发测试完成后,可申请上线为正式版,用于正式业务运营。
上线准备
申请上线应用前,请确认以下条件均已满足:
- 当前应用仍为 测试版,且尚未生成正式版。
- 测试版已 开通 IM 专业版或旗舰版套餐包。
- 已明确测试版中已开通的套餐、扩展功能与增值服务在正式版中是否保留。
- 账号已完成 实名认证。
上线步骤
- 登录 环信控制台,在页面上方选择 应用管理,或在首页 应用概览 区域选择 应用管理。

- 在 应用列表 页面,找到目标测试版应用,在 操作 栏点击 申请上线。

- 在 申请上线 对话框中,根据业务需求选择上线方式。建议先查看文档中的 上线事项对照表,再明确上线方式。
| 上线方式 | 适用场景 |
|---|---|
| 原测试版应用直接升级为正式版 | 希望保留测试数据。 |
| 创建新的正式版应用 | 希望测试环境和正式环境隔离。 |
选定方式后,按需填写正式版应用信息:
| 项 | 创建新的正式版应用 | 原测试版应用直接升级成正式版 |
|---|---|---|
| 测试版应用信息 | 确认测试版应用的 AppName、Appkey 和数据中心。 | 确认 AppName、Appkey 和数据中心。 |
| 正式版应用信息 | 填写正式版应用的 AppName、Appkey 和数据中心。 - 字段说明详见 创建应用文档。 | 无需填写。 |
| 正式版费用信息 | 确认上线后的费用信息。 | 确认上线后的费用信息。 |
确认或填写正式版应用信息后,点击 付费并上线。
提示
- 上线过程通常需要 5—15 分钟。
- 上线期间无法修改测试版和正式版的应用信息及功能配置。
- 请收到短信或邮件通知后再进行后续操作,避免影响业务。

- 系统弹出 申请上线 确认框,点击 确认。

系统提示 上线申请已提交,点击 我知道了。
上线成功后,你将收到短信及邮件通知。收到通知后再进行后续操作。

- 上线完成后,在应用列表中确认以下信息:
- 应用状态 为 已上线。
- AppKey-正式版 项中显示正式版 App Key。若选择 原测试版应用直接升级成正式版,则上线后 AppKey-测试版 项中为空。

上线事项
| 上线事项 | 创建新的正式版应用 | 原测试版应用直接升级 |
|---|---|---|
| 客户端与服务端配置(AppName / AppKey / URL) | 需要变更。 - 更新客户端 SDK 初始化配置中的正式版 AppKey。- 更新服务端请求地址中的 {app_name}。 | 无需操作。 |
| 功能配置 | 同步:测试版功能配置自动同步到新正式版。 | 继承:完整继承测试版全部功能配置。 |
| 业务数据 | 隔离:测试版与正式版数据完全隔离,不互通。 | 继承:完整继承测试版全部存量业务数据。 |
| 应用备案(仅国内) | 若应用所在地为中国,需及时完成 应用备案。 | 同左。 |
| 增值服务计费与订阅 | - 内容审核、消息翻译 和 即时推送:若测试版已开通,上线后继续生效,并按正式版规则计费。 - 实时音视频:即使测试版已开通,上线后也不会自动保留,如需继续使用,仍需单独订阅。 | 同左。 |
| 环境配置检查(回调地址 / IP 白名单) | - 检查 发送前/发送后回调地址,按需切换为正式环境。 - 检查 REST IP 白名单,按需在正式版重新设置。 | 无需操作。 |
