交互节点：HTTP交互

快速阅读

本文用于统一说明呼叫中心 IVR 交互节点中的“HTTP交互节点”产品口径。HTTP交互节点用于在 IVR 流程中调用客户外部业务系统，把通话上下文、客户输入、内置变量或自定义变量传给外部系统，并根据调用结果进入成功或失败路径。

本文的核心结论是：

• HTTP交互节点是 IVR 与外部业务系统协同的节点，适合查询订单、校验会员、获取客户标签、写入业务结果等场景。
• HTTP交互节点不是普通播放节点，也不是脚本节点；它更适合“固定请求 + 参数 + 成功/失败分支”的外部系统调用。
• HTTP交互节点需要明确请求地址、请求方式、请求参数、超时时间、重试策略、成功路径和失败路径。
• 请求参数可引用内置变量、自定义变量、通道变量或收号结果，但变量为空、格式错误、敏感信息外泄是主要风险。
• HTTP交互结果是否进入话单、推送、导出或报表，取决于后续变量写入和沉淀配置，不应默认承诺。

阅读地图

• 如果只想理解 HTTP交互节点是什么，重点阅读“二、产品总览”和“三、核心概念”。
• 如果要配置外部系统调用，重点阅读“六、产品功能说明”。
• 如果要处理超时、失败和变量传递，重点阅读“八、上线准备与运营建议”和“十、FAQ”。
• 如果要做上线验收，重点阅读“附录 C：实施检查清单”。

一、文档说明

1.1 文档目的

IVR 流程中经常需要和客户业务系统协同。例如客户输入订单号后，IVR 需要查询订单状态；客户输入会员号后，系统需要校验客户身份；客户在机器人或菜单中选择某项服务后，业务系统需要返回下一步处理结果。

HTTP交互节点用于承接这类外部系统调用。

如果 HTTP交互节点配置不清，容易出现：

1. 客户等待外部系统超时。
2. 请求参数缺失或变量为空。
3. 外部系统返回异常后没有失败兜底。
4. 敏感参数进入日志、推送或外部系统。
5. 外部系统返回值没有写入变量，后续节点无法判断。
6. 把复杂业务逻辑全部堆在 IVR 节点里，导致流程难维护。

本文用于建立 HTTP交互节点的统一说明，支撑 IVR 自助查询、会员校验、业务状态判断、外部系统协同和上线验收。

1.2 适用对象

• 客户业务负责人：用于确认 IVR 需要查询或写入哪些业务系统。
• 运营管理人员：用于分析自助查询成功率、失败率和转人工情况。
• 实施顾问：用于配置请求参数、变量、成功/失败路径和联调验收。
• 产品经理：用于统一 HTTP交互节点与变量、脚本节点、推送和话单的口径。
• 技术负责人：用于理解外部系统超时、参数安全、对接边界和排障方法。

1.3 文档范围

本文覆盖 IVR HTTP交互节点的产品说明，包括外部请求、参数传递、变量引用、超时、重试、成功路径、失败路径、返回结果使用、记录与推送影响、上线验收。

本文不展开代码实现、底层调用链路和内部实现细节。具体支持的请求方式、参数格式和返回值处理能力以实际系统版本为准。

二、产品总览

2.1 什么是 HTTP交互节点

HTTP交互节点是 IVR 中用于调用外部业务系统的交互节点。它可以把当前通话上下文和业务参数发送给客户系统，并根据调用结果继续执行后续流程。

人话总结：

HTTP交互节点就是“IVR 在流程中问一下外部系统，然后根据结果继续走”的节点。

2.2 HTTP交互节点解决什么问题

HTTP交互节点适合解决：

• 查询订单状态。
• 校验会员身份。
• 获取客户等级或标签。
• 查询工单进度。
• 写入客户选择结果。
• 请求外部系统返回转人工策略。
• 获取机器人或业务系统处理结果。

2.3 HTTP交互节点不是什么

2.4 核心价值

三、核心概念

3.1 请求地址

请求地址是 IVR 需要调用的客户业务系统地址。客户版文档中应说明为“外部业务系统地址”，不暴露内部实现细节。

3.2 请求参数

请求参数是发送给外部系统的字段，常见包括客户号码、订单号、工单号、通话标识、客户 ID、IVR 选择结果等。

3.3 请求方式

请求方式表示如何调用外部系统。具体支持能力以实际系统版本为准。

3.4 超时时间

超时时间用于控制等待外部系统返回的最长时间。超时后应进入失败路径或兜底路径。

3.5 重试策略

重试策略用于外部请求失败时是否再次尝试。重试可提高成功率，但也可能增加外部系统压力。

3.6 成功路径

成功路径是外部系统调用成功后进入的下一节点。

3.7 失败路径

失败路径是外部系统调用失败、超时或返回异常时进入的下一节点。

3.8 返回变量

返回变量是外部系统返回后被 IVR 后续节点使用的结果。是否支持返回值写入变量，以实际系统版本和配置为准。

四、对象关系与主流程

4.1 标准 HTTP交互流程

客户进入 HTTP交互节点
↓
读取通话上下文和请求参数
↓
调用外部业务系统
├─ 调用成功：进入成功路径
├─ 调用失败：进入失败路径
└─ 调用超时：进入超时或失败路径
↓
后续节点读取结果变量
↓
播放、判断、转人工、推送或记录沉淀

