钉钉应用
钉钉应用通知媒介,支持将告警发送到钉钉群聊或者单聊
概述
- 钉钉应用通知媒介,支持将告警发送到钉钉群聊或者单聊。
- 当前仅支持企业内部应用,不支持第三方企业应用。
- 钉钉应用支持发送告警截图。
使用步骤
创建钉钉应用
- 登录钉钉开发者平台 -> 应用开发 -> 企业内部应用 -> 钉钉应用 -> 创建应用 -> 填写信息后提交
- 进入创建的应用 -> 基础信息 -> 凭证与基础信息 -> 获取 Client ID / Client Secret 填写到系统中

- 进入应用能力 -> 添加应用能力 -> 添加机器人, 机器人消息接收模式选择 “Stream模式”

- 应用能力 -> 添加应用能力 -> 添加酷应用, 填写酷应用相关信息

- 开发配置 -> 权限管理

需要开启的权限列表:
- 钉钉群基础信息读权限
- 企业内机器人发送消息权限
- 搜索企业通讯录的权限
- 根据手机号获取成员基本信息权限
- 开发配置 -> 事件订阅,选择 Stream模式,并订阅 群内安装酷应用、群内卸载酷应用事件。

- 应用发布

创建类型为钉钉应用的通知媒介

- 应用唯一标识:填写钉钉应用的 AppKey。
- 应用密钥:填写钉钉应用的 AppSecret。
将钉钉应用安装到告警群
在群中添加配置的应用,用于发送告警。

常见问题
Q1:钉钉应用通知和钉钉群机器人有什么区别?
A:
- 钉钉群机器人(webhook 类):发到指定群,所有群成员都能看到;
- 钉钉应用:发给指定人的工作通知(推送到钉钉的"工作"页签),可以 @具体人,更适合一对一私聊式通知。
Q2:AgentID / AppKey / AppSecret 在哪拿?
A:钉钉开放平台 → 创建"企业内部应用" → 应用详情里有这三个字段。注意应用必须发布到企业才能使用。
Q3:通知发送了但用户没收到?
A:
- 应用是否对该用户可见(钉钉应用的"可见范围"配置);
- 用户在夜莺的"钉钉 userid"是否正确(错的话推送到错误的人);
- 应用是否被钉钉企业管理员暂停。
Q4:能不能批量推到多个人?
A:可以 — 在通知规则里多选接收人即可,夜莺会调钉钉批量推送 API。注意单次最多 100 人,超过自动分批。