Meta WhatsApp Webhook多元素嵌套数组场景及处理方式问询

针对你关于Webhook嵌套数组的几个问题，直接给你明确结论和场景说明：

一、哪些场景下会返回多元素的嵌套数组？ #

Webhook里的entry、changes、messages/contacts/statuses这些数组出现多元素，主要是Meta为了批量推送同类型/关联事件，常见场景包括：

• entry数组多元素：当你的WhatsApp商务账号绑定了多个业务号码/资产，且多个资产同时产生事件时（比如两个不同的客服号同时收到消息），Meta会把这些资产的事件打包进同一个Webhook请求。
• changes数组多元素：同一个业务资产下同时发生多种类型的变更（比如某条消息被用户发送的同时，另一条消息的状态变为已读），或者同一类型的多个独立事件（比如1秒内收到3条消息），会被合并到changes数组里。
• messages/contacts数组多元素：
  • 用户短时间内快速连发多条消息，Meta会把这些消息合并到同一个messages数组；
  • 多条消息来自不同联系人时，contacts数组会包含每个联系人的信息；
  • 群发消息的回调中，messages会包含群发对象的多条反馈（该场景较少见）。
• statuses数组多元素：当多条消息的状态同时更新（比如一批消息同时被标记为已送达），statuses数组会有多个元素。

二、直接通过entry[0].changes[0].value.messages[0].text.body取值可行吗？要不要循环？ #

单消息场景下能拿到数据，但绝对不推荐这么写。
这种写法只适用于每次Webhook只推送单个事件的理想情况，但一旦出现上述多元素场景，你会直接漏掉后面的所有事件（比如同时收到两条消息，只会处理第一条）。

正确的做法是对每一层嵌套数组做遍历处理，伪代码逻辑大概是：

// 遍历所有entry
for (const entry of webhookPayload.entry) {
  // 遍历当前entry下的所有变更
  for (const change of entry.changes) {
    // 根据变更类型处理
    if (change.field === 'messages') {
      // 遍历所有消息
      for (const message of change.value.messages) {
        // 处理单条消息
        const body = message.text?.body;
        // ...你的业务逻辑
      }
      // 遍历联系人（如果需要）
      for (const contact of change.value.contacts) {
        const contactName = contact.profile?.name;
        // ...
      }
    } else if (change.field === 'statuses') {
      // 遍历所有状态更新
      for (const status of change.value.statuses) {
        // 处理状态
        const statusType = status.status;
        // ...
      }
    }
  }
}

这种写法能覆盖所有多元素场景，保证不会丢事件。

三、哪些类型的变更会包含多元素？ #

主要集中在三类变更场景：

• 入站消息类变更：短时间内多条用户消息、群发消息的多接收反馈；
• 消息状态类变更：多条消息同时更新状态（已送达、已读、失败等）；
• 多资产/多联系人变更：多个业务号码的事件、多个联系人的消息/信息更新。

内容的提问来源于stack exchange，提问作者devanggarach