功能简介
webhook是无代码维格云应用中,流程上的一个节点(如下图)。在这个节点,您可以通过简单的配置,当数据流经该节点时,自动触发并使用您所需的第三方系统API提供的功能,如向钉钉系统增加新成员,调用谷歌日历,发送邮件,Trello增加卡片,github增加Issue等等。您也可以基于无代码维格云进行二次开发,与公司已有的系统进行对接。
Webhook也支持全局配置,在轻商城-插件中心-第三方连接-webhook配置界面进行配置后保存,即可以配置并生成全局可用的Webhook模版,方便您的后续使用。
目前webhook功能仅对alpha版本用户开放,如需试用或升级,请联系我们(具体见本文底端)。
设置步骤
(1) 请先确认您的版本:Webhook 为一种Q-Robot节点,目前仅开放给Alpha版本及以上用户,如需试用或升级,请联系我们(具体见本文底端)。
(2) 在轻商城-插件中心-第三方连接中安装Webhook功能
(3) 编辑应用流程时,添加Webhook节点,点击后可以看到以下配置内容
(4) 各个配置项说明
配置项名称 | 可填内容 | 用途描述 |
配置模式 | 自定义/使用插件中心模版/使用连接中心模版 | 如果想使用已有的webhook全局配置或连接中心现有的模版,可以选择对应模版直接使用,免去配置过程 |
鉴权方式 | 插件中心已有的鉴权 | 可以使用现有鉴权,省去鉴权步骤 |
URL | 第三方系统api的url,可以插入应用中表单内的字段 | 设置为第三方系统api定义中指定的url |
Method | 目前支持POST/PUT/DELETE/GET | 目前涵盖了常用的方法 |
触发方式 | 默认/自定义 | 默认情况下,会发送无代码维格云预定义好的数据结构到指定url |
Header | 请求发送的header信息 | 请求的header信息,支持自定义值或表单内字段插入 |
Body | url-encoded、application/json、application/xml | 请求的body信息,支持上述三种格式 |
x-www-form-urlencoded | body内容的键值对 |
| | application/json | body内容自定义json结构,可以插入字段 | 这部分属于无代码维格云webhook进阶内容,可以自定义请求体内容,支持传输普通字段、表格子字段、整表格 | | application/xml | body内容自定义xml结构,可以插入字段 | 这部分属于无代码维格云webhook进阶内容,可以自定义请求体内容,支持传输普通字段、表格子字段、整表格 | | 回调更新当前数据 | 可以对返回数据进行自定义解析,更新当前表单字段 | 支持解析XML和JSON格式的返回数据,按照自定义的规则更新到当前表单 |
注意事项
- 在无代码维格云钉钉版使用Webhook前 ,需向无代码维格云申请白名单,否则会影响功能的正常使用
插入字段时,实际插入的内容 | | | | —- | —- | | 插入的字段 | 实际内容 | | 成员字段 | 成员绑定的邮箱 | | 申请人 | 申请人绑定的邮箱 | | 上传附件 | 附件的url | | 日期 | 例:2020-09-18 14:09:46,随设置的精度变化 | | 下拉选择、单项选择 | 选项名称,空格隔开 |
企业微信用户不支持插入申请人、成员与部门字段
- 「数组格式」的结果关联到单值格式字段(如:单行文本)时,只取数组第一个对象值填入
视频课程
您可以点击无代码维格云学院的教学视频来学习如何使用Webhook功能。
SP3 Webhook配置详解
跟着无代码维格云学管理
https://learn.qingflow.com/detail/v_60a51171e4b0adb2d865baf0/3
使用案例
案例:向钉钉创建群会话
场景描述 企业新进一名员工,人力资源部门想直接用无代码维格云的应用,录入员工信息后直接为他创建钉钉账号。 解决方案 上述场景,我们可以使用Webhook功能轻松实现。 操作步骤 第一步:获取权限 首先,确定您有相关权限,详情参考权限申请
案例:连接无代码维格云和语雀
前置工作 获取login参数 进入个人主页 获取地址栏url中的最后一部分,即参数login(在创建知识库功能中需要这个参数,其他功能不一定需要的是这个) 配置语雀的鉴权 按照语雀开发者文档和无代码维格云鉴权文档配置语雀的OAuth2.0鉴权
案例:向企业微信群推送消息
场景描述 企业正在快速发展期,每次入职新同事,人事都要向公司群发送欢迎语,部门、姓名都要修改,比较麻烦,她希望每次在无代码维格云中入职一位同事时,能够自动发送欢迎语到微信群里。 解决方案 上述场景,我们可以使用Webhook功能轻松实现。 操作步