Telegram 机器人消息推送教程

机器人通过 Telegram Bot API 接收 Telegram 允许交给它的新消息。它不会读取你的全部个人聊天，也不能绕过群权限。接收普通群消息可能需要调整 BotFather 隐私模式或相应群权限。

Bot Token 相当于机器人的操作凭据，请仅使用你有权管理的 Token，并在 aaPush 应用内填写。不要贴到反馈、公开截图、教程评论或 URL 中。个人账号接入方式见iPhone Telegram 提醒教程。

1. 从主屏幕打开 aaPush，先完成通知权限设置。
2. 在 Telegram 的官方 @BotFather 中创建或管理你自己的机器人，取得 Token。
3. 进入 aaPush“推送”页，选择添加机器人来源，在应用内填写 Token 并完成认证。
4. 进入“设备”→ 本机详情，确认机器人来源已绑定。来源管理在推送页，设备详情负责绑定和解绑。
5. 需要私聊接收时，在 Telegram 中打开该机器人并按其要求开始对话；需要群消息时，将机器人加入你有权管理的目标群并核对权限。

未绑定并验证邮箱的账号，新增接入最多 1 个机器人；验证邮箱后可以在套餐与系统上限内增加。新增设备默认绑定已有来源，仍建议在设备详情核对实际绑定状态。

Telegram 机器人的群隐私模式会影响它能够收到哪些内容。开启隐私模式时，机器人通常只收到特定命令、相关回复等允许的消息，并非所有群文字。aaPush 只能处理 Telegram 已交给机器人的内容。

1. 在机器人来源详情检查群消息读取权限及页面提供的指引。
2. 如需普通群消息，使用官方 @BotFather 的 /setprivacy，选择对应机器人并按需求调整隐私模式。
3. 按 Telegram 提示使变更生效；部分情况下需要由群管理员重新将机器人加入群。管理员身份也会影响读取范围，仅授予实际需要的权限。
4. 确认机器人仍在群内，目标消息是设置完成后的新文字，再核对 aaPush 的来源和设备绑定。

1. 在“推送”页进入对应机器人来源的群消息设置。
2. 选择“仅 @指定用户”，填写最多 3 个 Telegram 用户名。用户名可带 @，匹配不区分大小写。
3. 名单添加或移除后自动保存，等待页面确认保存成功；如失败，按页面提示重试并重新进入核对。
4. 群消息中真实提及名单内任意一个用户即可匹配。仅输入普通昵称、粘贴个人主页链接，不能当作同一种提及。

例如名单中有 @example_user，群里通过 Telegram 提及功能选中该用户产生的新消息才属于对应提及场景。这里的用户名仅为占位示例，请替换为你需要的真实用户名。

“仅 @指定用户”的空名单会暂停群消息接收；私聊和频道保持原接收方式。个人 Telegram 来源有自己的群消息设置，修改机器人名单不会同步改变个人 TG 的接收范围。

使用你有权操作的群产生一条新的、真实提及名单用户的文字消息，再分别查看 aaPush 列表和系统通知。不要使用授权前的旧消息判断新规则是否生效。

• 私聊有消息、群没有：优先检查群权限、BotFather 隐私模式和群接收规则。
• 名单已保存仍不接收：检查是否是准确用户名和真实提及，当前设备是否绑定，以及当日额度。
• 列表有消息但没通知：检查 iPhone 通知权限与“推送检测”，见故障排查教程。
• 希望停止接收：设备详情解绑只停止该设备；推送页删除来源才会撤销授权并从所有设备移除。

群隐私模式和接收范围由 Telegram Bot API 决定，详见 Bots FAQ：机器人会收到哪些消息及 Privacy Mode 官方说明。