Webhook 是从 Zendesk 管理中心的 Webhook 页面 创建 和管理的。
您必须是管理员或具有权限的 自定义用户角色 的专员才能管理 Webhook。
编辑和管理 Webhook
在大多数情况下,管理员可以编辑、复制、取消激活和删除 Webhook。但是,根据应用要求创建的 Webhook 只能编辑,不能复制或删除。根据应用要求创建的 Webhook 可由应用开发者更新,并覆盖帐户管理员所做的更改。Webhook 创建后,您无法更改其连接方法。
编辑 Webhook 的步骤
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 操作和 Webhook > Webhook。
- 在列表中找到该 Webhook,单击选项菜单图标 ()在 Webhook 的行上,然后单击 编辑。
- 根据需要修改 Webhook。
所有字段都可以编辑。但是,使用身份验证时, 密钥、密钥或 密码 在创建或更新 Webhook后无法查看。要移除自定义标头,单击删除图标 ()。
- (可选) 测试 您对 Webhook 所做的更改。
- 单击保存。
复制 Webhook 的步骤
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 操作和 Webhook > Webhook。
- 在列表中找到该 Webhook,单击选项菜单图标 ()在 Webhook 的行上,然后单击 复制。
- 编辑 Webhook 的 名称 ,并根据需要修改 Webhook。
- 单击更新。
取消激活 Webhook 的步骤
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 操作和 Webhook > Webhook。
- 在列表中找到该 Webhook,单击选项菜单图标 (),然后单击 取消激活。
- 在确认对话框中,单击 取消激活。
删除 Webhook 的步骤
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 操作和 Webhook > Webhook。
- 在列表中找到该 Webhook,单击选项菜单图标 ()在 Webhook 的行上,然后单击 删除。
- 单击删除。
查看 Webhook 的活动
每个 Webhook 都有一个活动日志。除了详细的调用记录之外,您还可以查看最近 7 天内的请求数。
如果端点返回某些 HTTP 响应代码,Webhook 调用会自动重试最多 3 次。有关重试场景的更多信息和示例,请参阅我们开发者文档中的 Webhook 重试逻辑 。
Zendesk 会尽力将操作单次发送到 Webhook。但我们无法保证这一点。同一操作可能多次调用 Webhook,或者在某些情况下(例如已触发 Webhook 断路器 ),可能根本无法发送操作。要检测重复调用,您可以使用 Webhook 签名。如果这对您的工作流程产生问题,请确保您的 Webhook 生成的操作是幂等的。
- 在 管理中心,单击 侧栏中的 应用和整合 ,然后选择 操作和 Webhook > Webhook。
- 在列表中找到该 Webhook,单击选项菜单图标 () 在 Webhook 的行,然后单击 查看详情。
- 单击活动标签。
- 单击 筛选 以按开始日期、开始时间、结束日期、结束时间或状态筛选活动日志,然后单击 应用筛选。
调试 Webhook
如果 Webhook 工作不正常,失败的调用将显示在 Webhook 的活动日志中。您可以按 失败 状态或特定错误类型筛选活动日志。在活动标签中,您还可以单击调用 ID,以查看 Webhook 特定调用的请求和响应。
在大多数情况下,响应来自接收 Webhook 请求的第三方服务,而不是 Zendesk 本身。通常需要使用此服务来修复错误。
您可以使用回复状态中的数字代码来诊断问题。这些响应状态代码是 HTTP 请求的标准响应状态代码。有关标准 HTTP 响应状态代码及其含义的列表,请参阅 MDN 网络文档中的 HTTP 响应状态代码 。
Webhook 请求有 10 秒钟的超时。A“失败:504 网关超时”响应状态表示服务在此超时期限内未响应 Webhook 的请求。超时时长不可调整。
翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性
如对翻译准确性有任何疑问,请以文章的英语版本为准。