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)

results matching ""

    No results matching ""