需完成miro与slack双向集成:一、miro启用slack通知并授权获取webhook url;二、slack创建incoming webhook并复制url;三、miro白板配置slack通知规则及事件类型;四、slack中使用/miro命令快捷操作;五、验证版本权限、应用状态、url有效性及日志状态码。

如果您希望在Miro中实现团队协作动态实时同步至Slack,例如白板更新、评论提及或新成员加入等事件自动推送通知,则需完成Miro与Slack之间的双向集成配置。以下是实现该功能的具体步骤:
一、启用Miro中的Slack通知功能
此步骤用于在Miro工作区级别开启Slack集成开关,并授权基础事件推送能力。Miro需识别Slack应用身份并建立安全通信通道。
1、登录Miro企业版管理控制台,进入“Settings”→“Integrations”页面。
2、在搜索栏输入“Slack”,点击对应集成卡片右侧的“Enable”按钮。
3、系统将跳转至Slack权限授权页,确认授予以下权限:channels:read, groups:read, im:read, mpim:read, chat:write, incoming-webhook。
4、授权完成后,Miro将生成一个唯一的Webhook URL,该URL必须保存至后续Slack端配置使用。
二、在Slack中创建专用Incoming Webhook
此步骤用于在Slack侧创建接收Miro事件的入口点,确保通知消息能以机器人身份准确投递至指定频道。
1、访问Slack API Apps 页面,使用管理员账号登录目标工作区。
2、点击“Create New App”,选择“From scratch”,填写应用名称(如“Miro-Notifier”)及开发工作区。
3、在左侧菜单中进入“Features”→“Incoming Webhooks”,将开关设为On。
4、点击“Add New Webhook to Workspace”,选择目标频道(如#miro-updates),确认授权。
5、复制生成的Webhook URL,该URL格式为https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX。
三、配置Miro白板级Slack通知规则
此步骤用于为特定Miro白板设定触发条件与推送目标,支持按事件类型精细化控制通知内容与范围。
1、打开目标Miro白板,点击右上角“⋯”更多选项,选择“Notifications”。
2、点击“Add notification”,选择“Slack”作为通知渠道。
3、粘贴第二步中获取的Slack Webhook URL。
4、勾选需触发通知的事件类型:Board comments, Mentioned in comment, New collaborator added, Frame changes。
5、点击“Save”,系统将发送测试消息至对应Slack频道以验证连通性。
四、使用Miro Slack Bot执行快捷操作
此方法通过Slack内嵌指令直接调用Miro服务,无需跳转平台即可创建白板、插入链接或检索内容,提升上下文连续性。
1、在Slack任意频道中输入斜杠命令:/miro create whiteboard。
2、根据Bot提示输入白板标题(如“Q2 OKR Planning”),选择模板类型(Blank / Mind Map / SWOT)。
3、确认后,Bot将在Miro中创建白板并返回可点击链接,同时自动将链接发布至当前Slack频道。
4、后续可在Slack中使用/miro search "user research"检索含关键词的公开白板。
五、验证与故障排查关键检查项
当通知未如期送达时,需逐项核验基础链路状态,避免因权限或配置错位导致静默失败。
1、检查Miro工作区是否为企业版或Business版——Free版不支持Slack集成。
2、确认Slack应用已安装至目标频道且未被禁用——在频道设置中点击“Apps”,查找“Miro”是否显示为激活状态。
3、验证Webhook URL是否被意外修改或过期——重新生成URL并在Miro通知设置中覆盖更新。
4、查看Miro集成日志(Settings → Integrations → Slack → “View logs”)中最近三条记录的状态码,HTTP 200表示成功,403通常为权限不足,404指向URL失效。











