Zendesk集成

与Zendesk集成，提交和监控来自任何设备，内部网或信使的请求。

注意:

我们提供了两个Zendesk集成模板供您使用。对于大多数用例，我们建议使用更新的HTTP集成。HTTP集成提供了配置缓存数据结构的更强大功能。有关每个集成中可用的微应用程序的完整细节，请参见使用Zendesk微应用．

使用以下过程来启用Zendesk Integration。确保满足先决条件，并获得客户端ID和秘密令牌。完成此过程后，现有级别的审计日志记录将继续存在，包括使用Citrix Microapps执行的任何操作。

有关即时可用的Zendesk微应用程序的全面列表，请参见使用Zendesk微应用．

检查先决条件

创建一个专用的Zendesk帐户，并使用它来设置Zendesk集成。此帐户必须具有具有完全数据访问权限的管理员等角色。在Zendesk中设置此集成后，您将需要这些工件来在Citrix Workspace Microapps中添加集成:

• 基URL:基URL遵循这个模型:https://{客户id} .zendesk.com/．
• 客户ID:使用URL的客户ID部分(如上所示)进行替换客户id在设置过程中。
• 客户机ID:客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在Zendesk帐户中注册OAuth客户端来收集这些信息和秘密。
• 客户的秘密:客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
• 账户:这是您的服务帐户用户名。
• 密码:这是您的服务帐号密码。

在开始集成过程之前，应该满足以下先决条件:

• 将Citrix Gateway配置为支持Zendesk的单点登录，这样一旦用户登录，他们就会自动再次登录，而无需再次输入凭据。请按照Zendesk单点登录配置．有关配置SSO的详细信息，请参见Citrix Gateway Service．

Zendesk有一个选择保持通话状态它允许用户分配一个持有到票的状态。我们microapp票允许用户查看Zendesk门票的详细信息，以及页面更新票有一个领域状态在哪里持有是一个选项。如果持有在Zendesk实例中是不允许的，您需要删除持有项从状态列表。有关更多信息，请参见使用Zendesk微应用．

设置Zendesk集成

1. 使用专用用户登录www.zendesk.com。
2. 选择管理(设置图标)。下渠道选择API．
3. 选择OAuth客户选项卡，然后选择+(+)图标。
4. 输入一个客户端名称你的应用。
5. (可选)添加描述，公司,标志．
6. 复制自动填充的唯一标识符以后使用的价值。
7. 集重定向url如下所述。
8. 选择保存而且好吧．
9. 刷新页面后，会出现一个新的预先填充的Secret字段。复制秘密令牌这是为以后使用而生成的。离开此屏幕后将不可用。
10. 选择保存．

您已经准备好在Citrix Workspace Microapps中完成集成。

添加回调url

向实例配置中添加自定义URL，以授予对私有数据的访问权，并启用OAuth身份验证的用户操作。列出的第一个回调不会更改。第二个回调依赖于目标应用程序，可以在创建集成时在URL地址栏中找到。section {yourmicroappserverurl}由租户部分、区域部分和环境部分组成:https:// {tenantID}。{地区(美国/欧盟/ ap-s)} .iws.cloud.com．

以管理员身份登录Zendesk，并为该集成添加以下授权重定向url:

• https:// {yourmicroappserverurl} / admin / api / gwsc /认证/ serverContext
• https:// {yourmicroappserverurl} / app / api /认证/ serviceAction /回调

将集成添加到Citrix Workspace Microapps

按照以下步骤设置Zendesk HTTP集成。对于大多数用例，我们建议使用更新的HTTP集成。已预先选择身份验证选项。确保在完成流程时选中了这些选项。我们建议在大多数用例中使用这个更新的HTTP集成。HTTP集成提供了配置缓存数据结构的更强大功能。

注意:

默认情况下，该集成将同步三(3)个月的数据。我们建议您根据您的需要和机票的通常使用年限修改此值。筛选器基于最近一次更新，而不是创建。要更改此设置，必须修改start_time数据加载端点中的变量。看到替换数据加载变量．

