请输入
菜单

飞书应用

一、功能简介

1.1飞书企业自建应用能带来什么

只要集成积加ERP在飞书内，您企业可获得的能力：
  • 通过飞书工作台访问积加ERP，只需要授权一次，快捷方便
  • 飞书内扩展机器人推送审批单据，便捷审批

备注：目前支持审批单据，持续完善中：
采购订单、调拨单、采购计划、供应商产品、发货计划、移除订单、申请单、其他费用、推广费用、listing调价、促销活动、售后工单
 


1.2 流程图


1.3 飞书自建企业应用具体步骤

步骤一：成为飞书企业用户

在飞书开放平台上开发应用前，你必须先成为飞书的企业用户。你可以通过以下任一方式成为企业用户：
  • 创建企业
  • 如果你是企业管理员，可以进入飞书官网，点击右上角的 免费试用，注册并创建企业账号。创建完成后，你将默认成为企业管理员，并拥有邀请企业成员、管理企业组织架构等权限。详情参见注册企业账号。
  • 加入企业
  • 如果你是企业普通成员，并且所在的企业已使用飞书，可以联系企业管理员，获取任意方式的邀请（例如：企业链接、企业二维码、企业邀请码、手机短信），在飞书中加入所在企业。详情参见加入企业。
 

步骤二：创建企业自建应用

  1. 在 开发者后台，点击 创建企业自建应用。
填写应用基本信息，包括应用名称、应用描述、应用图标，并点击 创建。
 
名称：积加ERP
应用描述：积加致力于成为跨境电商最值得信赖的企业，推动企业可持续发展，实现品牌出海，货通全国。
LOGO原图：
 

步骤三：配置应用

配置两大应用能力：机器人(审批单推送)、网页(飞书工作台访问积加ERP)。
  1. 在左侧导航栏，进入 应用能力 > 添加应用能力 页面。
  2. 在该页面中，选择添加应用能力机器人、网页。
机器人
网页应用

配置桌面端主页+移动端主页ERP域名

示例：https://gongyinglian1.localtest.gerpgo.com/auth/login-feishu?appId=cli_a8f26ccea9bd100d（！！！注意：此处的appid记得改成上一步自建飞书应用的appdi）

示例说明：【https://gongyinglian1.localtest.gerpgo.com】为积加ERP域名

【/auth/login-feishu?appId=cli_a8f26ccea9bd100d】中的appId是飞书管理后台中应用凭证的App ID 

 

 
 

步骤四：开通应用权限

部分权限需要企业管理员审核通过，不能直接开通，建议用管理员账号操作。
开通 API 权限后，积加才能调用飞书 API。详细权限清单见：
  • 获取通讯录基本信息
  • 获取通讯录部门组织架构信息
  • 获取用户基本信息
  • 获取部门基础信息
  • 获取用户组织架构信息
  • 获取用户 user ID
  • 获取与发送单聊、群组消息
  • 以应用的身份发消息
  • 更新消息

 配置好的样：

 

配置入口

消息条数限制：飞书对应企业自建应用有对应的API限制，目前飞书基础免费版，单租户下所有企业自建应用API调研总量是10000次/月。
 

 

批量创建应用代码：（使用批量导入下边JOSN代码即可）

{ "scopes": { "tenant": [ "contact:contact.base:readonly", "contact:department.base:readonly", "contact:department.organize:readonly", "contact:user.base:readonly", "contact:user.department:readonly", "contact:user.employee_id:readonly", "im:message", "im:message:send_as_bot", "im:message:update" ], "user": [] } }

配置完权限后要配置范围

步骤五：安全设置

将ERP域名配置到安全设置中，如图所示

配置完效果：

重定向URL填写积加登录域名+/auth/login-feishu，例如https://gongyinglian1.localtest.gerpgo.com/auth/login-feishu
H5可信域名直接填写积加登录域名即可，例如https://gongyinglian1.localtest.gerpgo.com

步骤六：发布应用

 
在开发自建应用的过程中，当应用的 基本信息、权限范围、应用功能 和 事件订阅 等信息发生变更时，都需要发布新的应用版本，并且通过企业租户管理员的审核后才能生效。
  1. 在开发者后台进入需要发布的应用详情页。
  2. 在左侧导航栏，选择 应用发布 > 版本管理与发布，并点击 创建版本。
  1. 在 版本详情 页面完善并核对应用版本信息，点击 保存，并点击 申请线上发布。等待企业租户管理员通过审核后，应用即可发布上线。
 
注意，权限可见范围勾选全部成员。

步骤七：回传凭证给积加

完成以上步骤后，请将应用的凭证：AppKey、AppSecret给到积加。（在基础信息里面看凭证与基础信息）

管理员如何授权飞书权限

同钉钉授权，在用户管理中选中需要授权的用户-授权第三方账号-授权飞书

二、常见问题

Q1：一期上线的飞书应用支持什么功能？


A1：支持飞书审批和飞书应用内使用ERP

飞书审批

在消息设置-任务通知-任务通知设置-选择对应单据-选择通知方式为【飞书工作消息】，即可推送审批消息到飞书，点击审批会打开审批单详情页，在页面内完成审批即可（移动端飞书和PC端飞书均可查看）

A2:支持飞书内单点登录ERP应用

在飞书-工作台-找到管理员配置的积加内部应用，点击后可以直接登录到ERP系统（前提是系统管理员已经为您授权飞书权限）

 

Q2：授权飞书一直显示数据同步中或飞书审批时登录报错，如何处理？

   需要检查自建应用的3个配置页面。

1、检查开发配置->权限管理，开通的权限清单是否正确，列表上的可访问数据范围是否包含全部成员。

     

2、检查开发配置-安全设置，重定向url和H5可信域名是否填写正确，一定要记得修改为erp登录的域名。

         重定向URL：积加登录域名+/auth/login-feishu，例如https://gongyinglian1.localtest.gerpgo.com/auth/login-feishu

         H5可信域名：积加登录域名即可，例如https://gongyinglian1.localtest.gerpgo.com
 
3、检查应用能力-网页应用，桌面端主页和移动端主页是否填写正确，一定要记得修改为erp登录域名
         填写：积加登录域名+/auth/login-feishu?appId=自建应用appid
         例如：https://gongyinglian1.localtest.gerpgo.com/auth/login-feishu?appId=cli_a8f26ccea9bd100d
最近修改: 2025-08-25