Q: SaleSmartly 能接吗？
Q: 你们能接 Wati.io 吗？
Q: 聊天系统是我们自研的，你们能接入吗？A: 不止这些，只要符合以下条件的，都可以进行接入。
- 支持消息推送：可以将“咨询者”发的消息，通过渠道的方式转发出去（转发给 3ChatAI）
- 有发送消息接口：允许 3ChatAI 将生成好的回答通过渠道的接口发回“咨询者”
一、核心概念：什么是“渠道”？
我们将面向“咨询者”的端，统一称为 “渠道”。
3ChatAI 的职责（面向业务效果理解）：
- 代替“人”与“咨询者”进行对话
- 帮“咨询者”完成增删改查类操作（例如订单、售后、物流、产品等）
- 帮商家记录“咨询者”的画像信息（标签、偏好、历史咨询、订单状态等）
- 更多场景…
二、实现原理：消息如何流转？
流程说明（从用户到 3ChatAI 再回到用户）：
- “咨询者”在渠道侧发送消息
- 渠道通过 消息推送接口 将消息转发到 3ChatAI 后台
- 3ChatAI 生成回答
- 渠道通过 发消息接口 将 3ChatAI 的回答回传给“咨询者”
三、3ChatAI 接口能力（对接所需最小集合）
3ChatAI 接口支持：
- 给 3ChatAI 发消息：https://open.xinheyun.com/314783524e0
说明：对接时你需要将渠道侧收到的“咨询者消息”按规范转发给 3ChatAI；再把 3ChatAI 的返回结果通过渠道“发消息接口”发回给咨询者。
Q: 接口都有了，那传参怎么对接？或者叫怎么完成消息的流转？
A: 几种方式
- 若渠道方的消息推送请求体支持自定义，则可以直接将消息按要求发至 3ChatAI。
- 通过多维表实现“消息中转”
- …其他自定义方式
四、本篇方案说明（你将实现什么）
本篇将以 3ChatAI 为核心，借助：
- SaleSmartly 渠道
- 飞书多维表自动化
来实现第三方渠道消息的 接收 → 转发 → 生成回复 → 回传 的完整链路。
五、准备工作
5.1 3Chat 后台：获取 OAuth 应用 Token
生成并复制 OAuth 应用 token：
OAuth客户端获取调用3Chat_API的token - 开放平台 - 3Chat.ai 社区
建议：后续所有 API 鉴权配置都依赖该 Token，请妥善保存（避免泄露）。
5.2 飞书多维表：复用模板并配置 3Chat_API
复用模板：
第三方渠道方案_SaleSmartly
配置 3Chat_API：将生成的 OAuth 应用 token 填入 value 字段。
说明：该模板用于承接“消息中转”与自动化流程（也可作为排障时的观测面板）。
五、SaleSmartly配置
展开SaleSmartly配置
自定义 AI 机器人接入指南
1. 简介
本文将介绍如何在 AI 机器人中使用自定义 Agent，并通过应用市场接入您自己的机器人。
2. 操作步骤
2.1 在应用市场创建自定义 Agent
通过该方式，您可以将自研或第三方平台的 AI Agent 接入 SaleSmartly，为客户提供服务。
系统通过 Webhook 方式接收消息。您需要提供一个消息接收地址（Webhook URL），然后将 Agent 返回的消息，通过 SaleSmartly 的消息回复接口进行回传。
2.2 对接 SaleSmartly API 服务
您可以根据接口文档对 Agent 进行调试，完成消息通道的打通。
- 将多维表中接收消息的 Webhook 触发地址填入 SaleSmartly API 服务中的“Webhook 接收地址”
- 将 Access Token 复制，并粘贴到多维表模板中的 .env 下 key 为 Smartly_msgsend_token 的 value 中
接口文档地址：
https://salesmartly-robot.apifox.cn
2.3 在 AI 机器人中调用
进入 Robot → AI Robot，创建或编辑机器人以调用该自定义 Agent。
如需更多机器人配置说明，请参考 AI 机器人配置指南。