遵循以下步骤:

1. 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成．
2. 选择下面的Zendesk瓷砖集成．．
3. 输入一个集成的名字对于积分。
4. 输入连接器参数．
   • 输入您的基URL或者简单地替换{客户id}在你的客户ID的例子中。
   • 选择一个图标从图标库集成，或保留默认的Zendesk图标。

   

   • 启用本地实例如果您正在创建本地连接，请切换。有关更多信息，请参见本地实例．

   

5. 下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。已预先选择身份验证选项。确保在完成流程时选中了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。

   1. 选择授权代码从Grant型流程菜单。这授予了一个临时代码，客户端用它交换访问令牌。代码从授权服务器获得，您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示回调URL，在注册应用程序时使用
   2. 输入authorization_code在授权类型值字段。
   3. 选择授权头从令牌授权菜单。
   4. 选择URL编码表单从令牌内容类型菜单。
   5. 输入您的授权URL或者简单地替换{客户id}在你的客户ID的例子中。这是在设置目标应用程序集成时提供的授权服务器URL。
   6. 输入您的标记的URL或者简单地替换{客户id}在你的客户ID的例子中。这是访问授权令牌的URL。
   7. 确保阅读写为范围用于定义访问请求的范围。
   8. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在Zendesk帐户中注册OAuth客户端来收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
   9. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
   10. 输入您的标题前缀．(可选)如果您的承载字冠与默认字冠不同，请输入头冠。

   

   1. 如果你选择了OAuth 2.0认证方式，可选择+添加参数包括访问令牌参数．访问令牌参数定义目标应用程序授权服务器(如有必要)所需的访问令牌参数。

   

6. 下服务动作认证，启用在操作中使用独立用户身份验证toggle服务动作认证在服务动作级进行认证。凭据与服务授权级别的凭据相同。已预先选择身份验证选项。确保在完成流程时选中了这些选项。

   1. 选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。
   2. 选择授权代码从Grant型流程菜单。这授予了一个临时代码，客户端用它交换访问令牌。代码从授权服务器获得，您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示回调URL，在注册应用程序时使用
   3. 输入authorization_code在授权类型值字段。
   4. 选择授权头从令牌授权菜单。
   5. 选择URL编码表单从令牌内容类型菜单。
   6. 输入您的授权URL或者简单地替换{客户id}在你的客户ID的例子中。这是在设置目标应用程序集成时提供的授权服务器URL。
   7. 输入您的标记的URL或者简单地替换{客户id}在你的客户ID的例子中。这是访问授权令牌的URL。
   8. 确保阅读写为范围用于定义访问请求的范围。
   9. 输入您的客户机ID．客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在Zendesk帐户中注册OAuth客户端来收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
   10. 输入您的客户的秘密．客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
   11. 输入您的标题前缀．(可选)如果您的承载字冠与默认字冠不同，请输入头冠。

   

7. 的请求速率限制启用了Toggle，并且请求数每时间间隔设置为500每分钟。
8. (可选)使日志记录切换以保持24小时的日志记录用于支持目的。

9. 的请求超时字段默认为120。

   

10. 选择保存继续。
11. 下OAuth授权中,选择授权使用您的服务帐户登录。弹出一个Webex登录屏幕。
    1. 输入您的服务帐户用户名和密码并选择登录．
    2. 选择接受．

继续执行以下步骤完成设置过程。

替换数据加载变量

默认情况下，在完全同步期间，此集成只加载最近三(3)个月内修改的票据。如果需要对此进行更改，请修改start_time的模板变量参数票此集成数据加载设置中的端点。我们建议您根据您的需要和机票的通常使用年限修改此值。筛选器基于最近一次更新，而不是创建。

1. 从Microapp集成页面，选择Zendesk集成旁边的菜单，然后编辑．的数据加载屏幕上打开。如果在配置界面，选择数据加载从左侧导航栏。
2. 控件旁边的菜单票端点，然后选择编辑，或选择端点的名称:票．
3. 在编辑数据端点屏幕,下模板变量的值start_time变量，根据需要更改时间参数和数值。

