📖 图文教程

LeftRelay AI
设置指南

从零开始，约 15 分钟完成房源分类与分发配置

1
申请 Telegram Bot
BotFather 3 步获取 Token
2
创建群组 + 添加 Bot
建群、添加 Bot，群组自动出现
3
WA Group 显示为 ID？
如何读取并保存真实名称
4
添加转发规则
设置分类 → Telegram 群映射
5
私聊转发 + Forum Topics
WhatsApp 私聊同步到 Telegram，每人独立 Topic
1
申请 Telegram Bot
通过官方 BotFather 机器人，3 步拿到 Bot Token
第一步

搜索并打开 BotFather

在 Telegram 搜索栏输入 @BotFather，选择带蓝色认证勾的官方账号。

点击 Start 开始对话。BotFather 会列出所有可用指令。

✓ 提示： BotFather 只有一个，用户名完全一致，旁边有蓝色官方认证标志，不会有假冒。
9:41●●●
🤖
BotFather
bot
BotFather
I can help you create and manage Telegram bots.

/newbot — create a new bot
/mybots — manage your bots
/token — generate token
9:41
/newbot
9:41
Message
➤
第二步

发送 /newbot，设置名称

BotFather 会先问你 Bot 的显示名称（给用户看的，可以是中文），再问 username（英文，必须以 bot 结尾）。

例：显示名称 Property Forwarder，username MyPropertyBot

✓ 提示： Username 全球唯一，如果提示已被占用，换一个加数字或自己名字的组合即可。
9:42●●●
🤖
BotFather
bot
BotFather
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
9:42
Property Forwarder
9:42
Good. Now let’s choose a username for your bot. It must end in bot.
9:42
MyPropertyBot
9:42
Message
➤
第三步

复制 Bot Token

BotFather 返回一串 Token，格式是 1234567890:AAF...，这就是你的 Bot 身份凭证。

完整复制这串 Token，后面填入 App 设置时会用到。

⚠ 注意： Token 是私密的，不要发给别人。如果不小心泄露，可以用 /revoke 指令重新生成。
9:43●●●
🤖
BotFather
bot
BotFather
Done! Congratulations on your new bot. You will find it at t.me/MyPropertyBot.

Use this token to access the HTTP API:
7123456789:AAFhG2xKyP-qRmTvNwBsLdEoJcUiXzY8Hk
Keep your token secure and store it safely.
9:43
Message
➤
2
创建 Telegram 群组 + 添加 Bot
建群、把 Bot 加进去，群名称会在 App 里自动出现，无需手动找 ID
A

新建 Telegram 群组

打开 Telegram → 右上角铅笔图标 → New Group → 随便选一个联系人（凑人数用，之后可以踢出）→ 给群起名字（如 1WG – Lander For Sale）→ 创建。

每种分类建一个群，例如：有地产销售群、公寓出租群、商业物业群……

B

把 Bot 添加到每个群，并设为管理员

进入群 → 点群名称 → Add Members → 搜索你的 Bot（如 @MyPropertyBot）→ 添加 → 再进入群资料 → Administrators → 添加 Bot 为管理员。

⚠ 必须设为管理员，否则 Bot 没有发消息权限，转发会失败。
自动发现

群组名称在 App 里自动出现

完成上一步后，无需手动找 Chat ID。在 App 里配置转发规则时，已加入 Bot 的 Telegram 群会自动出现在下拉列表中，直接选择即可。

如果某个群没有出现，在那个群里随便发一条消息，App 就会捕获到该群并加入列表。

✓ 原理： App 通过 Bot Token 调用 Telegram API 自动发现 Bot 所在的所有群，并把群名直接显示在选择列表里。
9:46●●●
← 选择 Telegram 群
Bot 已加入的群（自动显示）
（未设置）
1WG – Lander For Sale
✓
2WG – Lander For Rent
3WG – Apartment For Sale
4WG – Apartment For Rent
7WG – Commercial
8WG – Other
3
WA Group 名称显示为 ID？
点击群详情页的「获取群名」按钮，一键拉取真实名称
原因说明

为什么会显示成 ID？

App 首次连接 WhatsApp 时，群列表里只有 JID（格式如 120363xxxx@g.us），真实群名还未被缓存。这种情况下，点进该群的详情页，右上角会出现 「获取群名」 按钮。

⚠ 前提： 必须先启动转发服务（WhatsApp 配对已完成、服务正在运行），「获取群名」按钮才能成功拉取。
9:41●●●
← 返回 120363052@g.us
获取群名
✎
基本信息
群 ID
120363052345678901@g.us
群名
（未获取，点右上角按钮）
设置
启用转发
点击后效果

群名自动填入并保存

点击「获取群名」后，App 会向 WhatsApp 查询该群的真实名称，自动填入并保存到本地数据库。页面标题和群列表都会立刻更新。

如果返回「WA 未返回群名」，通常是服务未运行或该 WhatsApp 账号已不在该群内。

✓ 备选方案： 点右上角铅笔图标（✎）→「设置别名」→ 手动输入你想显示的名称，同样可以保存。
9:42●●●
← 返回 Topsales KL
✎
基本信息
群 ID
120363052345678901@g.us
群名
✓ Topsales KL
设置
启用转发
4
添加转发规则
设置「AI 分类结果 → 转发到哪个 Telegram 群」的映射关系
第一步

