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. 将HTTP请求 组件添加至消息流程后，点击组件进行配置。

  2. 在弹出的右侧面板中，配置 HTTP 请求并点击 确认。
    注： 可使用包含变量、常量和函数的表达式定义 URI、查询参数、正文 以及 请求头 字段。

    可点击 配置表达式。在表达式编辑器中，输入 FX 查看并选择系统支持的函数，输入 $ 查看并选择已存储在当前消息流程中的变量。

    关于函数和变量的更多信息，请参见 支持的变量和函数。

    项 说明
    URI

    输入 HTTP 请求的目标 URI。
    请求类型 选择 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
    查询参数 点击 添加 设置查询参数。
    注： 建议最多添加 30 个参数。
    正文 输入要发送给服务器的请求内容。
    注： 如果在正文中插入了变量或函数，使用单引号 '' 将其包围。
    超时时长(秒) 设置 HTTP 请求的超时时长。
    请求头 点击 添加 设置请求头。
    注： 建议最多设置 30 个请求头。

    配置的信息显示在组件上。

  3. 可选： 要在满足组件的分支条件时路由消息会话或触发其他操作，将鼠标悬停在分支上，然后点击 以添加后接组件。

    关于支持连接的组件的更多信息，请参见 组件连接。

组件变量

在消息流程中添加 HTTP请求 组件后，系统将数据库信息存储至变量中。你可在支持表达式的组件中 (如 条件组件) 使用这些变量查询存储的值，以灵活控制会话。

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

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

组件连接

HTTP请求 组件默认包含两个分支 默认目的地 和 超时目的地，每个分支可连接 一个 组件。支持的组件详见下表。

注： 如果一个组件已经连接到分支，且你需要在它们之间插入一个新组件，将鼠标悬停在两者之间的线上，点击 并选择目标组件。选择的组件被自动插入并与两端分别建立连接，无需删除已有连接、添加新组件再手动重连。

结束组件 转移 和 关闭 不能通过此方式插入。

组件 说明
发送消息 发送消息 支持自动向客户发送消息。

更多信息，请参见 发送消息。
发送WhatsApp模板消息 发送WhatsApp模板消息 支持使用指定的 WhatsApp 消息模板自动向客户发送消息。
重要： 此组件仅在消息流程仅适用于 WhatsApp 消息渠道类型时可用。

更多信息，请参见 发送WhatsApp模板消息。
等待回复 等待回复 组件支持配置等待超时时长，并根据是否收到回复路由消息会话。

更多信息，请参见 等待回复。
菜单 菜单 组件可用于向客户提供一组菜单选项，并根据其回复的值路由消息会话。

更多信息，请参见 菜单。
办公时间组件

办公时间组件 组件支持根据不同时间将消息会话灵活路由至对应的目的地。

更多信息，请参见 办公时间组件。
等待 等待 组件支持在回复超时时自动将消息会话路由至连接的组件并执行指定的操作。

更多信息，请参见 等待。
条件组件 条件组件 组件支持基于逻辑表达式路由消息会话。

更多信息，请参见 条件组件。
循环 循环 组件支持基于循环策略重复执行多个组件。

更多信息，请参见 循环。
内部数据操作 内部数据操作 组件可用于从 PBX 内部数据库查询数据。
更多信息，请参见以下文章：
发送邮件 发送邮件 组件支持使用配置的邮件服务器自动发送电子邮件并记录发送日志，可用于实时通知。

更多信息，请参见 发送邮件。
数据库访问 数据库访问 组件可用于在消息流程中连接第三方数据库，执行数据查询或写入操作。

更多信息，请参见 数据库访问。
HTTP请求 HTTP请求 组件可用于向外部 Web 服务器发送 HTTP 请求，实现与第三方应用或服务之间的数据交互。

更多信息，请参见 HTTP请求。
转移

转移 可用于将消息会话转移至指定目的地以终止当前会话。

更多信息，请参见 转移。
关闭 关闭 组件可用于自动关闭消息会话以终止当前会话。

更多信息，请参见 关闭。