消息推送

1. 功能简介

消息推送可以将简道云中的待办通知、消息通知、抄送通知等消息同步到自己的服务器，便于企业的业务整合。

2. 推送服务器配置方法

2.1 配置入口

点击右上角头像，进入「企业管理 >>消息推送」，开启消息推送的开关：

2.2 服务器配置

点击「配置」，进入消息推送的配置页面，填写服务器地址后，可通过「服务器连接测试」测试连接是否成功，点击「生成 Secret」，即可自动生成消息推送的 Secret，设置好后点击「保存」：

3. 推送数据结构说明

数据样例如下：

{
    op: "flow_message", //推送事件
    data: {
        to: [{
            username: "jiandaoyun",
            name: "小云"    
        }],
        entry_name: "请假审批",
        notify_text: "小云本周五请假1天",
        url: "https://abc.com/xyz"
    }, //推送内容
    send_time: "2017-10-20T22:41:51.430Z" //推送时间
}

4. 推送事件

4.1 表单自定义时间提醒

4.1.1 配置方式

进入表单「扩展功能 >> 推送提醒」，点击「新建推送提醒」，填写好「自定义时间提醒」的提醒内容，在提醒方式处勾选「推送至我的服务器」：

4.1.2 推送内容

4.1.3 推送数据样例

{
	op: "form_schedule_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}, {
				username: "dao",
				name: "小道"
			}
		],
		entry_name: "请假审批",
		notify_text: "小云提出请假申请，请审批",
		url: "https://jiandaoyun.com/app/1/entry/2"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}

4.2 表单新数据提交提醒

4.2.1 配置方式

进入表单「扩展功能 >> 推送提醒」，点击「新建推送提醒」，填写好「新数据提交时提醒」的提醒内容，在提醒方式处勾选「推送至我的服务器」：

4.2.2 推送内容

4.2.3 推送数据样例

{
	op: "data_create_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}, {
				username: "dao",
				name: "小道"
			}
		],
		entry_name: "请假审批",
		notify_text: "小云提出请假申请，请审批",
		content: "请假人: 小云\n请假原因: 病假",
		url: "https://jiandaoyun.com/message/1/data"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}

4.3 表单数据修改后提醒

4.3.1 配置方式

进入表单「扩展功能 >> 推送提醒」，点击「新建推送提醒」，填写好「数据修改后提醒」的提醒内容，在提醒方式处勾选「推送至我的服务器」：

4.3.2 推送内容

4.3.3 推送数据样例

{
	op: "data_update_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}
		],
		entry_name: "请假审批",
		notify_text: "小云修改了请假日期",
		content: "修改人: 小云\n数据标题: 病假申请\n请假日期: 2018-5-1→2018-5-2",
		url: "https://jiandaoyun.com/dashboard/app/1/form/2/data/3/qr_link"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}

4.4 根据表单内日期时间字段提醒

4.4.1 配置方式

进入表单「扩展功能 >> 推送提醒」，点击「新建推送提醒」，填写好「根据表单内日期时间字段提醒」的提醒内容，在提醒方式处勾选「推送至我的服务器」：

4.4.2 推送内容

4.4.3 推送数据样例

{
	op: "form_widget_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}
		],
		entry_name: "生日提醒",
		notify_text: "小云的生日到了",
		content: "小云的生日到了",
		url: "https://jiandaoyun.com/dashboard/app/1/form/2/data/3/qr_link"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}

4.5 表单流程消息提醒

当流程发起、抄送、转交、回退、超时、激活、调整负责人时，都会给当前流程负责人推送流程提醒信息。

4.5.1 配置方式

进入流程表单的「流程设定」，在「流程属性 >> 流程提醒」处勾选「推送至我的服务器」：

4.5.2 推送内容

不同的流程操作（flow_action）对应不同的推送内容，具体如下表所示：

4.5.3 新旧流程消息推送时变化

1）新旧流程消息推送时to的变化

