如何开启消息对接功能

在集成过单点登录的前提下(基于 企业微信钉钉Welink飞书组织架构同步API 集成等同于开启过单点登录),明道云系统支持将应用消息推送给外部系统,当然也可以由明道云团队定制开发与外部系统的消息接口对接【定制开发则需另收费】。

主动接收明道云应用消息的启用方式如下:

  1. 如果非基于 企业微信、钉钉、Welink、飞书、组织架构同步API 集成,则需要提前挂载以下配置文件:

    /data/mingdao/script/volume/sso/extend.json

    {
      "relation": true
    }
    

    微服务应用对应的 docker-compose.yaml volumes 中增加:

    - ./volume/sso/extend.json:/usr/local/MDPrivateDeployment/sso/extend.json
    
  2. 创建接收应用消息所需的配置文件

    /data/mingdao/script/volume/integrate/appextensions.json

    {
      "WebhookUrl": "接收消息的 API 接口地址", // 必填,如:https://api.domain.com/hooks/NjA0NzdjMDNjMGFjMTE3ZGUwMjRjN2Nl
      "WebhookHeaders": {}  // 请求头自定义参数,可选
    }
    

    消息体格式如下:(POST application/json)

    {
      "message": "消息内容",
      "messageType": 11,  // 11:工作表系统消息,12:工作表讨论提到消息,13:工作表讨论回复我的,14:工作流待处理消息,15:工作流系统消息
      "appId": "应用Id",
      "appName": "应用名称",
      "attachments": ["附件地址|附件名"], // 图片类型可直接使用、文档类型目前只能作为附件数量提醒(无法直接下载)
      "redirectUrl": "跳转地址",   //  对应明道云系统内的消息处理落地页
      "targets": ["用户Id"] // 单点登录中的第三方用户Id
    }
    
  3. 挂载配置文件

    微服务应用对应的 docker-compose.yaml volumes 中增加:

    - ./volume/integrate/appextensions.json:/usr/local/MDPrivateDeployment/integrate/appextensions.json
    
  4. 重启明道云微服务应用

results matching ""

    No results matching ""