本文介绍毕升office v4版本中自定义消息推送的使用。
¶ 自定义消息推送
在毕升Office 系统中，管理员可以在设置界面中设置自定义消息推送的地址。当系统向用户发送消息且地址不为空时，如共享某文件给用户等，会向此地址发送POST请求，请求中包含消息内容和接收者信息。
如果用户的个人通知设置中关闭了自定义推送的接收，产生系统消息时，则不会推送此用户的消息信息。用户设置接收自定义消息时，产生的所有的系统消息都会发送到自定义推送地址中。
¶ 消息内容说明
以共享文件给某用户为例，向推送地址发送的消息数据如下：
{
"messageContent": { // 消息内容
"createTime": "2022-08-26T18:26:48.6759836+08:00", // 消息创建时间
"creatorId": "creatorID", // 消息创建者ID
"creatorUid": "creatorUID", // 消息创建者UID
"creatorTitle": "creatorTitle", // 消息创建者名称
"receiverId": "receiverID", // 消息接收者ID
"receiverUid": "receiverUID", // 消息接收者UID
"receiverTitle": "receiverTitle", // 消息接收者名称
"msgType": "msg_add_share", // 消息类型，当前为共享文件给用户，请参考msgType列表
"object": { // 消息中被操作的对象，此例中为被共享的文件
"objectType": "file",
"objectId": "fileID",
"title": "未命名文件.pptx"
},
"opt": null // 消息附加信息
}
}
¶ msgType列表
- msg_add_to_team_member - 添加团队成员
- msg_add_to_team_manager - 添加团队管理员
- msg_alter_team_member - 修改团队成员的身份 提示角色切换为opt中的role对象
- msg_remove_team_member - 移除团队成员
- msg_exit_team - 成员退出团队 通知团队管理员
- msg_add_share - 添加文件协作者
- msg_alter_share - 修改文件协作者权限
- msg_cancel_share - 移除文件协作者
- msg_exit_share - 协作者退出文件共享 通知共享的创建者
- msg_add_tag_share - 添加标签的共享成员
- msg_cancel_tag_share - 移除标签的共享成员
- msg_exit_tag_share - 共享成员退出标签的共享
- msg_editor_mentioned - 在Office批注中@了成员