Notion 与企业微信(WeCom)深度集成与双向协同实战:从群机器人告警、OA 审批回写到 Formula 2.0 响应 SLA 闭环

2026 年 11 月 18 日

一、为什么 B2B 团队需要打通 Notion 与企业微信的双向协同? #

在国内中大型企业与出海业务团队中,企业微信(WeCom) 承担着即时通讯、组织架构管理、外部客户连接(SCRM)及合规 OA 审批的核心角色,而 Notion 则是研发项目、知识库与跨部门台账的沉淀中枢。如果两者相互孤立,团队每天都会陷入以下高频内耗:

  • 通知触达失灵:Notion 数据库状态变更或客户工单新建后,成员不常驻 Notion 网页端,导致紧急需求响应超时;
  • 审批与台账割裂:采购、用章、报销或版本上线在企业微信走完审批后,需要人工复制审批单号与结果回填至 Notion 台账,极易遗漏或录错。

通过将 Notion 的数据库自动化触发器与企业微信的 群机器人 Webhook、自建应用审批事件回调 打通,可以构建一条“企微审批发起 → 回调中继网关 → Notion 台账幂等建单 → 状态变更反向推群提醒”的实时闭环。

[ Notion × 企业微信(WeCom)双向实时协同架构 ]

  ┌──────────────────────────────┐       Webhook 群机器人推送       ┌──────────────────────────────┐
  │   Notion 业务台账与项目库     │ ───────────────────────────────► │     企业微信项目/告警群       │
  │  • Status/Owner 变更触发     │   (Markdown 卡片 + @责任人)      │  • 即时查看单据链接与 SLA 状态  │
  └──────────────▲───────────────┘                                 └──────────────────────────────┘
                 │ 幂等先查后写 (WeCom_SpNo)
  ┌──────────────┴───────────────┐       OA 审批状态变更回调        ┌──────────────────────────────┐
  │  Node.js 网关中继(验签解密) │ ◄─────────────────────────────── │   企业微信自建应用 / OA 审批   │
  │  • WXBizMsgCrypt AES 解密    │   (XML 回调 + 审批单详情 API)    │  • 采购/立项/上线审批流通过    │
  └──────────────────────────────┘                                 └──────────────────────────────┘

二、企业微信集成方案选型与核心能力对比 #

在启动研发对接前,团队可根据业务复杂度在三种主流集成路径中做出选型(通用自动化架构可参阅 Notion Webhook 与自动化集成实战 与 钉钉双向集成方案对比):

对比维度 企微群机器人 Webhook(轻量推送) 无代码平台(Make / n8n 中转) 企微自建应用 + Node.js 中继网关
适用场景 Notion 任务逾期提醒、客户线索入库播报 常规表单转通知、定时数据汇总 OA 审批结果回写、企微客户线索归集、双向状态机
消息格式支持 支持文本、markdown 卡片与图文 依赖平台内置节点模板 全协议支持:应用消息卡片、审批回调、通讯录映射
安全与合规性 依赖 Webhook Key 保密,无双向身份校验 凭据托管在第三方或自建 n8n 严格企业级安全:支持 msg_signature 验签、AES 解密与固定 IP 白名单
防重与限流治理 单向发送,无幂等状态锁 需手动配置分支过滤 完全可控:支持 WeCom_SpNo 查重锁与 Notion 429 退避重试

三、分步骤实操:构建企微审批回写 Notion 与群告警闭环 #

步骤 1:规划 Notion 核心协同台账字段结构 #

首先在 Notion 创建目标数据库(例如 DB_业务审批与协同工单),数据库建模规范可参照 企业级数据库架构规范 与 数据库属性完整说明。建议配置以下关键字段:

Notion 属性名 属性类型 企业微信来源映射 核心作用说明
工单标题 Title 审批模板名称 + 申请人姓名 主记录标题,便于全局快速检索
WeCom_SpNo Text 企微审批单编号 sp_no 唯一幂等主键,防止回调重试造成重复建单
审批类型 Select sp_name(如采购申请/发版审批) 用于视图分组与自动化路由
申请人企微ID Text applyer.userid 用于反向推送处理进度提醒
Notion 经办人 Person 经由邮箱映射表转换的成员 绑定工作区责任人并支持 Me 动态视图
审批通过时间 Date apply_time / 终审时间戳 作为 Formula 2.0 核算响应 SLA 的起点
协同状态 Status 待处理 / 处理中 / 已办结 变更时触发 Notion 自动化向企微群发通知

步骤 2:在 Notion 与企业微信管理后台创建凭据 #

  1. 配置 Notion 内部集成:前往 Notion 开发者后台创建一个内部集成(详细步骤见 创建 Notion API 集成指南),开启 Read content、Update content、Insert content 权限,并在目标数据库右上角 ··· -> Connections 中授权绑定;
  2. 创建企微自建应用与群机器人:
    • 在企业微信管理后台「应用管理 -> 自建」创建应用,记录 CorpID、AgentId 与 Secret,并在「企业可信 IP」中填入中继服务器的公网固定出口 IP;
    • 在「接收消息」配置回调 URL、Token 与 EncodingAESKey,勾选「审批状态通知事件」;
    • 在目标业务群点击「添加群机器人」,获取 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=... 地址。

步骤 3:编写 Node.js 幂等接收与双向推送中继脚本 #

