开发文档

Telegram 隐私规则、通讯录与黑名单

理解手机号查询限制、隐私规则与黑名单的作用范围,避免将无法查询误判为号码没有注册。

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

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

本页内容
  1. 隐私规则按能力生效
  2. 查询不到不代表没有注册
  3. 黑名单有不同范围
  4. 实现建议

隐私规则按能力生效

PrivacyKey 与规则共同控制他人能做什么,另有全局隐私设置。修改后需要处理同步更新;不能只改当前设备的开关。新联系人发消息可能受到 Premium 或付费消息设置影响。

查询不到不代表没有注册

联系人导入和手机号查询受对方隐私设置影响。某些查询错误既可能表示没有账号,也可能表示不允许被号码查询,因此不能把查询结果作为公开的注册状态证明。

黑名单有不同范围

普通黑名单与动态黑名单分开。拉黑变更会同步到当前账号的其他会话,但被拉黑的人不会收到对应的系统更新。若客服产品需要明确提示,应该在自己的业务流程中设计通知,不能假设 Telegram 自动代发。

实现建议

只在用户明确授权时上传通讯录,避免后台持续扫描号码。保存数据前明确用途和保留周期。批量替换黑名单应先核对完整集合,避免把局部结果误当成全量而解除其他限制。