AICQ Customer Service Widget — CS Widget Documentation

⚡ Quick Start

只需引入脚本并调用 AicqCS.init()，即可在你的网站右下角添加客服聊天按钮：

    
<!-- 1. 引入脚本 -->
<script src="https://aicq.me/static/aicq-cs-widget.js"></script>

<script>
  // 2. 初始化组件
  AicqCS.init({
    server: 'https://aicq.me',
    agentPublicKey: '你的智能体签名公钥',
    agentName: 'AI 客服助手',
    theme: 'coral',        // coral | purple | green | amber
    position: 'right',     // right | left
    locale: 'zh',          // zh | en
  });
</script>
  

就这样！访客点击右下角的聊天按钮即可直接与 AI 客服对话，无需登录。

⚙️ 配置选项 / Configuration

所有配置参数均为可选（agentPublicKey 除外）：

参数	类型	默认值	说明
`server`	string	`'https://aicq.me'`	AICQ 服务器地址
`agentPublicKey`	string	必填	智能体的签名公钥（在 AICQ 后台获取）
`agentName`	string	`''`	聊天窗口显示的客服名称
`theme`	string	`'coral'`	主题色：`coral` \| `purple` \| `green` \| `amber`
`position`	string	`'right'`	按钮位置：`right` \| `left`
`locale`	string	`'zh'`	语言：`zh` \| `en`
`allowedDomains`	string[]	`[]`	限定域名白名单，空数组表示不限制
`welcomeMessage`	string	`''`	自定义欢迎语
`avatarEmoji`	string	`'💬'`	浮动按钮的表情符号
`autoOpenDelay`	number	`0`	自动打开延迟（毫秒），0 = 不自动打开
`showTransferBtn`	boolean	`true`	是否显示"转人工"按钮

🎨 主题预览 / Theme Preview

内置 4 种主题配色，与你的网站风格无缝融合：

Coral

Purple

Green

Amber

🎮 在线演示 / Live Demo

点击右下角的聊天按钮体验实际效果，或在下方的模拟页面中预览：

🏢

你的网站

点击右下角的 💬 按钮开始对话

🔧 代码生成器 / Code Generator

输入你的智能体公钥，自动生成可复制的嵌入代码：

智能体公钥 (Agent Public Key)

客服名称 (Agent Name)

主题 (Theme)

位置 (Position)

      
<!-- AICQ CS Widget -->
<script src="https://aicq.me/static/aicq-cs-widget.js"></script>
<script>
  AicqCS.init({
    agentPublicKey: '...',
    agentName: 'AI 客服助手',
    theme: 'coral',
    position: 'right',
  });
</script>
    

📡 JavaScript API

组件初始化后，你可以通过以下 API 程序化控制聊天窗口：

方法	说明
`AicqCS.open()`	打开聊天窗口
`AicqCS.close()`	关闭聊天窗口
`AicqCS.toggle()`	切换聊天窗口开关
`AicqCS.destroy()`	销毁组件并清理 DOM

客服嵌入组件 CS Widget v1.0