群機器人
如何使用群機器人
機器人現時支持加入群組會話的場景,可以用來推送應用的通知。
特別特別要注意:一定要保護好機器人的webhook地址,避免洩漏! 不要分享到github、部落格等可被公開查閱的地方,否則壞人就可以用你的機器人來發垃圾消息了。
創建機器人應用
1.登入嘟哩管理後臺,前往“工作臺-應用管理”,點擊添加“webhook應用”

2.添加webhook應用,設定應用基礎資訊

添加到群聊
1.進入機器人設定,為機器人綁定群組


2.獲取webhook url

發送機器人消息
請求說明
POST管道請求URL:(注意要將url替換成你的機器人webhook地址)
https://xxx../app/appWebhookMsgReceive?accessToken=xxxx
當前自定義機器人支持文字(text)、markdown(markdown)、範本卡片(template_card)等消息類型。
1.文字消息:
{
"title": "[發火][發火][發火]:告警節點:機器告警\n",
"message": "問題詳情: cpu太高了\n告警主機:Host1111 \n告警時間:2022-11-21 11:06:00 \n告警等級:高\n告警資訊:CPU使用率高達100% \n告警項目:有鴿服務\n當前狀態: Open \n告警描述: CPU高達100% \n事件ID: 1234"
}
參數 | 是否必填 | 說明 |
title | 是 | 消息類型,此時固定為text |
content | 是 | 文字內容,最長不超過2048個位元組,必須是utf8編碼 |
mentioned_list | 否 | userid的清單,提醒群中的指定成員(@某個成員),@ all表示提醒所有人,如果開發者獲取不到userid,可以使用mentioned_mobile_list |
mentioned_mobile_list | 否 | 手機號清單,提醒手機號對應的群成員(@某個成員),@ all表示提醒所有人 |
| | |
示例圖:

2.卡片消息
{
"msgType": "action_card",
"content":{
"title": "是透出到会话列表和通知的文案",
"markdown":"支持markdown格式的正文内容",
"single_title":"查看详情",
"single_url": "https://open.dingtalk.com"
}
}

3.卡片消息2
{
"msgType": "action_card",
"content": {
"text":"",
"title": "我20年前想打造一間蘋果咖啡廳,而它正是Apple Store的前身“,
"markdown": "\n\n ####約伯斯20年前想打造的蘋果咖啡廳\n\n Apple Store的設計正從原來滿滿的科技感走向生活化,而其生活化的走向其實可以追溯到20年前蘋果一個建立咖啡館的計畫",
"btn_orientation": "0",
"btn_json_list": [
{
"title": "內容不錯",
"action_url": "http://ugram2.bigdamo.com/images/contact/icon_company.png/"
},
{
"title": "不感興趣",
"action_url": "http://ugram2.bigdamo.com/images/contact/icon_company.png/"
}
]
}
}
示例圖:

4.markdown消息
{
"msgType": "markdown",
"content": {
"text": "####杭州天氣@150XXXXXXXX \n > 9度,西北風1級,空氣良89,相對溫度73%\n >! [screenshot]( https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png )\n > ###### 10點20分發佈[天氣]( https://www.dingtalk.com) \n",
"title": "markdownTitle"
}
}
示例圖:

状态码
状态码 | message | 說明 |
500 | err_message_resolve | 參數解析失敗,無法獲取appId |
500 | IP limit | 不在應用白名單裏 |
500 | Webhook address invalid | webhook地址無效 |
500 | AppId error | appId無效 |
500 | AppId closed | 後臺應用未啟用 |
0 | fail in send | 系统异常 |
| | |