📘 Wati.io x 3Chat 集成指南:基于飞书工作流 (无代码方案) Alpha

摘要:本文介绍如何通过 飞书工作流 (Feishu Workflow) 将 Wati 接收到的 WhatsApp 消息转发给 3Chat AI,并将 AI 的回复自动发回给用户。此方案不需要您拥有自己的服务器,只需简单的配置即可实现智能自动回复。


:hammer_and_wrench: 原理图解

我们将利用飞书工作流充当“中转站”:

可以直接复用此模板 https://3chat-ai.feishu.cn/base/FXQtb6q0Oaq92Xsct2RcNP39nwc?table=tblNTqCg3nxjLVp9&view=vewChbxZjJ

  1. 用户发消息 → Wati Webhook 触发
  2. 中转处理 → 飞书工作流接收消息 → 调用 3Chat API (思考) → 获取结果
  3. 发送回复 → 飞书工作流调用 Wati API → 用户收到 AI 回复

第一步:准备 Wati API 凭证

我们需要获取 Wati 的“钥匙”和“地址”,以便飞书工作流能代表您发送消息。

  1. 登录 Wati 后台。
  2. 点击顶部导航栏的 MoreAPI Docs
  3. 在页面中找到并复制以下两项信息,保存到记事本备用:
  • Access Token (长字符串,仅复制Bearer后面的部分

第二步:配置飞书工作流 (核心步骤)

可以直接复用上述模板

如果您是自行搭建流程,请参考以下逻辑;如果是使用现成的飞书模板,请直接跳到第三步。

在飞书多维表格或集成平台中创建一个新工作流,包含以下三个节点:

1. 触发器 (Webhook 触发)

  • 创建一个 Webhook 触发器
  • 复制生成的 Webhook URL(例如:https://3chat-ai.feishu.cn/...)。这个地址稍后要填入 Wati。

2. 动作:调用 3Chat AI (HTTP 请求)

直接将您的3Chat_API_Key复制到飞书表格下的 .env文件内即可

可以参考 OAuth客户端获取调用C2_API的token 获取key

3. 动作:发送回 Wati (HTTP 请求)

以下内容已经在飞书模板完成配置。只需要将第一步 Wati的Key复制到.env文件内即可。

  • 请求方式:POST
  • URL(https://app-server.wati.io)/api/v1/sendSessionMessage/{{waId}}
    • 注意:将 {{waId}} 替换为步骤1中接收到的电话号码变量。
  • HeaderAuthorization: Bearer <第一步获取的 Wati Access Token>
  • Query Params (查询参数)
    • messageText: {{AI_Response_Content}} (引用步骤2中 AI 返回的文本内容)

第三步:在 Wati 中配置消息转发

现在,我们需要告诉 Wati:“收到消息后,把内容推送到飞书工作流”。

  1. 登录 Wati 后台。
  2. 点击顶部导航栏的 MoreWebhooks
  3. 点击 Add Webhook 按钮。
  4. 填写配置信息:
  • URL: 粘贴您在第二步中获得的 飞书工作流 Webhook 地址
  • Status: Enabled (启用)。
  • Events: 勾选 Message Received (这一步非常关键,只勾选这一个即可)。
  1. 点击 Save 保存。

:white_check_mark: 测试与验证

  1. 用您的个人 WhatsApp 号码向您的 Wati 企业号发送一条消息(例如:“你们的产品有什么特点?”)。
  2. 观察飞书工作流的运行历史,确认是否成功触发。
  3. 检查您的 WhatsApp 是否收到了 AI 的回复。

常见问题 (FAQ)

Q1: 为什么我在 Wati 里找不到 Webhook 菜单? A: 请确保您拥有 Wati 的管理员权限。路径在顶部菜单的 More 下拉列表中。

Q2: 飞书工作流调用超时怎么办? A: Wati 的 Webhook 推送通常很快,但如果 AI 生成内容极长(超过 30 秒),飞书可能会断开。此时建议换“异步”调用接口

Q3: 会回复所有消息吗? A: 是的。配置 Webhook 后,Wati 收到的每一条用户消息都会推送给 AI。如果您希望人工介入时暂停 AI,需要在飞书工作流中增加判断逻辑(例如:如果 Wati 标签包含 “Human”,则不调用 AI)。