SuperAPI AI 工具集

clickup-webhooks-events

办公与效率

查看项目

更新于 10-16 06:20

技能介绍

用途:把 ClickUp Webhook 视为需持久处理与对账的签名变更信号,适用于需要可靠接收 ClickUp 事件并异步处理业务效果的集成场景。

主要能力:注册与验证 Webhook;用原始请求体做 HMAC-SHA256 校验(对比十六进制 X-Signature);以 webhook_id:history_item_id 作为幂等键;快速确认后异步处理;监控状态、失败计数、延迟、重复与死信;对投递缺口做对账读取;在所有权变更时安全轮换或重新注册。

必要用法:需公网 HTTPS 端点并能保留原始请求字节;需密钥管理、持久队列/幂等存储与 Workspace 白名单;需授权用户作为 Webhook 所有者。认证可用个人令牌(仅限可追责的个人/测试)或 OAuth 授权码(面向用户的集成),令牌须服务端注入、放在 Authorization 中,并校验 Workspace ID,禁止打印令牌、OAuth 客户端密钥或 Webhook 密钥。注册前确认端点归属、HTTPS、密钥存储与回滚审批,选择最窄位置与明确事件集,并先盘点重复注册。

限制:响应超过七秒或不成功即视为失败;ClickUp 最多尝试五次,之后不再重发,fail_count=100 时暂停,401 立即暂停。注册绑定创建用户,该用户被禁用或失去层级访问后可能停止触发。无 history item 的事件需使用文档化的回退键并对账。创建、扩大、暂停/恢复、轮换或删除生产 Webhook 及重放业务效果前需审批。

资料未提供具体安装命令、价格与平台细节。