如何设置 Webhook

Webhook 会在选定的 TicketingHub 事件发生时，将这些事件发送到其他系统。

开始前

• 您的 TicketingHub 账户必须已启用 Webhook。如果缺少 Webhook 部分，请联系 TicketingHub。
• 您需要管理员或经理权限。
• 接收系统必须提供公开的 HTTPS URL。

添加 Webhook

1. 前往 设置 → 高级。
2. 找到 Webhook，然后选择 编辑。
3. 选择 新建 Webhook。
4. 输入用于接收事件的 HTTPS URL。
5. 选择要发送的事件类型，例如已确认或已取消的预订。
6. 可选：输入一个强密钥，以便接收系统验证每个请求。
7. 创建 Webhook，然后执行所选事件中的一个以进行测试。

如果您添加了密钥，TicketingHub 会对每个请求进行签名，并将签名发送到 X-TicketingHub-Signature-256 标头中。您的开发人员应在接受数据之前验证此签名。

保持 Webhook 处于启用状态

接收系统应及时返回成功的 2xx 状态。对于超时或返回失败响应的传送，TicketingHub 会重试。如果端点持续失败，系统会自动将其停用；请修复接收系统，然后返回 Webhook 页面并重新启用该端点。

TicketingHub 只会向公开地址发送事件。如果 URL 指向私有网络地址（例如您自己网络中的服务器），TicketingHub 不会发送事件，并会立即停用 Webhook。Webhook 页面会显示“URL 指向私有网络地址”，您的账户管理员也会收到电子邮件。请将 URL 更改为公开的 HTTPS 地址，然后重新启用 Webhook。

请仅选择所需的事件，并避免在正式账户中使用测试 URL。若要在不自行构建接收端的情况下将事件发送到 Zapier，请参阅如何将 TicketingHub 连接到 Zapier。若要构建还需要从 TicketingHub 请求数据的集成，请参阅如何创建和使用 API 令牌。