Referlist 产品发布、收录与曝光
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/sales-referlist。
技能介绍
它解决什么问题
当产品通过 Referlist 搭建等待名单(waitlist)时,运营和开发团队会反复撞上几个实操难题:嵌入式表单、npm SDK、JS snippet 和 REST API 到底该选哪种安装方式;Next.js 的 SSR 环境下 window is not defined 怎么绕;手动调用 addToWaitlist 时推荐码没转发,导致排队位置不动;套餐分档明确,只有 Pro 开放服务端 API,导出和种子用户也有门槛;文档站点是 JS 渲染,REST 接口细节很难直接查到;另外,问题一旦偏离 Referlist 范畴,什么时候交给相邻技能,也很考验判断。这个技能把上述问题拆成可执行步骤,优先给出贴合上下文的选型与代码级建议,而不是铺陈产品介绍。
它如何工作
技能按四步推进。第一步收集上下文:判断你是要加病毒式推荐 waitlist、集成 React/Next.js SDK、调 REST API、导出注册数据、配置推荐机制、选套餐,还是和竞品做适配判断;同时确认表单部署位置(托管页、Webflow/Squarespace/Wix 无代码站,还是 React 应用),以及注册数据最终去向(留在 Referlist、导出到 Mailchimp/Airtable/CSV,还是进自建 backend)。第二步做路由判断:如果问题超出 Referlist 范畴,比如增长策略、邮件广播或活动防作弊,技能会给出对应的 /sales-xxx 命令,把任务转给更合适的技能。第三步读取平台参考:按安装方式、能力标签、套餐门控、推荐机制、导出集成、快速上手配方和竞品对比分块查找。第四步给出轻量集成方案:无代码站优先用嵌入式表单或 snippet,React 项目走 npm SDK,服务端读写则必须 REST API 并锁定 Pro 档。
适用边界与注意点
几个高频坑值得单独列出来。Next.js 出现 window is not defined,是因为 SDK 必须在客户端执行,正确做法是用 dynamic(() => import('referlist'), { ssr: false }) 加载,并在 useEffect 里调用 referlist.initialize。推荐码要用下面这种方式手动转发:
window.referlist.addToWaitlist('YOUR_DOMAIN', email, referralCode)
漏掉第三个参数,注册记录会写入,但没有人获得排队前进或推荐归属。REST API 的 base URL、鉴权方式和端点路径不在公开文档索引里,docs.referlist.co 是客户端渲染,技能只标记能力限制而不编造接口细节,真要接入需到登录后的 live 文档里逐条核实。套餐上限按注册数计算:Free 100、Growth 500、Pro 3000、Enterprise 按量计费;导出超过 Free 的 100 条需要升级。webhooks 和 Zapier 未见官方确认,实时推送需求要么先验证,要么转用具备推送能力的其他产品。最后,使用中发现的新技术坑、绕过方式或经验,可以追加写入 learnings.md,下次就能直接命中。
使用场景
- 在 Webflow 落地页上为产品发布添加无需写代码的病毒式推荐排队表单。
- 在 Next.js 应用中集成 Referlist SDK 时排查 SSR 报错并处理前端渲染问题。
- 手动调用 addToWaitlist 接口记录注册信息,同时转发推荐码以修正排队位置。
- 根据预估的注册量选择合适的套餐,并将名单数据导出同步到 Mailchimp 进行营销。
适合人员
- 在无代码平台搭建落地页,希望快速接入推荐排队且不愿编写前端代码的营销运营。
- 在 Next.js 等前端项目中引入第三方 SDK 时遇到环境兼容性或推荐归因报错的 Web 开发者。
- 需要依据预期用户注册量评估 REST API 权限和导出额度,从而决策购买何种套餐的后端工程师。