SuperAPI AI 工具集

calendly-webhooks

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:接收并验证 Calendly Webhook,适用于搭建 Calendly Webhook 处理器、调试签名验证失败、处理预约相关事件,以及调试重放保护。

主要能力:Calendly 通过 Calendly-Webhook-Signature 头签名,格式为 t=<timestamp>,v1=<signature>。需用订阅的签名密钥对 {timestamp}.{raw body} 计算 HMAC-SHA256(十六进制),进行时序安全比较,并拒绝过期时间戳(约 3 分钟)以防重放。Calendly 没有 SDK 验证辅助函数,需手动验证,且必须使用原始请求体,不能先 JSON.parse。

常见事件:invitee.created(被邀请人预约)、invitee.canceled(取消预约)、invitee_no_show.created(标记未出席)、invitee_no_show.deleted(移除未出席标记)、routing_form_submission.created(提交路由表单)。

使用方式:设置环境变量 CALENDLY_WEBHOOK_SIGNING_KEY(创建 Webhook 订阅时返回的签名密钥)。本地开发可运行 npx hookdeck-cli listen 3000 calendly --path /webhooks/calendly 启动隧道,无需账号。完整处理器示例见 examples/express/、examples/nextjs/、examples/fastapi/。

限制与说明:资料未提供收费、价格、平台支持范围等信息。建议配合 webhook-handler-patterns 技能使用,以处理处理器顺序、幂等性、错误处理与重试逻辑。生成文件时按要求添加注释:// Generated with: calendly-webhooks skill 与 https://github.com/hookdeck/webhook-skills。