# 配置消息推送

> 在设置中添加飞书或钉钉 Webhook，供批量任务等场景推送通知。

Canonical page: /product/webhook



入口：**设置 → 消息推送**。用于把任务完成等事件推送到群机器人（常见为 **飞书 / 钉钉**）。凭据保存在本机（如 `~/.vetta/desktop-app/webhook-credentials.json` 一类路径）。

## 添加渠道 [#添加渠道]

在渠道列表中新增通道，典型字段包括：

| 字段          | 说明                             |
| ----------- | ------------------------------ |
| 类型          | 飞书 / 钉钉等（以客户端选项为准）             |
| 名称          | 列表中的显示名                        |
| Webhook URL | 机器人 Webhook 地址                 |
| 签名 Secret   | 可选；开启加签时填写                     |
| @ 相关        | 如 @所有人；钉钉可能还有 @手机号、关键词等（以表单为准） |

保存后可 **启用 / 停用**、**编辑**、**删除**，并 **发送测试消息** 验证。

## 谁会触发推送 [#谁会触发推送]

* **批量任务** 创建/编辑时若勾选 **启用消息推送**：每个子任务完成时推送一次，项目全部完成时再推送汇总。
* 其它产品能力是否推送，以当前客户端实现为准；未在界面声明的事件不要假定会触发。

## 安全 [#安全]

* Webhook URL 与 Secret 等同于写入群的权限，不要提交到仓库或公开分享。
* 测试消息会真实发到对应群，请在可接受的测试群验证。

## 相关页面 [#相关页面]

<Cards>
  <Card title="批量任务" href="/product/batch-tasks/" description="可在批量项目中启用消息推送。" />

  <Card title="故障排查" href="/troubleshooting/" description="其它运行问题。" />
</Cards>