扣子AI第三方API集成指南：调用方法与步骤详解

想要为你的AI助手集成第三方服务？扣子AI提供了三种灵活的方式：一是直接使用自定义HTTP工具，就像亲手配置每一步请求与响应；二是通过你自己的Webhook服务作为“中转站”，处理那些需要复杂授权和数据清洗的接口；三是在插件市场安装现成的连接器，一键就能调用飞书、Notion等已验证的SaaS服务。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一、在扣子AI平台配置自定义工具（HTTP请求工具）

通过“自定义工具”功能，你可以直接调用任何第三方API。这种方式无需部署后端服务，一切配置都能在Bot编辑界面里完成。关键在于，你需要将第三方API封装成符合扣子平台规范的工具描述，并设定好请求方法、参数映射以及响应的解析逻辑。

1. 登录扣子AI控制台，选择目标Bot，点击「工具」→「添加工具」→「自定义工具」。

2. 填写工具名称（例如：“查询天气API”）和描述（例如：“调用和风天气接口获取城市实时天气”）。

3. 在「请求配置」中设置：请求方法选择GET或POST；URL填写第三方API完整地址（例如：https://devapi.qweather.com/v7/weather/now?location={cityId}&key={apiKey}）。

4. 在「参数配置」中逐项添加路径参数、查询参数或请求体字段，记得勾选「用户可输入」并绑定变量名（如{cityId}、{apiKey}需对应Bot内已定义的变量或用户提问时提取的实体）。

5. 在「响应处理」中指定成功状态码（例如200），并用JSONPath提取关键字段（如$.now.textDay），提取的结果将用于后续Bot的消息回复。

二、使用Webhook方式对接自有后端中转服务

当第三方API的授权流程比较复杂（比如需要OAuth2.0动态刷新Token）、存在跨域限制，或者需要对原始响应做清洗转换时，推荐你通过自建Webhook来中转。扣子AI会将请求转发至你的服务器，由你完成签名、重试、日志记录等逻辑后，再返回结构化数据。

1. 部署一个支持HTTPS的轻量Web服务（如Flask/FastAPI），监听POST请求，路径如/webhook/weather。

2. 在扣子AI「自定义工具」中选择「Webhook」类型，填入你服务的完整HTTPS URL。

3. 在Webhook服务端校验扣子发送的X-Plugin-Signature请求头（HMAC-SHA256签名），密钥为扣子Bot设置页中显示的Webhook Secret。

4. 解析请求体中的parameters字段，组装并调用第三方API（这一步包含Bearer Token、时间戳、随机数等必要头信息的添加）。

5. 收到第三方响应后，按照扣子要求的格式构造返回体：需包含status（success/error）、data（JSON对象）及可选的message字段。

三、通过扣子AI插件市场接入已认证的第三方服务

扣子AI最新的插件市场提供了经过审核的即用型连接器（如飞书、Notion、Zapier等），无需手动编写HTTP配置。这些插件内置了身份授权流程与错误重试机制，非常适合快速启用标准化的SaaS集成。

1. 在Bot编辑页面点击「工具」→「从插件市场添加」。

2. 搜索目标服务名称（如“飞书日历”），点击进入详情页，确认权限范围（如读取日程、创建会议）。

3. 点击「安装插件」，页面会跳转至该服务商的OAuth2授权页，使用管理员账号完成授权。

4. 授权成功后，插件会自动出现在Bot的可用工具列表中，其调用参数已在后台预设，你只需在Bot逻辑中调用对应动作（如lark_calendar_create_event）并传入必要字段即可。

5. 在Bot对话流中拖入「调用工具」节点，选择该插件动作，绑定用户输入变量（如会议标题、开始时间）作为参数输入。