1、登录钉钉后台创建应用(首次)

https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app

2、拿到应用相关配置 复制给IT(首次)

3、给应用添加权限(首次)



qyapi_get_attendance_data 考勤组读取权限
qyapi_get_department_member 通讯录部门成员读权限
qyapi_get_member_by_mobile 根据手机号获取成员基本信息权限
fieldMobile 企业员工手机号信息
qyapi_get_member 成员信息读权限
qyapi_get_department_list 通讯录部门信息读权限

4、配置群机器人 Webhook 添加到FMS字典里

4.1.1方式一 配置自定义机器人(不冲突)



4.1.2方式二 配置默认机器人(推荐)

配置完默认机器人要点击发布 才会生效

4.2群聊里添加机器人 不用每次自定义机器人(方便)


4.3复制webhook后的access_token到FMS字典里(必须)

offshop_employee_config_talk_token 字典类型


执行以下步骤需 先把相关配置给到IT

5、补卡通知配置(首次)

补卡数据原本是月初拉取上一个月的,纯在较大延时,使用钉钉Stream模式创建一个长链接通知B2B系统,实现实时数据推送

5.1、增加权限

qyapi_aflow 审批流数据管理权限
Workflow.Instance.Read 工作流实例读权限

5.2、点击事件订阅测试链接

测试Steam 是否能接入,如果不能,联系IT重建链接

5.3、增加订阅规则


为什么要增加订阅规则呢?免费版只给3000次通知,为了减少次数消耗,只处理补卡审核完成的通知

但是钉钉怎么知道是哪个表单提交的补卡审核呢?需要替换以上规则的表单ID


复制表单ID 替换processCode后表单ID即可

规则:
/v1.0/event/bpms_instance_change/bizCategoryId/attendance.supply/processCode/PROC-A84B93AD-34B4-41A5-A1F3-69F16E3A3D7E/type/finish
例子:复制出来的表单ID是ABC 替换规则后
/v1.0/event/bpms_instance_change/bizCategoryId/attendance.supply/processCode/ABC/type/finish

6、发布应用(必须)



版本描述 随便填,不影响,点击保存 发布即可

总结

现在所有门店都在一个组织,上面操作步骤都已经配置好了,只需要把群聊机器人webhook后的access_token配置到FMS字典里(详细看步骤4.3)

如果是一个门店一个组织,操作步骤类似,详细看offshop_employee_config表字段