Telegram API 对接项目：开发前需要确认的事项

Telegram API 对接可以把消息通知、用户操作和业务系统连接起来。项目开始前要先确认使用的是 Bot 能力还是其他客户端集成方式，因为二者的权限和适用场景不同。

确认接口边界

列出需要发送或接收的数据、触发条件、目标用户和异常情况。不要默认接口能够读取所有群组或个人信息，实际能力应以官方文档和账号授权为准。

处理失败与重复事件

网络故障、用户屏蔽机器人和服务端限流都可能导致消息未送达。系统应记录状态、按策略重试，并避免重复执行产生副作用的操作。

管理密钥与个人数据

Bot Token 应存放在受控的服务端配置中，避免进入前端代码和公开仓库。对话资料应按业务需要收集、限制访问并设置删除机制。