在用户界面中创建Zendesk源连接

本教程提供了使用Adobe Experience Platform用户界面创建Zendesk源连接的步骤。

快速入门

本教程需要对以下Adobe Experience Platform组件有一定的了解:

收集所需的凭据

要在Platform上访问您的Zendesk帐户,必须提供以下凭据的值:

凭据
描述
示例
Subdomain
在注册过程中创建的特定于您帐户的唯一域。
yoursubdomain
访问令牌
Zendesk API令牌。
0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf

有关验证Zendesk源的更多信息,请参阅Zendesk 源概述

Zendesk API令牌

为Zendesk创建平台架构

在创建Zendesk源连接之前,还必须确保首先创建用于源的Platform架构。 有关如何创建架构的完整步骤,请参阅有关创建平台架构的教程。

有关Zendesk Search API所需的Zendesk架构的其他指导,请参阅下面的限制部分。

创建架构

连接您的Zendesk帐户

在Platform UI中,从左侧导航栏中选择​ ​以访问源工作区。 Catalog屏幕显示您可以用来创建帐户的各种源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项查找您要使用的特定源。

在​ 客户成功 ​类别下,选择​ Zendesk,然后选择​ 添加数据

目录

出现​ 连接Zendesk帐户 ​页面。 在此页上,您可以使用新凭据或现有凭据。

现有账户

若要使用现有帐户,请选择您要用来创建新数据流的​ Zendesk ​帐户,然后选择​ 下一步 ​以继续。

现有

新帐户

如果要创建新帐户,请选择​ 新建帐户,然后提供名称、可选描述和凭据。 完成后,选择​ 连接到源,然后留出一些时间来建立新连接。

新

选择数据

在您的源进行身份验证后,页面将更新为交互式架构树,从而允许您浏览和检查数据的层次结构。 选择​ 下一步 ​以继续。

select-data

后续步骤

通过学习本教程,您已验证并创建了Zendesk帐户和平台之间的源连接。 您现在可以继续下一教程并创建数据流以将客户成功数据导入Platform

其他资源

以下部分提供了在使用Zendesk源时可以参考的其他资源。

验证 validation

下面概述了验证是否成功连接Zendesk源以及是否正在将Zendesk配置文件摄取到Platform可以采取的步骤。

在Platform UI中,从左侧导航中选择​ 数据集 ​以访问数据集工作区。 数据集活动屏幕显示执行的详细信息。

活动页面

接下来,选择要查看的数据流的数据流运行ID,以查看有关该数据流运行的特定详细信息。

数据流页面

最后,选择​ 预览数据集 ​以显示已摄取的数据。

Zendesk数据集

您还可以根据Zendesk > Customers页面上的数据验证您的Platform数据。

zendesk-customers

Zendesk架构

下表列出了必须为Zendesk设置的受支持映射。

TIP
有关API的更多信息,请参阅Zendesk Search API >导出搜索结果
来源
类型
results.active
布尔值
results.alias
字符串
results.created_at
字符串
results.custom_role_id
整数
results.default_group_id
整数
results.details
字符串
results.email
字符串
results.external_id
整数
results.iana_time_zone
字符串
results.id
整数
results.last_login_at
字符串
results.locale
字符串
results.locale_id
整数
results.moderator
布尔值
results.name
字符串
results.notes
字符串
results.only_private_comments
布尔值
results.organization_id
整数
results.phone
字符串
results.photo
字符串
results.report_csv
布尔值
results.restricted_agent
布尔值
results.result_type
字符串
results.role
字符串
results.role_type
整数
results.shared
布尔值
results.shared_agent
布尔值
results.shared_phone_number
布尔值
results.signature
字符串
results.suspended
布尔值
results.ticket_restriction
字符串
results.time_zone
字符串
results.two_factor_auth_enabled
布尔值
results.updated_at
字符串
results.url
字符串
results.verified
布尔值

限制 limits

  • Zendesk搜索API >导出搜索结果每页最多返回1000条记录。

    • filter[type]参数的值设置为user,因此Zendesk连接仅返回用户。
    • 每页的结果数由page[size]参数管理。 值设置为100。 这样做是为了减少Zendesk设置的减速限制的影响。
    • 查看限制分页
    • 您还可以参考使用游标分页对列表进行分页。
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089