功能使用手册

邀请归因

基于 ChatMemberUpdate 的可靠 invite metadata 缓存归因。

怎么用

操作目标

基于 ChatMemberUpdate 的可靠 invite metadata 缓存归因。

生成可追踪链接 通过邀请链接功能创建或让成员生成链接。不要手工混用不可识别链接。
新成员入群 系统接收成员变更事件并缓存来源信息。归因依赖 Telegram 返回的数据。
发放或跳过奖励 来源可靠时记录邀请和积分；无法确认时跳过。跳过比误发更安全。

开始前

前置条件

新成员通过可识别邀请链接加入。
Telegram 提供可靠 invite metadata。

实际使用

按用户实际体验操作

13 个页面 · 4 个输入点

从哪里进入

在 Telegram 私聊机器人发送 /start，先确认当前群组，再点击「邀请归因」。

进入后首先看到「邀请配置」。

照着做什么

生成可追踪链接：通过邀请链接功能创建或让成员生成链接。
新成员入群：系统接收成员变更事件并缓存来源信息。
发放或跳过奖励：来源可靠时记录邀请和积分；无法确认时跳过。

需要输入什么

设置邀请封面：发送图片、视频，或发送 /clear 清空封面（上传一张图片）
设置邀请文本：发送邀请卡片正文（邀请好友进群可获得积分。）
设置邀请按钮：逐行输入按钮，支持分号同排（加入频道 - https://t.me/example）
创建邀请链接：发送链接备注或使用默认创建（社群活动链接）

示例：image.jpg

失败时怎么处理

新成员通过可识别邀请链接加入。
Telegram 提供可靠 invite metadata。
格式不符合要求时，Bot 会停留在输入态并提示重新输入。
格式不符合要求时，Bot 会停留在输入态并提示重新输入。
格式不符合要求时，Bot 会停留在输入态并提示重新输入。
如果页面提示权限、未开启或无效，先回到当前功能页补齐配置，再重新点击同一个按钮。

Telegram 操作流

跟着真实按钮操作

入口：私聊 /start 后点击「邀请归因」页面：13 个输入：4 处需要填写群内：需要回到群内验证效果

第 1 / 13 页

@TgGroupRobot

管理员主菜单

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

点击「邀请归因」进入配置页。

当前群组：演示群

13:41

第 2 / 13 页

@TgGroupRobot

选择配置群组

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

可管理群：演示群、测试群

13:41

第 3 / 13 页

@TgGroupRobot

主菜单

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

13:41

第 4 / 13 页

@TgGroupRobot

邀请配置

这里聚焦邀请归因运行时，配置入口仍是邀请配置。

管理入口使用 inv:home，管理员配置和用户自助入口共用真实邀请服务。

当前群组：演示群异常恢复：配置「邀请归因」时如果提示未开启、权限不足、无效或失败，先确认当前群组和机器人权限，再回到「邀请配置」重新操作。进度提示：完成「邀请归因」前先检查必填项状态，最后通过「预览效果」、「链接详情」、「创建确认」等页面确认效果或继续下一步。