{
    "data": {
      "content": "",
      "entry_name": "旧版流程推送测试",
      "flow_action": "flow_forward",
      "notify_text": "有新的流程待办事项",
      "to": [
        {
          "name": "张三",
          "username": "zhangsan"
        },
        {
          "name": "李四",
          "username": "lisi"
        },
        {
          "name": "王五",
          "username": "wangwu"
        }
      ],
      "url": "https://www.jiandaoyun.com/dashboard/app/642e37f2374e1b0007f537b2/form/642e37f5fe736900073a99e5/data/642e3855dd27960007cf9514?actionType=flow_forward&flowId=1&memberType=0&guestCorpId="
    },
    "op": "flow_message",
    "send_time": "2023-04-06T03:11:18.102Z"
}

{
    "data": {
      "content": "",
      "entry_name": "新版流程推送测试",
      "flow_action": "flow_forward",
      "notify_text": "有新的流程待办事项",
      "to": [
        {
          "name": "张三",
          "username": "zhangsan"
        }
      ],
      "url": "https://www.jiandaoyun.com/message/redirect?msg=task_inst%3A%3A%3A%3A%3A&instanceId=642e38acd039d000080c637b&taskId=642e38acd039d000080c63a3&actionType=flow_forward&appId=63b62c3d0c76a3000a0bf8a6&dataId=642e38acd039d000080c637b&flowId=3&formId=63b62c3fa76046000a36d412&memberType=0&guestCorpId="
    },
    "op": "flow_message",
    "send_time": "2023-04-06T03:12:44.991Z"
}

{
    "data": {
      "content": "",
      "entry_name": "新版流程推送测试",
      "flow_action": "flow_forward",
      "notify_text": "有新的流程待办事项",
      "to": [
        {
          "name": "李四",
          "username": "lisi"
        }
      ],
      "url": "https://www.jiandaoyun.com/message/redirect?msg=task_inst%3A%3A%3A%3A%3A&instanceId=642e38acd039d000080c637b&taskId=642e38acd039d000080c63a3&actionType=flow_forward&appId=63b62c3d0c76a3000a0bf8a6&dataId=642e38acd039d000080c637b&flowId=3&formId=63b62c3fa76046000a36d412&memberType=0&guestCorpId="
    },
    "op": "flow_message",
    "send_time": "2023-04-06T03:12:44.991Z"
}

{
    "data": {
      "content": "",
      "entry_name": "新版流程推送测试",
      "flow_action": "flow_forward",
      "notify_text": "有新的流程待办事项",
      "to": [
        {
          "name": "王五",
          "username": "wangwu"
        }
      ],
      "url": "https://www.jiandaoyun.com/message/redirect?msg=task_inst%3A%3A%3A%3A%3A&instanceId=642e38acd039d000080c637b&taskId=642e38acd039d000080c63a3&actionType=flow_forward&appId=63b62c3d0c76a3000a0bf8a6&dataId=642e38acd039d000080c637b&flowId=3&formId=63b62c3fa76046000a36d412&memberType=0&guestCorpId="
    },
    "op": "flow_message",
    "send_time": "2023-04-06T03:12:44.991Z"
}

1）新旧流程消息推送时url的变化

新版地址相较旧版地址差别如下所示：

4.6 仪表盘定时提醒

4.6.1 配置方式

进入仪表盘的「仪表盘设计」，点击设置「定时提醒」，设置好提醒内容后，在提醒方式处勾选「推送至我的服务器」：

4.6.2 推送内容

4.6.3 推送数据样例

{
	op: "dash_schedule_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}
		],
		entry_name: "物料盘点",
		notify_text: "2019年度物料盘点的时间到了",
		url: "https://jiandaoyun.com/app/1/entry/2"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}

4.7 仪表盘预警提醒

4.7.1 配置方式

进入统计表的编辑页面，在「功能配置 >> 数据预警」处添加预警，设置好预警内容后，在提醒方式处勾选「推送至我的服务器」：

4.7.2 推送内容

4.7.3 推送数据样例

{
	op: "dash_alert_message",
	data: {
		to: [
			{
				username: "jian",
				name: "小简"
			}
		],
		entry_name: "库存统计",
		notify_text: "库存警告",
		content: "预警来源：库存应用>华南区盘点>库存剩余量",
		url: "https://jiandaoyun.com/app/1/entry/2"
	},
	send_time: "2017-10-20T22:41:51.430Z"
}