Agent Skills
返回列表
Referral Factory 推荐裂变

Referral Factory 推荐裂变

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 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 增长的运营负责人