亚博Zendesk提供了多种类型的本地数据对象,用于存储和管理客户数据,包括票据、用户、组织等。但是,它不能提供组织可能需要的所有可能类型的数据对象。例如,您可能希望将每个新票据与目录中的产品相关联,以便更好地了解客户在使用不同产品时的体验。遗留自定义对象允许您在Zendesk中为新对象类型创建蓝图,然后根据蓝图创建对象记录。亚博
本文包含以下部分:
关于遗留自定义对象
遗留自定义对象可以是任何东西,包括产品、服务契约或客户访问。您可以在Zendesk管理中心或使用亚博API,然后使用您的遗留自定义对象来定制Zendesk帐户,以满足您的业务需求。亚博您可以通过指定应用于每个对象的权限来控制对遗留自定义对象的访问。
本指南向您展示如何在管理中心中定义遗留自定义对象。它以度假租赁业务为例。客户可以通过打电话或与业务支持团队聊天来报告租赁物业的问题,该团队会为他们创建罚单。该企业希望将每张机票与支持中的租赁物业相关联,以帮助代理商提供更好的客户服务。企业还希望使用这些信息来更好地了解每个地点的客户体验,以计划物业改进。
下面的视频提供了管理中心的传统自定义对象的概述,但请注意,界面现在有了新的外观:
传统自定义对象增强(6:02)
启用遗留自定义对象
定义遗留自定义对象类型
对于度假租赁业务,您希望每个租赁属性都由Zendesk中的一个遗留自定义对象记录表示。亚博如果该公司购买了另一处度假房产,您只需添加一个对象记录来表示它。
出租物业共有某些属性。例如,每个房产都有地址、周租、卧室数量等等。属性值因出租物业而异。一个可能是里斯本的一套两居室公寓,每周600美元,另一个可能是阿斯彭的一套三居室公寓,每周1100美元。
类似地,相同类型(如“出租房产”类型)的Sunshine自定义对象都共享相同的属性。遗留自定义对象的属性定义在名为对象类型。
在技术层面上,对象类型由关键和一个模式描述属性。键是要用于标识对象类型的名称。创建对象类型时,在对象名称字段中输入密钥。例如:“rental_property”。
您可以为出租物业定义各种属性。为了保持示例简单,你决定为一个新的自定义对象使用以下属性,键名为“rental_property”:
名字 | 类型 | 要求 | 评论 |
---|---|---|---|
id | 字符串 | 是的 | 由企业分配给出租物业的唯一标识符 |
卧室 | 数量 | 没有 | 卧室数量 |
地址 | 字符串 | 没有 | 出租物业的街道地址 |
国家 | 字符串 | 没有 | 出租物业所在的国家 |
cleaning_service | 字符串 | 没有 | 本地清洁服务 |
cleaning_service_phone | 字符串 | 没有 | 本地清洁服务的电话号码 |
pets_allowed | 布尔 | 是的 | 是否允许宠物进入 |
这就是你的图式。请注意,该模式不包含关于任何特定出租财产的任何信息。它只是描述了这个信息。要了解更多信息,请参见为遗留自定义对象创建模式。
创建遗留自定义对象类型
- 在管理中心,点击对象和规则在侧栏中,然后选择自定义对象>遗留对象。
- 点击添加对象。
- 为对象名称,输入对象的键为“rental_property”。
您的密钥必须符合以下要求:
- 是独一无二的
- 只包含字母数字字符(a-z, 0-9),下划线(_)和破折号(-)
- 最少2个字符,最多32个字符
- 点击添加属性定义一个新属性。
- 在右侧面板的“添加属性”表单中输入以下值:
- 名字- - - - - - id
- 类型——字符串
- 描述-由公司分配给出租物业的唯一标识符
- 要求- - -检查
- 点击添加属性如果您想继续构建模式。
- 在Add属性表单中输入第二个属性的值。
- 继续点击添加属性向模式表中添加其他属性。
- 点击保存。
重新打开后,遗留对象类型应该如下所示:
保存对象后,可以设置基于角色的访问权限,以定义代理和最终用户对对象或关系记录的权限。看到设置对象的角色和权限。
添加遗留对象记录
在Admin Center中创建租赁属性对象类型后,组织中的开发人员可以使用Sunshine API来创建一个遗留的自定义对象记录为每个企业的出租物业。他们还可以使用API读取、更新和删除记录。遗留对象记录只不过是具有已定义属性的数据库记录。
开发人员在API请求中用于创建租赁属性记录的数据由您定义的对象类型定义,对于“rental_property”类型,该类型由名为“id”、“卧室”、“地址”、“国家”、“cleaning_service”和“cleaning_service_phone”的属性组成。例子:
{"data": {"type": "rental_property", "attributes": {"id": "fr-021", "bedroom ": 2间,"address": "11 rue Laurier, Saint-Tropez", "country": "France" "cleaning_service": "tropez-nettoyage" "cleaning_service_phone": "011.33.06.55.47.54.74 "}}}
如果您希望以后检索这些记录,开发人员可以使用几个不同的端点来检索它们。看到遗留对象记录在API文档中。
如果企业对出租物业进行更改,例如雇用新的清洁服务,开发商可以使用更新遗留对象记录端点更新该出租属性的对象记录。
如果企业出售出租物业,开发商可以使用删除遗留对象记录端点。
如果企业购买了另一个出租物业,开发商可以使用创建遗留对象记录端点。
使用遗留自定义对象对数据进行建模
为了以更有意义的方式使用租赁属性数据,您可以在Zendesk中的“rental_property”类型和其他对象类型之间建立关系。亚博例如,关于特定出租物业的信息对物业经理来说并不是很有用,除非它与客人提交的有关该物业的门票相关联。注意,票据只是Zendesk中的另一种对象类型。亚博
自定义对象支持对象类型之间的几种关系:
一对一的-两种对象类型在关系的任何一方都只能有一条记录。例如,一张票只与一个出租物业相关联,而一个出租物业也只与一张票相关联。在度假租赁的例子中,这不是一个可行的选择。一个出租物业可以有多个与之相关的票据。
一对多—第一种对象类型中的每个对象都不关联第二种对象类型中的任何一个或多个对象。例如,一个出租物业可以与一个、一个或多个票据相关联。
多对多—第一种对象类型中的每个对象都不关联第二种对象类型中的一个或多个对象,第二种对象类型中的每个对象都不关联第一种对象类型中的一个或多个对象。使用两个一对多关系类型定义多对多关系类型。
关系可以是:
- 两种遗留的自定义对象类型(例如,在“rental_property”和“guest_contract”对象类型之间)
- 一个遗留的自定义对象类型和以下任何Zendesk对象类型:门票、用户、文章、组织、组或聊天亚博
- 两种标准Zendesk对象亚博类型
定义遗留关系类型
就像对象类型是创建对象记录的蓝图一样,关系类型是在两个特定对象类型之间创建关系记录的蓝图。对于度假租赁示例,您希望在自定义的“rental_property”对象类型和标准的Zendesk ticket对象类型之间定义一个“租赁属性有许多票”关系类型。亚博
如果您使用Zendes亚博k Sell,您还可以在Zendesk Sell对象之间创建关系,如潜在客户、交易或联系人。
定义关系类型并不会在两个特定记录之间创建关联。它只是描述了这种关系。在定义关系类型之后,您可以创建一个关系记录,该记录将特定的票据与特定的租赁属性关联起来。随着这些关系记录的积累,每个记录都将一张票据关联到一个出租物业,您将开始更清楚地了解每个出租物业的问题。Sunshine可以根据您定义的关系类型将门票按租赁物业分组:一个租赁物业有许多门票。
创建遗留关系类型
- 在管理中心,点击对象和规则在侧栏中,然后选择自定义对象>关系。
- 点击添加关系类型。
- 为关系名称,输入“rental_prop_has_many_tickets”。
您的密钥必须符合以下要求:
- 是独一无二的
- 只包含字母数字字符(a-z, 0-9),下划线(_)和破折号(-)
- 最少2个字符,最多32个字符
- 在菜单中选择以下值:
- 源——rental_property
- 类型- 1:许多
- 目标——禅:机票
页面应该如下所示:
- 点击保存。
关联遗留自定义对象的相关记录
一旦定义了关系类型,就可以开始基于关系类型关联相关记录。
对象将一种对象类型的记录与另一种对象类型的记录关联起来关系的记录(不要与恋爱类型混淆)。对于度假租赁业务,您可以在特定的机票和特定的租赁物业之间创建关系记录。
关系记录由两个相关对象记录的id及其关系类型组成。关系记录不包含任何关于租房人的问题或出租财产的实际信息。它只包含了票据记录的id和租赁物业记录的id。Sunshine使用这些id检索相关记录。
关系记录由您创建的关系类型管理——名为“rental_property_has_many_tickets”的一对多类型,其中每个票据只能与一个租赁属性相关联,但每个租赁属性可以与许多票据相关联。
要创建关系记录,团队中的开发人员可以向创建关系记录端点。开发人员在请求中包含的JSON对象必须指定关系类型以及“源”和“目标”对象的id。例子:
{"data": {"relationship_type": "rental_property_has_many_tickets", "source": "1c771ee0-2c3f-11e7-bf60-e5c3f630b5aa", "target": "zen:ticket:35437746"}}
检索相关记录
团队中的开发人员可以使用按对象记录列出关系记录端点检索关系记录。例如,开发商可以通过记录id“5d0daa84-aec0-11e7-9a70-416881d66b6d”获得租赁物业的所有相关门票。
示例响应:
{"data": [{"id": " c547730 -2e98-11e7-acd9-9dbd5d6450d8", "target": "zen:ticket:35438118", "ref": "/api/v2/tickets/35438118"}, {"id": "5d3484b5-aec6-11e7-9a70-a12d6a7d800c", "target": "zen:ticket:35437746", "ref": "/api/v2/tickets/35437746"}], "links": {"previous":null, "next":null}}
在本例中,出租物业有两张与之关联的票,35438118和35437746。您可以使用这些信息查看门票。
把它们放在一起
您可以使用自定义对象和关系记录来解决实际问题,改进现有流程,或者仅仅是更好地了解您的客户。例如,您团队中的开发人员可以使用您的租赁物业自定义对象构建Zendesk应用程序,该应用程序向处理票据的代理显示有关租赁物业的详细信息。亚博
该应用程序还可以创建一个关系记录在机票和出租物业之间,代理更改机票的状态新来开放。然后,您可以使用Sunshine API生成列出每个出租物业的所有票据的报告,并使用这些信息来计划物业改进。
设置遗留对象的角色和权限
在创建遗留自定义对象时,一旦保存了对象模式,就可以设置权限。一旦保存了对象模式,就可以在permissions选项卡中看到一组默认权限。遗留对象的默认权限为代理提供完全权限(创建、读取、更新或删除),而不为最终用户提供权限。
为遗留自定义对象设置角色和权限
- 在管理中心,点击对象和规则在侧栏中,然后选择自定义对象>遗留对象。
- 点击添加对象类型或选择要编辑的现有对象。
- 单击权限选项卡。
- 选择代理或最终用户角色来定义权限。
- 在代理或最终用户面板中,选择要为代理或最终用户启用的权限。
选项包括:创建、读取、更新和删除。
- 点击保存。
您将收到一条消息,表明遗留对象已保存,并且可以在表中看到更新后的权限。
删除自定义对象类型和关系类型
在“管理中心”中可以删除自定义对象类型或关系类型,但不能删除自定义对象记录或关系记录。介绍在Admin Center中删除自定义对象类型或关系类型的操作步骤。如果对象类型/关系已经存在关联关系或记录,则不能删除该对象类型/关系。来删除自定义对象记录或者一个删除关系记录,使用Sunshine API。
删除一个自定义对象类型
- 在管理中心,点击对象和规则在侧栏中,然后选择自定义对象>对象。
- 将鼠标悬停在要删除的自定义对象类型上,然后单击该类型旁边的垃圾桶图标。
- 当出现确认消息时,单击删除确认删除。
删除关系类型
- 在管理中心,点击对象和规则在侧栏中,然后选择自定义对象>关系。
- 将鼠标悬停在要删除的关系类型上,然后单击该类型旁边的垃圾桶图标。
- 当出现确认消息时,单击删除确认删除。
9日评论
我在哪里找到安装自定义对象应用程序的说明??
这个链接对我没用:https://support.亚博zendesk.com/hc/en-us/community/posts/4409216975130。我得到一个“未授权查看此页面??”
我和我们的总理聊了聊,看起来他们现在不再接受EAP注册了。他们目前正在整体上改进自定义对象,这将消除应用程序的需要,所以请继续关注更多可用的信息。
我还建议大家遵循我们的公告页上保持最新的产品发布。
希望这能有所帮助!
你好,
是否有可能使用API POST记录到许多对象?
我可以成功地使用API针对单个对象创建记录,但还不能“批量”加载记录。
多谢。
可以通过创建对象记录来创建一批对象记录自定义对象作业。成功的Jobs API请求将创建请求中提供的对象记录的异步作业排队。
谢谢克里斯托弗•肯尼迪-我一定是忽略了这个功能。这将节省我很多时间。感谢反馈。
是否可以从自定义对象中删除属性?如果你不小心命名一个不正确,有没有办法摆脱它没有重新创建整个自定义对象?我只看到这些选项:
嗨,是否有可能定义一个只允许唯一值的属性,就像一个关系型数据库表上的主键一样。
事实证明,这个特性还不受支持。详情请参阅对象类型架构更新规则。
请登录留下评论。