适用版本:v3.2.5+;
企业微信接收消息
创建应用
登录企业微信。应用管理——应用——自建——创建应用
填写信息:必填:应用logo、应用名称、可见范围;选填:应用介绍
点击创建应用后,创建完成
接口定义
互联企业的应用支持推送文本、图片、视频、文件、图文等类型。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/linkedcorp/message/send?access_token=ACCESS_TOKEN
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
各个消息类型的具体POST格式参考以下文档。
返回示例:
{
“errcode” : 0,
“errmsg” : “ok”,
“invaliduser” : [“userid1”,”userid2”,”CorpId1/userid1”,”CorpId2/userid2”], // 不区分大小写,返回的列表都统一转为小写
“invalidparty” : [“partyid1”,”partyid2”,”LinkedId1/partyid1”,”LinkedId2/partyid2”],
“invalidtag”:[“tagid1”,”tagid2”]
}注:
如果部分接收人无权限或不存在,发送仍然执行,但会返回无效的部分(即invaliduser或invalidparty),常见的原因是接收人不在应用的可见范围内。
文本消息:
请求示例:
{
“touser” : [“userid1”,”userid2”,”CorpId1/userid1”,”CorpId2/userid2”],
“toparty” : [“partyid1”,”partyid2”,”LinkedId1/partyid1”,”LinkedId2/partyid2”],
“totag” : [“tagid1”,”tagid2”],
“toall” : 0,
“msgtype” : “text”,
“agentid” : 1,
“text” : {
“content” : “你的快递已到,请携带工卡前往邮件中心领取。\n出发前可查看<a href="http://work.weixin.qq.com\">邮件中心视频实况,聪明避开排队。”
},
“safe”:0
}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
touser | 否 | 成员ID列表(消息接收者,最多支持1000个)。每个元素的格式为: corpid/userid,其中,corpid为该互联成员所属的企业,userid为该互联成员所属企业中的帐号。如果是本企业的成员,则直接传userid即可 |
toparty | 否 | 部门ID列表,最多支持100个。partyid在互联圈子内唯一。每个元素都是字符串类型,格式为:linked_id/party_id,其中linked_id是互联id,party_id是在互联圈子中的部门id。如果是本企业的部门,则直接传party_id即可。 |
totag | 否 | 本企业的标签ID列表,最多支持100个。 |
toall | 否 | 1表示发送给应用可见范围内的所有人(包括互联企业的成员),默认为0 |
msgtype | 是 | 消息类型,此时固定为:text |
agentid | 是 | 企业应用的id,整型。可在应用的设置页面查看 |
content | 是 | 消息内容,最长不超过2048个字节 |
safe | 否 | 表示是否是保密消息,0表示否,1表示是,默认0 |
注意
:linked_id为互联ID,此ID可以在管理后台-通讯录-互联企业-详情里查看
系统配置
在企业微信配置完成后,用户需在ibps系统【员工管理】添加企业微信账号,添加完成后,就可接收到消息。
例如:
Bella用户手机端接收到的催办消息