store.store_webhooks 中的一条独立记录,拥有各自的 URL、订阅事件列表,以及 test/prod 环境绑定。
通道
URL 域名
无论何种通道,系统均接受任意 HTTPS URL。商户需自行确保 URL 与所选通道的目标平台匹配 —— 如果在channel: "slack" 下配置了 Discord URL,调度器会按 Slack attachments 格式编码载荷并发送给 Discord 端点,Discord 端会返回错误,并将该次失败记录在 webhook_deliveries 中。
同 URL 多 webhook
同一门店内允许将同一 URL 配置在多个 Webhook 下 —— Webhook 采用扇出模型,不同事件订阅、不同通道或不同testMode 可共用一个 URL。每个 Webhook 独立投递,因此当多个 Webhook 投递到同一 URL 时,消费方需按 (eventType, eventId) 去重。
限制
每个门店在所有通道下最多可配置 20 个 Webhook。超出上限会返回 400。列出 Webhook
不存在list-webhooks 端点 —— 查询已配置的 Webhook 列表通过 GraphQL Store.storeWebhooks(按 test_mode 自动过滤环境):
端点
新增 Webhook
为门店配置新的 Webhook 端点。
更新 Webhook
修改 Webhook 的 URL、事件列表或 secret。
移除 Webhook
硬删除 Webhook(保留历史记录)。