1. 概述
“待办中心”是一个全新的应用，它可以接收所有待办类型的消息，应用调用相应的推送接口，可以向“待办中心”推送消息。待办中心的消息分为“待审”、“待阅”两类。“待审”类型的消息，需要进行相应的业务动作之后（这个由业务场景自己决定，我们提供了更新状态的接口），才会变成已办状态。“待阅”类型的消息，只要用户点击阅读之后，就会自动变为已办状态。
2. 消息集成
2.1. 获取access_token
获取access_token，企业自建应用 请参考这里
获取access_token，明源H5应用 请参考这里
2.2. 设置应用，将消息推送到待办中心
登录企业平台，切换到应用中心，找到应用，进入到应用设置界面，设置如下图所示
2.3. 发送消息
发送消息，请参考这里
注意：往待办中心发消息，必须遵循以下格式,并且只支持OA类型
{
"tenantid": "my56a9c966df069",
"touser": "mysoft59b6664399333645882372",
"touser_value_type": "openid",
"agentid": "3023",
"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"
}
}
}
参数说明
| 参数 | 描述 |
|---|---|
| tenantid | 租户ID(企业自建应用，明源H5，无需传此字段) |
| touser | 必须有，(openid或者user_code，多个接收者用竖线分隔) |
| touser_value_type | 非必填，默认值为'openid' 1、当'touser_value_type'='openid'时，表示上面的字段'touser'使用openid进行推送 2、当'touser_value_type'='user_code'时，表示上面的字段'touser'使用user_code进行推送（适用于第三方用户体系与云助手一致，user_code相同，无需做用户打通） |
| agentid | 应用code |
| 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. 更新消息状态
接口地址：
https://www.fdccloud.com/api/tenant-open/update-msg-status?access_token=ACCESS_TOKEN
post参数
{
"tenant_id": "@tenant_id",//企业自建，明源H5无需传此字段
"msg": [
{
"openid": "openid",
"biz_id": "",//业务ID
"todo": 1//是否已办 0：未办 1：已办
}
]
}
返回值格式
成功
{
"errcode": 0,
"errmsg": “ok”
}
失败
{
"errcode": 10,
"errmsg": “错误信息”
}
备注
- errcode 等于0是成功，其他值为失败code
2.5. 更新消息状态（通过user_code）
接口地址：
https://www.fdccloud.com/api/tenant-open/update-msg-status-by-usercode?access_token=ACCESS_TOKEN
适用于第三方用户体系与云助手一致，user_code相同，则无需获取云助手账号的openid。
post参数
{
"tenant_id": "@tenant_id",//企业自建，明源H5无需传此字段
"msg": [
{
"user_code": "meiy02",
"biz_id": "",//业务ID
"todo": 1//是否已办 0：未办 1：已办
}
]
}
返回值格式
成功
{
"errcode": 0,
"errmsg": “ok”
}
失败
{
"errcode": 10,
"errmsg": “错误信息”
}
备注
- errcode 等于0是成功，其他值为失败code