功能使用手册

邀请积分

成员邀请新用户入群后获得积分,仅在可靠归因存在时发放。

怎么用

操作目标

成员邀请新用户入群后获得积分,仅在可靠归因存在时发放。

  1. 配置邀请奖励 在主积分或邀请链接功能中设置邀请积分规则。 建议同时开启邀请统计。
  2. 生成邀请链接 成员或管理员生成可归因的邀请链接。 普通成员可通过用户邀请链接生成自己的链接。
  3. 新成员加入 新成员通过链接入群后,系统记录归因并发放积分。 无法确认来源时不会误发奖励。

开始前

前置条件

  • 邀请链接或 Telegram invite metadata 可用于归因。
  • 主积分邀请规则已配置。

实际使用

按用户实际体验操作

13 个页面 · 2 个输入点
从哪里进入

在 Telegram 私聊机器人发送 /start,先确认当前群组,再点击「主积分」。

进入后首先看到「积分中心」。
照着做什么
  1. 配置邀请奖励:在主积分或邀请链接功能中设置邀请积分规则。
  2. 生成邀请链接:成员或管理员生成可归因的邀请链接。
  3. 新成员加入:新成员通过链接入群后,系统记录归因并发放积分。
需要输入什么
  • 输入积分数值:发送整数数值 (10)
  • 输入积分文本:发送别名或命令文本 (积分)
示例:10
失败时怎么处理
  • 邀请链接或 Telegram invite metadata 可用于归因。
  • 主积分邀请规则已配置。
  • 格式不符合要求时,Bot 会停留在输入态并提示重新输入。
  • 格式不符合要求时,Bot 会停留在输入态并提示重新输入。
  • 如果页面提示权限、未开启或无效,先回到当前功能页补齐配置,再重新点击同一个按钮。

Telegram 操作流

跟着真实按钮操作

入口:私聊 /start 后点击「邀请积分」 页面:13 个 输入:2 处需要填写 群内:需要回到群内验证效果
第 1 / 13 页
@TgGroupRobot
管理员主菜单

发送 /start 后点击管理入口,按按钮选择当前群组。

点击「邀请积分」进入配置页。

当前群组:演示群
13:41
第 2 / 13 页
@TgGroupRobot
选择配置群组

私聊配置前先确认目标群组,后续按钮都会写入这个群。

可管理群:演示群、测试群
13:41
第 3 / 13 页
@TgGroupRobot
主菜单

这里展示机器人后台的真实功能入口。

13:41
第 4 / 13 页
@TgGroupRobot
积分中心

这里聚焦邀请积分,保存后由邀请归因运行时发放。

签到、发言、邀请和展示规则都通过真实 pts 回调保存。

当前群组:演示群状态:已启用异常恢复:配置「邀请积分」时如果提示未开启、权限不足、无效或失败,先确认当前群组和机器人权限,再回到「积分中心」重新操作。进度提示:完成「邀请积分」前先检查必填项状态,最后通过 「导出日志」 确认效果或继续下一步。
13:41
第 5 / 13 页
@TgGroupRobot
签到积分规则

开启签到后,用户发送签到命令即可获得积分。

13:41
第 6 / 13 页
@TgGroupRobot
发言积分规则

开启后,达到最小字数的发言会按日上限累计积分。

13:41
第 7 / 13 页
@TgGroupRobot
邀请积分规则

邀请归因成功后,邀请人按规则获得积分。

13:41
第 8 / 13 页
@TgGroupRobot
积分展示规则

排行榜、个人发言统计和积分别名都在这里配置。

13:41
第 9 / 13 页
@TgGroupRobot
额外规则

管理员可通过真实 pts 编辑入口执行加分、扣分、清空和导出。

13:41
第 10 / 13 页
@TgGroupRobot
用户邀请入口

用户可创建自己的邀请链接并查看排行。

13:41
第 11 / 13 页
@TgGroupRobot
输入积分数值

请按照 Bot 提示在私聊发送内容。

发送整数数值
10
  • 格式不符合要求时,Bot 会停留在输入态并提示重新输入。
13:41
第 12 / 13 页
@TgGroupRobot
输入积分文本

请按照 Bot 提示在私聊发送内容。

发送别名或命令文本
积分

清空方式:/clear

  • 格式不符合要求时,Bot 会停留在输入态并提示重新输入。
13:41
第 13 / 13 页
@TgGroupRobot
积分设置结果

Bot 保存后回到积分中心,运行时按当前群组 chat_id 统计。

13:41

常见问题

常见问题

无法归因时会不会发错积分?

不会。当前实现只在可靠 metadata 存在时发放。