功能简介

webhook是无代码维格云应用中,流程上的一个节点(如下图)。在这个节点,您可以通过简单的配置,当数据流经该节点时,自动触发并使用您所需的第三方系统API提供的功能,如向钉钉系统增加新成员,调用谷歌日历,发送邮件,Trello增加卡片,github增加Issue等等。您也可以基于无代码维格云进行二次开发,与公司已有的系统进行对接。
Webhook也支持全局配置,在轻商城-插件中心-第三方连接-webhook配置界面进行配置后保存,即可以配置并生成全局可用的Webhook模版,方便您的后续使用。
目前webhook功能仅对alpha版本用户开放,如需试用或升级,请联系我们(具体见本文底端)。
Webhook - 图1

设置步骤

(1) 请先确认您的版本:Webhook 为一种Q-Robot节点,目前仅开放给Alpha版本及以上用户,如需试用或升级,请联系我们(具体见本文底端)。
(2) 在轻商城-插件中心-第三方连接中安装Webhook功能
Webhook - 图2
(3) 编辑应用流程时,添加Webhook节点,点击后可以看到以下配置内容
Webhook - 图3
Webhook - 图4
(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配置详解
跟着无代码维格云学管理
image.pnghttps://learn.qingflow.com/detail/v_60a51171e4b0adb2d865baf0/3

使用案例

案例:向钉钉创建群会话
场景描述 企业新进一名员工,人力资源部门想直接用无代码维格云的应用,录入员工信息后直接为他创建钉钉账号。 解决方案 上述场景,我们可以使用Webhook功能轻松实现。 操作步骤 第一步:获取权限 首先,确定您有相关权限,详情参考权限申请

案例:连接无代码维格云和语雀
前置工作 获取login参数 进入个人主页 获取地址栏url中的最后一部分,即参数login(在创建知识库功能中需要这个参数,其他功能不一定需要的是这个) 配置语雀的鉴权 按照语雀开发者文档和无代码维格云鉴权文档配置语雀的OAuth2.0鉴权

案例:向企业微信群推送消息
场景描述 企业正在快速发展期,每次入职新同事,人事都要向公司群发送欢迎语,部门、姓名都要修改,比较麻烦,她希望每次在无代码维格云中入职一位同事时,能够自动发送欢迎语到微信群里。 解决方案 上述场景,我们可以使用Webhook功能轻松实现。 操作步