---
title: "WhatsApp 群组 webhooks"
description: "两个 WhatsApp 群组 webhook 的载荷，分别在有人申请加入需要审批的群组以及取消该申请时触发。"
canonical: "https://bird.com/zh-sg/wendang/guides/whatsapp/webhooks/groups"
---

# WhatsApp 群组 webhooks

两个 webhook 事件会报告需要审批的[群组](/docs/guides/whatsapp/groups)上的加入请求活动。两者都是请求者自行发起的操作，因此不会出现在你任何调用的响应中；如果一个请求在两次列表读取之间被创建又被取消，则不会留下任何记录。订阅这两个事件，你就不需要轮询。

| 事件                                  | 触发条件                       |
| ------------------------------------- | ------------------------------ |
| `whatsapp.group.join_request_created` | 有人打开邀请链接并申请加入     |
| `whatsapp.group.join_request_revoked` | 在你处理之前，对方取消了该请求 |

处理请求不会触发事件，因为结果已经在你自己调用的响应中了。这两个事件都不属于消息时间线的一部分。

## 加入请求已创建

```json
{
  "type": "whatsapp.group.join_request_created",
  "timestamp": "2026-09-22T10:07:57Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}
```

`timestamp` 是该用户申请加入的时间。

## 加入请求已撤销

```json
{
  "type": "whatsapp.group.join_request_revoked",
  "timestamp": "2026-09-22T11:12:03Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}
```

`data` 与其所取消的请求相同，`join_request.id` 也相同。`timestamp` 是请求被取消的时间。

## 字段

| 字段                        | 含义                                                                                                                                                                              |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `group_id`                  | 该用户申请加入的群组                                                                                                                                                              |
| `whatsapp_number_id`        | 创建并管理该群组的商业号码                                                                                                                                                        |
| `workspace_id`              | 拥有该群组的工作区                                                                                                                                                                |
| `join_request.id`           | 该请求。与[加入请求列表](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group)返回的 ID 相同，也是批量批准和拒绝操作所使用的 ID，因此你可以直接根据事件进行处理    |
| `join_request.bsuid`        | 请求者的[业务范围用户 ID](/docs/guides/whatsapp/business-scoped-user-ids)。每个请求都携带该 ID，如果你批准了请求，该 ID 会延续到 `participants`，因此建议以此作为你自己记录的主键 |
| `join_request.phone_number` | 请求者的 E.164 格式号码，如果对方未向你的企业共享号码则为 `null`                                                                                                                  |
| `join_request.username`     | 请求者的 WhatsApp 用户名，如果对方未设置用户名则为 `null`                                                                                                                         |

## 后续步骤

- [管理 WhatsApp 群组](/docs/guides/whatsapp/groups/management#3-let-people-into-the-group)：批准或拒绝请求
- [WhatsApp webhooks](/docs/guides/whatsapp/webhooks)：你可以订阅的其他事件
- [Webhooks 指南](/docs/guides/webhooks)：端点、签名验证和重试

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)