您可以将最多 50 个外部内容源连接到您的 Zendesk 帐户，并使内容在使用外部内容的任何地方可用。

我的服务模式是什么？
所有 Suite： Team、Growth、Professional、Enterprise 或 Enterprise Plus
Support，含 知识 Professional 或 Enterprise

概要：◀▼

连接外部知识来源，使内容可在各种知识体验中搜索和使用。您可以添加最多 50 个来源，然后管理 Box、Confluence、Google 云端硬盘、 Jira、Notion、SharePoint 等连接器的同步、权限和身份验证。知识管理员可设置来源，并在下次同步时提取更新。

将外部内容连接到 Zendesk 帐户的功能适用于所有服务模式。但是，外部数据的存储空间限制因服务模式而异。请参阅管理 Zendesk 帐户中的数据存储空间。

您最多可以将 50 个外部内容来源连接到您的 Zendesk 帐户，并使其可用于任何使用外部内容的位置。

本文章包含以下主题：
  • 使用知识连接器连接外部内容
  • 知识连接器身份验证参考
相关文章：
  • 关于将外部内容连接到 Zendesk 以在各种知识体验中使用

使用知识连接器连接外部内容

您可以将外部知识源连接到您的 Zendesk 帐户，以便在任何使用外部内容的地方进行调用。每个知识连接器都有一个连接器特定的身份验证页面，您可以在连接之前配置该页面。连接后，您可以使用“连接”页面管理连接。对这些元素进行的任何更新或添加都将在下一次同步时同步到 Zendesk。

当您将外部知识来源连接到 Zendesk 时，您将在“知识管理”中看到它们被列为外部搜索来源。

只有知识管理员才能设置和管理外部内容连接。

