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) |