如何添加应用帐号
钉钉接入采用自建应用的方式,首先进入钉钉开发平台:https://open-dev.dingtalk.com/
登录后,在应用开发/H5微应用中,创建应用或者使用已经创建过的应用

在H5应用详情中获取3个信息:

- AgentId
- AppKey
- AppSecrect
然后进入开放平台的帐号首页,在企业信息下获取企业ID, CorpID

设置服务器IP访问权限:
140.179.154.207
71.132.47.54
47.95.204.94
182.92.233.90
59.110.69.65
39.96.177.194
59.110.115.67
101.201.147.89
可点击链接https://www.jijyun.cn/help/detail/568查看IP白名单地址

设置可使用范围,并发布应用

设置应用可用权限,建议包括下图中的权限

将上述信息添加到集简云添加钉钉帐号界面的指定位置中:

如何进行权限申请?
- 进入钉钉开放平台
- 应用开发-企业内部应用开发-服务端-找到使用动作所属的一级板块,点击展开,即可看到【权限申请】文档;例:在集简云选择"创建用户"这个执行动作,那么这个动作再钉钉开放平台属于一级"通讯录管理"板块,点击 "展开" 按钮,找到【权限申请】文档,即可查看到相关信息

具体如何开通,我们以"获取通讯录权限"为例演示
在调用通讯录接口前,需要在开发者后台添加对应的接口权限并设置权限范围(部门数据还是部分用户数据)
开发者在调用通讯录接口时,只能获取到在授权范围内的员工通讯录信息,获取非授权范围内的员工通讯录信息会提示获取部门/员工不在授权范围内
。可通过调用获取通讯录权限范围接口查看当前应用的通讯录权限。
参考以下操作进行接口授权:
- 登录开发者后台,单击目标应用打开详情页。
- 在权限管理页面,单击通讯录管理。

3. 选择需要添加的通讯录接口权限,单击申请权限或批量申请。

4. 设置通讯录接口的权限范围。
- 全部员工:可获取全部员工的通讯录信息。
- 部分员工:选择授权开放通讯录权限的部门和人员。
如下图所示,在调用通讯录相关接口时只能对开放平台的这个部门进行操作。如果对权限范围之外的其他部门通讯录进行操作,则会报错。
注意:权限范围只有添加了通讯录接口权限后才生效。

应用使用示例
- 钉钉+阿里云短信:当钉钉审批完成后,发送短信通知相关员工或者客户
- 钉钉+MySQL数据库: 员工在钉钉打卡后,同步打卡信息到企业数据库中保存
- 百度推广+钉钉通知:当百度推广有新线索添加时,发送钉钉通知销售跟进
- Teambition+钉钉待办事项:当Teambition新增任务时,同步创建钉钉待办事项给任务负责人