更新时间:2024-05-11 GMT+08:00
分享

如何开启消息推送

前提条件

如果使用消息推送功能,用户需准备消息推送接口,接口规格请参见消息推送接口规格。接口开发完成后,需向系统管理员提出申请,将消息推送地址{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. 单击“下一步”,完成配置。
分享:

    相关文档

    相关产品