添加帮助中心

帮助中心亚博Zendesk指南为您的客户提供基于web的自助服务知识库。亚博官方app您可以使用Support SDK在帮助中心中显示本地化的内容,过滤其内容以使其更有帮助,并将其用作创建票据的起点。

HelpCenterActivity添加帮助中心到您的Android应用程序。

如果您需要构建自己的ui, SDK还有一个API提供者,可以让您访问组织的帮助中心。看到HelpCenterProvider在支持SDK Javadocs中。

本节涵盖的主题:

先决条件

  • Ze亚博ndesk管理员已激活Zendesk支持中的帮助中心。看到激活帮助中心在支持帮助中心

  • 知识库中已发表一篇或多篇文章亚博官方app

  • Ze亚博ndesk管理员已启用使指南为您的Android应用程序在Zendesk支持亚博。看到在Zendesk Support中配置SDK亚博在支持帮助中心

  • 你在Android应用中有一个主题,它继承自主题。MaterialComponents.如果从主题。AppCompat的部分UI元素HelpCenterActivity将不正确地显示。看到自定义外观获取更多信息。

用户界面概述

的默认UIHelpCenterActivity如下所示:

帮助中心

若要更改UI的外观,请参见自定义外观.UI不会从基于web的帮助中心版本继承任何样式。

UI被本地化为33种语言,并根据设备区域选择适当的语言。区域设置必须存在于帮助中心和支持帐户本地化设置中。“帮助中心”中的文章必须本地化,才能以其他语言查看。

点击列表中的文章显示文章内容:

演出门票

如果用户在帮助中心找不到答案,他们可以选择点击加号(+)按钮来打开票务表单:

创建机票

若要配置活动的票据表单,请参见配置其他SDK活动的票据表单

如果您不想要,或者您愿意,您可以禁用票据表单添加单独的票据表单

显示帮助中心

使用显示()方法HelpCenterActivity构建器。例子:

             
HelpCenterActivity构建器显示MyActivity

看到显示HelpCenterActivity建设者

请注意:超过一定数量的文章,出于性能原因,SDK开始限制获取和显示的文章数量。如果出现这种情况,建议使用我们提供的类别、部分或标签上的各种过滤器来限制和控制结果的数量。
看到已知的问题

按类别筛选文章

使用withArticlesForCategoryIds ()方法HelpCenterActivity构建器。例子:

             
HelpCenterActivity构建器withArticlesForCategoryIds112233l223344l显示

看到withArticlesForCategoryIdsHelpCenterActivity建设者

按章节过滤文章

使用withArticlesForSectionIds ()方法HelpCenterActivity构建器。例子:

             
HelpCenterActivity构建器withArticlesForSectionIds112233l223344l显示

看到withArticlesForSectionIdsHelpCenterActivity建设者

按标签过滤物品

使用withLabelNames ()方法HelpCenterActivity构建器。例子:

             
HelpCenterActivity构建器withLabelNames“android”“android_o”显示

看到withLabelNamesHelpCenterActivity建设者

展示一篇文章

要打开特定的文章,请获取文章的id,然后启动ViewArticleActivity和它的建造者。

             
ViewArticleActivity构建器123l显示

看到ViewArticleActivity建设者

配置票据表单

对象的票据形式HelpCenterActivity因此,每个新票据都有一个共同的主题、共同的标签或共同的文件附件。您还可以为一个或多个自定义票据字段设置公共值,或者在Zendesk Support中设置自定义票据表单以使用代理接口。亚博

方法配置票据表单配置()方法RequestActivity构建器。看到配置在RequestActivity引用中。的配置()方法返回配置对象。

第二,传递配置对象的显示方法HelpCenterActivity构建器。

例子:

             
配置requestActivityConfigRequestActivity构建器withRequestSubject“Android票”withTags“android”“移动”配置HelpCenterActivity构建器显示MyActivityrequestActivityConfig

看到配置RequestActivity建设者

禁用票据创建

帮助中心有浮动的操作按钮,用户可以点击这些按钮打开一个UI来创建票据。默认情况下,该按钮在“帮助中心”文章列表视图和文章视图中都可见。您可以将按钮隐藏在一个或两个地方。

在文章列表视图中禁用票据创建

使用withContactUsButtonVisible ()withShowConversationsMenuButtonEnabled ()方法HelpCenterActivity构建器。例子:

             
HelpCenterActivity构建器withContactUsButtonVisiblewithShowConversationsMenuButton显示

看到withContactUsButtonVisibleHelpCenterActivity建设者

在项目视图中禁用票据创建

创建一个配置对象,然后将其传递给HelpCenterActivity

             
配置articleConfigViewArticleActivity构建器withContactUsButtonVisible配置HelpCenterActivity构建器显示articleConfig

看到withContactUsButtonVisible而且配置ViewArticleActivity建设者

在这两个视图中禁用票据创建

结合withContactUsButtonVisible ()方法。配置对象的ViewArticleActivity

             
配置articleConfigViewArticleActivity构建器withContactUsButtonVisible配置HelpCenterActivity构建器withContactUsButtonVisible显示articleConfig

看到withContactUsButtonVisible而且配置ViewArticleActivity建设者

禁用文章投票

支持SDK中的帮助中心文章投票功能可以由Zendesk管理员在Zendesk支持中启用和禁用。亚博默认启用。看到在Zendesk Support中配置SDK亚博在支持帮助中心。

本条表决完全独立于决议和否决回答机器人,不影响答题机器人的使用。

使用支持SDK与回答机器人SDK

回答机器人Zen亚博desk提供了一种强大的机制,可以在门票到达代理商之前转移门票。回答机器人的移动SDK目前处于早期访问计划中。

如果你有回答机器人1.0.0和支持SDK 2.3.0(或以上版本)在你的应用程序中,那么默认情况下的联系按钮HelpCenterActivity而且ViewArticleActivity打开回答机器人。您可以在这两个活动中禁用此行为,并直接引导用户创建票据。

禁用帮助中心文章列表视图中回答机器人的偏转:

             
HelpCenterActivity构建器withDeflectionEnabled配置

在“帮助中心”文章视图中禁用:

             
ViewArticleActivity构建器withDeflectionEnabled配置

如果您希望在两个屏幕中都禁用它,请在启动SDK时提供两个配置。

重写设备区域设置

如果您想手动指定获取“帮助中心”内容时使用的语言,您可以这样做:

             
支持实例setHelpCenterLocaleOverride语言环境

这适用于使用UI和提供者获取的所有Help Center内容,这意味着只从该区域获取文章、部分和类别。这不会更新移动UI元素。重写会忽略Zendesk Guide管理控制台中配置的设备区域和语言。亚博使用不受支持的对象重写语言环境或者该地区没有内容会导致“无法连接”的横幅。