HTTP 请求

本文介绍 HTTP 请求 组件的功能、配置方法、变量以及可连接的组件类型。

组件介绍

HTTP 请求 组件用于向外部 Web 服务器发送 HTTP 请求，实现与第三方应用或服务之间的数据交互。请求的响应结果存储在变量中，可作为后续组件的输入或用于条件判断。
支持的请求类型

  • GET

  • HEAD

  • OPTIONS

  • POST

  • PUT

  • TRACE

  • DELETE

支持的内容类型
  • application/javascript
  • application/json
  • application/x-www-form-urlencoded
  • application/pdf
  • application/xml
  • application/zip
  • multipart/form-data
  • text/css
  • text/html
  • text/plain
  • image/png
  • image/jpeg
  • image/gif

组件配置

  1. 添加 开发者组件 至通话流程后，点击组件进行配置。

  2. 在 组件类型 下拉列表中，选择 HTTP 请求。

  3. 配置 HTTP 请求。
    项目 说明
    URI

    输入 HTTP 请求的目标 URI。

    支持直接填写 URI，或点击 配置表达式以动态生成 URI。

    表达式示例：

    FX_CONCATENATE("https://crm.example.com/check-caller?callernum=",$Session.ani)

    在本例中，请求将发送至 CRM 系统，用于校验来电号码并识别用户类型。

    注： 更多关于表达式的信息，请参见 支持的变量和函数。
    请求类型 选择 HTTP 方法。

    • GET

    • HEAD

    • OPTIONS

    • POST

    • PUT

    • TRACE

    • DELETE
    请求内容类型 选择请求内容类型。
    • application/javascript
    • application/json
    • application/x-www-form-urlencoded
    • application/pdf
    • application/xml
    • application/zip
    • multipart/form-data
    • text/css
    • text/html
    • text/plain
    • image/png
    • image/jpeg
    • image/gif
    查询参数 点击 添加 设置查询参数。

    支持直接输入参数，或点击 配置表达式以动态指定。

    注：

    表达式示例：

    • 参数名： 
      FX_CONCATENATE("call_to_", $Session.did)
    • 值：
      $Session.ani

    在本例中，系统会动态拼接参数名和值，将来电号码和拨打的号码传递给 CRM 系统，以识别来电接入的中继或热线。
    正文 输入要发送给服务器的请求内容。
    超时时长(秒) 设置 HTTP 请求的超时时间，单位为秒。
    请求头 点击 添加 设置请求头。

    支持直接输入请求头，或点击 配置表达式以动态生成请求头。

    注：

    示例：

    • 名称：X-Caller-ID
    • 请求头：$Session.ani

    在本例中，请求头名称为固定值 X-Caller-ID，值通过变量 $Session.ani (来电号码) 动态获取。系统将来电号码传递给 CRM 系统，以匹配客户或联系人信息。
  4. 点击右下角的 确认。

组件变量

在通话流程中添加 HTTP 请求 组件后，系统将响应信息存储至变量中。这些变量可以在支持表达式的组件中 (如 条件 组件、开发者 组件) 调用，以根据查询结果控制流程。

注： 由于同一通话流程中可添加多个 HTTP 请求 组件，系统会按照添加顺序为每个组件编号 (如 HTTP 请求 1、HTTP 请求 2)。为确保正确获取到指定组件的输出结果，使用变量时需带上对应的编号。
变量 类型 说明 示例值
$HttpRequest{index}.responseContent String HTTP 请求响应的正文内容。

{"authenticated": true, "user": "10000"}
$HttpRequest{index}.responseStatusCode String HTTP 请求响应码。
注： 使用函数判断响应码时，请确保比较的常量为纯数字，不包含状态消息短语。
 "200"

组件连接

HTTP 请求 组件可连接 一个 组件，可选组件详见下表。

组件 说明
提示音

提示音 组件支持播放音频或将文本转为语音播放。

更多信息，请参见 提示音。
办公时间

办公时间 组件支持根据不同时间将来电路由至对应的目的地。

更多信息，请参见 办公时间。
菜单 菜单 组件用于向来电者提供多个菜单选项，并根据其按键输入路由来电。

更多信息，请参见 菜单。
用户输入

用户输入 组件用于收集来电者的按键输入，通常与 条件 组件配合使用，以判断用户输入并路由来电。

更多信息，请参见 用户输入。
语言

语言 组件用于更改其后续组件所使用的系统提示音语言，从而覆盖默认语言设置。

更多信息，请参见 语言。
录音 录音 组件可用于在来电者与另一方建立通话后对通话进行录音。你可以设置提示音或文本转语音内容，在录音开始前或录音期间播放，告知通话双方正在录音。

该组件也可用于禁用通话录音，从而覆盖系统对通话的默认录音设置。

更多信息，请参见 录音。
按号码拨打

按号码拨打 组件用于引导来电者通过输入号码将来电转接至指定的目的地，实现快速呼叫。

更多信息，请参见 按号码拨打。
按名称拨打

按名称拨打 组件是通话流程中的一种结束组件，来电者可通过输入目标分机用户姓名的前三个字母，快速查找并转接至该用户。

更多信息，请参见 按名称拨打。
转移

转移 组件是通话流程中的一种结束组件，用于终止来电者与当前通话流程的连接，并将其盲转至指定目的地。转接前可播放提示音，提示来电者通话即将转移。

更多信息，请参见 转移。
挂断

挂断 组件是通话流程中的一种结束组件，用于终止来电者与当前通话流程的连接。当来电者进入该组件时，系统会挂断通话。

更多信息，请参见 挂断。
条件 条件 组件支持基于表达式进行逻辑判断，根据判断结果对来电进行路由。

更多信息，请参见 条件。
循环 循环 组件支持重复执行多个组件，直到达到指定的循环次数或满足设定的条件。

更多信息，请参见 循环。
开发者 开发者组件 用于连接 PBX 或第三方数据库，执行数据查询或写入操作。
更多信息，请参见以下文章：