跳到主要内容

常见问题

下面这些问题,通常都出现在后台配置和首次联调阶段。

常见问题

为什么我创建了 Bot,但不能直接加群?

检查 Bot 配置中的"允许被搜索或直接加入群聊"开关是否已开启。如果关闭,群主或管理员无法在客户端直接将 Bot 拉入群聊。另外,如果目标群聊开启了端到端加密,Bot 也无法处理其中的消息

为什么命令没有生效?

可以从以下几个方面排查:

  • 是否已加入群聊:Bot 需要先进入目标群聊才能响应命令
  • 命令格式是否正确:发送时需要带上 @yourbot 后缀(如 /help @yourbot
  • 群聊是否开启加密:端到端加密会话中 Bot 无法收到消息事件
  • 生效范围配置:检查命令的生效范围是否覆盖了当前群聊
  • 默认回复是否配置:如果只配了回调地址但服务端未正确响应,命令也可能无反应

为什么重置 token 后原来的脚本报错?

重置 token 后,旧的 bot_token 会立即失效。所有使用旧 token 的脚本或服务需要更新为新的 token 才能继续调用接口。

哪些场景适合先用后台配置,哪些需要进入 API 接入?

  • 后台配置:适合快速体验流程、测试命令和默认回复、管理 Bot 基础信息。不需要写代码就能让 Bot 跑起来。
  • API 接入:适合需要自动化消息收发、处理回调事件、深度集成到自有服务中的生产场景。后台配置好命令后,配合 API 可以完成完整的消息闭环。