如何配置Webhooks以适配Vercel预览环境接收第三方事件？

方法1：中转端点+动态转发 #

• 在第三方服务（如Clerk）中配置固定的生产环境Webhook端点作为中转。
• 在生产端点的处理逻辑中新增分支：收到事件时，根据请求头自定义标识（如X-Branch-Name）或事件附带的测试标记，将请求转发到对应预览环境的URL。
• 预览URL可通过Vercel API拉取最新部署记录，或在CI/CD流程中把预览URL存入缓存/数据库，关联对应分支或提交ID。

方法2：固定子域名映射 #

• 给每个预览分支绑定固定子域名，比如{branch-name}.your-domain.com。在Vercel项目域名设置中配置通配符子域名，让分支预览部署自动映射到对应子域名。
• 第三方服务的Webhook可直接配置为https://{branch-name}.your-domain.com/api/webhooks/clerk，只要分支名称固定，就能精准发送到对应预览环境。

方法3：预览部署完成后自动注册Webhook #

• 配置Vercel的预览部署完成Webhook：当生成新预览URL后，自动调用第三方服务的API（如Clerk的POST /v1/webhooks），动态注册该预览URL为Webhook端点。
• 同时要处理清理逻辑：当预览部署被删除时，调用第三方服务的删除接口移除对应Webhook，避免无效端点堆积。

方法4：本地代理转发（仅开发测试） #

• 开发阶段测试预览分支时，用工具（如ngrok）将本地端口暴露为公网URL，在第三方服务中配置这个临时URL即可接收Webhook。

内容的提问来源于stack exchange，提问作者hayata_suenaga