飞书审批集成 ZOHO CRM

飞书审批集成 ZOHO CRM

使用飞书审批插件，可以将CRM 数据提交到飞书进行审批，在飞书中即可统一完成审批信息处理，享受一站式的办公体验。
Info
  1. 适用版本：Zoho CRM旗舰版、Zoho CRM超级版、CRMPlus、Zoho One。
  2. 只有Zoho CRM的管理员才能够安装此扩展程序。

一、创建飞书应用

  1. 登录飞书应用管理平台中，选择相应的组织，进入后台页面。
  2. 点击创建企业自建应用，填写应用基础信息，并点击创建。

二、配置飞书应用

1. 点击权限管理，批量开通(方法 1)：
  1. 审批所有权限

  2. 通讯录所有权限

2. 批量导入权限（方法 2）：
  1. { "scopes": { "tenant": [ "contact:contact", "contact:contact:update_department_id", "contact:contact:update_user_id", "contact:department.base:readonly", "contact:department.hrbp:readonly", "contact:functional_role", "contact:functional_role:readonly", "contact:group", "contact:group:readonly", "contact:job_family", "contact:job_family:readonly", "contact:job_level", "contact:job_level:readonly", "contact:job_title:readonly", "contact:role:readonly", "contact:unit", "contact:unit:readonly", "contact:user.assign_info:read", "contact:user.department:readonly", "contact:user.dotted_line_leader_info.read", "contact:user.employee_number:read", "contact:user.job_family:readonly", "contact:user.job_level:readonly", "contact:user.subscription_ids:write", "contact:work_city:readonly", "tenant:tenant.product_assign_info:read", "approval:approval", "approval:approval.list:readonly", "approval:approval:readonly", "approval:definition", "approval:external_approval", "approval:external_instance", "approval:instance", "approval:instance.comment", "approval:task", "contact:contact.base:readonly", "contact:department.organize:readonly", "contact:user.base:readonly", "contact:user.email:readonly", "contact:user.employee:readonly", "contact:user.employee_id:readonly", "contact:user.gender:readonly", "contact:user.id:readonly", "contact:user.phone:readonly", "corehr:authorization:read", "corehr:process.instance:write", "passport:session_mask:readonly" ], "user": [ "approval:approval:readonly", "contact:contact.base:readonly", "contact:department.organize:readonly", "contact:user.base:readonly", "contact:user.email:readonly", "contact:user.employee:readonly", "contact:user.employee_id:readonly", "contact:user.gender:readonly", "contact:user.id:readonly", "contact:user.phone:readonly", "serviceaccount:approval:approvals:read" ] } }
3. 配置数据权限范围
点击可访问的数据范围 -> 配置 -> 通讯录 ->配置 -> 全部成员 -> 保存。
Notes
注意：建议允许获取到所有用户，否则可能导致无法提交审批数据。



4.发布版本

当应用的配置信息修改后需要发布版本，页面左上方会有提示“版本发布后，当前修改方可生效。

  1. 点击创建版本
  2. 填入信息后，点击保存，然后发布即可。 
          保存之后，左上方会显示当前修改均已发布。



5.点击凭证与基础信息，复制App ID、App Secret，为Zoho CRM配置作准备。


三、创建审批模板

  1. 进入飞书审批管理后台，点击审批管理 -> 创建审批。

  2. 点击创建自定义审批。
  3. 按照系统提示步骤，创建审批。
Notes
注意：
  1. 在表单设计步骤建议不要开启必填选项。
  2. 暂不支持字段类型：文档，计算公式，日期区间，多维表格，图片/视频，附件，部门，关联审批，地址，定位，收款账户，流水号，控件组,电子签章,引用多维表格,说明,明细表格。

       4. 完成配置后，点击右上角的发布。


      5. 返回审批列表，找到刚创建的审批定义，并点击编辑图标。




      6. 在当前审批定义页面的浏览器地址栏，复制 definitionCode 参数值。
          该值即是当前审批定义的唯一编码（Approval Code），将在后续在 Zoho CRM 中配置。




       7. 配置订阅审批事件，进入开发文档，点击尝试一下。


       8. 通过订阅审批事件，测试应用与审批是否可用：
  1. 填入刚才复制的 definitionCode。
  2. 点击获取Token。
  3. 然后点击开始调试。
    （返回success 即证明成功）

四、Zoho CRM 安装审批插件

  1. 访问设置 -> 应用市场 -> 全部。点击全部的扩展程序, 然后浏览并点击FeishuApproval 扩展程序安装。
  2. 点击安装。

3. 安装完成后，弹窗中填入飞书应用的 App ID、App Secret。

4. 在插件的设置页面，配置CRM 与飞书的用户映射关系。

五、在工作流中使用插件

1. 在Zoho CRM内，访问设置 -> 自动化 >工作流，新建规则。

2. 根据需求设置触发条件。
3. 添加操作，选择 Approval(feishu)。


4. 填入飞书的Approval Code ，点击右边的搜索按钮。



5. 配置字段对应关系。


Notes
注意：
  1. 审批状态字段，需要填入 CRM 状态字段的API名称，以供飞书更新审批状态。
  2. 审批定义名称，填入对应 CRM 的 API名称。

6. 提交后，需要输入一个函数的名字。

    这里，它只是作为在 CRM 系统函数和日志中查看的名字。


六、插件效果

1. 审批数据创建后，在 CRM 中的 FeiShuApprovals 模块内查看。

2. 在飞书中会看到，已经成功发送审批任务。



审批状态结果

1. 插件定时回调
安装插件后，会定时每2个小时执行一次，以获取审批状态，更新数据。
如果在此处配置了 审批状态字段，会将审批状态更细到具体数据中。


2. 通过外部服务实现

若想要通过外部部署来订阅飞书审批事件的回调，请参考飞书开发文档和 ZOHO CRM API 文档 进行开发并部署。























如果需要技术支持，请联系-  support@zohocorp.com.cn