1. 需求背景
为了满足企业级用户在自动化流程中与外部业务系统进行数据交互的复杂需求，我们正式推出了【外部请求】节点。
通过该节点，您可以轻松将当前工作流中的用户数据或对话数据，实时推送至您的外部业务接口。这不仅打破了系统孤岛，更让您的自动化流程能够真正串联起CRM、ERP或其他业务后台，实现数据的实时流转与处理。
2. 功能概述
版本要求： 专家版本 可用
节点名称： 外部请求
核心功能： 仅需简单配置，即可在自动化流程中向外部接口发送HTTP请求，推送数据。
3. 节点配置详解
在配置【外部请求】节点时，您需要关注以下几个核心模块，以确保数据能够准确无误地送达外部系统。
3.1 请求方式与URL
- 请求方式： 目前支持 POST 和 GET 两种主流请求方式。
- 建议： 若需推送大量结构化数据（如JSON），请务必选择 POST 方式。
- 请求URL： 请输入您的外部系统接口地址。
3.2 请求头 (Headers)
用于定义数据的传输格式或进行身份验证。
- 操作： 点击 ➕ 号可添加多组键值对。
- 示例： 通常需要添加
Content-Type: application/json以确保后端正确解析JSON数据。 - 灵活性： 添加后如需调整，可随时点击删除按钮移除。
3.3 请求体 (Body)
这是推送数据的核心区域。您可以在此处自定义发送给外部系统的数据结构。
- 自定义数据： 支持直接输入静态文本或JSON结构。
- 变量注入： 点击 ➕ 号选择变量，系统将自动将其转换为动态值。
📌 配置示例：
假设您需要将用户姓名和消息内容等推送给外部系统，您的Body配置如下：
{
"name" : "{{contact.name}}",
"message" : "{{conv.current_message}}"
}
(注：${name} 和 ${message} 为动态变量占位符)
3.4 高级设置
- 响应成功HTTP状态码： 用于定义何种HTTP状态码代表请求成功。
- 失败重试次数： 网络波动不可避免，您可以在此设置请求失败后的自动重试次数，确保数据的高可用性。
4. 支持的变量列表
为了让您的外部系统接收到最精准的数据，【外部请求】节点支持丰富的动态变量。以下是目前支持的变量清单：
| 变量名称 | 来源 | 变量代码 | 说明 |
|---|---|---|---|
| 联系人信息 | 取联系人字段上的值 | contact.(xxxxx) | (xxxxx) 为具体的字段名称，例如 contact.phone。 |
| 当前消息 | 当前触发器触发的消息内容 | conv.current_message | 返回JSON序列化后的字符串。包含3个字段： 1. id：消息ID2. content_type：消息类型（text 文本, audio 语音, photo 图片, file 文件, video 视频）3. content：消息内容异常场景： 若节点前置不是用户发送消息触发器，则该字段为空。 |
| 对话ID | 对话 | conv.id | 唯一标识本次对话的ID。 |
| 访问标识 | 对话 | conv.track_id | 用于追踪用户访问的标识。 |
| 渠道 | 对话 | conv.source | 消息来源的主渠道（如 Facebook, Telegram 等）。 |
| 子渠道 | 对话 | conv.sub_source | 消息来源的子渠道。 |
| 对话类型 | 对话 | conv.conv_type | 对话类型： 1: 私信 2: 群组 |
5. 节点配置示意图
图：【外部请求】节点配置界面
📌 进阶功能说明：
当前版本主要满足基础的数据推送需求。关于响应数据映射（支持将外部接口返回的数据回写到本系统中）这一进阶功能，因涉及复杂的业务逻辑适配，属于深度定制服务。我们将视客户的付费合作情况及业务优先级，为您单独评估并排期新增，如有需求，欢迎随时联系商务团队详询。
如有任何配置疑问，欢迎随时联系我们。