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集成
- 使用专用用户登录www.zendesk.com。
- 选择管理(设置图标)。下渠道选择API.
- 选择OAuth客户选项卡,然后选择+(+)图标。
- 输入一个客户端名称你的应用。
- (可选)添加描述,公司,标志.
- 复制自动填充的唯一标识符以后使用的价值。
- 集重定向url如下所述。
- 选择保存而且好吧.
- 刷新页面后,会出现一个新的预先填充的Secret字段。复制秘密令牌这是为以后使用而生成的。离开此屏幕后将不可用。
- 选择保存.
您已经准备好在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
数据加载端点中的变量。看到替换数据加载变量.
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成.
- 选择下面的Zendesk瓷砖集成..
- 输入一个集成的名字对于积分。
- 输入连接器参数.
- 输入您的基URL或者简单地替换
{客户id}
在你的客户ID的例子中。 - 选择一个图标从图标库集成,或保留默认的Zendesk图标。
- 启用本地实例如果您正在创建本地连接,请切换。有关更多信息,请参见本地实例.
- 输入您的基URL或者简单地替换
下服务认证中,选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。已预先选择身份验证选项。确保在完成流程时选中了这些选项。使用OAuth 2.0安全协议为委托访问生成请求/授权令牌。建议在可用的情况下始终使用OAuth 2.0作为服务身份验证方法。OAuth 2.0确保您的集成满足您所配置的微应用程序的最大安全合规。
- 选择授权代码从Grant型流程菜单。这授予了一个临时代码,客户端用它交换访问令牌。代码从授权服务器获得,您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示回调URL,在注册应用程序时使用
- 输入authorization_code在授权类型值字段。
- 选择授权头从令牌授权菜单。
- 选择URL编码表单从令牌内容类型菜单。
- 输入您的授权URL或者简单地替换
{客户id}
在你的客户ID的例子中。这是在设置目标应用程序集成时提供的授权服务器URL。 - 输入您的标记的URL或者简单地替换
{客户id}
在你的客户ID的例子中。这是访问授权令牌的URL。 - 确保阅读写为范围用于定义访问请求的范围。
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在Zendesk帐户中注册OAuth客户端来收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
- 输入您的标题前缀.(可选)如果您的承载字冠与默认字冠不同,请输入头冠。
- 如果你选择了OAuth 2.0认证方式,可选择+添加参数包括访问令牌参数.访问令牌参数定义目标应用程序授权服务器(如有必要)所需的访问令牌参数。
下服务动作认证,启用在操作中使用独立用户身份验证toggle服务动作认证在服务动作级进行认证。凭据与服务授权级别的凭据相同。已预先选择身份验证选项。确保在完成流程时选中了这些选项。
- 选择OAuth 2.0从身份验证方法菜单并完成身份验证详细信息。
- 选择授权代码从Grant型流程菜单。这授予了一个临时代码,客户端用它交换访问令牌。代码从授权服务器获得,您可以在其中看到客户端请求的信息。只有这种授权类型支持安全用户模拟。这将显示回调URL,在注册应用程序时使用
- 输入authorization_code在授权类型值字段。
- 选择授权头从令牌授权菜单。
- 选择URL编码表单从令牌内容类型菜单。
- 输入您的授权URL或者简单地替换
{客户id}
在你的客户ID的例子中。这是在设置目标应用程序集成时提供的授权服务器URL。 - 输入您的标记的URL或者简单地替换
{客户id}
在你的客户ID的例子中。这是访问授权令牌的URL。 - 确保阅读写为范围用于定义访问请求的范围。
- 输入您的客户机ID.客户端ID是表示授权服务器唯一的客户端注册信息的字符串。您可以通过在Zendesk帐户中注册OAuth客户端来收集这些信息和秘密。您需要添加回调URL您可以在集成配置页面上看到。
- 输入您的客户的秘密.客户端秘密是在设置目标应用程序集成时发出的唯一字符串。
- 输入您的标题前缀.(可选)如果您的承载字冠与默认字冠不同,请输入头冠。
- 的请求速率限制启用了Toggle,并且请求数每时间间隔设置为500每分钟。
- (可选)使日志记录切换以保持24小时的日志记录用于支持目的。
的请求超时字段默认为120。
- 选择保存继续。
- 下OAuth授权中,选择授权使用您的服务帐户登录。弹出一个Webex登录屏幕。
- 输入您的服务帐户用户名和密码并选择登录.
- 选择接受.
继续执行以下步骤完成设置过程。
替换数据加载变量
默认情况下,在完全同步期间,此集成只加载最近三(3)个月内修改的票据。如果需要对此进行更改,请修改start_time
的模板变量参数票此集成数据加载设置中的端点。我们建议您根据您的需要和机票的通常使用年限修改此值。筛选器基于最近一次更新,而不是创建。
- 从Microapp集成页面,选择Zendesk集成旁边的菜单,然后编辑.的数据加载屏幕上打开。如果在配置界面,选择数据加载从左侧导航栏。
- 控件旁边的菜单票端点,然后选择编辑,或选择端点的名称:票.
- 在编辑数据端点屏幕,下模板变量的值
start_time
变量,根据需要更改时间参数和数值。 选择应用在屏幕底部,并确认。
现在可以设置并运行第一次数据同步了。有关同步规则、不符合其时间表的同步和否决规则的完整信息,请参见同步数据.
有关API端点和表实体的详细信息,请参见Zendesk连接器规格.
使用Zendesk微应用
现有的应用集成带有开箱即用的微应用。从这些微应用程序开始,并根据您的需要定制它们。
注意:我们提供了两个Zendesk集成模板供您使用。对于大多数用例,我们建议使用更新的HTTP集成,而不是旧的基于java的集成。它们包含的微应用程序略有不同。
使用Zendesk微应用
我们的Zendesk HTTP集成带有以下预配置的开箱即用的微应用程序:
添加机票:提交Zendesk门票。
通知或页面 | 用例的工作流 |
---|---|
添加门票页面 | 提供用于提交票据的表单。 |
门票:查看Zendesk门票详细信息。如果持有
在Zendesk实例中是不允许的,您需要删除持有
项从状态
列于更新票页面。
通知或页面 | 用例的工作流 |
---|---|
新票已分配给您(已更改)通知 | 当现有的票据被分配给用户时,他们会收到一个通知。 |
新票分配给你(新)通知 | 当一个新票据被分配给用户时,他们会收到一个通知。 |
机票状态变更通知 | 当票据的状态发生变化时,票据的提交者会收到通知。 |
机票已更新通知 | 当票据更新时,提交者会收到通知。 |
添加评论页面 | 提供用于向票据添加注释的页面。 |
评论详情页面 | 提供注释及其详细信息的只读视图。 |
我的票务页面 | 提供与用户相关的个性化门票列表,以及到门票详细信息的链接。 |
票务详情页面 | 提供包含详细信息的票据的只读视图。 |
更新票务页面 | 提供管理员修改票据的页面。包括“优先级”、“类型”和“状态”。 |
添加Zendesk Legacy集成
按照下面的说明设置遗留的基于java的Zendesk集成。
遵循以下步骤:
- 从Microapp集成页面,选择添加新的集成,从citrix提供的模板中添加新的集成.
- 下遗产,选择Zendesk瓷砖。
为集成输入一个名称。
- 进入连接器参数你收集的先决条件。
- 输入实例URL.
- 进入客户机ID.此值是您在Zendesk注册应用程序时获得的唯一标识符。
- 进入客户的秘密.此值是您在Zendesk注册应用程序时复制的Secret。
- 属性的值要装载的票的月数.
- 选择使用Zendesk帐户登录启用OAuth Authorization。一个Zendesk登录页面将在一个新选项卡中打开。系统将提示您输入帐户名、确认访问并输入密码。
- 选择添加.
的Microapp集成页面打开与您添加的集成及其微应用程序。从这里开始,您可以添加另一个集成,继续设置开箱即用的微应用程序,或者为该集成创建一个新的微应用程序。
现在可以设置并运行第一次数据同步了。由于可以从集成应用程序中提取大量数据到Microapps平台,我们建议您使用表格页,为第一次数据同步筛选实体,以加快同步速度。有关更多信息,请参见验证所需的实体.有关同步规则、不符合其时间表的同步和否决规则的完整信息,请参见同步数据.
有关API端点和表实体的详细信息,请参见Zendesk连接器规格.
遗留Zendesk微应用程序
我们基于java的Zendesk集成带有以下预配置的开箱即用的微应用程序:
添加机票:提交Zendesk门票。
通知或页面 | 用例的工作流 |
---|---|
提交门票页面 | 提供用于提交票据的表单。 |
门票:查看Zendesk门票详细信息。
通知或页面 | 用例的工作流 |
---|---|
新票已分配给您(已更改)通知 | 当现有的票据被分配给用户时,他们会收到一个通知。 |
新票分配给你(新)通知 | 当一个新票据被分配给用户时,他们会收到一个通知。 |
机票状态变更通知 | 当票据的状态发生变化时,票据的提交者会收到通知。 |
机票已更新通知 | 当票据更新时,提交者会收到通知。 |
我的票务页面 | 提供与用户相关的个性化门票列表,以及到门票详细信息的链接。 |
票务详情页面 | 提供包含详细信息的票据的只读视图。 |