1. 概述

“待办中心”是一个全新的应用，它可以接收所有待办类型的消息，应用调用相应的推送接口，可以向“待办中心”推送消息。待办中心的消息分为“待审”、“待阅”两类。“待审”类型的消息，需要进行相应的业务动作之后（这个由业务场景自己决定，我们提供了更新状态的接口），才会变成已办状态。“待阅”类型的消息，只要用户点击阅读之后，就会自动变为已办状态。

2. 消息集成

2.1. 获取access_token

获取access_token，请参考这里

2.2. 设置应用，将消息推送到待办中心

登录企业平台，切换到应用中心，找到应用，进入到应用设置界面，设置如下图所示

2.3. 发送消息

发送消息，请参考这里

注意：往待办中心发消息，必须遵循以下格式,并且只支持OA类型

{
    "touser": "39e1a4b4-a76c-e02a-0479-82d17a225f90",
    "agentid": "rental",
    "msgtype": "oa",
    "biz_id":"@biz_id",
    "extra": {
        "biz_type": 0
    },
    "mark": [
        {
            "bgcolor": "0000FF",
            "text": "帅"
        }
    ],
    "oa": {
        "message_url": "https://m.baidu.com/",
        "body": {
            "title": "中午吃了顿好的",
            "content": "这是一条优美的测试消息",
            "author": "初良详",
            "author_avator": "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1508323110&di=615b2a71fe477e162341c77fa85cb019&imgtype=jpg&er=1&src=http%3A%2F%2Fu1.tdimg.com%2F2%2F77%2F114%2F_127201209595861056372327234675946761312.jpg"
        }
    }
}

参数说明

参数	描述
touser	必须有，异构系统组织用户guid，多个用户用“竖线”隔开
agentid	必须有，第三方应用code，参考[注册应用,third_app_code字段](suite-app-create.html#注册应用
msgtype	必须有，消息类型，待办中心只支持oa
biz_type	消息业务类型，0：待审，1：待阅,不传默认为待阅
biz_id	消息业务id，用来刷新消息状态，待审类型的请务必传biz_id字段，刷新消息状态会用到
mark.bgcolor	标签的颜色
mark.text	标签的文本
message_url	消息跳转地址
oa.body.title	消息体的标题
oa.body.content	消息体的内容，最多显示3行
oa.body.author	自定义的作者名字
oa.body.author_avator	自定义的作者头像

效果

2.4. 更新消息状态

接口地址：

/api/open1/update-msg-status?access_token=ACCESS_TOKEN

post参数

{
    "msg": [
        {
            "user_guid": "@user_guid", //异构系统组织用户guid
            "biz_id": "",//业务ID
            "todo": 1//是否已办  0：未办 1：已办
        }
    ]
}

返回值格式

成功

{      
    "errcode": 0,     
    "errmsg": “ok”
}

失败

{      
    "errcode": 10,     
    "errmsg": “错误信息”
}

备注

errcode 等于0是成功，其他值为失败code

待办中心