应用自建群发送消息

企业微信支持应用创建聊天群并通过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]}

results matching ""

    No results matching ""