SuperAPI AI 工具集

frontapp-webhooks

编程与开发

查看项目

更新于 10-16 05:52

技能介绍

用途:用于搭建或调试 Front(Frontapp)应用 Webhook 处理程序,主要是签名校验与订阅校验环节。Front 应用 Webhook 没有官方服务端 SDK,需要手动验证。

主要能力:校验 X-Front-Signature——Front 用应用签名密钥对 X-Front-Request-Timestamp + ":" + rawBody 做 HMAC-SHA256,结果 base64 编码后放入该头部;必须使用原始请求体,不能在验证前 JSON.parse。订阅时 Front 会先发送带 X-Front-Challenge 头部的校验请求,需在 10 秒内返回 HTTP 200 并回显该值,可用 JSON {"challenge": "<value>"}、表单 challenge=<value> 或 text/plain 原始值。支持按顶层 type 字段分发事件:inbound_received、outbound_sent、conversation_moved、message_delivery_failed、conversation_archived、conversation_reopened、conversation_deleted、conversation_restored、conversation_snoozed、conversation_snooze_expired、new_comment_added、assignee_changed、tag_added、tag_removed、link_added、link_removed。

使用方式:提供 examples/express/、examples/nextjs/、examples/fastapi/ 完整示例,含 challenge 握手、事件分发与测试。环境变量 FRONT_WEBHOOK_SECRET 填 Front 应用设置中的应用签名密钥。本地开发用 npx hookdeck-cli listen 3000 frontapp --path /webhooks/frontapp 建立隧道。参考文件包括 references/overview.md、setup.md、verification.md。建议同时安装 webhook-handler-patterns 技能以处理处理顺序、幂等、错误与重试。

限制:无官方服务端 SDK;未提供收费、价格与性能数据;签名比较需用 crypto.timingSafeEqual 并处理长度不匹配。