网络钩子

查看 Webhook 接收地址和投递活动，或在提供方门户未就绪时恢复操作。

网络钩子让另一项服务接收来自 Runner 项目的选定事件。这是一项高级的、安全敏感的功能：仅在您知道哪项服务应接收事件以及该服务如何验证事件时才使用它。

入口路径

当 Runner 为工作区开放此入口时，打开搭建 → Webhooks。如果没有入口，请勿猜测 URL；请参阅功能可用性，或向支持团队确认功能是否已启用。

开始前

• 仅当 Runner 或支持公开批准的入口时才使用网络钩子。
• 了解预期的接收服务及其如何验证事件。
• 将端点地址、签名密钥和交付的数据视为敏感信息。

Runner 显示的内容

您的工作区可能显示 Runner 的 Webhook 工作台，也可能嵌入提供方门户。请按照与屏幕一致的部分操作。

查看 Runner 工作台

有条件可用：启用原生工作台后，使用以下标签页：

1. 打开端点，找到要查看的接收地址。
2. 阅读目录，检查相关事件类型。
3. 打开日志，查看该接收地址的一次可用投递记录。
4. 将其状态与接收服务自身的记录核对后，再判断投递是否成功。

检查点：保存端点只能确认配置已保存；成功投递记录与接收方匹配的记录，才能确认该次事件投递。空日志不证明投递正常。测试、重发和重放操作会发送事件，请仅在确实需要测试时使用。

嵌入式提供方门户

Runner 在显示嵌入式管理门户之前准备网络钩子服务。

从长时间初始化中恢复

1. 等待初始化消息完成。
2. 如果出现初始化耗时比预期长，请选择重试一次。
3. 等待嵌入式门户替换初始化屏幕。
4. 如果再次出现错误，请保存项目名称和确切消息，然后联系支持，而不是重复重试。

在需要时重新连接 Shopify

1. 阅读重新连接您的 Shopify 商店通知。
2. 选择重新连接 Shopify。
3. 在 Shopify 集成页面上完成连接流程。
4. 返回网络钩子并确认重新连接通知已消失，然后再依赖事件交付。

重新连接会更改商店的集成授权。只有被允许管理该商店连接的人员才应继续。

安全说明

• 将端点地址、签名密钥和事件内容视为敏感信息。
• 仅当其所有者提供了正确的安全地址时，才添加或更改目标。
• 查看嵌入式门户内显示的每个确认；其操作可能会影响未来的交付。
• 如果签名值被泄露，请在发送更多事件之前在 Runner 的网络钩子服务和接收系统中替换它。

故障排除

相关指南

• 功能可用性
• 安全和会话
• 应用故障排除
• 支持和社区