跳到主要内容

钉钉(自建应用)如何授权

钉钉,阿里巴巴出品,专为全球企业组织打造的智能移动办公平台,含PC版,Ipad和手机版。远程视频会议,消息已读未读,DING消息任务管理,让沟通更高效;移动办公考勤,签到,审批,企业邮箱,免费企业OA,企业通讯录,钉钉教育解决方案,让工作学习更简单。 官网: https://www.dingtalk.com

  • 关于钉钉接口使用说明:
    1.钉钉标准版、钉钉专业版、钉钉专属版的Webhook&Stream消息通道将于2023年12月1日正式开始商业化,对调用量做次数限制,钉钉标准版享有免费5000次/自然月的Webhook&Stream调用量。
    2.标准版钉钉组织,企业内部应用、委托第三方定制开发企业内部应用,每个应用调用服务端接口每秒并发的最高频次限制为20qps;除不纳入每月调用量限制的接口(包括获取访问凭证接口、身份验证(免登)接口、通讯录接口、宜搭接口和生态接口,详细接口请查看附录A:不纳入每月调用量限制的接口清单)之外,其他接口累计可调用次数调整为10000次/月。
    详情请查看钉钉官方文档:https://open-dev.dingtalk.com/fe/noticeDetail?id=254234

关于订阅设置

如果希望锁定钉钉推送数据范围(即:精细化管理钉钉的接口流量使用),可以点击上一张图中的【订阅设置】进行相应配置,可以锁定接口推送的钉钉审批模板。
订阅地址填写方式:

方式1:
/v1.0/event/bpms_instance_change/**/PROC-57EE931C-07A7-4F2A-A846-052BA54332D2/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,这样就只推送指定的模板数据了。
方式2:
/v1.0/event/bpms_instance_change/** /{PROC-57EE931C-07A7-4F2A-A846-052BA54332D2,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7}/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,{}里多个模板code之间用英文逗号分隔,可以填三个,推送指定的模板数据。

image
Preview

钉钉自建应用

1.登录钉钉开发平台

1.1.打开钉钉开放平台。
地址:https://open.dingtalk.com/

1.2.登录后,点击右上角的【我的后台】。

image
Preview

1.3.在管理后台的【首页】,点击下图位置的Corpid。把信息保存下来(后面会用到)。

image
Preview

2.创建钉钉的自建应用

2.1.点击【应用开发】,进入企业内部自建应用。

image
Preview

2.2.找到界面上的【创建应用】,点击后进行应用创建。

image
Preview

2.3.填写相应信息后,点击【保存】。

image
Preview

2.4.之后进入到应用的配置界面。需要进行2个配置操作。
配置1:找到【凭证与基础信息】配置,进行相应操作。
点击下图位置的AgentId、AppKey、AppSecret。把信息保存下来(后面会用到)。

image
Preview

配置2:找到【权限管理】配置,进行相应设置。
如下图中的红框部分,依次对【个人权限】、【通讯录管理】、【OA审批】进行授权。
操作方法:依次勾选全部授权接口列表后,点击【批量申请】。
image
Preview

配置3:找到【事件订阅】配置,进行相应设置。
推送方式,选择Http推送。如下图:
image
Preview

点击下图中的2个图标,可以看到aes_key、token,把信息保存下来(后面会用到)
image
Preview

3.安捷云中创建钉钉自建应用

3.1.登录安捷云,选择应用账户,点击新建应用账户,选择钉钉自建应用。

image
Preview

image
Preview

把上面保存的信息,填入到相应位置,之后点击【测试并保存】,则系统会返回出auth_hook_url。

image
Preview

3.2.把上一步获取的auth_hook_url回填到钉钉自建应用中。

image
Preview

3.3.上一步保存后,在钉钉的【事件订阅】中开启【审批事件】的订阅。自此,配置完毕。
image
Preview

4. 钉钉自建应用版本发布

完成上述操作后,点击【版本管理与发布】,创建一个新版本。
填入一下信息后将应用发布。需要注意的是每次授权的更改都需要发布一次版本,否则系统还是会取未发布版本。

image
Preview

[温馨提示]关于订阅设置

如果希望锁定钉钉推送数据范围(即:精细化管理钉钉的接口流量使用),可以点击上一张图中的【订阅设置】进行相应配置,可以锁定接口推送的钉钉审批模板。
订阅地址填写方式:

方式1:
/v1.0/event/bpms_instance_change/**/PROC-57EE931C-07A7-4F2A-A846-052BA54332D2/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,这样就只推送指定的模板数据了。
方式2:
/v1.0/event/bpms_instance_change/** /{PROC-57EE931C-07A7-4F2A-A846-052BA54332D2,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7,PROC-79869EF5-E088-4B2C-BFA4-EC454AB90FB7}/type/finish
其中:PROC-57EE931C-07A7-4F2A-A846-052BA54332D2换成对应的模板code,{}里多个模板code之间用英文逗号分隔,可以填三个,推送指定的模板数据。

image
Preview