进入 WA Group 设置页

在 App 底部导航点 Settings（设置） → 找到 WA Groups 列表 → 点击想要设置的群组 → 进入该群的详细配置页。

确认群已经开启转发（toggle 打开），才会处理来自该群的消息。

9:45●●●
← Topsales KL
基本设置
启用转发
默认转发群（无分类规则时）
-1001234567890
默认群名称
General Property
转发规则 → 点击添加
+ 添加分类规则
第二步

添加第一条分类规则

点击 「+ 新增」，填写两项：

• 分类名称：填写 AI 会返回的类别，例如 Landed 放售
• 目标群：从下拉列表选择 Telegram 群（Bot 已加入的群会自动出现）

点击保存，规则即刻生效。之后每当 AI 判断某条消息符合该分类，就会自动转发到对应 TG 群。

✓ 提示： 每种分类可以对应不同的 TG 群，例如 Landed 放售 → 有地产销售群，Apt 出租 → 公寓出租群。
9:46●●●
← 添加转发规则
AI 分类
LANDED_SALE ▾
目标 Telegram 群
1WG – Lander For Sale ▾
保存规则
完成效果

多条规则叠加，精准分发

重复以上步骤，为每种分类建一条规则，即可实现精准路由：

LANDED_SALE → 有地产销售群
LANDED_RENT → 有地产出租群
APT_SALE → 公寓销售群
APT_RENT → 公寓出租群
COMMERCIAL → 商业物业群
WTB / WTR → 买家求购群

没有匹配规则的消息会转到默认群，不会漏掉任何一条。

✓ 测试方法： 在 WA Group 发一条测试消息，几秒内检查对应 TG 群是否收到，同时在 App 的 Stats → AI Log 查看分类结果。
9:47●●●
← Topsales KL — 规则
LANDED_SALE
LANDED SALE 群
-1001234567890
✎
APT_RENT
公寓出租群
-1009876543210
✎
WTB
买家求购群
-1005555555555
✎
+ 添加规则
5
私聊转发 + Forum Topics（可选功能）
把 WhatsApp 私聊同步到 Telegram Forum，每个联系人自动分配独立 Topic
💡

这是什么功能？

除了群组消息，App 还能把你的 WhatsApp 私聊对话同步到 Telegram。每个 WhatsApp 联系人会在 Telegram Forum 群里自动创建一个独立的 Topic（话题），方便统一管理、搜索、归档，再也不怕私聊消息丢失。

✓ 适合场景：房产经纪人与客户、业主的私聊需要统一归档；或者不想漏看任何私人对话。
A

创建一个新的 Telegram 群组

打开 Telegram → 右上角铅笔图标 → New Group → 添加任意一个联系人（之后可踢走）→ 给群起名（如 私聊备份）→ 完成创建。

这个群之后会变成 Forum 群，专门用来存放私聊转发。

B

开启群组的 Topics 功能

进入刚创建的群 → 点击顶部群名称进入群详情 → 右上角铅笔图标（Edit）→ 向下滚动找到 Topics 开关 → 打开 → 保存。

⚠ 注意：开启 Topics 后，群组会自动升级为 超级群（Supergroup），群 ID 会改变。这是 Telegram 正常机制，App 会自动处理，无需担心。

开启后，群里会出现一个默认的 General topic。之后 App 会为每个 WhatsApp 联系人自动创建新的 topic。

C

把你的 Bot 添加到 Forum 群，设为管理员

进入 Forum 群 → 点群名称 → Add Members → 搜索并添加你的 Bot → 再进入 Administrators → 选择你的 Bot → 开启以下权限：

  • Post Messages（发消息）
  • Manage Topics（管理话题）— 必须开启
⚠ 如果没有开启 Manage Topics，Bot 无法自动创建联系人 Topic，私聊转发会失败。
第四步

在 App 设置里绑定 Forum 群

打开 App → 设置 → 向下滚动找到 「私聊转发」 卡片 → 点下拉框 → 选择刚才建好的 Forum 群（名字会自动出现）→ 重启转发服务生效。

如果 Forum 群没有出现在列表里，在那个群里随便发一条消息，然后再打开下拉框重试。

✓ 关闭方法：点下拉框右边的 ✕ 清除选择，私聊转发立即停止，群组和已有的 Topic 不受影响。
9:46●●●
← 设置
私聊转发
Forum 群（每个联系人独立 Topic）
私聊备份
✕ ▾
✓ 已保存
效果预览
💬 Forum 群 → Topics
Ali Hassan
Tan Wei Ming
Muthu Kumar
E

完成！私聊自动出现在 Forum Topics

下次有人给你发 WhatsApp 私聊，App 会：

  1. 自动在 Forum 群里为该联系人创建一个以 对方名字 命名的 Topic
  2. 把消息（文字、图片、语音等）转发到该 Topic
  3. 同一个人的所有消息都会归入同一个 Topic，不会混乱
✓ Telegram Forum 上限： 每个 Forum 群最多支持 1000 个 Topics，足够应对大量联系人。