创建任务时发送消息【可选】

主要用于给待办接收人发送待办时，通过消息提醒接收人有待办任务需要处理；

门户表象

将通过对应的消息通道给用户发送待办提醒消息；

同时收件箱也将会有对应的收件箱消息；

流程动作

创建待办时，告知接口时候连带消息发送，同时告知需要发送的通道；

涉及接口

创建/更新任务

请求体

说明

请求体中省略内容详见推送任务至列表中请求体介绍

字段名	参数名	必填	类型	描述
新增任务信息	insertModel	*M	List<InsertModel>	新增信息（任务和申请）
是否发送消息 3.6.2.Beta1+	isSendMsg	O	integer	是否连带发送消息 0：否（默认） 1：是
消息通道 3.6.2.Beta1+	sendChannels	*M	String	发消息时的通道。通过 查看通道列表 接口获取返回的通道的wid，英文逗号分隔的通道主键字符串，isSendMsg=1时必填。
微信企业号消息类型 3.7.3.SP4+	wxSendType	O	String	当发送类型为微信企业号时此字段才会生效： text（文本消息，默认） textcard（文本卡片）
今日校园消息类型 3.8.1.SP4+	campusSendType	O	String	push(push消息类型),不填或者其它的就是普通的今日校园app消息

请求示例

{
    "insertModel": [
      ...
    ],
    "isSendMsg": 1,
    "sendChannels": "instanceId1,instanceId2"
}

Demo

待办通知场景

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
SimpleTaskAddRequest request = new SimpleTaskAddRequest();
SimpleTaskAddRequest.SimpleTaskAddModel model = new SimpleTaskAddRequest.SimpleTaskAddModel();
model.setTaskId("20240808");
model.setSceneCode("testCode1");
model.setSubject("test20240808");
model.setInitiatorId("xxx");
model.setServiceId("");
model.setServiceName("");
model.setProcessors(Arrays.asList(new Processor("user01")));
model.setPcViewUrl("http://www.pc.url");
model.setH5ViewUrl("http://www.h5.url");
request.setSimpleTaskAddModelList(Arrays.asList(model));
request.setIsSendMsg(1);
request.setSendChannels("instanceId1,instanceId2");
request.setWxSendType(WxSendType_Constants.TEXT_CARD);
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
//.....
}

待办审批场景

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
SaveOrUpdateRequest request = new SaveOrUpdateRequest();
request.setIsSendMsg(1);
request.setSendChannels("instanceId1,instanceId2");
request.setWxSendType(WxSendType_Constants.TEXT_CARD);
// 发起任务
InsertModel insertModel = new InsertModel();
insertModel.setTaskId("2024071703");
insertModel.setSceneCode("testCode1");
insertModel.setInitiatorId("user01");
insertModel.setInitiatorType(ProcessorType.USER_ACCOUNT);
insertModel.setSubject("test主题");
insertModel.setProcessors(Arrays.asList(new Processor("user03"), new Processor("user04")));
insertModel.setServiceId("xxx");
insertModel.setServiceName("xxx");
insertModel.setNodeId("002");
insertModel.setNodeName("002");
insertModel.setPcViewUrl("http://www.pc.url");
insertModel.setH5ViewUrl("http://www.h5.url");
insertModel.setProcessInstanceImgUrl("");
insertModel.setProcessInstanceRecordUrl("");
insertModel.setPrevProcessor("user02");
// 任务关联的申请信息
ApplicationModel applicationModel = new ApplicationModel();
applicationModel.setProcessInstanceId("20240717");
applicationModel.setSubject("申请主题");
applicationModel.setProcessInstanceStatus(ProcessInstanceStatusType.RUNNING);
applicationModel.setProcessors(Arrays.asList(new Processor("user03"), new Processor("user04")));
applicationModel.setPcViewUrl("http://www.pc.url");
applicationModel.setH5ViewUrl("http://www.h5.url");
applicationModel.setNodeId("002");
applicationModel.setNodeName("002");
applicationModel.setNodeList(Arrays.asList(new ApplicationModel.Node("001", "001")
, new ApplicationModel.Node("002", "002"), new ApplicationModel.Node("003", "003")));
insertModel.setApplicationModel(applicationModel);
request.setInsertModel(Collections.singletonList(insertModel));
BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
//.....
}