知识百科
什么是Webhook？它和API有什么区别
Webhook 是一种"事件驱动的反向通知"：当某个事件发生时，系统主动把消息推送到你事先配置好的地址，而不是让你一遍遍去问"有没有新消息"。它和 API 不是替代关系，而是互补——API 由你主动发起请求，Webhook 由系统主动推送通知。搞清楚"谁先发起"这条差别，就能明白为什么企业 IM 的自动化联动几乎都离不开 Webhook。
- 知识百科
Webhook 是一种"事件驱动的反向通知"：当某个事件发生时，系统主动把消息推送到你事先配置好的地址，而不是让你一遍遍去问"有没有新消息"。它和 API 不是替代关系，而是互补——API 由你主动发起请求，Webhook 由系统主动推送通知。搞清楚"谁先发起"这条差别，就能明白为什么企业 IM 的自动化联动几乎都离不开 Webhook。
一、Webhook 的本质：把"我来问"换成"它来告诉"
用日常场景类比很直观。要知道快递到没到，有两种办法：每隔十分钟下楼看一眼快递柜（轮询），或者留个电话、到了直接通知你（Webhook）。
后者正是这套机制的工作方式：你不必反复查询，只在事件发生的那一刻收到通知。实现上也很朴素——你提供一个可被访问的地址（URL），系统在事件触发时向它发送一个 HTTP 请求，把事件内容一并带过去。
它省下的不只是流量，更是时间差。轮询的快慢决定了你能多快知道变化：频率低会延迟，频率高会浪费；而它把"等待"变成"即时到达"。
在企业 IM 场景里，这套机制尤其关键。BeeWorks 就把 Webhook 作为开放能力的一部分，让业务系统能实时感知聊天里发生的事件，为后续的自动化联动打好基础。
二、Webhook 和 API 到底差在哪
初次接触 Webhook 的人常觉得"这不也是 API 吗"。它们确实都基于 HTTP、都能传数据，但设计方向恰好相反。
| 对比维度 | API | Webhook |
|---|---|---|
| 谁先发起 | 你主动调用 | 系统主动推送 |
| 何时触发 | 你想查的时候 | 事件发生的时候 |
| 数据方向 | 拉取（Pull） | 推送（Push） |
| 实时性 | 取决于调用频率 | 事件触发即通知 |
| 典型用途 | 查数据、下指令、做操作 | 接收变化通知、触发后续动作 |
一句话记住：API 是"我去取"，Webhook 是"它来送"。API 回答"我要什么"，Webhook 回答"发生了什么"。
两者通常配合使用：Webhook 先通知你"有事件发生了"，你的系统再调用 API 去取详细数据、执行后续动作。它不替代 API，而是补上 API 在"实时感知"上的短板。
三、企业 IM 里，Webhook 解决什么问题
企业 IM 的高频场景大多是事件驱动的：有人 @ 了机器人、有人点了审批卡片上的按钮、一条工单状态变了、一个系统告警触发了。它们的共同点是——你无法预知何时发生，却必须尽快响应。
Webhook 正是为此而生，它主要解决三件事：
- 事件进得来：机器人收到的消息、用户的点击与交互，可被业务系统实时感知；
- 消息出得去：审批提醒、系统告警、工单通知，能主动触达相关的人，而不是等人来查；
- 流程接得上：收到事件后调用开放 API 取数、写库、推进流程，形成"通知—处理—回执"的闭环。
一句话：它让聊天里的一次点击，变成业务系统里的一次真实动作。
四、BeeWorks 的 Webhook 开放了什么
以 BeeWorks 为例，它的机器人能力里明确包含 Webhook 回调与事件订阅——开发者可以通过事件订阅监听机器人消息及用户交互事件，并通过 Webhook 回调实现与企业业务系统的数据联动和自动化处理。这意味着"聊天中发生的事"可以稳定地传导到后端系统。
与之配套的还有两层能力：
- 消息推送：BeeWorks 提供统一消息推送引擎，支持文本、图文、图片、附件、Markdown 等消息类型，并支持交互式消息、按钮事件、动态消息更新——业务系统的通知可以做成"可点击、可回执"的卡片，而不只是单向广播；
- 应用形态：机器人、服务号、轻应用、内宣号、原生应用等多种形态，让触发后的结果能以合适的形式呈现给用户，业务方不必另建入口。
需要说明的是，Webhook 只是 BeeWorks 开放体系（开放 API、客户端 SDK、消息开放能力等）中的一环。它的价值不在于数量，而在于能不能与消息推送、应用形态打通，形成"事件感知—消息触达—流程闭环"的完整链路。
五、判断一套 Webhook 能力够不够用
拿下面四个问题去验收任何方案：
- 事件覆盖够不够——能订阅哪些事件（消息、交互、群组、应用），而不是只有一两类；
- 投递是否可靠——事件丢失怎么办、能否重试、能否补偿；
- 来源是否可信——接收端如何确认请求确实来自平台、而非伪造（具体校验机制以各产品官方文档为准）；
- 能否与 API 闭环——收到事件后能不能顺畅取数、回写，形成完整动作，而不是只通知不落地。
四问都能明确回答，Webhook 才算真正可用。
FAQ
Q1：Webhook 和 API 到底有什么区别？
A：核心差别在方向。API 由你主动调用，是"我去取"；Webhook 由系统主动推送，是"它来送"。API 适合查数据和下指令，Webhook 适合接收"某件事发生了"的通知，两者通常配合使用。
Q2：Webhook 安全吗？怎么防止被伪造？
A：Webhook 本质是暴露一个接收地址，因此来源校验很重要。通用做法包括签名校验、密钥验证、来源限制等，用以确认请求确实来自可信平台。具体采用哪种机制、如何配置，以对应产品官方文档为准。
Q3：没有开发团队，Webhook 对我还有用吗？
A：有。它的价值是让业务系统之间自动联动，通常由企业 IT 或集成商一次性配置好，日常使用无需再管。选型时重点看平台是否提供现成的应用形态和接入指引，降低落地门槛。
Q4：Webhook 和机器人是什么关系？
A：机器人是"在聊天里和人交互的角色"，Webhook 是"把交互事件传给业务系统的通道"。用户与机器人互动（@ 它、点它的按钮），这些事件可以通过 Webhook 回调送到你的系统，由系统决定如何响应。