钉钉机器人通过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"} ] } }