开发文档

Telegram 群组、频道、论坛与频道私信

区分普通群、超级群、广播频道、论坛话题和频道私信,正确选择聊天类型与消息归属。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 相似界面不代表相同数据结构
  2. 论坛话题属于聊天内部
  3. 频道私信使用独立上下文
  4. 建模建议

相似界面不代表相同数据结构

超级群和广播频道都可能由 channel 构造器表示,需要读取相应标志。普通群的管理能力、迁移方式与超级群不同;gigagroup 的转换还存在不可逆条件。不要靠名称或成员数量推测类型。

论坛话题属于聊天内部

论坛在超级群中按话题组织消息;开启、管理和关闭相关功能需要相应权限。Bot 的 threaded mode 也能提供话题式界面,但具有独立设置和适用条件,不能与普通群论坛混用。

频道私信使用独立上下文

频道开启私信后会关联特殊的 monoforum。其会话按用户组织,使用 saved_peer_id 等字段;这与普通 forum topics 的线程结构不同。分享链接、消息定位和管理权限应以实际私信聊天为准。

建模建议

在数据模型里保留账号、peer、话题或子会话和消息四层身份。列表可统一展示,但权限检查、历史读取与发送路由按类型处理。迁移或转换后,应更新旧链接与缓存,避免把消息发到错误的上下文。