TRANXACT.AI 帮助

签署 webhook 交付

所有出站 webhook 请求均使用 HMAC-SHA256 进行签名。未设置密钥的 webhook 会被分配一个密钥,该密钥会显示一次;未设置密钥的 webhook 会显示为“未签名 - 未设置密钥”,并且在设置密钥之前不会发送其请求。

  • 平台 › 事件和 Webhook › Webhook › 新增:对于未设置签名密钥而保存的 Webhook(或再次保存为活动状态但未设置签名密钥的 Webhook),系统会自动为其分配一个强签名密钥,该密钥仅显示一次,并带有复制按钮。请将其复制到接收方;之后将不再显示。
  • 在 Webhook 上设置签名密钥:输入至少 32 个字符的密钥,或留空以生成一个密钥并查看一次。密钥过短将被拒绝。
  • HMAC-SHA256 是目前唯一可用于出站 webhook 的签名方式。
  • Webhook 和 Webhook 发送都有“签名”列。如果 Webhook 没有设置密钥,则其状态会显示为“未签名 - 未设置密钥”,并且每次发送都会失败,并显示“未发送:此 Webhook 未设置签名密钥”,而不是以未签名状态发送。设置密钥(或在 Webhook 处于活动状态时重新保存)后,发送的 Webhook 就会以签名状态发送。

如果由于无法查找收件人名称(DNS 故障)导致投递失败,则会像连接失败一样,重试直至达到 webhook 的重试次数上限。平台直接拒绝的目标地址(私有地址或元数据地址,或平台不调用的协议)在第一次尝试时仍然会失败。

另请参阅“永不丢失的事件”。