WhatsApp 群组 webhooks
两个 webhook 事件会报告需要审批的群组上的加入请求活动。两者都是请求者自行发起的操作，因此不会出现在你任何调用的响应中；如果一个请求在两次列表读取之间被创建又被取消，则不会留下任何记录。订阅这两个事件，你就不需要轮询。
| 事件 | 触发条件 |
|---|---|
whatsapp.group.join_request_created | 有人打开邀请链接并申请加入 |
whatsapp.group.join_request_revoked | 在你处理之前，对方取消了该请求 |
处理请求不会触发事件，因为结果已经在你自己调用的响应中了。这两个事件都不属于消息时间线的一部分。
加入请求已创建
代码示例
{
"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 是该用户申请加入的时间。
加入请求已撤销
代码示例
{
"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 | 该请求。与加入请求列表返回的 ID 相同，也是批量批准和拒绝操作所使用的 ID，因此你可以直接根据事件进行处理 |
join_request.bsuid | 请求者的业务范围用户 ID。每个请求都携带该 ID，如果你批准了请求，该 ID 会延续到 participants，因此建议以此作为你自己记录的主键 |
join_request.phone_number | 请求者的 E.164 格式号码，如果对方未向你的企业共享号码则为 null |
join_request.username | 请求者的 WhatsApp 用户名，如果对方未设置用户名则为 null |
后续步骤
- 管理 WhatsApp 群组：批准或拒绝请求
- WhatsApp webhooks：你可以订阅的其他事件
- Webhooks 指南：端点、签名验证和重试