应用自建群发送消息
企业微信支持应用创建聊天群并通过API向自建的应用群发送指定消息
暂时本服务支持两种消息类型:
发送文本消息
发送卡片消息
应用如需发送应用自建群消息,需要发送邮件单独申请,进行配置,并发送所需的指定群ID
申请流程
1.发送申请邮件 请项目负责人审批后, 发送至devopsgroup@credithc.com
接收人:devopsgroup@credithc.com , 项目负责人
邮件标题:邮件和企业微信API应用《项目名称》申请自建群发送消息权限
邮件内容:邮件和企业微信API应用《项目名称》申请自建群发送消息权限
项目名称: 必填
指定群名: 必填
是否新建群: 必填
群主邮箱: 新建群必填
群成员邮箱列表: 至少两人,必须包含群主
群使用场景: 新建群必填
是否开通测试环境: 选填
2.审批成功后,会将指定群ID线下发送到申请人企业微信
3.本文档所有接口对所有环境均适用,调用地址默认均为生产环境地址;要开通测试环境请在邮件中说明。
生产地址:http://10.10.255.196
测试地址:http://10.150.26.29:8000
发送文本消息
通过API ,向指定企业微信自建群发送文本消息
请求方式
POST
请求地址
http://10.10.255.196/api/v2/qywx_appchat/sendmsg/text
请求参数
参数名称 | 是否必填 | 类型 | 描述 |
---|---|---|---|
key | 必须项 | string | 内部应用认证key |
chatid | 必须项 | string | 指定群ID |
body | 必须项 | string | 需要发送的内容,支持换行\n、以及<</a>;标签 |
调用样例
eg:
curl -v -H "Content-Type:application/json" -X POST --data '{"key": "da1f4cddca568b9337d793b5e520c6204b6556b7","chatid": "wrjyoHCwAAItCkmSXWXXXXXXXXXXX","body": "This is an app chat text test"}' "http://10.10.255.196/api/v2/qywx_appchat/sendmsg/text"
返回示例
{"message": "success", "code": 200, "data": [1]}
发送卡片消息
通过API ,向指定企业微信自建群发送卡片消息
请求方式
POST
请求地址
http://10.10.255.196/api/v2/qywx_appchat/sendmsg/textcard
请求参数
参数名称 | 是否必填 | 类型 | 描述 |
---|---|---|---|
key | 必须项 | string | 内部应用认证key |
chatid | 必须项 | string | 指定群ID |
body | 必须项 | string | 需要发送的内容,持使用br标签或者空格来进行换行处理,也支持使用div标签来使用不同的字体颜色,目前内置了3种文字颜色:灰色(gray)、高亮(highlight)、默认黑色(normal),将其作为div标签的class属性即可 |
subject | 必须项 | string | 标题,不超过128个字节,超过会自动截断 |
url | 必须项 | string | 点击后跳转的链接 |
btntxt | 可选项 | string | 按钮文字。 默认为“详情”, 不超过4个文字,超过自动截断。 |
key 必须项 string 内部应用认证key
to 必须项 string|list 接收人邮箱
subject 必须项 string 标题,不超过128个字节,超过会自动截断
url 必须项 string 点击后跳转的链接
body 必须项 string 文本内容,支持换行\n、以及<a/>标签
btntxt 可选项 string 按钮文字。 默认为“详情”, 不超过4个文字,超过自动截断。
说明
卡片消息的展现形式非常灵活,支持使用br标签或者空格来进行换行处理,也支持使用div标签来使用不同的字体颜色,目前内置了3种文字颜色:灰色(gray)、高亮(highlight)、默认黑色(normal),将其作为div标签的class属性即可,具体用法请参考下面的示例。
eg:
"<div class=\"gray\">2016年9月26日</div> <div class=\"normal\">恭喜你抽中iPhone 7一台,领奖码:xxxx</div><div class=\"highlight\">请于2016年10月10日前联系行政同事领取</div>"
请求示例
curl -v -H "Content-Type:application/json" -X POST --data '{"key": "da1f4cddca568b9337d793b5e520c6204b6556b7","chatid": "wrjyoHCwAAItCkmSXWXXXXXXXXXXX","body": "文本消息测试", "subject":"卡片测试", "url":"http://127.0.0.1/testview"}' "http://10.10.255.196/api/v2/qywx_appchat/sendmsg/textcard"
返回示例
{"message": "success", "code": 200, "data": [1]}