接入方式
扫码快速接入(推荐)
扫码快速接入(推荐)
几分钟完成配置:
- 在专家 Studio 的「渠道接入」中选择企业微信
- 点击「扫码接入」
- 使用企业微信管理员账号扫描二维码
- 确认授权,系统自动完成配置
- 在企业微信中搜索应用名开始测试
手动配置
手动配置
需要精细控制权限时选择手动方式:
1
创建企业微信应用
登录企业微信管理后台,进入「应用管理」→「自建」→ 创建应用。填写应用名称、图标和可见范围。
2
配置接收消息
在应用详情的「接收消息」设置中,开启 API 接收消息。将袋袋提供的回调 URL 填入,同时记录下 Token 和 EncodingAESKey。
3
获取凭证
记录应用的 AgentId,以及企业的 CorpId 和应用 Secret。
4
填入袋袋
将 CorpId、AgentId、Secret、Token 和 EncodingAESKey 全部填入袋袋的渠道配置面板。
5
验证回调
保存配置后,企业微信会向回调地址发送验证请求。袋袋服务会自动完成验证。
消息投递:编辑模式
企业微信渠道的消息风格与其他平台不同:企业微信采用「编辑模式」(StreamBridge)——专家的回复在同一条消息中实时更新,而非发送多条消息气泡。类似于你在网页端看到的打字机效果。
编辑模式的优势
工具调用展示
当专家调用工具时,消息内容会更新为当前执行状态(如「搜索中…」),完成后替换为最终回复内容。整个过程在一条消息内完成。使用方式
应用内对话
在企业微信的「工作台」中找到配置好的应用,点击进入对话界面,直接发送消息。单聊
在通讯录中找到应用机器人,发送消息开始一对一对话。配置步骤详解(手动模式)
1
企业微信管理后台创建应用
在「应用管理」→「自建」中创建应用,设置:
- 应用名称(建议与专家名称一致)
- 应用图标
- 可见范围(选择哪些部门/人员可以使用)
2
开启 API 接收消息
进入应用详情 →「接收消息」→ 设置 API 接收:
- URL:填入袋袋提供的回调地址
- Token:自动生成或自定义
- EncodingAESKey:自动生成或自定义
3
配置可信域名
在「企业可信 IP」中添加袋袋服务的出口 IP(如有需要)。
4
提交袋袋配置
在袋袋专家 Studio 的渠道配置中填入所有凭证,点击保存。
5
测试
在企业微信中给应用发送测试消息,确认收到正常回复。
注意事项
常见问题
消息验证失败
消息验证失败
确认 Token 和 EncodingAESKey 在袋袋配置和企业微信配置中完全一致。注意不要有多余的空格。
应用看不到/找不到
应用看不到/找不到
确认你的企业微信账号在应用的「可见范围」内。如果刚修改了可见范围,可能需要等待几分钟生效。
回复内容不完整
回复内容不完整
企业微信单条消息有字数限制。如果专家的回复超过限制,会在达到限制时截断。建议在专家配置中适当控制回复长度。
相关页面
渠道总览
了解所有 IM 平台概况
微信接入
微信公众号渠道配置

