作者:管理员  历史版本:1  更新时间:2024-10-24 16:08

适用版本: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用户手机端接收到的催办消息