渠道接入

登录企业管理后台，左侧菜单「渠道接入」下提供三种接入渠道：网站接入、公众号接入、小程序接入。网站与小程序接入页面均自动填充您的企业 ID，复制代码即可使用；公众号接入填写微信配置后保存即生效。

进入企业管理后台「渠道接入 → 网站接入」，页面已自动生成带企业 ID 的嵌入代码。将代码粘贴到网站 HTML 的 </body> 标签之前：

<script src="https://your-domain.com/chat/chat-widget.js"
  data-tenant="YOUR_TENANT_ID"
  data-theme="blue"
  data-bottom="70"
  data-offset="50"
  data-width="420"
  data-height="620"></script>

刷新网站后，右下角即出现在线客服浮动按钮。

一行脚本同时开启两项能力：在线聊天与访客轨迹追踪（自动采集页面浏览、来源渠道与设备信息，无需额外配置）。

对话框支持主题定制：通过 data-theme 指定 blue（默认）/ red / yellow / green / purple / pink 六种主题，消息气泡、头部配色与悬浮按钮（未单独设置 data-color 时）同步生效。

可选参数

参数	说明	默认值
data-tenant	企业 ID（必填）	—
data-server	服务地址	https://kf.guoway.net
data-path	聊天页路径	/chat/index.html
data-text	按钮文案	💬 在线客服
data-theme	对话框主题（blue/red/yellow/green/purple/pink）	blue
data-color	按钮颜色（不设置则跟随主题）	跟随主题
data-position	按钮位置 left/right	right
data-bottom	距底部距离（px）	70
data-offset	距左右边距（px）	50
data-width	窗口宽度（px）	420
data-height	窗口高度（px）	620
data-mobile	移动端全屏	true
data-auto-open	页面加载后自动打开	false
data-auto-open-delay	自动打开延迟（ms）	3000
data-track	启用访客轨迹追踪	true
data-track-debug	轨迹追踪调试日志	false
data-api-host	数据上报地址	同 data-server

自定义调用（ChatWidget）

加载嵌入代码后即可调用以下方法，初始化完成前的调用会自动排队执行。可用于自定义按钮打开聊天窗口、按钮触发主动邀请等场景：

方法	说明
ChatWidget.open()	打开聊天窗口
ChatWidget.close()	关闭聊天窗口
ChatWidget.toggle()	切换窗口显隐
ChatWidget.destroy()	移除聊天窗口
ChatWidget.getConfig()	获取当前配置（data-* 参数）
ChatWidget.getState()	获取当前状态 { open, folded }

示例：点击页面任意按钮打开聊天窗口

<script src="https://your-domain.com/chat/chat-widget.js"
  data-tenant="YOUR_TENANT_ID"></script>
<script>
  document.getElementById('contact-btn').addEventListener('click', function () {
    ChatWidget.open()
  })
</script>

进入企业管理后台「渠道接入 → 公众号接入」，填写以下配置并保存：

• 启用接入：开关控制公众号消息是否同步到客服系统
• AppID / AppSecret：在微信公众平台「设置与开发 → 基本配置 → 公众号开发信息」中获取；AppSecret 仅修改时填写，不修改请留空
• 回调 Token：自定义令牌，用于微信回调签名校验

保存后页面会自动生成回调地址，复制该地址，填入微信公众平台的服务器配置即可。

微信公众平台配置步骤

• 登录微信公众平台（mp.weixin.qq.com），进入「设置与开发 → 基本配置」
• 服务器配置：填写回调地址与 Token（与后台配置保持一致），消息加解密方式选择「明文模式」
• 保存并启用服务器配置，粉丝发送的消息即会同步到客服系统

接入后可在后台查看粉丝列表，支持按昵称 / OpenID 搜索，展示关注状态与最近互动时间；坐席回复直达粉丝微信。

进入企业管理后台「渠道接入 → 小程序接入」，通过小程序 web-view 组件加载果唯云 H5 聊天页，用户在微信小程序内即可与客服对话。接入步骤：

• 获取聊天页地址：复制页面上的专属聊天页 URL（已含企业 ID）
• 配置业务域名：在微信小程序后台「开发管理 → 开发设置 → 业务域名」中添加聊天页域名
• 编写页面代码：按页面示例创建小程序页面并上传发布

页面代码示例：

<!-- pages/chat/chat.wxml -->
<web-view src="{{chatUrl}}"></web-view>

// pages/chat/chat.js
Page({
  data: {
    chatUrl: '（粘贴从后台复制的专属聊天页地址）'
  }
})

• 聊天页以全屏模式显示，铺满整个页面
• 会话来源标记为「微信小程序」，在历史会话中可区分
• 首次接入建议先在微信开发者工具中预览调试，确认能正常收发消息
• 如需在小程序内使用按钮唤起聊天，可在任意页面放置「联系客服」按钮并跳转到该 web-view 页面

会话来源渠道将标记为「微信小程序」，支持与网页端一致的实时接待、访客轨迹与质检。

聊天窗口自动适应移动端屏幕尺寸，在手机上将自动切换为全屏模式。可通过 data-mobile="false" 关闭。

• 页面加载：确认浮动按钮正常显示
• 发送消息：测试发送文本、图片、视频、文件
• 接收消息：测试客服回复是否能正常接收
• 移动端：在手机上测试显示和操作