扣子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对话流中拖入「调用工具」节点，选择该插件动作，绑定用户输入变量（如会议标题、开始时间）作为参数输入。
热门专题
热门推荐
清明节假期期间，A 股和港股休市，但比特币行情永不停歇。 4月6日，当多数市场还在假期中沉睡时，比特币已经悄然启动。价格从亚洲早盘的低点67400美元出发，一路向上试探，盘中最高涨破70300美元，不仅刷新了3月26日以来的高位，较日内低点的涨幅也超过了4%。以太坊的表现同样不俗，从2050美元附近
4月5日消息，日前，REDMI K90至尊版通过3C认证，预计将于本月发布。今日，小米中国区市场部总经理魏思琪用小米新机发布微博，不出意外，这正是即将登场的REDMI K90至尊版，这将是小米首款配
WPS演示中图表不随数据更新时，可通过四种方法实现自动同步：一、用OFFSET+COUNTA定义动态名称绑定图表；二、用组合框控件联动VLOOKUP提取数据；三、用数据透视图配合切
聚焦数字技术，释放创新动能。为集中展示静安区区块链技术从“实验室”走向“应用场”的丰硕成果，挖掘一批可复制、可推广的行业解决方案，加速构建区块链产业生态闭环，静安区数据局特推出“静安区区块链创新应用
太空中的马桶堵了，边飞边修还能勉强用。但中东被点燃的火药桶，美国怎么来扑灭？靠一再延期的“最后通牒”？还是靠无底线的轰炸？2300万美元的马桶美国航空航天局4名宇航员1日搭乘“猎户座”飞船升空，执行