天智安捷云连接器【星辰版】
宋青青 于2025/04/14 12:00:38创建
宋青青 于2025/04/14 12:04:37修改
展开目录
钉钉，阿里巴巴出品，专为全球企业组织打造的智能移动办公平台，含PC版，Ipad和手机版。远程视频会议，消息已读未读，DING消息任务管理，让沟通更高效；移动办公考勤，签到，审批，企业邮箱，免费企业OA，企业通讯录，钉钉教育解决方案，让工作学习更简单。 官网： https://www.dingtalk.com <span style={{color:'red'}}>- 关于钉钉接口使用说明：</span> 1.钉钉标准版、钉钉专业版、钉钉专属版的Webhook&Stream消息通道将于2023年12月1日正式开始商业化，对调用量做次数限制，钉钉标准版享有免费5000次/自然月的Webhook&Stream调用量。 2.标准版钉钉组织，企业内部应用、委托第三方定制开发企业内部应用，每个应用调用服务端接口每秒并发的最高频次限制为20qps；除不纳入每月调用量限制的接口（包括获取访问凭证接口、身份验证（免登）接口、通讯录接口、宜搭接口和生态接口，详细接口请查看附录A：不纳入每月调用量限制的接口清单）之外，其他接口累计可调用次数调整为10000次/月。 详情请查看钉钉官方文档：https://open-dev.dingtalk.com/fe/noticeDetail?id=254234 <hr /> # 关于订阅设置 **如果希望锁定钉钉推送数据范围（即：精细化管理钉钉的接口流量使用），可以点击上一张图中的【订阅设置】进行相应配置，可以锁定接口推送的钉钉审批模板。** <span style={{color:'red'}}>订阅地址填写方式：</span> 注意此处的<span style={{color:'red'}}>PROC-57EE931C-07A7-4F2A-A846-052BA54332D2</span>需要填写自己的表单code，此处的code是示例数据。 ``` 方式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之间用英文逗号分隔,可以填三个,推送指定的模板数据。 ```  ## 钉钉自建应用 ### 1.登录钉钉开发平台 1.1.打开钉钉开放平台。 地址：https://open.dingtalk.com/ 1.2.登录后，点击右上角的【我的后台】。  1.3.在管理后台的【首页】，点击下图位置的Corpid。把信息保存下来（后面会用到）。  ### 2.创建钉钉的自建应用 2.1.点击【应用开发】，进入企业内部自建应用。  2.2.找到界面上的【创建应用】，点击后进行应用创建。  2.3.填写相应信息后，点击【保存】。  2.4.之后进入到应用的配置界面。需要进行2个配置操作。 **配置1：找到【凭证与基础信息】配置，进行相应操作。** 点击下图位置的AgentId、AppKey、AppSecret。把信息保存下来（后面会用到）。  **配置2：找到【权限管理】配置，进行相应设置。** 如下图中的红框部分，依次对【个人权限】、【通讯录管理】、【OA审批】进行授权。 操作方法：依次勾选全部授权接口列表后，点击【批量申请】。  **配置3：找到【事件订阅】配置，进行相应设置。** 推送方式，选择Http推送。如下图：  点击下图中的2个图标，可以看到aes_key、token，把信息保存下来（后面会用到）  ### 3.安捷云中创建钉钉自建应用 3.1.登录安捷云，选择应用账户，点击新建应用账户，选择钉钉自建应用。   把上面保存的信息，填入到相应位置，之后点击【测试并保存】，则系统会返回出auth_hook_url。  3.2.把上一步获取的auth_hook_url回填到钉钉自建应用中。  3.3.上一步保存后，在钉钉的【事件订阅】中开启【审批事件】的订阅。自此，配置完毕。  ### 4. 钉钉自建应用版本发布 完成上述操作后，点击【版本管理与发布】，创建一个新版本。 填入一下信息后将应用发布。需要注意的是每次授权的更改都需要发布一次版本，否则系统还是会取未发布版本。  ### [温馨提示]关于订阅设置 如果希望锁定钉钉推送数据范围（即：精细化管理钉钉的接口流量使用），可以点击上一张图中的【订阅设置】进行相应配置，可以锁定接口推送的钉钉审批模板。 订阅地址填写方式： ``` 方式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之间用英文逗号分隔,可以填三个,推送指定的模板数据。 ``` 