GetMyBot 知识库

Web 请求与 Webhook

让网站事件启动机器人,以及让反应向其他服务发起请求。

本页内容

网站可以通知机器人有新申请,机器人也可以向网站查询订单状态。这是两个方向:

方向谁发起示例
入站 Webhook其他服务通知 GetMyBot,启动反应网站收到申请,机器人通知经理
出站 Web 请求反应查询其他服务并取得响应机器人查询价格或订单状态

Webhook 是一个服务自动通知另一个服务。两者都使用 HTTP,即浏览器访问网站所用的协议。已有的现成连接见集成。

入站 Webhook(触发器)

**入站 Web 请求(webhook)**触发器可通过外部 HTTP 请求启动反应:

  • 地址:开启触发器并保存反应后,GetMyBot 会生成该反应专用的 Webhook URL。地址可复制,不能自行修改。
  • 密钥令牌:防止其他人通过该地址启动反应。
  • 方法:POST / GET / PUT / ANY。

收到的字段保存在反应的临时数据 ctx 中。例如请求带 order_id,动作中可用 {{ctx.order_id}}。设置后发送一次测试请求,确认反应取得预期字段。

出站 Web 请求(动作)

Web 请求动作可在反应中发送 HTTP 请求,设置:

  • 方法 GET、HEAD、OPTIONS、POST、PUT、PATCH 或 DELETE,以及请求头和 JSON 或文字请求体;
  • 哪些状态码算成功、超时和重试次数;
  • 把响应保存到用户参数或 ctx,并用 JSONPath 指定需要的字段;
  • 异步执行:机器人不等待响应即可继续,之后可由成功或失败反应处理结果。

加载 URL可把网页文字存入 ctx;查询数据源和写入数据源用于已连接的数据源。见数据源与密钥。

Webhook 集成

经常向同一服务发送数据时,可配置 Webhook 集成,填写 URL 和 HMAC 签名,让接收方验证发送者。见集成。

安全性

入站请求应配置密钥令牌,避免其他人启动反应。平台会阻止出站请求访问内部网络的私有地址(SSRF 防护),响应大小也有限制。

接下来