4. 选择应用在屏幕底部，并确认。

   

现在可以设置并运行第一次数据同步了。有关同步规则、不符合其时间表的同步和否决规则的完整信息，请参见同步数据．

有关API端点和表实体的详细信息，请参见Zendesk连接器规格．

使用Zendesk微应用

现有的应用集成带有开箱即用的微应用。从这些微应用程序开始，并根据您的需要定制它们。

注意:我们提供了两个Zendesk集成模板供您使用。对于大多数用例，我们建议使用更新的HTTP集成，而不是旧的基于java的集成。它们包含的微应用程序略有不同。

使用Zendesk微应用

我们的Zendesk HTTP集成带有以下预配置的开箱即用的微应用程序:

添加机票:提交Zendesk门票。

通知或页面	用例的工作流
添加门票页面	提供用于提交票据的表单。

门票:查看Zendesk门票详细信息。如果持有在Zendesk实例中是不允许的，您需要删除持有项从状态列于更新票页面。

通知或页面	用例的工作流
新票已分配给您(已更改)通知	当现有的票据被分配给用户时，他们会收到一个通知。
新票分配给你(新)通知	当一个新票据被分配给用户时，他们会收到一个通知。
机票状态变更通知	当票据的状态发生变化时，票据的提交者会收到通知。
机票已更新通知	当票据更新时，提交者会收到通知。
添加评论页面	提供用于向票据添加注释的页面。
评论详情页面	提供注释及其详细信息的只读视图。
我的票务页面	提供与用户相关的个性化门票列表，以及到门票详细信息的链接。
票务详情页面	提供包含详细信息的票据的只读视图。
更新票务页面	提供管理员修改票据的页面。包括“优先级”、“类型”和“状态”。

添加Zendesk Legacy集成

按照下面的说明设置遗留的基于java的Zendesk集成。

遵循以下步骤:

1. 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成．
2. 下遗产，选择Zendesk瓷砖。

3. 为集成输入一个名称。

   

4. 进入连接器参数你收集的先决条件。
   • 输入实例URL．
   • 进入客户机ID．此值是您在Zendesk注册应用程序时获得的唯一标识符。
   • 进入客户的秘密．此值是您在Zendesk注册应用程序时复制的Secret。
   • 属性的值要装载的票的月数．
5. 选择使用Zendesk帐户登录启用OAuth Authorization。一个Zendesk登录页面将在一个新选项卡中打开。系统将提示您输入帐户名、确认访问并输入密码。
6. 选择添加．

的Microapp集成页面打开与您添加的集成及其微应用程序。从这里开始，您可以添加另一个集成，继续设置开箱即用的微应用程序，或者为该集成创建一个新的微应用程序。

现在可以设置并运行第一次数据同步了。由于可以从集成应用程序中提取大量数据到Microapps平台，我们建议您使用表格页，为第一次数据同步筛选实体，以加快同步速度。有关更多信息，请参见验证所需的实体．有关同步规则、不符合其时间表的同步和否决规则的完整信息，请参见同步数据．

有关API端点和表实体的详细信息，请参见Zendesk连接器规格．

遗留Zendesk微应用程序

我们基于java的Zendesk集成带有以下预配置的开箱即用的微应用程序:

添加机票:提交Zendesk门票。

通知或页面	用例的工作流
提交门票页面	提供用于提交票据的表单。

门票:查看Zendesk门票详细信息。

通知或页面	用例的工作流
新票已分配给您(已更改)通知	当现有的票据被分配给用户时，他们会收到一个通知。
新票分配给你(新)通知	当一个新票据被分配给用户时，他们会收到一个通知。
机票状态变更通知	当票据的状态发生变化时，票据的提交者会收到通知。
机票已更新通知	当票据更新时，提交者会收到通知。
我的票务页面	提供与用户相关的个性化门票列表，以及到门票详细信息的链接。
票务详情页面	提供包含详细信息的票据的只读视图。