AskAIs接入总览
目前接入 AskAIs 的几种方式：你的网站、你的 App、Telegram 和 AI 客户端。
代码中的
window.SingChat等是挂件与 API 的技术名称，请原样保留。
AskAIs 是托管服务：你的工作区、收件箱、AI 客服和知识库都在 askais.com 上。你可以用下面几种方式让客户联系到它，所有对话都会进入同一个共享收件箱，由同一个 AI 客服用同样的知识和设置来回答。
接入方式
| 在哪里 | 怎么接入 | 更新 |
|---|---|---|
| 你的网站 | 一个 <script> 标签 | 无需更新：每次加载页面都会拿到当前版本的聊天窗口 |
| 你的 iOS、Android、Flutter、React Native 或桌面 App | 用 WebView 打开你的聊天页面 | 无需更新：WebView 会加载当前版本的聊天窗口 |
| Telegram | 在设置 → 渠道里填入机器人 token | 无需更新 |
| Claude Code、Cursor 或 Gemini CLI（给你的团队用） | MCP 服务器，搭配 MCP 密钥 | 无需更新 |
你的网站
把这段代码加到 </body> 之前。App ID 在设置 → 收件箱与聊天框外观里复制；它是公开的，可以放心发布。
<script src="https://askais.com/widget.js"
data-app-id="YOUR_APP_ID"
data-base-url="https://askais.com"
async></script>⚠️ 从 askais.com 加载 widget.js
不要下载 widget.js，也不要把它打包进你自己的代码。从 askais.com 加载，它始终运行当前版本；复制下来的副本会停在当时的版本，之后的每一个修复和新功能都用不到。
手机和桌面 App
不需要安装任何 SDK。在 WebView 里打开 https://askais.com/api/widget-embed?appId=YOUR_APP_ID，你的 App 就会全屏显示和网站上一样的聊天。把已登录用户的 ID、邮箱和名字加到网址上，你的团队就知道在和谁对话。「App 内聊天」页面有完整指南，并附有 Flutter、iOS、Android 和 JavaScript 的代码。
已登录访客与身份验证
对于已登录的用户，传入 externalId、email 和 name，他们的对话就能跨设备延续。为了防止有人冒充其他用户，还要传入 hmac：在你的服务器上、以收件箱密钥对 externalId 计算出的 HMAC-SHA256。「网站聊天窗口」页面有具体做法。
Telegram
用 @BotFather 创建一个机器人，把它的 token 贴到设置 → 渠道里并连接。发给机器人的消息会进入同一个收件箱，由 AI 客服和你的团队回复。
AI 客户端（MCP）
MCP 服务器让 Claude Code、Cursor 或 Gemini CLI 操作你的工作区：阅读和回复对话、训练 AI、编辑 FAQ、查看数据统计。它是给你和团队用的，不是给客户用的。MCP 密钥由工作区的所有者或管理员创建。
目前不提供
- 可安装的 SDK 包（npm、pub.dev、CocoaPods、Gradle）。网站请用 script 标签，App 请用 WebView 页面。
- 供你自己的后端调用的公开 REST API。API 密钥只有 MCP 服务器接受。
- 对话或消息事件的 Webhook。设置 → Webhook 可以保存一个端点并发送带签名的测试 ping，但目前还不会推送任何事件。
- 用来打开、关闭或监听聊天窗口的 JavaScript 方法。
window.SingChat.start()是脚本提供的唯一方法。