EdgeOne Makers 消息通知

部署完项目后，你肯定想知道部署成功了没有，或者部署失败了是什么原因。每次都要手动去控制台查看太麻烦，EdgeOne Makers 提供了消息通知功能，可以在部署成功或失败时自动发送通知。

通知类型

EdgeOne Makers 支持多种通知方式:

通知方式	说明	适用场景
邮件通知	发送邮件到你的邮箱	个人项目，简单直接
Webhook	发送 HTTP POST 请求到指定 URL	集成到企业微信、钉钉、飞书等
企业微信	推送到企业微信群机器人	团队协作，实时通知
钉钉	推送到钉钉群机器人	团队协作，实时通知
飞书	推送到飞书群机器人	团队协作，实时通知

配置邮件通知

步骤一: 进入通知设置

进入项目设置，点击”通知”标签。

步骤二: 添加邮件通知

点击”添加通知渠道”，选择”邮件”。

输入你的邮箱地址，选择要接收的通知类型:

通知类型	说明
部署成功	每次部署成功时发送
部署失败	每次部署失败时发送
部署开始	每次部署开始时发送
域名变更	绑定或解绑域名时发送
环境变量变更	修改环境变量时发送

选择后，点击”保存”。

步骤三: 验证邮箱

平台会发送一封验证邮件到你的邮箱，点击邮件里的链接确认。

验证完成后，邮件通知就配置好了。

邮件内容示例

部署成功时收到的邮件:

主题: [EdgeOne Makers] my-blog 部署成功

项目: my-blog
部署 ID: d-abc123
状态: 成功
触发方式: git push
分支: main
部署时间: 2026-08-18 10:00:00
访问地址: https://my-blog.edgeone.app

查看详情: https://console.edgeone.ai/projects/proj_abc123/deployments/d-abc123

部署失败时收到的邮件:

主题: [EdgeOne Makers] my-blog 部署失败

项目: my-blog
部署 ID: d-def456
状态: 失败
触发方式: git push
分支: main
部署时间: 2026-08-18 10:30:00
错误信息: Build failed with exit code 1

查看详情: https://console.edgeone.ai/projects/proj_abc123/deployments/d-def456
查看日志: https://console.edgeone.ai/projects/proj_abc123/deployments/d-def456/logs

配置 Webhook 通知

Webhook 是最灵活的通知方式，可以集成到各种第三方服务。

步骤一: 获取 Webhook URL

首先要有一个接收 Webhook 的 URL。这个 URL 可以是:

企业微信群机器人的 Webhook 地址
钉钉群机器人的 Webhook 地址
飞书群机器人的 Webhook 地址
自己搭建的 HTTP 服务

步骤二: 添加 Webhook 通知

在项目通知设置里，点击”添加通知渠道”，选择”Webhook”。

输入 Webhook URL，选择通知类型，保存。

Webhook 请求格式

EdgeOne Makers 发送的 Webhook 请求是 HTTP POST，Content-Type 是 application/json。

请求体示例:

{
  "event": "deployment.success",
  "project": {
    "id": "proj_abc123",
    "name": "my-blog",
    "url": "https://my-blog.edgeone.app"
  },
  "deployment": {
    "id": "d-abc123",
    "status": "success",
    "trigger": "git_push",
    "branch": "main",
    "commit_sha": "abc123def456",
    "commit_message": "update readme",
    "author": "zhangsan",
    "created_at": "2026-08-18T10:00:00Z",
    "completed_at": "2026-08-18T10:02:00Z"
  },
  "url": "https://console.edgeone.ai/projects/proj_abc123/deployments/d-abc123"
}

事件类型:

事件	说明
deployment.start	部署开始
deployment.success	部署成功
deployment.failed	部署失败
domain.added	添加域名
domain.removed	移除域名
env.changed	环境变量变更

验证 Webhook

为了确保 Webhook 请求是 EdgeOne Makers 发送的，不是伪造的，每个请求都会在 Header 里带上签名:

X-EdgeOne-Signature: sha256=abc123def456...

你可以在接收端验证这个签名:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return `sha256=${expectedSignature}` === signature;
}

配置企业微信通知

企业微信通知本质上也是 Webhook，只是 URL 格式固定。

步骤一: 创建群机器人

在企业微信群里，点击右上角的设置，找到”群机器人”，点击”添加机器人”。

给机器人起个名字，比如”EdgeOne 部署通知”，点击”添加”。

创建后会生成一个 Webhook URL，格式是:

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx

步骤二: 配置通知

在 EdgeOne Makers 通知设置里，选择”企业微信”，粘贴刚才的 Webhook URL，选择通知类型，保存。

通知效果

部署成功时，企业微信群里会收到一条消息:

EdgeOne Makers 部署通知

项目: my-blog
状态: ✅ 成功
分支: main
提交: abc123 update readme
时间: 2026-08-18 10:00:00
地址: https://my-blog.edgeone.app

部署失败时:

EdgeOne Makers 部署通知

项目: my-blog
状态: ❌ 失败
分支: main
提交: def456 fix bug
时间: 2026-08-18 10:30:00
错误: Build failed with exit code 1
日志: https://console.edgeone.ai/projects/proj_abc123/deployments/d-def456/logs

配置钉钉通知

钉钉通知也是 Webhook 方式。

步骤一: 创建群机器人

在钉钉群里，点击右上角的设置，找到”智能群助手”，点击”添加机器人”。

选择”自定义”机器人，给机器人起个名字，设置安全设置（建议选”加签”）。

创建后会生成一个 Webhook URL。

步骤二: 配置通知

在 EdgeOne Makers 通知设置里，选择”钉钉”，粘贴 Webhook URL，保存。

配置飞书通知

飞书通知同样是 Webhook 方式。

步骤一: 创建群机器人

在飞书群里，点击右上角的设置，找到”群机器人”，点击”添加机器人”。

选择”自定义机器人”，给机器人起个名字，保存。

创建后会生成一个 Webhook URL。

步骤二: 配置通知

在 EdgeOne Makers 通知设置里，选择”飞书”，粘贴 Webhook URL，保存。

通知规则

可以配置更细粒度的通知规则。

按分支配置

比如:

main 分支部署失败时通知
develop 分支部署不通知
feature 分支部署成功时通知

在添加通知渠道时，可以选择只对哪些分支生效。

按通知类型配置

可以组合不同的通知类型:

场景	推荐配置
生产环境	部署失败时通知，成功时不通知
测试环境	部署成功和失败都通知
预览环境	不通知，避免打扰

通知频率

如果部署很频繁，可能会收到很多通知。

可以设置通知频率:

频率	说明
实时	每次部署都通知
汇总	每小时汇总一次
仅失败	只在失败时通知

通知最佳实践

实践	说明
生产环境必配	生产环境的部署失败一定要通知
团队协作	用企业微信/钉钉/飞书，团队成员都能看到
避免打扰	测试环境可以关闭通知，或者只通知失败
多渠道备份	重要项目配置邮件 + 企业微信双通道
定期清理	不用的通知渠道及时删除

速查卡片

要点	说明
通知方式	邮件、Webhook、企业微信、钉钉、飞书
邮件通知	配置简单，适合个人项目
Webhook	最灵活，可以集成各种服务
企业微信	团队协作推荐，实时通知
通知类型	部署开始、成功、失败、域名变更、环境变量变更
通知规则	可以按分支、按类型、按频率配置
验证签名	Webhook 请求带签名，防止伪造
最佳实践	生产环境必配，团队协作用 IM，避免打扰