微信企业号开发之如何发送消息

移动开发 移动应用
企业可以主动发消息给员工,消息量不受限制。调用接口时,使用Https协议、JSON数据包格式,数据包不需做加密处理。目前支持文本、图片、语音、视频、文件、图文等消息类型。

企业可以主动发消息给员工,消息量不受限制

调用接口时,使用Https协议、JSON数据包格式,数据包不需做加密处理。

目前支持文本、图片、语音、视频、文件、图文等消息类型。除了news类型,其它类型的消息可在发送时加上保密选项,保密消息会被打上水印,并且只有接收者才能阅读。

一、发送接口说明

  • 请求说明

Https请求方式: POST

https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN

  • 参数说明
参数 必须 说明
access_token 调用接口凭证
  • 权限要求

需要管理员对应用有使用权限,对收件人touser、toparty、totag有查看权限,否则本次调用失败。

  • 返回结果

如果对应用或收件人、部门、标签任何一个无权限,则本次发送失败;如果收件人、部门或标签不存在,发送仍然执行,但返回无效的部分。

  1.    "errcode"0
  2.    "errmsg""ok"
  3.    "invaliduser""UserID1"
  4.    "invalidparty":"PartyID1"
  5.    "invalidtag":"TagID1" 
  6. }

二、消息类型及数据格式

  • text消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""text"
  5.    "agentid""1"
  6.    "text": { 
  7.        "content""Holiday Request For Pony(http://xxxxx)" 
  8.    }, 
  9.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:text
agentid 企业应用的id,整型。可在应用的设置页面查看
content 消息内容
safe 表示是否是保密消息,0表示否,1表示是,默认0
  • image消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "msgtype""image"
  4.    "agentid""1"
  5.    "image": { 
  6.        "media_id""MEDIA_ID" 
  7.    }, 
  8.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:image
agentid 企业应用的id,整型。可在应用的设置页面查看
media_id 媒体资源文件ID
safe 表示是否是保密消息,0表示否,1表示是,默认0
  • voice消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""voice"
  5.    "agentid""1"
  6.    "voice": { 
  7.        "media_id""MEDIA_ID" 
  8.    }, 
  9.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:voice
agentid 企业应用的id,整型。可在应用的设置页面查看
media_id 媒体资源文件ID
safe 表示是否是保密消息,0表示否,1表示是,默认0
  • video消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""video"
  5.    "agentid""1"
  6.    " video": { 
  7.        "media_id""MEDIA_ID"
  8.        "title""Title"
  9.        "description""Description" 
  10.    }, 
  11.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:video
agentid 企业应用的id,整型。可在应用的设置页面查看
media_id 媒体资源文件ID
title 视频消息的标题
description 视频消息的描述
safe 表示是否是保密消息,0表示否,1表示是,默认0
  • file消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""file"
  5.    "agentid""1"
  6.    "file": { 
  7.        "media_id""MEDIA_ID" 
  8.    }, 
  9.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:file
agentid 企业应用的id,整型。可在应用的设置页面查看
media_id 文件ID
safe 表示是否是保密消息,0表示否,1表示是,默认0
  • news消息
  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""news"
  5.    "agentid""1"
  6.    "news": { 
  7.        "articles":[ 
  8.            { 
  9.                "title""Title"
  10.                "description""Description"
  11.                "url""URL"
  12.                "picurl""PIC_URL"
  13.            }, 
  14.            { 
  15.                "title""Title"
  16.                "description""Description"
  17.                "url""URL"
  18.                "picurl""PIC_URL"
  19.            }     
  20.        ] 
  21.    } 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:news
agentid 企业应用的id,整型。可在应用的设置页面查看
title 标题
description 描述
url 点击后跳转的链接。企业可根据url里面带的code参数校验员工的真实身份。具体参考“9 微信页面跳转员工身份查询”
picurl 图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80。如不填,在客户端不显示图片
  • mpnews消息

注:mpnews消息与news消息类似,不同的是图文消息内容存储在微信后台,并且支持保密选项。

  1.    "touser""UserID1|UserID2|UserID3"
  2.    "toparty"" PartyID1 | PartyID2 "
  3.    "totag"" TagID1 | TagID2 "
  4.    "msgtype""mpnews"
  5.    "agentid""1"
  6.    "mpnews": { 
  7.        "articles":[ 
  8.            { 
  9.                "thumb_media_id""id"
  10.                "author""Author"
  11.                "content_source_url""URL"
  12.                "content""Content" 
  13.                "digest""Digest description"
  14.                "show_cover_pic""0" 
  15.            }, 
  16.            {  
  17.                "thumb_media_id""id"
  18.                "author""Author"
  19.                "content_source_url""URL"
  20.                "content""Content" 
  21.                "digest""Digest description"
  22.                "show_cover_pic""0" 
  23.            } 
  24.        ] 
  25.        "media_id""id" 
  26.    } 
  27.    "safe":"0" 
参数 必须 说明
touser UserID列表(消息接收者,多个接收者用‘|’分隔)。特殊情况:指定为@all,则向关注该企业应用的全部成员发送
toparty PartyID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag TagID列表,多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 消息类型,此时固定为:mpnews
agentid 企业应用的id,整型。可在应用的设置页面查看
articles 图文消息,一个图文消息支持1到10个图文
thumb_media_id 图文消息缩略图的media_id, 可以在上传多媒体文件接口中获得。此处thumb_media_id即上传接口返回的media_id
title 图文消息的标题
author 图文消息的作者
content_source_url 图文消息点击“阅读原文”之后的页面链接
content 图文消息的内容,支持html标签
digest 图文消息的描述
show_cover_pic 是否显示封面,1为显示,0为不显示
safe 表示是否是保密消息,0表示否,1表示是,默认0

 

责任编辑:闫佳明 来源: 51CTO
相关推荐

2014-09-24 11:11:08

微信企业号开发

2014-09-24 09:59:23

微信企业号开发

2014-09-24 10:29:14

微信企业号开发

2014-09-28 22:34:09

微信企业号

2014-09-24 11:04:31

微信企业号开发

2014-09-24 13:11:34

信企业号

2014-09-24 11:45:15

微信企业号开发

2013-11-13 00:37:12

微信微信公号微信公众账号

2014-09-24 11:47:41

微信企业号开发

2013-11-12 23:32:53

微信公号微信公众账号

2014-09-25 15:48:51

微信企业号申请认证

2013-11-13 00:14:16

微信微信公号微信公众账号

2014-09-28 22:30:13

微信企业号

2014-09-28 22:26:11

微信企业号

2014-09-24 11:52:37

微信企业号开发

2013-11-13 00:20:01

微信微信公号微信公众账号

2014-09-25 15:27:28

微信企业号注册流程

2013-11-13 01:25:33

微信微信公号微信公众账号

2014-10-21 15:42:30

微信企业号企业移动平台

2014-09-25 13:40:52

微信企业号图解
点赞
收藏

51CTO技术栈公众号