XIKEW.COM - 公读宝典 - 企业微信机器人提醒 - 公读宝典, - 特别特别要注意:一定要**保护好机器人的webhook地址**,避免泄漏!不要分享到github、博客等可被公开查阅的地方,否则坏人就可以用你的机器人来发垃圾消息了。

企业微信机器人提醒
{{DIY_TAGS}} 4/16/2020 8:51:35 AM 阅读:40

img

异常提醒BOT

Webhook地址: https://qyapi.weixin.qq.com/cg...54-8818-bdcbb8a519a3

如何使用群机器人

  • 在终端某个群组添加机器人之后,可以获取到webhook地址,然后开发者用户按以下说明构造post data向这个地址发起HTTP POST 请求,即可实现给该群组发送消息。下面举个简单的例子. 假设webhook是:https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=633a31f6-7f9c-4bc4-97a0-0ec1eefa589

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

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

curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=633a31f6-7f9c-4bc4-97a0-0ec1eefa5898'  -H 'Content-Type: application/json' -d '{"msgtype": "text","text": {"content": "hello world"}}'
  • 当前自定义机器人支持文本(text)、markdown(markdown)两种消息类型。

消息类型及数据格式

文本类型

{
    "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表示提醒所有人 |

img

markdown类型

{
    "msgtype": "markdown",
    "markdown": {
        "content": "实时新增用户反馈<font color=\"warning\">132例</font>,请相关同事注意。\n>类型:<font color=\"comment\">用户反馈</font> \n>普通用户反馈:<font color=\"comment\">117例</font> \n>VIP用户反馈:<font color=\"comment\">15例</font>"
    }
}

| 参数 | 是否必填 | 说明 | | ------- | -------- | -------------------------------------------------- | | msgtype | 是 | 消息类型,此时固定为markdown | | content | 是 | markdown内容,最长不超过4096个字节,必须是utf8编码 |

img

目前支持的markdown语法是如下的子集:

  1. 标题 (支持1至6级标题,注意#与文字中间要有空格)

    # 标题一## 标题二### 标题三#### 标题四##### 标题五###### 标题六
    
  2. 加粗

    **bold**
    
  3. 链接

    [这是一个链接](http://work.weixin.qq.com/api/doc)
    
  4. 行内代码段(暂不支持跨行)

    `code`
    
  5. 引用

    > 引用文字
    
  6. 字体颜色(只支持3种内置颜色)

    <font color="info">绿色</font><font color="comment">灰色</font><font color="warning">橙红色</font>
    

图片类型

{
    "msgtype": "image",
    "image": {
        "base64": "DATA",
        "md5": "MD5"
    }
}

| 参数 | 是否必填 | 说明 | | ------- | -------- | ------------------------------- | | msgtype | 是 | 消息类型,此时固定为image | | base64 | 是 | 图片内容的base64编码 | | md5 | 是 | 图片内容(base64编码前)的md5值 |

注:图片(base64编码前)最大不能超过2M,支持JPG,PNG格式

img

图文类型

{
    "msgtype": "news",
    "news": {
        "articles": [
            {
                "title": "中秋节礼品领取",
                "description": "今年中秋节公司有豪礼相送",
                "url": "URL",
                "picurl": "http://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png"
            }
        ]
    }
}

| 参数 | 是否必填 | 说明 | | ----------- | -------- | ------------------------------------------------------------ | | msgtype | 是 | 消息类型,此时固定为news | | articles | 是 | 图文消息,一个图文消息支持1到8条图文 | | title | 是 | 标题,不超过128个字节,超过会自动截断 | | description | 否 | 描述,不超过512个字节,超过会自动截断 | | url | 是 | 点击后跳转的链接。 | | picurl | 否 | 图文消息的图片链接,支持JPG、PNG格式,较好的效果为大图 1068455,小图150150。 |

img

消息发送频率限制

每个机器人发送的消息不能超过20条/分钟。

重置Webhook地址后,当前所有根据该地址进行的消息推送都将失效,请根据新的地址重新配置