在线客服系统接入指南：网页、微信小程序、APP 三步接入

KF 智能客服是一套支持多租户的在线客服系统。所有渠道共用同一套后端，访客消息统一进入客服工作台，AI 自动回复在全渠道生效。按你业务所在的端选择下面的接入方式即可。

更新于 2026-10-27

一、先获取 appKey

1. 打开 KF 智能客服首页，点击「免费申请」，填写站点名称、域名、管理员账号、密码与联系邮箱。
2. 平台审核通过后生成 appKey，后续所有端都靠它标识你的租户。
3. 你的域名会被后端动态放行 CORS，接入新站点无需改代码或重启服务。

二、网页 / PC / H5：一行代码接入

在任意网页的 </body> 前加入下面这一行：

<script src="https://kf.ihsan.vip/widget/kf-widget.js" data-app-key="你的appKey" defer></script>

如需自定义主题色、按钮位置或图标，可在挂件脚本前设置 window.KF_CONFIG：

<script>
window.KF_CONFIG = {
  server: 'https://kf.ihsan.vip',
  appKey: '你的appKey',
  title: '在线客服',
  theme: '#3b82f6',
  position: 'right',   // right / left
  icon: 'https://你的图/icon.png',
  dir: 'auto'          // auto / ltr / rtl
};
</script>

也可以直接用 data-* 属性配置，KF_CONFIG 的优先级更高。

不想用悬浮挂件时，可直接跳转独立聊天页：https://kf.ihsan.vip/h5/?appKey=你的appKey。

三、微信小程序接入

路线 A：微信客服消息回调（推荐，原生体验）

用户点击 <button open-type="contact">联系客服</button> 后，消息由微信推送到 KF，客服在工作台回复，再经微信接口送回用户。小程序端零代码。

1. 登录 KF 管理后台，在「微信小程序」页填入 AppID、AppSecret、Token 与 EncodingAESKey，复制回调地址并启用。
2. 在微信公众平台「客服 → 消息推送」中填入同一回调地址与 Token，保存校验。
3. 在小程序页面放置 open-type="contact" 按钮即可。

路线 B：内嵌聊天页（自定义界面）

在小程序后台「开发设置 → 服务器域名」中加入 request 合法域名 https://kf.ihsan.vip 与 socket 合法域名 wss://kf.ihsan.vip，然后复用访客端聊天页或按 REST + WebSocket 协议自行实现。

四、APP 接入

WebView 加载（零开发量）

在「联系客服」入口用 WebView 打开 https://kf.ihsan.vip/h5/?appKey=你的appKey，该页已适配移动端与 PC 宽屏。

uniapp 原生页面

把访客端聊天页复制进你的工程，在 pages.json 注册页面，并把 KF_SERVER_BASE 指向 https://kf.ihsan.vip，通过页面参数传入 appKey。

五、留言表单（全端通用）

不做实时聊天、只收集联系方式与问题时，可直接调用留言接口：

POST https://kf.ihsan.vip/api/inquiry
Content-Type: application/json

{
  "appKey": "你的appKey",
  "name": "张三",
  "contact": "13800138000",
  "contactType": "phone",
  "content": "想咨询一下产品价格",
  "sourceUrl": "https://你的站点/页面"
}

contact 与 content 必填，contactType 支持 phone / email / wechat；同 IP 5 分钟内最多 20 条。

六、接入方式对比