4.2 与变量的关系

HTTP交互节点通常读取变量作为请求参数，也可能把外部返回结果写入变量。

变量来源包括：

• 内置变量。
• 自定义变量。
• 缓存变量。
• 收号结果。
• 机器人会话信息。
• 外呼任务字段。

4.3 与话单和记录的关系

HTTP交互节点本身不代表话单字段。若客户需要事后查询请求结果，应明确返回值是否写入变量，并配置进入记录、推送或导出。

4.4 与推送和日志的关系

HTTP交互节点的调用结果可用于排障。是否有日志查询、是否推送给客户系统、是否可重推，应以实际配置和版本为准。

五、能力地图

六、产品功能说明

6.1 请求参数配置

请求参数应按业务系统要求配置。

建议：

• 参数名和客户系统一致。
• 参数值来源明确。
• 变量为空有处理策略。
• 敏感信息不明文传递。

6.2 变量引用

HTTP交互节点可引用当前通话上下文中的变量。

常见变量：

• 客户号码。
• 订单号。
• 工单号。
• 通话标识。
• 客户 ID。
• 按键结果。
• 收号结果。

6.3 成功路径

成功路径应进入符合业务预期的节点。

例如：

• 播报查询结果。
• 进入判断节点。
• 进入队列。
• 进入机器人。
• 结束流程。

6.4 失败路径

失败路径必须配置。

常见方式：

• 播放失败提示。
• 重新输入。
• 转人工。
• 留言。
• 结束流程。

6.5 超时控制

外部系统超时会直接影响客户体验。

建议：

• 超时时间不宜过长。
• 业务系统慢时进入人工或留言。
• 关键外部系统应有监控和告警。

6.6 重试控制

重试应谨慎配置。

适合：

• 偶发网络抖动。
• 非关键查询。

不适合：

• 会重复写入业务结果的请求。
• 会增加客户等待的长耗时请求。
• 客户系统承压场景。

6.7 返回结果使用

若外部系统返回业务结果，应确认：

• 是否写入变量。
• 后续节点是否读取。
• 是否需要播报。
• 是否需要推送或记录沉淀。
• 失败或空结果如何处理。

七、典型业务场景

7.1 订单状态查询

客户输入订单号后，HTTP交互节点查询订单系统，成功后播放订单状态，失败后转人工。

7.2 会员身份校验

客户输入会员号或手机号后几位，HTTP交互节点校验身份，命中后进入会员服务路径。

7.3 工单进度查询

客户输入工单号，HTTP交互节点查询进度，成功播报，失败进入人工队列。

7.4 客户标签获取

系统根据客户号码获取客户标签，后续判断是否 VIP、投诉客户或高风险客户。

7.5 业务结果写入

客户在 IVR 中完成确认后，HTTP交互节点把确认结果写入客户业务系统。

八、上线准备与运营建议

8.1 上线前确认事项

1. 外部系统地址和访问权限已确认。
2. 请求参数清单已确认。
3. 变量来源已确认。
4. 超时时间和重试策略已确认。
5. 成功路径和失败路径已配置。
6. 敏感字段已脱敏。
7. 返回结果是否需要沉淀已确认。
8. 外部系统异常时有兜底。

8.2 运营建议

• 监控外部系统响应稳定性。
• 分析 HTTP交互失败后转人工比例。
• 对高频失败请求优化参数和兜底。
• 不把复杂业务逻辑全部堆在 IVR 节点中。

8.3 验收建议

验收应覆盖：

• 参数正确。
• 调用成功。
• 调用失败。
• 调用超时。
• 返回值为空。
• 变量写入和后续读取。
• 记录和推送按需沉淀。

九、与周边能力的关系

9.1 与收号节点的关系

收号节点可生成订单号、工单号等变量，HTTP交互节点可读取这些变量调用外部系统。

9.2 与判断节点的关系

HTTP交互节点可获取结果，判断节点根据结果决定后续路径。

9.3 与变量节点的关系

如果需要加工或保存返回结果，可使用变量节点处理后续上下文。

9.4 与推送的关系

HTTP交互是 IVR 流程中主动调用外部系统；推送是事件发生后把结果发给外部系统。

9.5 与话单的关系

HTTP交互结果不自动进入话单。需要长期追溯时，应配置沉淀字段。

十、FAQ

10.1 HTTP交互节点和推送有什么区别？

HTTP交互是 IVR 主动调用外部系统；推送是事件发生后系统通知外部系统。

10.2 外部系统超时怎么办？

应进入失败路径，例如转人工、留言或播放失败提示。

10.3 返回结果能否用于 TTS 播报？

可以，但需要写入变量，并确认变量有值和播报内容适合语音表达。

10.4 HTTP交互结果是否会进入记录？

不一定。需要配置变量沉淀或记录字段。

10.5 能不能把复杂逻辑都写在 HTTP交互节点里？

不建议。复杂逻辑应由外部系统或脚本/自定义节点承接，IVR 只处理清晰的成功/失败路径。

十一、总结

HTTP交互节点是 IVR 与外部业务系统协同的重要节点。它适合查询、校验、写入和获取业务结果，但必须控制超时、失败兜底、参数安全和变量沉淀边界。

附录 A：入口与权限

附录 B：关键字段口径

附录 C：实施检查清单

附录 D：常见问题速查

附录 E：术语表