企业微信在群聊中可以添加群机器人,并提供非常简单的webhook接口用于此机器人向群内的成员发送各种消息,非常适合将持续集成中的实时状态进行信息的共享,这篇文章介绍一下使用的具体方法。
添加群机器人
企业微信的此项功能的使用实在群中添加的,所以首先需要建群,然后在群中添加一个机器人,比如此处有一个名为Trident的只有一个人的群,右键功能中就包含了创建群机器人的功能选项。
点击Add Robot
点击New Robot
输入机器人的名称,然后继续点击Add Robot
然后就创建了此群机器人,注意保护好Webhook URL中的key的信息,这就是身份的标识,微信官方建议不要在任何地方截图显示以免别人冒用。不过影响范围仅限于此企业微信群内。
使用方法
创建此群聊机器人后,就可以直接使用Restful API以Json的格式进行消息的推送了。以curl命令为例,使用如下示例脚本即可进行验证
liumiaocn:robot liumiao$ cat demo_message_send.sh
#!/bin/sh
CHAT_WEBHOOK_URL='https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key'
CHAT_CONTENT_TYPE='Content-Type: application/json'
curl "${CHAT_WEBHOOK_URL}=${CHAT_WEBHOOK_KEY}" \
-H "${CHAT_CONTENT_TYPE}" \
-d '
{
"msgtype": "text",
"text": {
"content": "hello liumiao"
}
}' 2>/dev/null |jq .
liumiaocn:robot liumiao$
执行结果确认
liumiaocn:robot liumiao$ export CHAT_WEBHOOK_KEY=your_own_webhook_key_info
liumiaocn:robot liumiao$ sh demo_message_send.sh
{
"errcode": 0,
"errmsg": "ok"
}
liumiaocn:robot liumiao$
注:your_own_webhook_key_info使用自己的key信息进行替换
总结
企业微信的目前提供的群机器人有三个特点,其一是需要依托与群而存在,其二是直接将key作为URL中的一项参数传入,不需要其他的鉴权操作,三是需要联网。