如何实现RocketChat与REST API工单系统对接？非Zapier方案求荐

核心对接逻辑 #

RocketChat 聊天结束时触发 outgoing webhook，将对话数据推送到中间服务；中间服务解析数据后，调用工单系统的 REST API 完成工单创建。Zapier 绝对不是唯一方案，完全可以用局域网内部署的开源工具实现，数据全程在内部流转，更安全可控。

局域网可用的开源中间服务方案 #

以下都是支持接收 Webhook 并调用 REST API 的开源工具，可直接部署在局域网服务器：

1. n8n #

• 特点：可视化工作流配置，无需大量代码，支持多种触发器和动作（包括 Webhook 接收、REST API 调用），部署简单。
• 部署方式：推荐用 Docker 快速部署，命令如下：

  docker run -it --rm -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n
  

• 配置步骤：创建工作流，用「Webhook」节点接收 RocketChat 的推送，再用「HTTP Request」节点配置工单系统的 API 参数（从 Webhook 数据中提取对话ID、用户信息、聊天内容等字段，映射到工单 API 的请求体）。

2. Node-RED #

• 特点：基于 Node.js 的可视化编程工具，通过拖拽节点即可完成逻辑配置，扩展性强，适合有基础的用户定制复杂逻辑。
• 配置步骤：添加「http in」节点作为 Webhook 入口，解析 RocketChat 的请求数据；添加「http request」节点调用工单系统 API，根据需求用「function」节点做数据转换。

3. Huginn #

• 特点：类 IFTTT 的开源自动化工具，轻量灵活，支持自定义代理和数据处理，适合简单的触发-动作场景。
• 配置步骤：创建「Webhook Agent」接收 RocketChat 的推送，再创建「HTTP Agent」调用工单 API，通过规则映射数据字段。

4. 自定义轻量服务 #

如果需求极简，完全可以自己写个小服务：

• 用 Python 的 FastAPI/Flask，或者 Go 的 Gin 框架，写一个接口监听 Webhook 请求，解析参数后发起 HTTP 请求调用工单 API。
• 示例（FastAPI 简化版）：

  from fastapi import FastAPI, Request
  import requests
  
  app = FastAPI()
  TICKET_API_URL = "http://你的工单系统API地址"
  
  @app.post("/rocketchat-webhook")
  async def handle_webhook(request: Request):
      chat_data = await request.json()
      # 提取聊天数据中的关键信息
      ticket_payload = {
          "subject": f"聊天工单：{chat_data['roomName']}",
          "content": chat_data["message"],
          "user": chat_data["username"]
      }
      # 调用工单API
      requests.post(TICKET_API_URL, json=ticket_payload)
      return {"status": "ok"}
  

• 部署后，把这个服务的地址填到 RocketChat 的 outgoing webhook 配置中即可。

关键配置要点 #

1. RocketChat Webhook 触发条件：在 RocketChat 管理后台的「集成」-「Outgoing Webhooks」中，设置触发事件为「对话关闭/结束」（需确认 RocketChat 对应事件的触发规则，部分版本可能需要通过自定义事件实现）。
2. 数据映射：确保中间服务能正确提取 RocketChat 推送的对话数据（比如对话ID、用户ID、聊天记录、结束时间等），并转换成工单系统 API 要求的参数格式。
3. 权限与网络：确保 RocketChat 能访问局域网内的中间服务，中间服务能访问工单系统的 API 地址，必要时配置防火墙规则。

内容的提问来源于stack exchange，提问作者Dercni