企业微信群机器人配置说明

 
开发参考

如何使用群机器人

  • 在终端某个群组添加机器人之后，创建者可以在机器人详情页看的该机器人特有的webhookurl。开发者可以按以下说明向这个地址发起HTTP POST 请求，即可实现给该群组发送消息。下面举个简单的例子.
    假设webhook是：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

特别特别要注意：一定要保护好机器人的webhook地址，避免泄漏！不要分享到github、博客等可被公开查阅的地方，否则坏人就可以用你的机器人来发垃圾消息了。

以下是用curl工具往群组推送文本消息的示例（注意要将url替换成你的机器人webhook地址，content必须是utf8编码）：

curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa' \   -H 'Content-Type: application/json' \   -d '   {    	"msgtype": "text",    	"text": {        	"content": "hello world"    	}   }'

  • 当前自定义机器人支持文本（text）、markdown（markdown）、图片（image）、图文（news）四种消息类型。

  • 机器人的text/markdown类型消息支持在content中使用<@userid>扩展语法来@群成员

消息类型及数据格式

文本类型

{    "msgtype": "text",    "text": {        "content": "广州今日天气：29度，大部分多云，降雨概率：60%",		"mentioned_list":["wangqing","@all"],		"mentioned_mobile_list":["13800001111","@all"]    }}
参数是否必填说明
msgtype是消息类型，此时固定为text
content是文本内容，最长不超过2048个字节，必须是utf8编码
mentioned_list否userid的列表，提醒群中的指定成员(@某个成员)，@all表示提醒所有人，如果开发者获取不到userid，可以使用mentioned_mobile_list
mentioned_mobile_list否手机号列表，提醒手机号对应的群成员(@某个成员)，@all表示提醒所有人


有话要说