---
url: /zh/build/showcase/pr-notice-group.md
description: |
  介绍如何配置流水线，在 PR 创建、更新或评审状态变更时自动发送通知到企业微信群， 包含完整的 Webhook 配置示例。
---
## 添加群机器人

在企业微信群中添加机器人，复制 Webhook 地址。

## 配置流水线

通知的核心是 `tencentcom/wecom-message` 插件，通过 `content` 字段自定义消息内容。
Webhook 地址建议通过 `env` 注入（敏感信息勿硬编码），下方示例用 `WECOM_ROBOT` 统一引用。

以下完整示例展示了 `pull_request`、`pull_request.changes_requested`、
`pull_request.merged` 三个常用事件的配置，通过 `env` 统一注入企业微信群机器人
Webhook 地址（敏感信息勿硬编码），各事件配置结构相同，仅需调整事件名和
`content` 即可：

```yaml title=".cnb.yml"
env:
  WECOM_ROBOT: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx
main:
  # PR 创建或更新时通知
  pull_request:
    - stages:
        - name: notice
          image: tencentcom/wecom-message
          settings:
            robot: $WECOM_ROBOT
            content: |
              > **PR 需要评审：**
              > **标题:** ${CNB_PULL_REQUEST_TITLE}
              > **发起人:** ${CNB_PULL_REQUEST_PROPOSER}
              > [查看详情]($CNB_EVENT_URL)

  # 有评审建议时通知
  pull_request.changes_requested:
    - stages:
        - name: notice
          image: tencentcom/wecom-message
          settings:
            robot: $WECOM_ROBOT
            content: |
              > **${CNB_BUILD_USER} 提出了修改建议**
              > **标题:** ${CNB_PULL_REQUEST_TITLE}
              > [查看详情]($CNB_EVENT_URL)

  # PR 合并后通知
  pull_request.merged:
    - stages:
        - name: notice
          image: tencentcom/wecom-message
          settings:
            robot: $WECOM_ROBOT
            content: |
              > **PR 已合并**
              > **标题:** ${CNB_PULL_REQUEST_TITLE}
              > [查看详情]($CNB_EVENT_URL)
```

其他 PR 事件（如 `pull_request.mergeable`）配置方式相同，仅需调整事件名和 `content` 即可。
`pull_request.mergeable` 可搭配 `git:auto-merge` 内置任务实现自动合并后再通知。

可用变量请参考 [环境变量](../env.md)。