Notify via Slack 步骤
从工作流添加 Slack 通知分为两个部分:
- 创建 Slack Webhook 外部连接
- 将 Slack 通知步骤添加到工作流
将 Slack 通知步骤添加到工作流
Section titled “将 Slack 通知步骤添加到工作流”将 Slack 通知步骤添加到工作流与添加其他步骤相同。添加步骤后,打开步骤配置,填写表单并保存。随后即可测试 Slack 通知。
在要上传的文件中选择一个文档,即可将其连同消息(作为其评论)一起发送到频道。Webhook 无法携带文件,因此附件需要通过 Slack 连接上的机器人令牌发送:
- 向连接添加机器人令牌。它是具有
files:write范围的 Slack 应用的xoxb-令牌,并且该应用必须已被邀请加入该频道。 - 在步骤中输入频道 ID,例如
C0123ABCD,而不是频道名称。Slack 的文件上传只接受 ID,没有 ID 则步骤会失败。要查找 ID,请在 Slack 中打开频道详情并滚动到底部。 - 如果找不到该文档,消息将通过 Webhook 发送但不带该文档,步骤会给出带有该文档路径的警告。
设置 Slack 消息的格式
Section titled “设置 Slack 消息的格式”Slack 提供多种格式设置选项,包括添加图像和提及用户。详情请参阅 Slack 文本格式设置文档。
创建 Slack Webhook 外部连接
Section titled “创建 Slack Webhook 外部连接”这是一次性设置,允许 PlaidCloud 代表您发送 Slack 通知。Slack 允许创建 Webhook 应用(通过互联网发送通知的通用方式)。在 Slack 中创建 Webhook 应用后,将提供的凭据添加到 PlaidCloud 即可使用它。
创建 Slack Webhook 应用
Section titled “创建 Slack Webhook 应用”这些步骤需要由 Slack 管理员执行。请按以下步骤创建 Slack Webhook 应用:
- 在 Slack 中,打开工作区控制菜单并选择
Settings & administration > Manage Apps - 从应用类别列表中选择
Custom Integrations - 从应用列表中选择
Incoming Webhooks - 选择
Add to Slack按钮 - 在下一个屏幕上,选择要发布消息的 Slack 频道并继续。这是将使用的默认频道,但可以在每条通知中覆盖,包括向特定个人发送私信。
- 复制显示的 Webhook URL。稍后会用到,请妥善保管。它看起来类似于:
https://hooks.slack.com/services/T04QZ1435/G02TGBFTOP8/K9GZrR2ThdJz1uSiL9YeZxoR - 保存之前可以自定义外观、名称和表情符号。这些自定义只是默认值,可以在 PlaidCloud 工作流内的每个通知步骤上覆盖。
设置 PlaidCloud 外部连接
Section titled “设置 PlaidCloud 外部连接”这些步骤需要由具有创建外部数据连接权限的 PlaidCloud 工作区管理员执行。请按以下步骤创建连接:
- 导航到
Analyze > Tools > External Data Connections - 在
+ New Connection选项下,选择 Slack Webhook - 填写名称、描述,并粘贴上文第 6 步中提供的 Webhook URL。此处提供的名称将显示为工作流步骤中的选项,因此应尽可能具有描述性。任何持有该 URL 的人都可以向您的频道发帖,因此 Webhook URL 字段会在您粘贴时将其遮蔽,并在您重新打开连接时显示为空;保持为空即可保留已保存的 URL。
- 若要发送附件,还需将 Slack 应用的机器人令牌粘贴到机器人令牌(用于上传文件) 字段中。连接可以保存 Webhook URL、机器人令牌,或两者都保存。机器人令牌与 Webhook URL 一样会被遮蔽,并在您重新打开连接时显示为空。
- 选择
+ Create按钮
暂无示例…