支持与聊天服务商
在 docs.json 的 integrations 中配置 appId 或 snippetId,为 Jamdesk 文档添加 Intercom 或 Front Chat,并可选择启用同意管理。
Jamdesk 可以在文档网站的每个页面加载实时聊天小组件。在 docs.json 的 integrations 下添加服务商配置块,Jamdesk 会为你注入小组件脚本。
Jamdesk 加载小组件前,会检查每个值是否符合严格格式。格式错误的值会被静默跳过,且不会渲染——不会显示错误页面,也不会生成损坏的脚本标签。
从仪表板配置
设置这两项的最快方式是:Dashboard → Integrations。选择服务商卡片,粘贴其 ID,Jamdesk 会为你写入 docs.json 配置块并触发重新构建(仅适用于已连接 GitHub 的项目)。以下部分适用于直接编辑 docs.json,或仅使用 CLI 的项目。
Intercom
**格式:**应用 ID 必须由 6–16 个字母或数字组成。
在 Intercom 的 Settings → Installation → Web 中查找你的 App ID——它就是你的工作区 ID。
docs.json
{
"integrations": {
"intercom": {
"appId": "abc12345"
}
}
}Front Chat
**格式:**Chat ID 必须由 8–64 个小写十六进制字符组成(0-9、a-f)。
docs.json
{
"integrations": {
"frontchat": {
"snippetId": "3f8a2e1c9b6d4a7f"
}
}
}同意控制
两个小组件都支持 integrations.cookies。设置该选项后,聊天脚本会等到你的同意横幅记录批准后才加载——完整设置请参阅 Cookie 同意。不设置该选项时,小组件会在页面加载时为每位访客加载。
