上线检查

所有接入都要检查

• 环境一致：API 地址、账号、资源和凭证都属于目标品牌与环境。
• 权限最小化：运行时使用对应凭证，不把账号 JWT 当成长期服务端 Token。
• 凭证可轮换：密钥保存在服务端，确认替换凭证后服务仍能正常运行。
• 失败可恢复：区分鉴权错误、权限错误、限流和临时故障；使用有上限的退避重试。
• 结果可观测：日志能关联一次请求和业务结果，且没有明文密钥。

机器人与事件投递

• 机器人已审核且启用，并已加入目标会话；按群隐私规则测试命令、提及和回复。
• Webhook 与 getUpdates 二选一；切换方式后确认旧消费者已停止。
• Webhook 使用 HTTPS，并按时间戳和原始请求体验签；收到重复 Update 时不重复执行业务。
• 轮询按 update_id 推进 offset；模拟重启和重连，确认不会漏消费已接收但未处理的事件。
• 制造一次可控投递失败，检查投递日志、重试与恢复后的业务结果。

Webhook · 轮询指南 · 配额

开放应用与联享券

• 确认应用启用、模板已审核、Token 的 scopes 与实际操作匹配，来源策略允许真实调用方。
• 按 API 契约配置幂等键；模拟请求超时后重试，核对同一业务操作没有重复发券或履约。
• 验证无效、过期、已核销的券，以及核销成功后业务系统履约失败的补偿流程；冲正需要相应权限。
• 如果环境要求请求加密，验证加密与解密路径，不要以关闭保护作为上线方案。

API 与鉴权 · 请求加解密

留下可复现的验收记录

记录环境、资源 ID、测试时间、脱敏请求、响应状态和业务结果。失败时保留请求 ID 或 Update ID，便于和控制台投递记录对照。不要记录完整 Token、密码或访客隐私数据。