易快报对接飞书的五个关键步骤
本文通过配置易快报出站消息、获取易快报token、配置飞书机器人、获取飞书token、业务需求开发,这五个步骤,来讲述易快报的消息通知自动推送至飞书的基本过程。
建议阅读人员
OA/费控/ERP/飞书系统管理员、IT实施等人员、希望实现费控系统(易快报)与飞书两个系统之间数据同步的程序开发人员。
适用场景
用户在易快报的审批流程或支付等业务中产生待审批、待寄送、待收单、待支付、被驳回、已支付/审批完成、催办、超时提醒、审批通过、抄送、评论、被@、打印提醒、单据撤回的数据时,在飞书中能够自动接收到通知消息,并且点击通知中的链接后,能够打开易快报对应的单据,进行审批、支付或查看,无需再去登录易快报。
数据流程
易快报对接飞书的
实现原理
- 利用易快报开放平台的Open API接口实现消息通知的接收;
- 利用飞书开放平台的Open API接口实现消息通知的推送;
- 最终利用两个系统各自的API接口,结合具体的业务需求,实现系统间的数据同步。
第一步:配置易快报出站消息
先来解释一下什么是出站消息,出站消息是由“易快报”触发,并且自动向外部系统发送的Post接口请求,用于解决“易快报”与外部系统(如OA系统)的自动对接。换种表达方式的话,那就是通过出站消息这种能够自动执行业务流程的触发器,来实现自动化传递信息(如通知消息、业务数据等)。当前出站消息支持【Ebot节点触发】和【单据流转时触发】两种实现方式。
在本文中我们使用的是【单据流转时触发】,但是要注意出站消息受charge控制,也就是说如果出站消息charge授权关闭,则会导致无法新建出站消息,已经配置好的出站消息则不受影响
管理员登录易快报的后台后,进入【系统设置】-【出站消息】,点击【新增】打开页面后,选择需要同步的审批事件,及出站时需要调用的URL接口,再选择需要发送的单据字段就可以了。
第二步:获取易快报AccessToken
易快报网页端打开后进入【扩展中心】页面,点击【开放接口】-【获取验证码】,就可以拿到开放接口的验证码(即VerifyCode),但是要注意这个验证码的有效期为2小时,且同一验证码只能使用一次。所以在拿到验证码后,就要尽快调用【获取授权接口】来拿到accessToken及refreshToken,
Response:
{
"value": {
"accessToken":