如何开启消息对接功能

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

主动接收HAP应用消息的启用方式如下：

如果非基于企业微信、钉钉、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
```

创建接收应用消息所需的配置文件

/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：工作流系统消息不发送记录
  "messageTypeV2": 11,  // 11：工作表系统消息，12：工作表讨论提到消息，13：工作表讨论回复我的，14：工作流待处理消息（填写、审批），15：工作流系统消息不发送记录，16：工作流系统消息发送记录
  "appId": "应用Id",
  "appName": "应用名称",
  "attachments": ["附件地址|附件名"], // 图片类型可直接使用、文档类型目前只能作为附件数量提醒（无法直接下载）
  "redirectUrl": "跳转地址",   //  对应 HAP 系统内的消息处理落地页
  "targets": ["用户Id"] // 单点登录中的第三方用户Id
}

挂载配置文件

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

- ./volume/integrate/appextensions.json:/usr/local/MDPrivateDeployment/integrate/appextensions.json

重启 HAP 微服务应用