1. 内置节点
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. 内置节点

Webhook触发

Webhook触发器使用手册#

概述#

Webhook触发器是AI FLOW流程的外部调用入口,支持通过HTTP请求触发流程执行。它提供了灵活的参数传递和执行控制机制,适用于外部系统集成、API回调等场景。

功能特性#

HTTP请求触发:通过POST/GET等HTTP方法触发流程
参数传递:支持JSON格式的参数传递给流程
执行模式:支持同步和异步两种执行模式
安全控制:IP白名单限制访问来源
状态反馈:提供执行结果和错误信息

配置参数#

hookUrl#

类型:String
描述:Webhook的回调URL,由系统自动生成
示例:https://api.example.com/webhook/flow-123

type#

类型:String
描述:执行方式,支持"同步"和"异步"
默认值:异步

value#

类型:Object
描述:输入参数,支持JSON对象或数组
示例:json\{"userId": "12345","action": "create","data": \{"name": "example"\}\}

ipList#

类型:String
描述:IP白名单,逗号分隔的IP地址列表
示例:192.168.1.1,10.0.0.1/24

使用方法#

1. 配置Webhook触发器#

在StartEvent节点中选择Webhook作为触发器类型,系统会自动生成唯一的hookUrl。

2. 调用Webhook#

使用HTTP客户端调用生成的URL:
# 异步调用示例
curl -X POST https://api.example.com/webhook/flow-123 \
  -H "Content-Type: application/json" \
  -d '{
    "type": "异步",
    "value": {
      "param1": "value1",
      "param2": "value2"
    },
    "ipList": "192.168.1.100"
  }'

# 同步调用示例
curl -X POST https://api.example.com/webhook/flow-123 \
  -H "Content-Type: application/json" \
  -d '{
    "type": "同步",
    "value": {
      "input": "test data"
    }
  }'

3. 处理响应#

异步模式响应#

{
  "requestId": "req_123456789",
  "status": "accepted",
  "message": "请求已接受,正在后台处理"
}

同步模式响应#

{
  "requestId": "req_123456789",
  "status": "completed",
  "result": {
    "output": "处理结果",
    "statusCode": 200
  }
}

执行逻辑#

同步执行流程#

1.
接收HTTP请求
2.
验证IP白名单
3.
解析请求参数
4.
执行流程直到完成
5.
返回执行结果

异步执行流程#

1.
接收HTTP请求
2.
验证IP白名单
3.
解析请求参数
4.
生成requestId并返回
5.
后台异步执行流程
6.
可通过API查询执行状态

安全特性#

IP白名单验证#

如果配置了ipList,只有白名单内的IP才能触发流程
支持单个IP和CIDR网段格式
未配置白名单时允许所有IP访问

请求频率限制#

系统内置频率限制,防止恶意调用
超频请求会被拒绝并记录日志

错误处理#

常见错误码#

400 Bad Request:请求参数格式错误
403 Forbidden:IP不在白名单内
429 Too Many Requests:请求频率超限
500 Internal Server Error:服务器内部错误

错误响应格式#

{
  "error": {
    "code": "INVALID_IP",
    "message": "IP地址不在白名单内",
    "details": "请求IP: 192.168.1.200"
  }
}

最佳实践#

1. 使用HTTPS#

在生产环境中确保Webhook URL使用HTTPS协议,确保数据传输安全。

2. 配置IP白名单#

始终配置IP白名单,只允许信任的服务器访问。

3. 错误处理#

在调用方实现重试机制和错误处理逻辑。

4. 参数验证#

在流程开始处添加参数验证,确保输入数据符合预期格式。监控和日志

执行日志#

每次Webhook调用都会记录详细日志
包含请求参数、执行时间、结果等信息
可在系统日志界面查看

性能监控#

响应时间统计
成功率监控
错误率告警

常见问题#

Q: 如何获取requestId用于查询异步结果?#

A: 异步调用时,系统会立即返回包含requestId的响应。您可以使用此ID调用查询API获取最新执行状态。

Q: IP白名单支持哪些格式?#

A: 支持单个IP(如192.168.1.1)和CIDR网段(如10.0.0.0/24)。多个地址用逗号分隔。

Q: 同步调用超时时间是多少?#

A: 同步调用的默认超时时间为5分钟。如果流程执行时间超过此限制,会返回超时错误。

AI Webhook与传统连接流Webhook对比#

AI连接流的Webhook触发器与连接中心的Webhook存在以下差异:
特性AI连接流Webhook连接流Webhook
触发方式POST请求POST请求
默认执行模式异步同步
参数格式JSON(type/value/ipList)JSON(直接参数)
IP白名单支持支持
频率限制有有
主要区别说明:
1.
执行模式默认值不同:AI连接流默认异步执行,连接流默认同步执行
2.
参数结构不同:AI连接流的Webhook使用嵌套的type和value结构,连接流使用扁平化参数结构
3.
适用场景:AI连接流适用于需要AI处理、长流程或后台处理的场景;连接流适用于快速同步响应场景
如需了解传统连接流的Webhook配置,请参考连接中心相关文档。
修改于 2026-05-07 01:44:57
上一页
数字签名
下一页
缓存列表处理
Built with