用途:为 Hootsuite 集成实现 Webhook 签名校验与事件处理,覆盖 App Directory 集成的流事件,以及 API-only 集成下的消息状态轮询与自建调度回调。
主要能力:轮询消息状态变化(如 SENT、FAILED、REJECTED);构建自定义调度 Webhook,用定时任务检查已发送消息并通知内部系统;处理 App Directory 的流事件,如 message.sent、message.failed、stream.message。
使用方式:轮询可调用 https://platform.hootsuite.com/v1/messages/{messageId},携带 Authorization: Bearer 令牌;自建 Webhook 可查询 https://platform.hootsuite.com/v1/messages?state=SENT&limit=50 并向内部 Webhook 地址 POST 事件;App Directory 事件在 /webhooks/hootsuite 接收并返回 200。
前置条件:需要密钥管理中的 Webhook 密钥、事件来源允许列表、重放窗口策略和不透明事件账本;还需带禁用/取消控制的沙箱消费者。
输出:返回事件回执,包含类型、不透明事件 ID、签名/时间戳结果、幂等结果、队列状态、草稿/公开断言和回滚引用,不包含载荷副本、媒体、账号名和签名。
错误处理:拒绝未知来源、过期或重放投递、畸形载荷、未知配置/受众或非幂等重试;完整性或审批不确定时隔离事件并禁用消费者。
限制:Hootsuite REST API 不推送消息状态 Webhook,需自行轮询或自建调度;具体签名算法、事件字段与平台限制资料未提供。