---
title: 支持与聊天服务商
description: >-
  在 docs.json 的 integrations 中配置 appId 或 snippetId，为 Jamdesk 文档添加 Intercom 或 Front Chat，并可选择启用同意管理。
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Jamdesk 可以在文档网站的每个页面加载实时聊天小组件。在 `docs.json` 的 `integrations` 下添加服务商配置块，Jamdesk 会为你注入小组件脚本。

<Info>
Jamdesk 加载小组件前，会检查每个值是否符合严格格式。格式错误的值会被静默跳过，且不会渲染——不会显示错误页面，也不会生成损坏的脚本标签。
</Info>

## 从仪表板配置

设置这两项的最快方式是：**Dashboard → Integrations**。选择服务商卡片，粘贴其 ID，Jamdesk 会为你写入 `docs.json` 配置块并触发重新构建（仅适用于已连接 GitHub 的项目）。以下部分适用于直接编辑 `docs.json`，或仅使用 CLI 的项目。

## Intercom

**格式：**应用 ID 必须由 6–16 个字母或数字组成。

<Info>
在 Intercom 的 **Settings → Installation → Web** 中查找你的 App ID——它就是你的工作区 ID。
</Info>

```json docs.json
{
  "integrations": {
    "intercom": {
      "appId": "abc12345"
    }
  }
}
```

## Front Chat

**格式：**Chat ID 必须由 8–64 个小写十六进制字符组成（`0-9`、`a-f`）。

```json docs.json
{
  "integrations": {
    "frontchat": {
      "snippetId": "3f8a2e1c9b6d4a7f"
    }
  }
}
```

## 同意控制

两个小组件都支持 `integrations.cookies`。设置该选项后，聊天脚本会等到你的同意横幅记录批准后才加载——完整设置请参阅 [Cookie 同意](/cn/integrations/cookie-consent)。不设置该选项时，小组件会在页面加载时为每位访客加载。

## 相关文章

<Columns cols={2}>
  <Card title="Cookie 同意" icon="cookie-bite" href="/cn/integrations/cookie-consent">
    在访客同意后再加载聊天小组件
  </Card>
  <Card title="分析与会话回放服务商" icon="chart-line" href="/cn/integrations/analytics-providers">
    PostHog、Mixpanel、Amplitude 及另外 10 个服务商
  </Card>
</Columns>