开启和配置即时通讯服务

使用即时通讯 IM 前，你需要在声网控制台开启并配置即时通讯服务。

前提条件

开启即时通讯服务前，请确保已经具备以下条件：

• 有效的声网开发者账号。
• 已启用的鉴权方式为 APP ID + Token (推荐) 的声网项目。
• 已订阅即时通讯套餐包。关于如何订阅即时通讯套餐包，详见订阅即时通讯套餐包。

开启即时通讯 IM 服务

参考以下步骤，在声网控制台开启即时通讯服务：

1. 登录声网控制台，点击左侧导航栏项目管理。

2. 选择需要开通即时通讯服务的项目，点击配置。

3. 在服务配置页面，点击即时通讯中的配置链接。

如果你未订阅套餐包，你会看到弹窗提示订阅套餐包，点击订阅进入套餐包订阅页面。关于如何订阅套餐包，详见订阅即时通讯套餐包。

4. 仔细阅读弹窗提示，根据你的应用服务器所在区域选择即时通讯服务的数据中心，点击启用。成功开启即时通讯服务后，启用按钮会切换为配置按钮，用于配置即时通讯。

获取即时通讯项目信息

声网控制台会给每个开启即时通讯服务的项目分配以下项目信息：

• OrgName：即时通讯服务分配给每个企业（组织）的唯一标识。

• AppName：即时通讯服务分配给每个应用的名称。每个企业（组织）的应用名称唯一。

• AppKey：即时通讯服务分配给每个应用的唯一标识。App Key 的生成规则为 ${OrgName}#{AppName}。

• 数据中心：针对不同的业务覆盖区域，即时通讯 IM 提供多个数据中心选择。

• 访问域名：即时通讯服务分配的 WebSocket 和 RESTful API 请求地址域名。

参考以下步骤获取上述项目信息：

1. 在声网控制台的项目管理页面，选择需要开通即时通讯服务的项目，点击配置。
2. 在服务配置页面，点击即时通讯中的配置链接。
3. 在基本信息 > 应用信息页面，获取 OrgName、AppName、AppKey、数据中心和访问域名。

添加消息推送证书

发送消息推送前，需要配置各平台的推送证书。当前支持平台：苹果、谷歌 FCM、华为、小米、OPPO、魅族和 VIVO。详见设置消息推送。

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

1. 在声网控制台的项目管理页面，选择需要开通即时通讯服务的项目，点击配置。
2. 在服务配置页面，点击即时通讯中的配置链接。
3. 选择功能配置 > 推送证书，点击添加推送证书。

4. 在弹出的添加推送证书对话框内填写各平台消息推送所需的证书名称、推送密钥等信息，然后点击保存。

添加消息回调地址

即时通讯提供消息回调服务，配置回调后，你的应用服务器会收到所选类型的消息和事件。详见设置 HTTP 回调。

1. 登录声网控制台，在项目管理页面，选择需要开通即时通讯服务的项目，点击配置。

2. 在服务配置页面，点击即时通讯中的配置链接。

3. 在功能配置 > 总览页面的消息功能区域开启消息回调。

4. 在功能配置 > 消息回调页面，单击添加回调规则。

5. 在回调配置对话框中，填写回调相关配置信息，点击保存，完成回调配置。关于回调配置，详见配置回调规则。