[关闭]
@myyzs 2017-11-01T08:53:56.000000Z 字数 1520 阅读 41

待办中心消息内部接入文档(移动审批、管理简讯等应用)

概述

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

消息集成

发送消息

接口地址:

/api/message/send?access_token=MjAwMDAuMWY1NWRiMzI5Zjg1ZTcwODlkZWI1ZmU1ZGVlNTJlYzFhNmEwMmM3Yy4xNDQwNDkxOTQx

此处的access_token和之前各个应用调用发消息的接口时用的access_token一致就行了

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

  1. {
  2. "tenantid": "my56a9c966df069",
  3. "touser": "mysoft59b6664399333645882372",
  4. "appcode": "3023",
  5. "msgtype": "oa",
  6. "extra": {
  7. "to_app_code": "10001",
  8. "biz_type": 0
  9. },
  10. "mark": [
  11. {
  12. "bgcolor": "0000FF",
  13. "text": "帅"
  14. }
  15. ],
  16. "oa": {
  17. "message_url": "https://m.baidu.com/",
  18. "body": {
  19. "title": "中午吃了顿好的",
  20. "content": "这是一条优美的测试消息",
  21. "author": "初良详",
  22. "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"
  23. }
  24. }
  25. }

参数说明

参数 描述
tenantid 必须有,租户ID
touser 必须有,获取到的openid(多个接收者用竖线分隔)
appcode 必须有,原始发送方的应用code
msgtype 必须有,消息类型,待办中心只支持oa
to_app_code 必须有,待办中心code,固定为10001
biz_type 必须有,消息业务类型,0待审1待阅
mark.bgcolor 标签的颜色
mark.text 标签的文本
message_url 消息跳转地址
oa.body.title 消息体的标题
oa.body.content 消息体的内容,最多显示3行
oa.body.author 自定义的作者名字
oa.body.author_avator 自定义的作者头像

更新消息状态

接口地址:

/api/todo-center/update-msg-status?access_token=MjAwMDAuMWY1NWRiMzI5Zjg1ZTcwODlkZWI1ZmU1ZGVlNTJlYzFhNmEwMmM3Yy4xNDQwNDkxOTQx

post参数

  1. {
  2. "tenant_id": "@tenant_id",
  3. "msg": [
  4. {
  5. "openid": "openid",
  6. "biz_id": "",//业务ID
  7. "todo": 1//是否已办
  8. }
  9. ]
  10. }

返回值

  1. {
  2. "success": 1,
  3. "data": {
  4. "code": 1,
  5. "message": "ok"
  6. }
  7. }
添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注