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