如何使用群機(jī)器人

• 在終端某個(gè)群組添加機(jī)器人之后，創(chuàng)建者可以在機(jī)器人詳情頁看的該機(jī)器人特有的webhookurl。開發(fā)者可以按以下說明a向這個(gè)地址發(fā)起HTTP POST 請求，即可實(shí)現(xiàn)給該群組發(fā)送消息。下面舉個(gè)簡單的例子.
  假設(shè)webhook是：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa

特別特別要注意：一定要保護(hù)好機(jī)器人的webhook地址，避免泄漏！不要分享到github、博客等可被公開查閱的地方，否則壞人就可以用你的機(jī)器人來發(fā)垃圾消息了。

以下是用curl工具往群組推送文本消息的示例（注意要將url替換成你的機(jī)器人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"        }   }'

• 當(dāng)前自定義機(jī)器人支持文本（text）、markdown（markdown）、圖片（image）、圖文（news）四種消息類型。
• 機(jī)器人的text/markdown類型消息支持在content中使用<@userid>擴(kuò)展語法來@群成員

消息類型及數(shù)據(jù)格式

文本類型

{    "msgtype": "text",    "text": {        "content": "廣州今日天氣：29度，大部分多云，降雨概率：60%",        "mentioned_list":["wangqing","@all"],        "mentioned_mobile_list":["13800001111","@all"]    }}

img

markdown類型

{    "msgtype": "markdown",    "markdown": {        "content": "實(shí)時(shí)新增用戶反饋<font color=\"warning\">132例</font>，請相關(guān)同事注意。\n         >類型:<font color=\"comment\">用戶反饋</font>         >普通用戶反饋:<font color=\"comment\">117例</font>         >VIP用戶反饋:<font color=\"comment\">15例</font>"    }}

img

目前支持的markdown語法是如下的子集：

1. 標(biāo)題 （支持1至6級(jí)標(biāo)題，注意#與文字中間要有空格）

   # 標(biāo)題一## 標(biāo)題二### 標(biāo)題三#### 標(biāo)題四##### 標(biāo)題五###### 標(biāo)題六
   

2. 加粗

   **bold**
   

