开发文档

Telegram 动态、已读状态与实时位置

区分动态发布资格、消息已读、内容已读、浏览统计与位置共享,避免错误承诺阅读回执。

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

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

本页内容
  1. 发布前检查资格,发送时仍处理失败
  2. 已读与浏览量不是一回事
  3. 实时位置需要可以停止
  4. 产品实现建议

发布前检查资格,发送时仍处理失败

动态发布前可检查是否具备权限和可用名额,但其他设备操作会改变条件。预检查成功后,真正上传或发布仍可能返回限制。页面应以最终结果为准。

已读与浏览量不是一回事

不同聊天类型使用不同的已读方法;消息历史已读、具体内容已读、频道浏览计数及其他视口统计各有用途。不能因客服发送成功就显示“客户已读”,也不能把普通 Bot API 没有提供的回执从客户端 API 文档里移植出来。

实时位置需要可以停止

实时位置通过媒体消息和后续编辑更新,包含有效期等信息。停止共享有相应的结束动作。位置预览、接近提醒和已查看状态也不是普通文字消息。

产品实现建议

把“本地已展示”“平台已接受”和“对方已读”分开命名,只在存在对应证据时显示。位置权限由用户主动授予,持续共享应有明显标识与停止入口。重启后先恢复服务端状态,不自动开启上一轮已经结束的共享。