嘟哩开放平台
简体中文
繁體中文
English
快速开始 开放接口 嘟哩官网
模板

群机器人


如何使用群机器人

机器人目前支持加入群组会话的场景,可以用来推送应用的通知。


特别特别要注意:一定要保护好机器人的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.卡片消息1:

{
"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": "![screenshot](https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png) \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

系统异常