Duaer

集成

在 Duaer 里用 Slack 审批

用 Duaer Slack 节点的 Send and Wait for Response,审批人直接在 Slack 里点按钮批准或拒绝,工作流程随即继续,并记录是谁点的。

Duaer 的 Slack 审批和链接按钮的区别

  • 链接按钮(默认):点了在浏览器里打开 Duaer 页面确认;任何拿到链接的人都能响应;输出只有 approved 和 respondedAt。
  • Slack 内审批:在 Slack 里一次点击完成;可限定审批人;Duaer 用 Slack 请求签名校验每次回调;输出还带响应人、频道和消息。

前提条件

  • Slack 能通过公网 HTTPS 访问你的 Duaer。
  • 一个 Slack 凭证(访问令牌或 OAuth2),Signature Secret 已填应用的 Signing Secret。没填时按钮能显示,但点击不会让工作流程继续。
  • 要在输出里带邮箱,应用需要 users:read 和 users:read.email 授权范围;缺了只是不带邮箱。

1. 创建 Slack 应用和凭证

按 Slack 凭证 创建应用和凭证,授权范围里加上 users:read 和 users:read.email。

2. 打开 Interactivity

  1. 在 Slack API Apps 打开应用,进入 Interactivity & Shortcuts,打开 Interactivity。
  2. Request URL 填 https://<你的 Duaer 地址>/webhook-waiting-slack,保存。实例上所有工作流程共用这一个地址;改过 DUAER_ENDPOINT_WEBHOOK_WAIT 时按新路径改。

一个 Slack 应用只能填一个 Request URL,所以一个应用只对应一个 Duaer 实例。

3. 把 Signing Secret 填进凭证

在 Slack 应用的 Basic Information → App Credentials 复制 Signing Secret,填进 Duaer Slack 凭证的 Signature Secret。校验失败的回调会被拒绝,工作流程继续等待。

4. 配置节点

Slack 节点选 Message → Send and Wait for Response,Response Type 选 Approval。Advanced Interactivity 下:

  • Capture Who Responded:打开后按钮改为 Slack 交互按钮,并记录响应人。下面几项在打开后出现。
  • Restrict Who Can Approve:限定可以操作的用户。名单外的人点击后收到一条只有自己能看到的提示,工作流程继续等待。留空则能看到消息的人都能响应。
  • Unauthorized Reply:给名单外的人看的提示,默认 You are not authorized to respond to this request.
  • After Decision:Show Outcome and Remove Buttons(默认,去掉按钮并写上结果和响应人)、Remove Buttons Only、Keep Message Unchanged(以第一次决定为准)。

名单只限制谁能响应,不限制谁能看到。敏感审批请发到私有频道或私信。

节点输出

{
  "data": {
    "approved": true,
    "respondedAt": "2026-09-29T08:00:00.000Z",
    "channel": "C0123ABC456",
    "messageId": "1759132800.123456",
    "responder": { "id": "U0123ABC456", "name": "Jo Doe", "username": "jo.doe", "email": "jo@example.com", "source": "slack" }
  }
}

Response Type 是 Free Text 或 Custom Form,或者 Capture Who Responded 关着时,仍然发送链接按钮。

常见问题

Duaer 的 Slack 审批要把 Request URL 设成什么?

在 Slack 应用的 Interactivity 里填 https://<你的 Duaer 地址>/webhook-waiting-slack,Duaer 实例上的所有工作流程共用。

同组