respond-io
New
🚀 TikTok商务消息现已上线! 将对话转化为转化率,无缝对接。 了解更多。arrow-icon

首页 >

产品 >
工作流 >
步骤: HTTP 请求

步骤: HTTP 请求

Avatar
Shing-Yi Tan
· 12 Jun 2024
5 分钟

此步骤允许发送 HTTP 请求并将他们的响应保存为变量。

这个步骤仅适用于业务计划和以上项目。

配置

HTTP 请求步骤中有两个关键配置:

HTTP 请求方法

请求所需的具体方法。 从下拉列表中选择适当的方法。

网址

在 URL 字段中,输入外部 API 的 URL 端点来检索数据。 要包括变量,请使用 "$" 前缀支持静态文本和变量的内插值。

您现在可以在 HTTP 请求步骤中使用IP地址和端口号。 给予您直接访问服务器的权限和在非标准端口访问服务的灵活性。

请注意,回复.io和白色标签域名都是黑名单。 不允许将 API 调用发送到这些域,因为它可能导致循环问题。

正文内容

为了确保请求收件人正确解码,扩展正文部分并包括一个与内容类型标题一起的机构。

信头

在标题部分,您可以同时添加头部到HTTP请求。 密钥代表头名,值代表头部值。 您可以通过添加前缀 "$" 作为头部使用变量。 然而,请记住,最多只允许10个头部。

响应映射

对于JSON API响应,您可以将特定响应元素保存为变量。 在响应映射部分中,在左边输入JSON对象的密钥,并将一个名称分配给右边的变量。 请记住,只能保存 JSON 响应,您最多可以有 10 个响应映射设置。

示例:

要以不同格式保存响应,请填写与您想要保存的数据相对应的 JSON 密钥。

{  
    "名称": "Jason",  
    "邮政编码": "12345",  
    "电话": "123123"  
}  

要保存上述响应中的电话号码,请使用 $.phone 作为JSON 密钥。

{  
    "custom\_fields": {  
        "firstName": "约翰",  
        "lastName": "杜",  
        "locale": "zh\_CN",  
        "timezone": "5",  
        "gender": "男",  
        "phone": "123123",  
        "email": "[email protected]",  
        "customerid": "1"  
    },  
    "created\_at": 1575618542  
}  

要保存上述响应中的电话号码,请使用 $.custom_fields.phone

    {  
        "data": {  
            "id":"1776025372480910",  
            "contacts" : \[  
                {  
                    "firstName":"约翰",  
                    "lastName":"杜",  
                "locale": "zh\_CN"  
                },  
                {  
                    "firstName":"简",  
                    "lastName":"杜",  
                "locale": "zh\_CN"  
                }  
    \]  
        }  
    }  

若要保存上述响应中的名字 '简易' ,请使用 $.data.contacts[1].firstName

将响应状态保存为变量

要将 HTTP 请求的响应状态保存为变量,请打开 将响应状态保存为变量 开关。 然后命名字段中提供的变量。

如何工作

激活后,此步骤将使用定义的实体和头向指定的 URL发送HTTP请求。

您可以根据响应状态引导工作流。 例如,您可以为 "状态代码创建一个分支,等于200"。 如果收到任何其他响应状态代码,跳转步骤可以返回 HTTP 请求步骤。 或者,如果没有满足分支的条件,则可将联络人指向失败处。 如果在故障处没有设置步骤, 工作流将结束。

如果您的 HTTP 请求超过 10 秒,它将导致超时导致请求失败。

潜在失败

为了避免执行HTTP请求时可能出现故障,确保满足以下条件:

  • 使用正确的 HTTP 方法和 Content-Type 头.

  • 请确保在您的URL中包含所需的协议 http://https://// 基于您的系统支持的内容,以避免请求失败。

  • 确认内容类型有效。

  • 从URL中排除端口号。

  • 避免在URL中使用自签名证书。

  • 验证授权是否有效。

  • 确保我们的IP地址(52.74.35.155、18.138.31.163、54.169.155.20)不被拦截。

如果上述任何条件未得到满足,联系人将跳过这一步骤并继续其余的旅程。

验证带有动态变量的 HTTP 请求输出时,请记住没有值的变量将返回为 null未定义的

最佳做法

以下是一些最佳做法,您可以遵循这个步骤来优化您的工作流:

HTTP 请求成功时

  1. 将响应状态保存为变量:

    1. 确保第一步是 将响应状态保存为变量 以进行进一步操作。

  2. 分级步骤:

    1. 添加一个分支步骤来评估 HTTP 请求状态。

    2. 如果状态为 200, 请求是成功的。

    3. 如果没有,请设置一个提醒通知管理员该请求未成功.

  3. Google Sheet 用于监视:

    1. 将响应状态记录到谷歌工作表中,以明确显示请求的成功或失败。

  4. 评论:

    1. 在您的工作流中添加一条评论来文档响应状态。 这将帮助您更有效地跟踪和审查错误。

HTTP 请求失败时

  1. 将响应状态保存为变量:

    1. 类似于成功的请求, 将响应状态保存为处理错误的可变

  2. 使用等待或跳转步骤重试

    1. 实现等待步骤,在重试失败的请求之前暂停。

    2. 或者,使用跳转步骤返回HTTP请求步骤并再次尝试请求。

  3. 评论:

    1. 通过创建注释记录HTTP请求错误来记录错误

    2. 包含联系人详细信息并标记负责人。

  4. 谷歌表单用于监测:

    1. 使用 Google 表单步骤记录联系人信息和错误详细信息以进行监测和审查。

  5. 任务分配:

    1. 将任务分配给指定的用户,在工作流中启动另一个进程,然后重试。

推荐的使用案例

以下是您可以使用 HTTP 请求步骤的一些方式:

  • 路由 VIP 联系人:使用 HTTP 请求步骤从数据仓库获取联系人详情,如CRM 这使您能够识别VIP联系人,允许个人化的客户体验,并且将它们与非VIP联系人区分开来。

分享这篇文章
Telegram
Facebook
Linkedin
Twitter

相关文章 :woman_technologist:

如何避免工作流程循环
学习如何防止导致不必要重复、系统过载和延迟的工作流程循环。
步骤: 发送转换 API 事件
了解配置、工作方式、最佳做法以及实现发送转换 API 事件步骤的更多信息。
工作流触发
了解所有关于触发器以及如何使用它们来运行 Workflow
步骤:提出问题
了解实施“提问步骤”时的配置、最佳实践和用例。
步骤: 更新生命周期
了解最佳做法、使用案例及其在实现更新生命周期步骤时如何工作。

找不到您正在寻找的东西? 🔎