如果Zendesk support提供的支亚博持对你的用例来说不够及时,你也可以编写代码,直接调用Zendesk API来将内容推送给Zendesk support。支持推比支持拉要费力得多,所以只有在确定需要时才应该尝试。

推的元素

通过向Zendesk API推送端亚博点发出POST请求,可以将数据推送到Zendesk Support。POST请求必须通过Channel框架生成的OAuth令牌进行身份验证。在Channel框架为您生成令牌之前,您必须向Zendesk Supp亚博ort注册一个客户端ID。

使用push:

  1. 创建一个新的全局OAuth客户端如下面所述,或使用已存在的客户机。
  2. 设置push_client_id的价值清单将您的服务转换为全局客户机的唯一标识符。
  3. 当管理员使用您的UI创建一个新的集成帐户时,记录子域和访问令牌传递给你的服务
  4. 方法调用子域和访问令牌推动端点是合适的。

创建全局OAuth客户端

  1. 在Zendesk Support中创建或获取OAuth客户端,如亚博对应用程序使用OAuth身份验证
    • 描述不能为空
    • 记录唯一标识符和秘密
  2. 中所描述的完成请求表单,将OAuth客户端提升为“全局”客户端设置一个全局OAuth客户端

获取访问令牌

当Zendes亚博k支持管理员设置或编辑集成帐户时,Zendesk支持将调用您的管理界面.如果你的清单包括一个push_client_id入口,Zend亚博esk支持将生成一个访问令牌,并将其传递给您的接口。具体来说,以下数据将被post到您的服务:

Post字段名 类型 评论
子域名 字符串 Zendesk支持帐户的子域,该帐户正在使亚博用您的服务设置帐户
instance_push_id 字符串 正在设置的帐户的ID。调用推动端点
亚博zendesk_access_token 字符串 调用时使用的OAuth令牌推动端点.此令牌不能与其他端点一起使用,而其他令牌也不能用于访问推送端点

注意,此信息仅对您的管理界面可用。您应该以安全的方式记录此信息,以供后续使用。

调用push端点

获得子域、实例推送id和访问令牌之后,就可以调用推动端点同步推送集成内容到Zendesk支持。亚博

无效的请求

方法验证JSON通道框架模式.发送错误类型的JSON值将导致400个Bad Request响应。

             
POST / api / v2 / any_channel /推动。json HTTP /1.1宿主sample.亚博zendesk.com内容类型application / jsonHTTP /1.1400坏的请求“错误”“消息”//bundle/gems/any_channel_亚博电脑端json_schemas-0.4.0/json_schemas/external_resource.json#中'#/external_resources/0'属性不包含' external__id '的必需属性