钉钉机器人通过https://oapi.dingtalk.com/robot/send 接口支持多种消息类型,以下为常用类型及特点总结:
特点:纯文本格式,支持@指定用户或全体成员。
适用场景:简单的通知或提醒。
示例结构:
{
"msgtype": "text",
"text": {"content": "服务器CPU使用率超过90%!"},
"at": {"atMobiles": ["138xxxx1234"], "isAtAll": false}
}特点:包含标题、描述、跳转链接及配图链接,支持外部链接跳转。
适用场景:需跳转查看详细内容的通知(如文档、报表)。
示例结构:
{
"msgtype": "link",
"link": {
"title": "月度报告",
"text": "点击查看本月销售数据",
"messageUrl": "https://example.com/report",
"picUrl": "https://example.com/cover.png"
}
}特点:支持富文本排版(标题、列表、加粗等),内容展示更结构化。
适用场景:复杂格式的通知(如日志摘要、带格式的告警)。
示例结构:
{
"msgtype": "markdown",
"markdown": {
"title": "服务异常告警",
"text": "### 服务名称: API网关\n> **状态**: 异常\n> **时间**: 2025-02-22 15:00"
}
}特点:支持按钮交互,可配置单个或多个按钮,按钮支持跳转链接。
适用场景:需用户操作的场景(如审批、任务确认)。
类型细分:
{
"msgtype": "actionCard",
"actionCard": {
"title": "任务审批",
"text": "请处理待审批订单:\n- 订单号: 20250222001\n- 金额: ¥5000",
"btns": [{"title": "同意", "actionURL": "https://example.com/approve"}]
}
}独立跳转型:每个按钮独立跳转不同链接。
整体跳转型:点击标题或内容区域统一跳转。
特点:以信息流形式展示多个链接,每个链接包含标题、配图和跳转地址。
适用场景:聚合类信息推送(如新闻、动态更新)。
示例结构:
{
"msgtype": "feedCard",
"feedCard": {
"links": [
{"title": "更新日志", "messageURL": "https://example.com/log", "picURL": "https://example.com/icon1.png"},
{"title": "产品文档", "messageURL": "https://example.com/docs", "picURL": "https://example.com/icon2.png"}
]
}
}