learning
发布到多平台
当前阅读:进阶视角
本单元目标
学完本单元后,你将能够独立完成一个扣子 Bot 的发布配置,在微信、飞书、Web 三个渠道上分别上线,并掌握各渠道的审核与调试差异。
概念讲解
“发布到多平台”本质上是在解决 Bot 的分发问题。在扣子(Coze)中,一个 Bot 的“大脑”(工作流、知识库、模型参数)是独立于“身体”(渠道适配层)存在的。你可以把 Bot 想象成一个演员,剧本和演技是核心资产,而微信、飞书、Web 则是不同的剧场——每个剧场的舞台尺寸、观众互动方式、甚至灯光规则都不同。扣子的发布机制正是通过“渠道适配器”将同一套逻辑翻译成各平台能理解的协议。
关键在于理解三个差异点:触发方式、消息格式和审核策略。微信订阅号要求被动回复且 5 秒内响应,飞书则支持主动推送卡片消息且对延迟容忍度更高,Web 渠道几乎无限制但需要处理 CORS 跨域。这意味着你的 Bot 在飞书上可以输出富文本卡片,在微信里则可能退化为纯文本。扣子通过“发布配置”面板让你为每个渠道单独设置欢迎语、菜单和回复模板,而不是一刀切的全局配置。高级用法是:利用“变量”在不同渠道间传递用户状态,例如在 Web 端收集的偏好设置,在飞书端读取时依然有效,但要注意各渠道的会话保持机制不同——微信的 session 是 48 小时,飞书则是永久。
实操演练
- 在扣子控制台打开目标 Bot,点击右上角“发布”按钮,在弹窗中勾选“微信客服”、“飞书”和“Web 应用”三个渠道。
- 为微信渠道填写 AppID 和 AppSecret(从微信公众平台获取),并配置“自动回复”兜底话术,确保 5 秒内无命中时返回友好提示。
- 为飞书渠道完成 OAuth 授权,在“事件订阅”中勾选 `im.message.receive_v1`,并将消息卡片模板切换为“自适应宽度”以适配移动端。
- 为 Web 渠道生成专属嵌入代码,复制 `<script>` 标签,粘贴到任意 HTML 页面的 `<body>` 末尾,并设置 `allowed-origins` 白名单为你的域名。
- 依次点击各渠道的“提交审核”,微信通常需要 1-3 个工作日,飞书即时生效,Web 渠道提交后立即返回一个预览链接,可先自测。
练习任务
- 将你的 Bot 同时发布到飞书和 Web 渠道,并在飞书内发送一条包含图片的消息,验证卡片是否正常渲染、Web 端是否同步显示相同内容。
- 修改 Web 渠道的欢迎语为“来自网页的访客”,并在飞书渠道设置不同的欢迎语,分别触发一次对话,截图对比两端的回复差异。