Skip to main content
渠道把一个专家接到 IM 平台的机器人上,团队在熟悉的聊天窗口里直接对话,不用切到网页端。

支持的平台

QQ 未实现。四个平台都支持扫码快速接入与手动填写凭证两种模式。

一个关键前提:积分算在绑定者头上

绑定关系是「机器人 → 一个袋袋用户 + 一个专家」。消息进来后,系统按机器人的 App ID 查出这条绑定,用绑定者的身份发起调用。
群里所有人和这个机器人说话,消耗的都是绑定这个渠道的那个账号的积分,不是各自的账号。IM 侧不做逐人身份识别,也没有「先绑定袋袋账号才能用」的流程。所以:把机器人放进大群前,先想清楚这笔账记在谁头上。
绑定被删除后,该机器人的消息会被直接丢弃,并自动卸载对应的适配器——不会报错给群里。

会话怎么隔离

也就是说群里两个人各自有独立的上下文,互相看不到对方的对话历史,尽管消息发在同一个群里。

消息怎么发出来

回复采用分段气泡:内容攒够一定长度就发一段,不会等全部生成完才发。 分段点会避开代码块中间:正处在代码围栏里时会继续攒到上限再切,不会把一段代码劈成两条消息。 工具执行会先发一条状态提示(比如「正在搜索…」),委派其他专家时也会提示「正在咨询 X」。
「原地编辑」式的流式输出(消息气泡内容持续刷新)在代码里是关闭状态——企业微信和钉钉的适配器都把这个开关设为关。所有平台目前都走分段气泡

群聊里的 @

在群里,未 @ 机器人的消息不会触发回复,但也不会丢:它们进一个待合并缓冲区,等你下一次 @ 机器人时一起带上。 这是为飞书的限制做的补偿——飞书不允许同时上传文件和 @ 机器人,所以「先发文件、再 @ 说要求」是常见用法。 缓冲区有界:单个「群 + 人」最多存 10 条、总文件 50 MB、保留 30 分钟,超出的按先进先出丢弃。

文件与图片

可以在 IM 里直接发文件和图片给专家:单个文件上限 15 MB,超过的会被跳过(日志里有记录,用户侧只是没被处理)。文件会被转成数据流上传到对象存储,与网页端上传走同一条路径。 专家产出的文件也会回传到聊天里。

命令

飞书用户授权

不授权时,专家用机器人身份调飞书接口——创建出来的文档属于机器人,你可能看不到。/auth 走设备码授权:机器人发一张卡片,你点按钮完成授权(授权码默认 10 分钟内有效),之后创建的文档归属于你本人 令牌过期会自动刷新;刷新令牌失效时回落到机器人身份,工具报权限错误时重新 /auth 即可。

计费与试用

  • 消耗按绑定者账户结算,规则与网页端完全一致
  • 试用轮次在 IM 与网页端共享(同一个专家、同一个账号)
  • 试用用完时,IM 会回一条错误提示并附上该专家的网页购买链接(IM 内没有购买界面)
  • 最后一轮免费试用结束时会主动提醒一次,避免下一条消息突然被拒

IM 用不了什么

失败与对策

各平台详细指南

飞书接入

配置步骤与 OAuth 授权

钉钉接入

钉钉机器人配置

企业微信接入

企业微信应用配置

微信接入

微信公众号配置