4.4 企业微信消息发送接口
4.4.1 请求方式
POST
4.4.2 接口URL(提供http以及https,根据实际情况选其一)
http连接:http://10.150.11.22:8281/weichat/v1.0/mpTemplateMessage/sendMessage
https连接:https://10.150.11.22:8244/weichat/v1.0/mpTemplateMessage/sendMessage
4.4.3 接口参数
Header参数:
参数名称 | 参数类型 | 是否可为空 | 说明 |
---|---|---|---|
Authorization | String | N | 参数值为: “Bearer”+英文空格+token 其中token为接口4.2中返回的access_token |
Body参数:
参数名称 | 参数类型 | 是否可为空 | 说明 |
---|---|---|---|
touser | String | N | 推送用户集合: 多个用户逗号隔开 |
toparty | String | N | 部门集合: 部门编号集合,多个逗号隔开,如果使用此参数则必须跟上下方的 接收者类型(userTypes) |
msgType | String | N | 消息类型(请选择以下值): ENTER 企业短信 |
senderName | String | N | 发送者名字: 系统名 用户名 |
senderId | String | N | 发送者id: 系统id 用户账号 |
content | json | N | 消息主体(json字符串) |
template | String | N | 模板id |
subId | String | N | 系统id(一站式系统id,联系运维人员获取) |
userTypes | String | Y | 接收者类型(请选择一下值-可多选): 管理员:1 学生:2 教师:3 兼职教师:4 新生:5 如需要发送给教师及兼职教师:(请以,分割),如:3,4 |
4.4.4 截图
4.4.5 返回结果说明
result:0,表示获取数据失败,1,表示获取数据成功 下个版本弃用
code0,表示获取数据失败,1,表示获取数据成功
msg:描述信息,若出现异常,则msg返回异常信息
data:Tasked:任务处理id
示例:
{
"result": 1,
"code": "1",
"msg": "消息发送成功",
"data": "XXXXXX"
}
4.4.5 说明
按照要求,企业微信分为两类消息,一类为通知消息,一类为待办消息
两类消息参数:
参数名称 | 参数说明 | 待办消息 | 通知消息 |
---|---|---|---|
touser | 推送用户集合 | 具体用户code | 具体用户code |
toparty | 部门集合 | 具体部门code | 具体部门code |
msgType | Str消息类型ing | ENTER | ENTER |
senderName | 发送者名字 | 系统名称 | 系统名称 |
senderId | 发送者id | 系统id | 系统id |
content | 消息主体 | json | json |
template | 模板id | 6e0a6256-d84c-461c-1234-38ea6eabc88a | 7a51fb8b-5922-4846-a812-c77e6dec4baa |
subId | 系统id | portal-web-todo | portal-web-msg |
userTypes | 接收者类型 | 用户类型 | 用户类型 |
待办消息content参数:
参数名称 | 参数说明 | 类型 | 值说明 |
---|---|---|---|
subName | 系统名称 | String(20) | 发送消息应用的名称 |
title | 标题 | String(44) | |
content | 内容 | String(160) | |
time | 日期 | date | yyyy-MM-dd HH:mm:ss |
remark | 备注 | String(200) | |
url | 地址 | String(250) |
通知消息content参数:
参数名称 | 参数说明 | 类型 | 值说明 |
---|---|---|---|
title | 标题 | String(44) | |
content | 内容 | String(160) | |
time | 时间 | date | yyyy-MM-dd HH:mm:ss |
remark | 备注 | String(200) | |
url | 地址 | String(250) |