如何开启消息推送

前提条件

如果使用消息推送功能，用户需准备消息推送接口，接口规格请参见消息推送接口规格。接口开发完成后，需向系统管理员提出申请，将消息推送地址{baseUrl}/webhooks/v1/messages加入地址白名单。

若{baseUrl}为https协议时，还需自备认证证书，目前只支持“JKS”、“DER”、“PEM”类型的证书。

http协议有安全风险，推荐使用安全的https协议。

当消息推送地址开启了双向认证，还需自备当前系统身份证书。

背景信息

• 当前仅支持Web、WhatsApp渠道。

  其中，WhatsApp渠道，系统会自动推送消息，无需手动配置。

• 消息推送密钥，由消息推送方提供，当其有变更时，AICC侧需要同步修改，可参考下面操作步骤输入修改后的消息推送密钥即可。

操作步骤

1. （可选）上传推送地址信任证书和系统身份证书，若{baseUrl}为https协议时，需要进行如下操作。
   1. 进入“配置中心 > 系统管理 > 证书管理”页面。
   2. 单击“新建”，根据界面提示输入证书编码、证书密码。
   3. 选择待上传证书类型。
   4. 单击，选择本地信任证书和身份证书，单击“打开”。
   5. 单击“保存”，完成配置。

2. 进入Web渠道配置页面。
3. 单击，打开消息推送开关。
4. 输入提前准备的消息推送地址，此处只需填写{baseUrl}。
5. 上传证书。推送地址为https时需要执行该步骤。
   1. （可选）单击信任证书，选择步骤1中上传的证书。
   2. （可选）单击身份证书，选择步骤1中上传的证书。

6. 选择认证方式，支持签名认证和OAuth认证。
   • 若选择签名认证，表示将消息直接推送给客户，还需配置如下参数：

     消息推送密钥：长度为43位且只能包含字母A-Z,a-z,数字0-9。

   • 若选择OAuth认证，表示将消息推送给APIFabric，由APIFabric将消息推送给客户，还需配置如下参数：

     App标识：请联系系统管理员在“在线开发 > 接口管理 > APP服务 > APP管理”，找到订阅了pushMsg接口并绑定了待配置Web渠道租间的APP，获取APP标识填到此处。

     App密钥：请联系系统管理员在“在线开发 > 接口管理 > APP服务 > APP管理”，找到订阅了pushMsg接口并绑定了待配置Web渠道租间的APP，获取APP密钥填到此处。

7. 单击“下一步”，完成配置。