配置指南管理员指南

连接个人 Telegram 渠道时需要做什么

面向管理员的图文指南：获取 API 凭据、在 ChatHub 中配置 MTProto，并连接个人 Telegram 账号。

ChatHub Team·阅读约 8 分钟

开始之前#

本文面向通过 MTProto 配置个人 Telegram 账号的管理员，涵盖共用的 Telegram 应用凭据，以及在 ChatHub 中收发消息所需的单独账号登录。

API ID / API Hash 用于标识应用，在各个个人 Telegram 渠道之间共用。每个账号仍需要各自的手机号和登录验证。Telegram 机器人使用的是单独的 bot token；切勿把 bot token 填进 API Hash。

登录后，Your Telegram Core 会显示三个选项。选择 API development tools 打开应用详情，如下图所示。

如果账号已经创建过应用，Telegram 会直接打开 App configuration。否则请填写 Telegram 的应用表单以获取 API ID 和 API Hash。下图展示的是已有应用的情况。

1
复制 App api_id（位置 1）旁边的值，粘贴到 ChatHub 的 API ID。
2
复制同一页面上 App api_hash（位置 2）旁边的值，粘贴到 ChatHub 的 API Hash。
3
App title 和 Short name 是应用名称，不是连接凭据，不能用来代替 API ID / API Hash。
4
只需复制页面顶部这两个 API 值。为已有应用获取凭据时，无需修改 FCM credentials、WNS credentials 或 Available MTProto servers，也不用在 Telegram 中点击 Save changes。接着按下面第 3 步在 ChatHub 中保存即可。

请妥善保管 API Hash、登录验证码和两步验证密码。两张已登录状态的截图来自真实会话；在放入本文之前，API ID、API Hash 和应用名称都已完全遮挡。不要把真实凭据放进截图、支持工单或源代码。

API Hash (đã lưu) 表示已经保存过 hash。输入框为空属于正常现象：ChatHub 不会把已保存的密文回传给浏览器。留空即保持当前 hash 不变。更换 Telegram 应用时，ID 和 Hash 要同时更新为配套的值。

hash 会在保存前加密。这些设置的优先级高于 TELEGRAM_API_ID / TELEGRAM_API_HASH 环境变量，且无需重启即时生效。

“已配置”只表示已保存 API Hash，并不能证明这对凭据可用或 Telegram 账号已连接；接下来还需要完成账号登录。

1
打开 Quản trị → Kênh（管理 → 渠道），地址为 /channels。该账号管理页面与设置中的“渠道”标签页是两个不同的地方。
2
新增渠道账号：点击 Thêm tài khoản（添加账号）→ Telegram cá nhân（个人 Telegram，手机号）→ Tạo tài khoản（创建账号）。
3
已有渠道账号：在其卡片上点击 Mở cấu hình（打开配置），找到 Đăng nhập Telegram（Telegram 登录）。注意不要重复创建渠道账号。

1
在 Số điện thoại 中填写该账号的手机号。国外号码需带 + 和国家代码；本地号码 ChatHub 也会自动规范化。
2
点击 Gửi mã xác thực（发送验证码）。查看 Telegram，把验证码填入 Mã xác thực 并点击 Xác nhận mã（确认验证码）。请按 ChatHub 显示的发送方式操作。
3
如有提示，填写 Mật khẩu hai bước（两步验证密码）并点击 Xác nhận mật khẩu（确认密码）。这是 Telegram 账号密码，不是 API Hash。
4
等待账号连接成功的提示或 Đã kết nối（已连接）状态。请勿把登录验证码告诉他人。