3. 鏈接

   [這是一個(gè)鏈接](http://work.weixin.qq.com/api/doc)
   

4. 行內(nèi)代碼段（暫不支持跨行）

   `code`
   

5. 引用

   > 引用文字
   

6. 字體顏色(只支持3種內(nèi)置顏色)

   <font color="info">綠色</font><font color="comment">灰色</font><font color="warning">橙紅色</font>
   

例如

        message = "## **【西點(diǎn)云】2022年2月17日 日報(bào)**\n         " \
                  ">100｜ 線上續(xù)款 50單 5100元 \n  " \
                  ">101｜ 線下消費(fèi) 50單 5100元 \n  " \
                  "><font color=\"red\">102｜</font><font color=\"red\"> 線下消費(fèi)</font><font color=\"red\"> 1單(ERP 2單)</font><font color=\"red\"> 100元(ERP 99元)</font> \n" \
                  "<font color=\"#930000\">**提示：紅色字體表示賬務(wù)不一致，請核實(shí)!**</font>"

企業(yè)微信截圖_683a4f27-3438-4b24-9c25-0143567ca194.png

圖片類型

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

注：圖片（base64編碼前）最大不能超過2M，支持JPG,PNG格式

img

圖文類型

{    "msgtype": "news",    "news": {       "articles" : [           {               "title" : "中秋節(jié)禮品領(lǐng)取",               "description" : "今年中秋節(jié)公司有豪禮相送",               "url" : "www.qq.com",               "picurl" : "http://res.mail.qq.com/node/ww/wwopenmng/images/independent/doc/test_pic_msg1.png"           }        ]    }}

img

文件類型

{    "msgtype": "file",    "file": {         "media_id": "3a8asd892asd8asd"    }}

img

模版卡片類型

文本通知模版卡片

img

{    "msgtype":"template_card",    "template_card":{        "card_type":"text_notice",        "source":{            "icon_url":"https://wework.qpic.cn/wwpic/252813_jOfDHtcISzuodLa_1629280209/0",            "desc":"企業(yè)微信"        },        "main_title":{            "title":"歡迎使用企業(yè)微信",            "desc":"您的好友正在邀請您加入企業(yè)微信"        },        "emphasis_content":{            "title":"100",            "desc":"數(shù)據(jù)含義"        },        "sub_title_text":"下載企業(yè)微信還能搶紅包！",        "horizontal_content_list":[            {                "keyname":"邀請人",                "value":"張三"            },            {                "keyname":"企微官網(wǎng)",                "value":"點(diǎn)擊訪問",                "type":1,                "url":"https://work.weixin.qq.com/?from=openApi"            },            {                "keyname":"企微下載",                "value":"企業(yè)微信.apk",                "type":2,                "media_id":"MEDIAID"            }        ],        "jump_list":[            {                "type":1,                "url":"https://work.weixin.qq.com/?from=openApi",                "title":"企業(yè)微信官網(wǎng)"            },            {                "type":2,                "appid":"APPID",                "pagepath":"PAGEPATH",                "title":"跳轉(zhuǎn)小程序"            }        ],        "card_action":{            "type":1,            "url":"https://work.weixin.qq.com/?from=openApi",            "appid":"APPID",            "pagepath":"PAGEPATH"        }    }}

請求參數(shù)

template_card的參數(shù)說明

圖文展示模版卡片

img

{    "msgtype":"template_card",    "template_card":{        "card_type":"news_notice",        "source":{            "icon_url":"https://wework.qpic.cn/wwpic/252813_jOfDHtcISzuodLa_1629280209/0",            "desc":"企業(yè)微信"        },        "main_title":{            "title":"歡迎使用企業(yè)微信",            "desc":"您的好友正在邀請您加入企業(yè)微信"        },        "card_image":{            "url":"https://wework.qpic.cn/wwpic/354393_4zpkKXd7SrGMvfg_1629280616/0",            "aspect_ratio":2.25        },        "vertical_content_list":[            {                "title":"驚喜紅包等你來拿",                "desc":"下載企業(yè)微信還能搶紅包！"            }        ],        "horizontal_content_list":[            {                "keyname":"邀請人",                "value":"張三"            },            {                "keyname":"企微官網(wǎng)",                "value":"點(diǎn)擊訪問",                "type":1,                "url":"https://work.weixin.qq.com/?from=openApi"            },            {                "keyname":"企微下載",                "value":"企業(yè)微信.apk",                "type":2,                "media_id":"MEDIAID"            }        ],        "jump_list":[            {                "type":1,                "url":"https://work.weixin.qq.com/?from=openApi",                "title":"企業(yè)微信官網(wǎng)"            },            {                "type":2,                "appid":"APPID",                "pagepath":"PAGEPATH",                "title":"跳轉(zhuǎn)小程序"            }        ],        "card_action":{            "type":1,            "url":"https://work.weixin.qq.com/?from=openApi",            "appid":"APPID",            "pagepath":"PAGEPATH"        }    }}

請求參數(shù)

template_card的參數(shù)說明

消息發(fā)送頻率限制

每個(gè)機(jī)器人發(fā)送的消息不能超過20條/分鐘。

文件上傳接口

素材上傳得到media_id，該media_id僅三天內(nèi)有效
media_id只能是對應(yīng)上傳文件的機(jī)器人可以使用

請求方式：POST（HTTPS）
請求地址：https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=KEY&type=TYPE

使用multipart/form-data POST上傳文件， 文件標(biāo)識(shí)名為”media”
參數(shù)說明：

POST的請求包中，form-data中媒體文件標(biāo)識(shí)，應(yīng)包含有 filename、filelength、content-type等信息

filename標(biāo)識(shí)文件展示的名稱。比如，使用該media_id發(fā)消息時(shí)，展示的文件名由該字段控制

請求示例：

POST https://qyapi.weixin.qq.com/cgi-bin/webhook/upload_media?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa&type=file HTTP/1.1Content-Type: multipart/form-data; boundary=-------------------------acebdf13572468Content-Length: 220---------------------------acebdf13572468Content-Disposition: form-data; name="media";filename="wework.txt"; filelength=6Content-Type: application/octet-streammytext---------------------------acebdf13572468--

返回?cái)?shù)據(jù)：

{   "errcode": 0,   "errmsg": "ok",   "type": "file",   "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",   "created_at": "1380000000"}

參數(shù)說明：

上傳的文件限制：

• 要求文件大小在5B~20M之間