钉钉自定义审批表单事件订阅，如何解决？

钉钉自定义审批表单事件订阅配置指南

在钉钉中实现自定义审批表单的事件订阅，需要完成以下步骤。这些步骤包括钉钉微应用的配置、OA审批对接以及事件订阅的具体设置。

一、前提条件

1. 钉钉企业管理员权限：确保您是钉钉团队的管理员，并已创建至少包含一名企业员工的团队。
2. Quick BI与钉钉绑定：需将Quick BI网页版的钉钉账号与钉钉团队绑定。
3. 开通相关权限：
   • 在钉钉权限管理中开启以下权限：
     • 工作流实例写权限
     • 工作流模板写权限
     • 工作流模板读权限
     • 工作流实例读权限

二、钉钉微应用配置

1. 扫描二维码安装微应用：

   • 使用钉钉移动端扫描指定二维码，选择所属团队完成应用安装。
   • 确保当前用户为团队管理员。

2. 获取并绑定CorpId：

   • 登录钉钉开发平台，获取CorpId参数。
   • 在Quick BI控制台中填入CorpId并保存，完成接口授权。

3. 微应用打开方式配置（可选）：

   • 默认打开方式为“工作台”，可根据需求配置为“跳转浏览器”（仅对PC端生效）。

三、Quick BI对接钉钉OA审批

1. 启用钉钉渠道审批：

   • 登录Quick BI控制台，进入“审批设置”页面。
   • 勾选“钉钉渠道审批”，选择官方模板并单击“一键生成”。
   • 此操作将在钉钉企业OA审批应用中创建一个Quick BI审批模板。

2. 测试审批流程：

   • 保存设置后，单击“测试”按钮，发起一个OA审批实例以验证流程是否正确创建。

四、事件订阅配置

1. 创建事件订阅规则：

   • 在Quick BI或相关产品中，进入“事件中心”页面。
   • 单击“订阅规则”，然后单击“新建订阅规则”。
   • 在弹出的面板中，选择需要订阅的事件模式（如审批事件），并单击“下一步”。

2. 配置通知对象：

   • 设置通知方式，支持以下四种方式（可多选）：
     • 手机短信
     • 邮件
     • 钉钉机器人
     • 手机短信+邮件
   • 选择联系人或创建新联系人，支持同时选择多个联系人。

3. 设置事件触发条件：

   • 配置事件来源、资源类型、事件类型和事件通知生效资源。
   • 设置检查周期和触发通知阈值。例如：
     • 检查周期：在X秒内出现该事件达到N次及以上时触发通知。
     • 触发通知阈值：累计触发次数达到设定值时发送通知。

4. 启用订阅规则：

   • 默认开启订阅规则。如果关闭开关，规则创建成功后状态将显示为“已停止”，后续可通过“启用”操作重新激活。

五、常见问题及解决方案

1. 问题描述：创建钉钉OA官方审批模板时提示“没有调用该接口的权限”。

   • 原因：钉钉权限管理未开启相关OA审批权限。
   • 解决方案：确保已开启工作流实例写权限、工作流模板写权限、工作流模板读权限和工作流实例读权限。

2. 问题描述：钉钉应用内的审批结果无法同步到Quick BI。

   • 解决方案：
     • 检查配置一致性：确保Quick BI内钉钉的事件订阅配置与钉钉企业内部应用的事件订阅配置中的加密 aes_key 和签名 token 一致。
     • 检查网络问题：确认Quick BI的域名是否为公网域名。

六、测试与验证

1. 测试报警通知：

   • 创建订阅规则后，测试是否能收到报警通知。
   • 注意：报警通知可能会有一定的时间延迟，请耐心等待。

2. 验证事件投递：

   • 在钉钉中触发新增成员或审批事件，查询事件追踪以验证事件是否成功投递。

通过以上步骤，您可以顺利完成钉钉自定义审批表单的事件订阅配置，并实现审批结果的自动化处理和通知功能。