Referral Factory 推荐裂变
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/sales-referral-factory。
技能介绍
解决什么问题
Referral Factory 是一个推荐裂变工具,但把它接进自家产品时,团队常在几个环节翻车:
- 归因失败:只调了
POST /users新建用户,没传referrer对象,导致推荐关系根本没记录。 - 奖励不触发:以为添加用户就等于完成推荐,实际上必须先调用
PUT /users/qualification让用户被资格化,奖励才会进入 due 状态。 - Webhook 不安全:平台没有文档化的 HMAC 签名,如果不做幂等设计和二次校验,同一个推荐可能被重复发奖。
- 计划门控不清:白标、自定义域名需要 Pro,自定义 HTML 和本地化部署需要 Enterprise,基础版只能用 API 和 Webhook。
这个技能的作用,就是把上述坑位变成可执行的操作清单。
技能如何工作
技能按四步推进,每一步都给出精确的接口调用和决策路径:
1. 收集上下文
技能首先判断你在做什么:添加推荐人、资格化用户、配置 Webhook、选择活动类型,还是对接 CRM/ESP/Stripe。如果你的问题已经足够具体,可以直接跳到下一步。如果缺少 references/learnings.md,技能会优先读取已有知识库。
2. 路由或直接回答
技能区分三类问题,并给出对应的子技能指令:
- 跨工具的推荐策略(比如如何选择平台、评估增量效果) →
sales-audience-growth - 基于佣金的联盟营销设计 →
sales-affiliate-program - 邮件投递问题 →
sales-deliverability - 通用 CRM/ESP/Stripe 集成 →
sales-integration
路由时,技能会返回可直接使用的指令,例如:“这是一个策略问题,运行 sales-audience-growth 来测试推荐是否具有增量性。”
3. 查阅平台参考
技能会按需读取两个参考文件:
references/platform-guide.md:完整的模块地图、活动类型映射、数据模型 JSON 结构和快速上手配方。references/referral-factory-api-reference.md:基址https://api.referral-factory.com/api/v2、Bearer认证、核心端点(POST /users、PUT /users/qualification、GET/POST /rewards/*)、分页限制(per_page ≤ 250)、速率限制(600 次/分钟)以及 Webhook 机制。
4. 提供可操作指导
技能会把每个问题折叠成一条明确指令,例如:
- 创建用户时,必须显式传递
referrer对象(支持code、id、email三种字段),否则用户会变成独立的 Person Referring,推荐关系无法归因。 - 资格化用户时,调用
/users/qualification,传入id、code或email + campaign_id,奖励才可流转。 - 发放奖励是两步流程:先
GET /rewards/due/{metric}找到待发奖励,再POST /rewards/issue/{id}执行发放或POST /rewards/cancel/{id}取消。 - Webhook 推荐使用出站而非轮询:新用户创建和资格化事件都会触发回调,但需把它当作秘密 URL 对待,收件端要幂等,发放前用
GET /users/{identifier}二次验证。 - 注意计划门控:Basic 约 $200/月,Pro 约 $400/月,Enterprise 约 $1,000/月,按用户数计费;白标和自定义域名需 Pro,自定义 HTML 需 Enterprise。
- 奖励发放只能走 PayPal、200+ 国家的礼品卡、Stripe 积分/优惠券、佣金或自定义,不支持直接银行转账。
适用边界
这个技能聚焦于客户推荐(Customer Referral)的场景:现有的客户通过奖励或折扣拉新朋友注册。它不处理以下问题:
- 佣金制的联盟营销(Affiliate)或合作伙伴计划。技能会建议使用
sales-affiliate-program来设计这类项目。 - 跨工具的推荐策略选择和增量性度量。技能会路由到
sales-audience-growth。 - 邮件送达率问题,例如通知邮件是否进了垃圾箱。
在集成层面,技能假设你使用 api.referral-factory.com/api/v2 作为基址,并遵循 Bearer 认证。如果帮助文档中出现了不同的二级域名,以账户内的 OpenAPI 配置为准。
最后,技能的最佳实践来自 2026 年 6 月的研究,价格和功能可能已调整,实际使用前请在账户内确认。如果遇到新的坑或变通方案,可以补充到 references/learnings.md,让后续对话复用。
使用场景
- 自有应用注册时通过 API 添加被推荐人,并正确归因到邀请人
- 被推荐用户转付费后,调用资格化接口并发放对应奖励
- 接到 Webhook 回调后写入 CRM,并做幂等去重防止重复发奖
- 在自有 SaaS 里决定启用推荐还是联盟计划,并按方案路由子技能
适合人员
- 需要把 Referral Factory 接入自研产品的后端工程师,关注创建、归因、资格化和发放链路
- 负责推荐活动上线和奖励规则配置的增长产品经理,关注契约调用与计划门控
- 要处理 Webhook 去重、重放和异常发放排查的运维工程师
- 评估推荐与联盟哪种模式更适合 SaaS 增长的运营负责人