Agent Skills
返回列表
ReferralHero 推荐裂变与受众增长

ReferralHero 推荐裂变与受众增长

企业运营 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fccf428b/sales-referralhero。

技能介绍

先对齐你要解决的问题

ReferralHero 不是单纯的"拉新工具",而是一个需要根据你的套餐层级、ESP 栈和活动类型做大量判定的推荐系统。这个技能把平台文档、API 参考和踩坑记录压成一条可执行的排查路径。

常见触发场景包括:

  • 在 Free(25 subs)、PRO($199/mo,10K)、PREMIUM($399/mo,50K)之间做决策
  • 通过 REST API 添加、批量导入或追踪订阅者
  • 配置 webhooks 监听 referral confirmation 事件
  • 接入 Mailchimp / Kit / AWeber / Klaviyo / ActiveCampaign / SendLane 等原生 ESP connector
  • 排查 Level 1/2/3 推荐计数偏差
  • 创建 coupon group 并批量导入优惠码
  • 触发 HTTP 429 too_many_calls 需要调速率

技能如何工作

Step 1 — 上下文收集:技能会先确认你的目标、活动类型(Referral / Affiliate / Waitlist / Contest / NPS)和所在 ESP。如果 references/learnings.md 已有积累的平台知识,会优先读取。

Step 2 — 路由或直接回答:非 ReferralHero 专属问题会被分发到 /sales-audience-growth、/sales-newsletter 等相邻技能;ReferralHero 专属问题则进入平台参考库。

Step 3 — 平台参考检索:按需读取 references/platform-guide.md(功能分层、ESP 集成流程、多级推荐机制、反欺诈规则)和 references/referralhero-api-reference.md(原生 REST 文档,包含认证方式、Base URL https://app.referralhero.com/api/v2、完整 endpoint 列表、软限速 5,000 req/hr 和错误码)。

Step 4 — 给出可执行建议:技能只输出与当前情境相关的段落,不会倾倒整份参考。

关键工程约束

  • API 仅在 PRO 及以上可用:Free 层不含任何 API 和 webhooks,不要在 Free 上承诺程序化工作流。
  • 认证二选一:Authorization: Bearer <token>(推荐)和 X-API-Key: <key> 只能发一个,混发行为未定义。
  • 批量导入 500/请求:POST .../subscribers/add_bulk_transactions 上限 500,单条循环会撞 429。
  • 多级 endpoint 分开:level_2_referrals 仅返回 confirmed,level_2_all_referrals 包含 unqualified;Level 3 同理。
  • Promote 与 unlockpromotedreward 是两步:先 POST .../subscribers/:id/promote,再调用 unlock 并携带 reward_id;跳过第一步会导致解锁静默失败。
  • 优惠券必须先建 group:POST /coupon_groups → POST /coupons,平铺导入会失败。
  • 原生 ESP + API 别同时用:Mailchimp / Kit 等 connector 与 /subscribers 手动写入会 double-add。
  • 无 MCP server:截至 2026-06-01 没有官方 MCP 支持。

技能的边界

这个技能能把 ReferralHero 文档拆到"够写代码"的粒度,但它不会替你做下面这些事:

  • 不会改套餐、不会替你发支持邮件
  • 不会为免费层编一个 API 调用示例(Free 没有 API)
  • 不会跳过 references/learnings.md 直接答(除非问题里已经带了足够上下文)

先在 SkillHub 安装本技能,再在对话里给出套餐、活动类型和 ESP,就能获得贴近工程现场的回答。

使用场景

  • 增长负责人决定是否升级到 PRO 或 PREMIUM,需要对比 API、webhook、防欺诈能力后再写方案
  • 后端工程师在 Mailchimp 与 ReferralHero 之间做数据流设计,需要避开重复写订阅者
  • 工程师写批量导入脚本,遇到批量上限和 429 限流,需要确认改用 bulk 接口并分片
  • 运营排查 Level 2 推荐人数与后台不一致,需要区分 all referrals 与 confirmed 两个 endpoint

适合人员

  • 负责 newsletter 增长的增长运营,需要在各套餐之间给出带 API 边界的升级建议
  • 需要把 ReferralHero REST API 接进现有后端的工程师,关注认证方式、endpoint 和限流策略
  • 正在排查多级推荐数据不一致的分析或后端负责人,需要定位 endpoint 差异和数据修复路径
  • 用 Mailchimp 或 Klaviyo 做活动发送的营销技术负责人,需要判断原生 connector 与 API 二选一