当企微推送审批通过回调时,网关需先通过 WeCom_SpNo 查询 Notion 数据库防重,再执行创建或更新,同时在异常时遵循 Notion API 速率限制规范 控制写入频率:

// wecom-notion-sync.mjs:企业微信审批单幂等同步至 Notion 与群机器人播报
import { Client } from "@notionhq/client";

const notion = new Client({ auth: process.env.NOTION_TOKEN });
const DB_ID = process.env.NOTION_APPROVAL_DB_ID;
const WECOM_WEBHOOK = process.env.WECOM_BOT_WEBHOOK;

// 1. 幂等同步企微审批单至 Notion 数据库
export async function upsertApprovalToNotion(approvalDetail) {
  const spNo = String(approvalDetail.sp_no);
  const title = `${approvalDetail.sp_name} - ${approvalDetail.applyerName}`;
  const passedAt = new Date(approvalDetail.apply_time * 1000).toISOString();

  // 先查后写,拦截企业微信回调超时重发导致的重复建卡
  const existing = await notion.databases.query({
    database_id: DB_ID,
    filter: { property: "WeCom_SpNo", rich_text: { equals: spNo } }
  });

  if (existing.results.length > 0) {
    const pageId = existing.results[0].id;
    await notion.pages.update({
      page_id: pageId,
      properties: { "协同状态": { status: { name: "处理中" } } }
    });
    return pageId;
  }

  const created = await notion.pages.create({
    parent: { database_id: DB_ID },
    properties: {
      "工单标题": { title: [{ text: { content: title } }] },
      "WeCom_SpNo": { rich_text: [{ text: { content: spNo } }] },
      "审批类型": { select: { name: approvalDetail.sp_name } },
      "申请人企微ID": { rich_text: [{ text: { content: approvalDetail.userid } }] },
      "审批通过时间": { date: { start: passedAt } },
      "协同状态": { status: { name: "待处理" } }
    }
  });

  await notifyWeComGroup(title, spNo, created.url);
  return created.id;
}

// 2. 向企业微信群机器人发送 Markdown 协同卡片
async function notifyWeComGroup(title, spNo, notionUrl) {
  await fetch(WECOM_WEBHOOK, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      msgtype: "markdown",
      markdown: {
        content: [
          `### 📋 新审批单已同步至 Notion`,
          `> **单据名称**:${title}`,
          `> **企微单号**:\`${spNo}\``,
          `> **处置入口**:[点击前往 Notion 领单](${notionUrl})`
        ].join("\n")
      }
    })
  });
}

步骤 4:配置反向推送自动化与人员邮箱映射表 #

  1. 建立 Notion 自动化推送规则:在 DB_业务审批与协同工单 右上角开启 Database Automations,当 协同状态 从 待处理 变更为 已办结 时,自动触发 Send webhook 通知中继网关向发起人对应的企微群或应用消息发送完工回执;
  2. 维护企微 userid 与 Notion 邮箱对照表:由于企业微信回调仅返回成员 userid 而不直接暴露个人邮箱,建议在脚本配置或独立的 Notion 成员字典表中维护 WeCom_UserID -> Notion 注册邮箱 映射,并通过 notion.users.list() 缓存工作区成员 ID,确保每次同步都能精准绑定 Notion 经办人 属性并触发桌面端 @提醒。

四、Formula 2.0 实战:企微审批转派响应 SLA 与超期红牌预警 #

企微审批单流入 Notion 后,若缺乏履约倒计时监控,单据仍可能积压。可在数据库中新增 SLA 响应状态 公式列,利用 Formula 2.0 的 lets()、dateBetween() 与 style() 实时测算距审批通过后的处置耗时(语法参考 Formula 2.0 速查手册):

lets(
  status, prop("协同状态"),
  approvedAt, prop("审批通过时间"),
  priority, prop("审批类型"),
  slaHours, ifs(priority == "发版审批", 4, priority == "采购申请", 24, 48),
  elapsedHours, if(empty(approvedAt), 0, dateBetween(now(), approvedAt, "hours")),
  remainHours, slaHours - elapsedHours,

  ifs(
    status == "已办结",
      style("🟢 已按期闭环", "green", "bold"),
    empty(approvedAt),
      style("⚪ 缺少审批时间戳", "gray"),
    remainHours < 0,
      style("🚨 SLA 已超时 " + abs(remainHours) + " 小时 · 需企微群督办", "red", "bold"),
    remainHours <= 4,
      style("🔥 临近超时 · 仅剩 " + remainHours + " 小时", "orange", "bold"),
    style("🔵 处理中 · 剩余 " + remainHours + " 小时", "blue")
  )
)

五、常见故障排查与站内延伸阅读 #

  1. 企业微信接口报错 60020 not allow to access from your ip:企微自建应用调用 getapprovaldetail 等敏感接口强制校验出口 IP 白名单。若中继服务部署在无固定 IP 的 Serverless 平台,需绑定固定 NAT 网关或改用带静态出口 IP 的云主机,并在企微后台同步更新可信 IP 列表;
  2. 审批回调重复建单或接口超时:企业微信要求回调接口在 5 秒内 返回 success,否则会连续重发 3 次。务必采用“先校验签名并立即返回 HTTP 200,再投递异步队列查重写入 Notion”的解耦模型;更多接口报错排查请参阅 Notion 常见报错与故障诊断手册;
  3. 延伸实战推荐:

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。