来源追踪
查看哪些链接和标签带来了新用户，并将每次访问与特定推荐人关联起来。
5 分钟
即可上线推荐计划
2 种模式
纯观察模式，或全托管模式
自动化
支持手动、Webhook 或定时支付
功能概览
完整的推荐计划，无需开发
启动并发展机器人推荐计划所需的一切，全都集中在一处。
推荐人与被推荐人记录
系统会记录谁邀请了谁，并完整保存推荐人 → 被推荐人的关系历史。
自动计算奖励
灵活的奖励规则：固定金额、按比例计算，或由机器人中的任意事件触发的外部计算。
奖励发放
支持手动发放、Webhook 触发，或按计划自动发放。各币种余额独立追踪。
统计与分析
转化漏斗、头部推荐人排名、奖励趋势，以及报表生成器中的推荐数据，一应俱全。
可叠加于您现有系统之上
即使您已有自己的推荐逻辑，也可以接入 — 无需更改基础设施。
已经有自己的推荐系统？完全没问题
graspil 的推荐系统可以叠加运行在您自己的系统之上。在“观察”模式下，您只需为现有链接的访问数据获得分析与追踪 — 无需更改机器人或基础设施。
模式
观察模式或托管模式 — 由您选择
两种模式满足不同需求：在您自有逻辑之上做纯分析，或由我们提供完整的推荐计划。
观察模式
系统会捕获链接中 ?start= 参数携带的代码，并将访问与用户关联起来。代码由您的机器人生成和管理。
- 适合已经在自行发放推荐链接的场景
- 无需更改基础设施即可获得完整的访问分析
- 只要传入推荐人的 Telegram ID，或通过 API 关联代码所属人，奖励计算即可生效
托管模式
平台会为每位推荐人生成专属代码和链接。您将获得奖励规则、余额和支付功能 — 可通过界面或 API 操作。
- 开箱即用的专属推荐代码和链接
- 奖励计算规则、余额管理与支付功能
- 适合从零开始搭建推荐计划的场景
链接与代码
灵活配置推荐链接
您可以自定义参数名称、传入不透明代码，或直接传入推荐人的 Telegram ID — 系统会适配您的链接格式。
- 自定义参数名称（默认为 ref），匹配您的链接格式
- 支持“参数 = 推荐人 Telegram ID”模式，无需代码与用户的映射层
- 通过 API 关联代码所属人 — 可提前预设，也可事后回填
链接格式
不透明代码（默认）
t.me/your_bot?start=ref-aK39xZ 直接使用推荐人的 Telegram ID
t.me/your_bot?start=128471992 参数名称和模式均可一键配置
奖励规则
推荐人付款的 10% 已启用
事件
payment
条件
≥ 1000 ₽
奖励
10%
冻结期
14 天
附带操作
POST https://api.yourbot.com/reward
奖励计算规则
灵活的规则是推荐计划的核心
每条规则定义：由哪个事件触发、为推荐人计入多少金额，以及还要执行哪些操作。多条规则可按优先级生效。
- 触发条件 — 机器人中的任意事件：付款、订阅、漏斗中的某一步骤
- 针对事件数值的条件：最小值、最大值，或精确匹配
- 冻结期 — 在支付前防范退款风险
- 附带操作：调用 Webhook、更新用户的自定义字段
- 当多条规则同时匹配同一事件时的优先级设置
固定金额
每次事件按所选币种计入固定金额。
按比例计算
按事件金额的一定比例计算 — 币种与事件本身保持一致。
外部计算
平台通过 Webhook 通知您的服务器，由您自行计算金额。
支付
以您喜欢的方式发放奖励
一旦推荐人的余额获得确认，您可以手动发放、通过 Webhook 发放，或按计划自动发放。
手动发放
您可以用任意方式转账，并在系统中标记为已支付。平台会自动记录。
Webhook
平台会发送一个 POST 请求，要求“为用户 Z 计入 Y 币种的 X 金额”，由您的服务器执行。
自动支付
按计划执行（每月或每 N 天一次），并可为每种币种设置最低支付门槛。
推荐人余额
可用余额4 820 ₽
已预留1 200 ₽
冻结中650 ₽
已支付12 300 ₽
支付流程
已申请处理中已完成
统计数据
完整的推荐计划分析
追踪推荐计划的整体表现，并在报表生成器中将推荐数据与机器人的其他分析数据结合使用。
- 从访问到目标行为的完整推荐计划转化漏斗
- 头部推荐人排名与奖励趋势变化
- 各币种的余额与奖励状态
- 推荐数据可直接用于报表生成器
机器人内自动化
机器人内置的开箱即用工作流
借助自动化工具，您机器人的用户无需离开 Telegram 即可管理推荐计划。
加入计划
用户加入推荐计划后，会直接在与机器人的对话中获得专属链接。
个人数据统计
推荐人可通过机器人指令查看自己的余额、邀请人数和奖励历史记录。
申请提现
点击“提现”按钮，即可直接在机器人中触发已累积余额的支付。
开箱即用的场景 — 无需编写代码
您的机器人
bot
欢迎加入推荐计划！点击 /ref 获取您的专属链接。
/ref
您的专属推荐链接：
t.me/your_bot?start=ref-aK39xZ📊 我的数据💸 申请提现
邀请好友，每一次目标行为都能为您赚取奖励！
API
通过 API 实现全面控制
以编程方式管理推荐计划：发放链接、关联代码所属人，并直接从机器人触发支付。
- 按指令为用户发放推荐链接
- 批量关联代码所属人 — 支持提前预设和事后回填
- 在机器人中点击按钮即可触发支付
推荐系统 API
GET
referral/default/referrer-code返回（或创建）某用户的推荐链接
POST
v1/referral/set-code-owners将所属人关联到一个或多个代码
POST
v1/referral/payout触发推荐人可用余额的支付