创建Zendesk支持渠道集成时,还亚博创建了一个亚博Zendesk应用管理员使用它来发现和安装集成。Zende亚博sk应用程序可能没有任何代理可见的用户界面。然而,你可以选择通过在应用程序中添加功能来增强代理的能力。例如,如果你集成了Instagram,你可能想要显示一个心形图标,表明Instagram用户是否“喜欢”了照片。当代理点击心形图标时,您的集成作为与该帐户关联的Instagram用户“喜欢”这张照片。

Zend亚博esk应用程序不能直接调用集成服务或原始服务,但它可以使用Zendesk作为代理来代表它调用集成服务。

代理做什么,为谁服务?

这有点令人困惑,因为有许多感兴趣的方,包括:

  1. Zend亚博esk支持代理,可能有也可能没有Instagram账户

  2. Zend亚博esk支持管理员,在他们的Zendesk支持帐户中设置了Instagram集成

  3. Zendesk支持管理员识别的Instagram用户。亚博这通常是一个企业账户,比如Omniwear Instagram账户。

  4. Instagram集成,作为特定用户连接到Instagram API(例如作为Omniwear Instagram帐户)

当Zendesk支亚博持代理点击Zendesk应用程序中的“喜欢”按钮时,他们并不表示他们个人喜欢这张照片。相反,他们表示这张照片应该被他们的Zendesk支持帐户的整合“喜欢”。亚博例如,Omniwear的Instagram账号应该是那个点赞的人。

Zendesk应用程序如何实亚博现这个“喜欢”按钮呢?它不知道应该使用哪个Instagram账户,当然也没有身份验证信息,比如用户名或密码。

该应用程序不能直接调用Instagram。它甚至不能直接调用集成服务,因为它没有身份验证信息。但是,它可以调用Zendesk,后者可以代亚博表它调用集成服务。

代表代理的应用程序调用Zendesk。亚博亚博然后Zendesk调用集成服务,传递由Zendesk Support管理员设置的身份验证信息。集成服务使用Zendesk提供的身份验证信息连接到Instagram API并执行适当的“喜欢”操作。亚博

当然,设置数据并不是唯一的问题。应用程序还想知道“喜欢”按钮应该处于“当前喜欢”状态,还是处于“当前不喜欢”状态。应用程序需要从Instagram获取这些信息。这也需要身份验证——本质上与设置“喜欢”状态相同。

将数据发布到Zendesk用于集亚博成服务

亚博Zendesk允许应用程序POST JSON到/api/v2/any_channel/proxy。json端点。当调用端点时,应用程序将在查询字符串参数中提供票据ID和所需的端点。post的主体应该是传递给集成服务的JSON,可以为空。查询字符串参数为:

参数 类型 最大字符 评论
ticket_id 字符串 应用程序向代理显示的Zend亚博esk票据的ID
post_to_path 字符串 511 应用程序希望POST到的集成服务中的URL。如果是相对的,则解释为相对于清单URL。必须是与清单托管在同一域中的HTTPS URL。

例子:

             
旋度- x“职位”“https://{子域名}.zendes亚博k.com/api/v2/any_channel/proxy.json ? ticket_id = 62 &post_to_path = /like '- h“application / json内容类型:- h接受:application / json的- d $”{“喜欢”:“真正的”} '

Zende亚博sk传递给集成服务的东西

当应用程序将数据提交到Zendesk中的代理端点时,Zendesk将数据传递给集成服务。亚博它用来自集成实例的元数据补充该数据。亚博Zendesk将以下参数post到post_to_path在集成服务中:

参数 类型 评论
instance_metadata 字符串 来自与票据ID关联的集成实例的元数据传递给代理端点
client_data 字符串 从应用程序到Zendesk代理端点的原始POST的JSON体亚博

来自集成服务的任何JSON响应都被传递回调用方。