SuperAPI AI 工具集

product-onboarding

部署与运维

查看项目

更新于 10-16 09:29

技能介绍

用途:将新的 Skill Recordings 产品接入客服支持平台,适用于用户要求新增产品、接入新应用或执行产品 onboarding 的场景。

前置条件:产品已有 Front 收件箱、有 Stripe 账户用于退款处理、且代码库可访问。

主要流程:1)从 Front URL 获取收件箱 ID,并按 base-36 转换为 API ID,格式为 'inb_' + 数字 ID.toString(36);2)通过向导或手动生成应用配置;3)向 SUPPORT_apps 表插入应用记录,包含 id、slug、name、front_inbox_id、integration_base_url、webhook_secret、capabilities、自动批准退款与转移天数等字段;4)通过 Stripe OAuth 授权接口连接对应收件箱的 Stripe 账户;5)在产品质量中安装 @skillrecordings/sdk,配置 SUPPORT_WEBHOOK_SECRET 环境变量,创建 app/api/support/integration.ts 实现 lookupUser、getPurchases、revokeAccess、transferPurchase、generateMagicLink 等方法,并创建 app/api/support/[...action]/route.ts 路由处理器;6)通过 curl 或 CLI 验证端点可达。

对基于 course-builder 的应用:应使用 courseBuilderAdapter 而非直接数据库查询,并提供了方法对照表,包括 getUerByEmail、getPurchasesForUser、updatePurchaseStatusForCharge、transferPurchaseToUser、updateUser、createVerificationToken 等。

限制与注意:路由处理器需在请求时检查环境变量,不可在模块加载时抛出异常,否则会破坏构建;Turborepo monorepo 需把该环境变量加入 build 任务的 env 数组;否则 Turbo 不会传递该变量并会产生警告。具体安装命令为 pnpm add @skillrecordings/sdk 或 bun add @skillrecordings/sdk。