LOGO 首页 OA教程 ERP教程 模切知识交流 PMS教程 CRM教程 技术文档 其他文档  
 
网站管理员

微信企业号开发之如何发送消息
admin
2014年12月2日 0:38 本文热度 12313

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


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


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


一、发送接口说明



  • 请求说明

Https请求方式: POST


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



  • 参数说明










参数 必须 说明
access_token 是 调用接口凭证


  • 权限要求

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



  • 返回结果

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

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

二、消息类型及数据格式



  • text消息 
  1. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "text", 
  6.    "agentid": "1", 
  7.    "text": { 
  8.        "content": "Holiday Request For Pony(http://xxxxx)" 
  9.    }, 
  10.    "safe":"0" 
  11. } 


































参数 必须 说明
touser 否 UserID列表（消息接收者，多个接收者用‘|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 PartyID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag 否 TagID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：text
agentid 是 企业应用的id，整型。可在应用的设置页面查看
content 是 消息内容
safe 否 表示是否是保密消息，0表示否，1表示是，默认0


  • image消息 
  1. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "msgtype": "image", 
  5.    "agentid": "1", 
  6.    "image": { 
  7.        "media_id": "MEDIA_ID" 
  8.    }, 
  9.    "safe":"0" 
  10. } 


































参数 必须 说明
touser 否 UserID列表（消息接收者，多个接收者用‘|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 PartyID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag 否 TagID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：image
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 媒体资源文件ID
safe 否 表示是否是保密消息，0表示否，1表示是，默认0


  • voice消息 
  1. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "voice", 
  6.    "agentid": "1", 
  7.    "voice": { 
  8.        "media_id": "MEDIA_ID" 
  9.    }, 
  10.    "safe":"0" 
  11. } 


































参数 必须 说明
touser 否 UserID列表（消息接收者，多个接收者用‘|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 PartyID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag 否 TagID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：voice
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 媒体资源文件ID
safe 否 表示是否是保密消息，0表示否，1表示是，默认0


  • video消息 
  1. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "video", 
  6.    "agentid": "1", 
  7.    " video": { 
  8.        "media_id": "MEDIA_ID", 
  9.        "title": "Title", 
  10.        "description": "Description" 
  11.    }, 
  12.    "safe":"0" 
  13. } 










































参数 必须 说明
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. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "file", 
  6.    "agentid": "1", 
  7.    "file": { 
  8.        "media_id": "MEDIA_ID" 
  9.    }, 
  10.    "safe":"0" 
  11. } 


































参数 必须 说明
touser 否 UserID列表（消息接收者，多个接收者用‘|’分隔）。特殊情况：指定为@all，则向关注该企业应用的全部成员发送
toparty 否 PartyID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
totag 否 TagID列表，多个接受者用‘|’分隔。当touser为@all时忽略本参数
msgtype 是 消息类型，此时固定为：file
agentid 是 企业应用的id，整型。可在应用的设置页面查看
media_id 是 文件ID
safe 否 表示是否是保密消息，0表示否，1表示是，默认0


  • news消息 
  1. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "news", 
  6.    "agentid": "1", 
  7.    "news": { 
  8.        "articles":[ 
  9.            { 
  10.                "title": "Title", 
  11.                "description": "Description", 
  12.                "url": "URL", 
  13.                "picurl": "PIC_URL", 
  14.            }, 
  15.            { 
  16.                "title": "Title", 
  17.                "description": "Description", 
  18.                "url": "URL", 
  19.                "picurl": "PIC_URL", 
  20.            }     
  21.        ] 
  22.    } 
  23. } 










































参数 必须 说明
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. { 
  2.    "touser": "UserID1|UserID2|UserID3", 
  3.    "toparty": " PartyID1 | PartyID2 ", 
  4.    "totag": " TagID1 | TagID2 ", 
  5.    "msgtype": "mpnews", 
  6.    "agentid": "1", 
  7.    "mpnews": { 
  8.        "articles":[ 
  9.            { 
  10.                "thumb_media_id": "id", 
  11.                "author": "Author", 
  12.                "content_source_url": "URL", 
  13.                "content": "Content" 
  14.                "digest": "Digest description", 
  15.                "show_cover_pic": "0" 
  16.            }, 
  17.            {  
  18.                "thumb_media_id": "id", 
  19.                "author": "Author", 
  20.                "content_source_url": "URL", 
  21.                "content": "Content" 
  22.                "digest": "Digest description", 
  23.                "show_cover_pic": "0" 
  24.            } 
  25.        ] 
  26.        "media_id": "id" 
  27.    } 
  28.    "safe":"0" 
  29. } 






























































参数 必须 说明
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

该文章在 2014/12/2 0:38:38 编辑过
关键字查询
相关文章
正在查询...
点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。
点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理，结合码头的业务特点，围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体，是物流码头及其他港口类企业的高效ERP管理信息系统。
点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。
点晴免费OA是一款软件和通用服务都免费，不限功能、不限时间、不限用户的免费OA协同办公管理系统。
Copyright 2010-2026 ClickSun All Rights Reserved　　粤ICP备13012886号-1　　粤公网安备44030602007207号