人则是创建并通过Webhooks页面在Z亚博endesk管理中心进行管理。
您必须是一个管理员或代理自定义角色具有管理webhook的权限。
编辑和管理webhook
在大多数情况下,管理员可以编辑、克隆、停用和删除webhook。然而,由应用程序需求创建的webhook可以被编辑,但不能被克隆或删除。由应用需求创建的webhook可以由应用开发人员更新,并覆盖账户管理员所做的更改。创建webhook后,您不能更改其连接方法。
编辑webhook
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择Webhooks > Webhooks。
- 在列表中找到该网络钩子,单击选项菜单图标(),然后单击编辑。
- 根据需要修改webhook。
所有字段都可以编辑。但是,在使用身份验证时关键,令牌,或密码在创建或更新webhook后无法查看。若要删除自定义标题,请单击删除图标()。
- (可选)测试您对webhook所做的更改。
- 点击保存。
克隆一个webhook
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择Webhooks > Webhooks。
- 在列表中找到该网络钩子,单击选项菜单图标(),然后单击克隆。
- 编辑网络钩子名字并根据需要修改webhook。
- 点击更新。
停用一个webhook
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择Webhooks > Webhooks。
- 在列表中找到该网络钩子,单击选项菜单图标(),然后单击禁用。
- 在确认对话框中单击禁用。
删除webhook
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择Webhooks > Webhooks。
- 在列表中找到该网络钩子,单击选项菜单图标(),然后单击删除。
- 点击删除。
查看webhook的活动
每个webhook都有一个活动日志。除了详细的调用记录外,您还可以查看过去7天内的请求数量。
如果端点返回某些HTTP响应代码,webhook调用将自动重试三次。有关重试方案的详细信息和示例,请参见Webhook重试逻辑在我们的开发人员文档中。
亚博Zendesk尽了最大的努力,一次只向webhook交付操作。但是,我们不能保证。一个webhook可以被同一个动作多次调用。要检测重复调用,可以使用webhook签名。如果这对你的工作流程有问题,确保由你的webhook产生的动作是幂等的。
- 在管理中心,点击应用程序和集成在侧边栏中,然后选择Webhooks > Webhooks。
- 在列表中找到该网络钩子,单击选项菜单图标(),然后单击查看详细信息。
- 单击活动选项卡。
- 点击过滤器按开始日期、开始时间、结束日期、结束时间或状态筛选活动日志,然后单击应用过滤器。
调试webhook
如果一个webhook不能正常工作,失败的调用将在Webhook的活动日志。您可以通过状态来过滤活动日志失败的或者是特定类型的错误。在Activity选项卡中,您还可以单击调用ID来查看webhook特定调用的请求和响应。
在大多数情况下,响应来自接收webhook请求的第三方服务,而不是Zendesk本身。亚博通常需要使用此服务来修复错误。
您可以使用响应状态中的数字代码来诊断问题。这些响应状态码是跨HTTP请求的标准。有关标准HTTP响应状态码的列表及其含义,请参见HTTP响应状态码在MDN网络文档。
Webhook请求有10秒超时。“Failed: 504 Gateway Timeout”响应状态表示服务在此超时时间内没有响应webhook的请求。超时时间不可调整。
23日评论
是否可以通过API管理/创建webhook ?
嗨,克里斯。是的,这是可能的。这里有一个链接webhook API参考文档和Webhook开发人员教程。
可以在这些网络钩子中访问书签资源吗?亚博电脑端
嗨,David,书签可以通过API创建,删除或列出:API -书签
网上提供的文件说明:
你能解释一下如何将URL参数传递给任何URL吗?据我所知,只有webhook的主体可以定制。
嗨@……,
你可以把查询参数在URL中定义webhook。这些查询参数还可以包含亚博Zendesk触发占位符动态填充信息。
希望这能帮到你,
克里斯
你好,
是否有可能在webhook返回失败响应状态时收到警报?可能的选项-将失败的有效负载转发到另一个webhook,通过一些api GET请求或通过任何其他自动化过程检索webhook的最后X个失败数?
提前感谢!
嗨尼古拉斯•西蒙斯!
就像目标一样,webhook对单个失败没有通知;因为没有停用,所以没有额外的通知。要查看类似的内容,您需要查看API以检查最近的请求和类似的失败。与往常一样,请随时添加任何其他问题,评论或关注;我们总是很乐意帮忙。请随时创建一个反馈帖子在反馈-管理中心。这样,其他寻找此功能的最终用户也可以加入对话并分享他们的用例。
我想确认一下……如果用户a创建了一个网络钩子,然后用户a不再是Zendesk中的代理,那么他们创建的网络钩子是否仍然存在?亚博
嗨伊丽莎白的玩具,
这是正确的。无论创建管理员的状态如何,webhook都将保持活动状态。
克里斯
你好,
我如何通过一个“HEADER”参数到我的端点使用webhook?
我发布的API (PUT)要求我通过HEADER传递一些参数,而不是在JSON体中。
嗨,卡洛斯,
目前,Webhook不支持自定义标头。因为我们不知道远程端点,我们没有办法知道它需要什么,需要什么语法,格式,我们根本没有可见性。
我们所能建议的是你向https://hookbin.com/查看负载、呼叫头和信息是否在公共端点而不是受限制端点中被良好接收。
你好,
有没有办法通过webhook发送新的票务评论。
目前我必须获得票证id,然后调用get api来获得评论,如果评论可以直接发送,我可以避免这2步的过程
你好年代Shatheesh!
我已代表您提交了一份票,供我们的支持团队进一步调查。你应该很快就会收到一封邮件。
你好,
我使用触发器来调用WebHook。
如何从(另一个)触发器访问请求响应值?我需要的是从响应负载(json格式),并在后续触发器中使用它。
您可以在触发器的实际JSON主体中找到它。
嗨丹麦人,
我的理解是,触发器的实际JSON体(屏幕截图中的那个)不是响应有效载荷,而是请求有效载荷。
例如,我定义了一个由触发器调用的webhook (GET方法)。返回一个HTTP 200响应,包括它的有效负载:我如何通过触发器/自动化访问它?
谢谢你的澄清。
亚博Zendesk没有办法在票证、触发器或自动化上显示实际的响应有效载荷。
然而,你可以通过直接转到你创建的webhook并在Actions中选择Test webhook来提取实际的JSON响应。此方法将要求您指定所使用的端点的值。
嗨!我错误地删除了一个webhook。我有什么办法可以恢复它吗?
我们没有允许您恢复已删除的webhook的功能。
嗨,支持,
有什么时间表吗?查看webhook的活动(测试版),是否会从测试版转到稳定版/功能版?
我没有得到一个组织的自定义文件填写的网络。
只填充标准字段。
json包括:
"组织":{
“custom_fields”:(
{
“关键”:107953418 xxxxxx,
“价值”:“你好”
}
]
}
}
很抱歉,因为您无法在Webhook中获得组织自定义字段。
我希望得到更多的用例来帮助您。我将继续为您创建一个单独的票,这样我就可以获得更多特定于帐户的详细信息来解决此问题。您可能很快就会收到关于机票信息的电子邮件。
谢谢你!
请登录留下评论。