扣子AI提供三种第三方API接入方式：一、自定义HTTP工具，直接配置请求参数与响应解析；二、Webhook中转，通过自有HTTPS服务处理复杂鉴权与数据清洗；三、插件市场，一键安装已认证SaaS服务并调用预置动作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
一、配置扣子AI平台的自定义工具（HTTP请求工具）
扣子AI支持通过“自定义工具”能力调用任意第三方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、时间戳、nonce等必要头信息）。
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对话流中拖入「调用工具」节点，选择该插件动作，绑定用户输入变量（如会议标题、开始时间）作为参数输入。