使用知识连接器连接外部内容
  1. 在知识管理中，单击管理文章( ）。
  2. 单击外部内容>连接。
  3. 在可用来源部分，单击您要连接的知识来源对应的连接。
  4. 查看消息传送，然后单击继续以开始配置连接。
  5. 输入所需的身份验证信息，以授予 Zendesk 访问知识来源内容的权限。

    身份验证详情因连接器而异。请参阅知识连接器身份验证参考，了解特定于您正在配置的连接器的信息。

  6. 单击同步。

    知识连接器随即添加到连接页面并开始同步。要管理现有连接，请参阅管理外部知识连接。

知识连接器身份验证参考

下表列出了每个连接器必填的身份验证字段。登录要连接的系统时，使用对您要同步到 Zendesk 的内容具有正确权限的用户帐户。
连接器 身份验证和连接详情
Amazon S3 在身份验证标签上，配置以下内容：
  • 访问密钥 ID和秘密访问密钥：AWS IAM 凭证，用于授予对您要同步的 Amazon S3 存储桶的编程访问权限。AWS访问密钥通过AWS Identity and Access Management (IAM) 控制台生成。有关更多信息，请参阅AWS Developer Guide 。
  • AWS区域：存储桶所在的AWS区域。
在定义范围标签上，配置以下内容：
  • 存储段名称：您要同步的 Amazon S3 存储桶的名称。此连接器将同步存储桶中所有受支持的文件类型（.docs、.xlsx 和 .md）、文件夹及子文件夹。
Box 使用对您要同步到 Zendesk 的内容具有正确权限的用户帐户登录 Box。

配置以下内容：

  • 根文件夹：您要同步到 Zendesk 帐户的根文件夹。您只能选择根目录中的顶级文件夹；您无法选择根目录中的子文件夹或单个文件。当您选择一个根文件夹时，同步将自动包括该文件夹中的所有子文件夹和受支持的文件类型（docx、.xlsx、.html 和 .md）。

设置 Box 连接时，您可以选择位于 Box 知识库根目录下的父文件夹。同步连接器时，该父文件夹中所有受支持的内容（包括子文件夹和受支持的文件）都将同步到您的 Zendesk 帐户。
Confluence 使用对您要同步到 Zendesk 的内容具有正确权限的用户帐户登录 Confluence。

配置以下内容：

  • Confluence 网站：您要连接的 Confluence 网站。
  • 空间：您要连接的空间。下拉菜单中仅显示前 20 个空格（按字母顺序显示）。要选择一个不显示在菜单中的空间，请在搜索框中输入该空间的名称，然后在空间显示后将其选中。要移除空间，单击空间标签上的X。

不允许连接到 Confluence 中的个人空间。
Contentful 在身份验证标签上，配置以下内容：
  • Contentful 空间 ID ：您要连接到 Zendesk 的 Contentful 空间的标识符。有关查找 Contentful 空间 ID 的更多信息，请参阅Contentful帮助中心。
  • API 密钥：（ ContentDelivery API - Contentful 中的访问密钥）此凭证可授予以读取存储在您的 Contentful 空间中的内容的编程访问权限。
在添加公共 URL 标签上，配置以下内容：
  • URL 格式*（必填） ：托管 Contentful 内容的公开页面的 URL 格式。URL 格式可以是：
    • 包含完整 URL 的字段，例如fields.url
    • 带有一个或多个占位符的 URL 字符串，例如https://zendesk.com/{fields.slug}
    占位符可以引用输入字段（fields.<fieldId> ）和条目元数据（sys.<key> ），例如sys.id。

知识连接器仅提取可与 URL 关联的内容。如果由于缺少必填字段而无法从 URL 格式构造 URL，则在内容同步期间会跳过该记录。
Document360 在身份验证标签上，配置以下内容：
  • 选择服务器：选择托管您 Document360 帐户的服务器区域（欧盟、美国或私有）。如果您选择私密，系统还会提示您输入 Document360 私密托管帐户的子域名。
  • API 密钥：输入您在 Document360 帐户中为此连接创建的 API 密钥。
在定义范围标签上，配置以下内容：
  • 工作区：选择您要同步的任意公开工作区。
  • 语言：选择您要同步的知识库语言。此连接将仅以您在此处指定的语言同步 Document360 内容。您必须为每种语言创建一个新的连接。
  • 类别：选择您要同步的类别。您选择的每个类别或子类别都将显示为类别字段中的标签。选择类别后，您将仅同步该类别级别的内容；您未同步该类别中的子类别。您必须选择包含要同步的内容的类别和子类别。

每次创建连接时，您都必须提供一个唯一的 API 密钥。在 Document360 中创建 API 令牌以用于 Zendesk 时，请务必将 GET 指定为允许的 HTTP 方法。有关更多信息，请参阅Document360 文档。
Dropbox 使用对您要同步到 Zendesk 的内容（.docs、.xlsx、.html 和 .md）具有正确权限的用户帐户登录 Dropbox。

选择您要同步到 Zendesk 帐户的根文件夹。

您只能选择根目录中的顶级文件夹；您无法选择根目录中的子文件夹或单个文件。当您选择根文件夹时，同步将自动包括该文件夹中的所有子文件夹和受支持的文件类型。
Freshdesk 配置以下内容：
  • 域名：当前 Freshdesk 域名。这是您在创建帐户时选择的子域名（例如，yourcompany. Freshdesk.com）。
  • API 密钥：Freshdesk API 密钥，允许 Zendesk 直接与您的 Freshdesk 帐户通讯。

Zendesk 仅从默认区域设置提取内容。
Google Drive 使用对您要同步到 Zendesk 并允许 Zendesk 访问您的 Google 云端硬盘文件的内容具有正确权限的用户帐户登录 Google。

选择您要同步的云端硬盘。

Google 云端硬盘连接器支持 Google 文档和表格。此外，Google 云端硬盘连接器可同步来自共享 Google 云端硬盘的内容。来自私密 Google 云端硬盘的内容不会同步。您可以注册 PDF 提取 EAP以启用PDF 文档同步。
大师 在身份验证标签上，配置以下内容：
  • 电邮：用于访问您的 Guru 帐户的电邮地址。您必须是 Guru 管理员才能创建连接，并且只能同步您在 Guru 中有权访问的内容。
  • API 密钥：与您在 Guru 中的电邮地址关联的用户令牌。用户令牌根据您现有的帐户权限提供 Guru 中的读取和写入访问权限。单击管理>此字段上方的API 访问可访问 Guru 中的页面，您可在其中生成用户密钥。有关更多信息，请参阅 Guru帮助中心的利用 Guru's API 。
在定义范围标签上，配置以下内容：
  • 集合：包含您要同步的已发布内容的 Guru 集合。
Jira 选择您要与 Zendesk 帐户同步的 JIRA 帐户。

输入以下信息：

  • Jira网站：输入您要同步的Jira网站。此字段显示您有权访问的所有Jira网站。每个Jira网站都映射到一个Jira连接。要同步多个网站，必须为每个网站创建新的连接。
  • 选择空间：输入您要同步的Jira空间。此字段显示您选择的Jira网站中所有您可以访问的空间。您选择的每个空间都会显示为空间字段中的一个标签。您可以通过单击空间标签上的X图标来移除误选的空间。
已同步内容包括：
  • 问题密钥
  • 概要
  • 描述
  • 状态
  • 优先级
  • 类型
  • 标签
  • 评论
Notion 从右上角的下拉列表中选择您的 Notion 工作区。

在团队空间中选择您要同步的页面，然后允许访问这些页面。

由于 Notion 的限制，您只能在 Zendesk 帐户中设置一个 Notion 连接。要向此连接添加或移除内容，请参阅在您的 Notion 连接中添加或移除内容。

要使页面同步到您的 Zendesk 帐户，页面正文中必须有内容。
SharePoint 使用对您要同步到 Zendesk 的内容具有正确权限的用户帐户登录 Microsoft。

从下拉列表中选择您的SharePoint 网站。

支持的文件类型为 docx、.xlsx 和 .md。您可以注册 PDF 提取 EAP以启用PDF 文档同步。
Zendesk 输入所有连接（公开和非公开）所需的信息：
  • Zendesk URL ：您 Zendesk 帐户的 URL
如果您要同步需要用户登录的非公开内容，单击打开，然后输入所需的信息：
  • 电邮：与您的 Zendesk 帐户关联的电邮地址。此信息与 API 密钥结合使用，以访问和同步您的内部内容。
  • API 密钥：API 密钥，您可用于将非公开文章同步到您的 Zendesk 帐户。如果您将此字段留空，则只有对匿名用户可见的内容才会被同步。

为您要同步的文章选择区域设置（可选） 。您要同步的文章的区域设置。如果您将此字段留空，则与所有区域设置关联的文章都将同步。

如果您不指定带有电邮和区域设置的 API 密钥，则每个连接将包含该子域名在所有区域设置中的公开可用内容。所有满足此条件的已发布文章都将同步到连接。如果您想从另一个 Zendesk 子域名同步内容，您需要为该子域名添加一个新的连接。

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。

由 Zendesk 提供技术支持