百积木文档
开发集成

渠道接入

飞书、企业微信、钉钉、微信等渠道通过模块服务与工作区绑定。

渠道接入可以把飞书、企业微信、钉钉、微信等外部入口连接到百积木工作区。绑定后,用户可以在对应平台中向应用或智能体发送消息。

绑定流程

先在第三方平台完成授权,再在百积木中选择工作区、应用或智能体,并填写回调地址、密钥和事件订阅配置。保存后发送一条测试消息。

消息检查

消息没有回复时,按以下顺序查看日志:

  1. 第三方平台是否已推送回调。
  2. 百积木渠道配置是否收到消息。
  3. 绑定的应用或智能体是否执行。
  4. 回复消息是否发送回原渠道。

常见检查点

  • 第三方平台回调地址是否指向目标环境。
  • 工作区渠道配置是否写入正确租户。
  • 回调消息是否携带可识别的用户身份。
  • 运行时是否能找到对应应用和会话。

从应用和工作流主动发送消息

消息正文使用统一内容协议(Content Parts),通过 content[] 组合文字和媒体片段。

渠道开通后,给指定同事发送企业微信私聊、向已绑定群聊发消息或回复原渠道会话,见 组织级基础能力:渠道与会话消息。 该教程包含接收人绑定、真实渠道发现、外部会话键和工作流节点示例。

管理员需要通过 API 查询连接、管理会话策略或绑定用户时,使用渠道资源管理 API,以 Runtime 和完整 Module Locator 选择渠道提供方。

本页内容