开发集成
渠道接入
飞书、企业微信、钉钉、微信等渠道通过模块服务与工作区绑定。
渠道接入可以把飞书、企业微信、钉钉、微信等外部入口连接到百积木工作区。绑定后,用户可以在对应平台中向应用或智能体发送消息。
绑定流程
先在第三方平台完成授权,再在百积木中选择工作区、应用或智能体,并填写回调地址、密钥和事件订阅配置。保存后发送一条测试消息。
消息检查
消息没有回复时,按以下顺序查看日志:
- 第三方平台是否已推送回调。
- 百积木渠道配置是否收到消息。
- 绑定的应用或智能体是否执行。
- 回复消息是否发送回原渠道。
常见检查点
- 第三方平台回调地址是否指向目标环境。
- 工作区渠道配置是否写入正确租户。
- 回调消息是否携带可识别的用户身份。
- 运行时是否能找到对应应用和会话。
从应用和工作流主动发送消息
消息正文使用统一内容协议(Content Parts),通过 content[] 组合文字和媒体片段。
渠道开通后,给指定同事发送企业微信私聊、向已绑定群聊发消息或回复原渠道会话,见 组织级基础能力:渠道与会话消息。 该教程包含接收人绑定、真实渠道发现、外部会话键和工作流节点示例。
管理员需要通过 API 查询连接、管理会话策略或绑定用户时,使用渠道资源管理 API,以 Runtime 和完整 Module Locator 选择渠道提供方。