` 是挂载点——聊天面板会在其中渲染并填满其尺寸。你可以随意设置该 div 的样式（赋予固定高度、将其放入 flex 容器、放置在网格单元格中等），聊天面板将随之调整。
即使你嵌入了多个聊天小部件，页面上也只需要 **一个** `
```
{% endcode %}
内嵌式代码片段则将目标信息携带在 `
` 上，因此一个页面可以容纳多个指向不同位置的聊天：
{% code overflow="wrap" %}
```html
```
{% endcode %}
对于坐席，措辞会变为 `?agent=AGENT_ID` 或 `data-agent="AGENT_ID"`。
几点值得注意的事项：
- 请使用复制按钮，而不是手动输入 ID。如果 ID 与您账户中的营销活动或代理不匹配，聊天功能仍可正常使用，但会回退到默认路由。
- 已经在进行对话的用户将保持与当前对话对象的连接，即使他们随后跳转到指向其他位置的页面。这可以防止对话中途出现“人格”切换。
- 特定页面的目标设置优先级高于账户默认设置和关键词触发器。
### 告知小部件访客身份（高级）
如果您将聊天小部件放置在会员专区、客户门户或用户已登录的应用程序中，您的网站已经知道他们的身份。您可以将其传递给小部件，这样访客就不必再次输入他们已经提供过的信息，您的 AI 也可以利用您已掌握的关于他们的信息。
在小部件脚本**之前**添加一个小的设置代码块：
{% code overflow="wrap" %}
```html
```
{% endcode %}
您的页面应在服务器端填充这些值，具体取决于当前登录的用户。
会发生两件事：
- **跳过“开始之前...”表单。** 提供姓名和电子邮件后，访客将直接进入对话，这些详细信息将保存到他们的联系人信息中，就像他们自己输入的一样。
- **`data` 下的所有内容都会传递给您的 AI。** 您在此处放入的任何内容（如套餐、订单号、续订日期、信用余额、席位数量等）都将成为 AI 对该用户了解的一部分，因此它可以回答“我的套餐什么时候续订？”之类的问题，而无需先询问他们的身份。使用对您有意义的任何字段名称；它们会显示在联系人的“自定义字段”下。最多支持 20 个值，随每条消息实时发送，因此如果套餐在对话中途发生变更，AI 也能看到新的信息。
对于内嵌式嵌入，您可以将相同的信息放在 `
` 上，这在单个页面包含多个聊天窗口时非常方便：
{% code overflow="wrap" %}
```html
```
{% endcode %}
如果您的网站仅在页面加载后才知道访客是谁（例如，登录无需重新加载页面的单页应用程序），请在获取详细信息时调用此方法，小部件会自动更新：
{% code overflow="wrap" %}
```html
```
{% endcode %}
几点值得注意的事项：
- 如果两个不同的人在同一台计算机上登录，第二个人将开始新的对话，而不是看到第一个人的聊天记录。小部件会注意到人员变更并自行重置。
- 这仅用于提供上下文，而非用于登录。对话仍按原样保持独立，因此传递 `id` 不会让任何人打开他人的聊天记录，而在不同设备或浏览器上使用的人员也会开启新的对话。
- 这是可选的。普通公共页面上的小部件不需要这些设置，其行为与之前完全相同。
### 通过您自己的代码更改小部件设置 (API)
小部件 **管理 (Manage)** 面板上的所有内容也可以通过 [REST API](../api/reference.md) 进行更改，如果您管理多个网站或希望自动为客户关闭附件按钮，这将非常方便。发送 `PATCH` 到 `https://api.youraiconnector.com/v1/chat-widget-configs/CONFIG_ID`，并在其中包含您的 API 密钥以及您想要更改的字段——例如 `{"show_upload_button": false}` 可隐藏附件按钮，`{"show_emoji_button": false}` 可隐藏表情符号选择器，`{"launcher_icon": "chat-dots"}` 可更换启动器图标。`CONFIG_ID` 是与您的嵌入脚本中相同的标识符。可接受字段的完整列表（名称、开场消息、颜色、启动器图标、允许的域名、访客信息表单、隐私声明、主题、圆角和字体样式）位于 [API 参考](../api/reference.md) 的 **聊天小部件 (Chat Widget)** 下。网站会在下次页面加载时获取这些更改。
### 安装后的预期效果
将脚本添加到您的网站后，聊天小部件会自动在网站角落（默认在右下角）创建一个聊天按钮。当用户滚动页面时，该小部件会保持固定位置，确保始终可以访问。
当访客点击此按钮时，它会展开为一个完整的聊天窗口，访客可以在其中开始对话，并显示您的开场白。如果开启了“收集访客信息”，则在访客输入内容前，会先弹出一个小表单，要求他们提供姓名和电子邮件（以及可选的电话）。
聊天界面会自动适应不同的屏幕尺寸，因此在桌面端和移动端设备上都能无缝运行。
### 测试您的实现
将小部件添加到您的网站后，请测试其是否正常工作：
1. 在浏览器中打开您的网站。
2. 点击聊天按钮以打开小部件。
3. 发送一条测试消息，并确认您收到了回复。
4. 在不同的设备或浏览器上重复此操作，以确认它在任何地方都能正常工作。
如果聊天小部件未在您的网站上显示，请检查以下内容：
1. 确保您已将 `CONFIG_ID` 替换为您实际的配置标识符。
2. 确保脚本标签放置在结束的 `