本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AWS 最终用户消息社交中的消息和事件格式
<a name="managing-event-destination-dlrs"></a>

事件的 JSON 对象包含 AWS 事件标头和 WhatsApp JSON 有效负载。有关 JSON WhatsApp 通知负载和值的列表，请参阅*WhatsApp 商业平台云 API [参考中的 Webhooks 通知负载](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components)参考*和[消息状态](https://developers.facebook.com/docs/whatsapp/conversation-types#message-status)。

## AWS 最终用户消息社交事件标题
<a name="managing-event-destination-dlrs_body"></a>

事件的 JSON 对象包含 AWS 事件标题和 WhatsApp JSON。标题包含您的 WhatsApp 企业账户 (WABA) ARNs 的 AWS 标识符和电话号码。

```
{
  "context": {
    "MetaWabaIds": [
      {
        "wabaId": "1234567890abcde",
        "arn": "arn:aws:social-messaging:us-east-1:123456789012:waba/fb2594b8a7974770b128a409e2example"
      }
    ],
    "MetaPhoneNumberIds": [
      {
        "metaPhoneNumberId": "abcde1234567890",
        "arn": "arn:aws:social-messaging:us-east-1:123456789012:phone-number-id/976c72a700aac43eaf573ae050example"
      }
    ]
  },
  "whatsAppWebhookEntry": "{\"...JSON STRING....",
  "aws_account_id": "123456789012",
  "message_timestamp": "2025-01-08T23:30:43.271279391Z",
  "messageId": "6d69f07a-c317-4278-9d5c-6a84078419ec"
}
//Decoding the contents of whatsAppWebhookEntry
{
//WhatsApp notification payload
}
```

在前面的示例事件中：
+ {{1234567890abcde}}是来自 Meta 的 WABA ID。
+ {{abcde1234567890}}是来自 Meta 的电话号码 ID。
+ {{fb2594b8a7974770b128a409e2example}}是 WhatsApp 企业账户 (WABA) 的 ID。
+ {{976c72a700aac43eaf573ae050example}}是电话号码的 ID。

## 用于接收消息的 WhatsApp JSON 示例
<a name="managing-event-destination-dlrs-example-receive-text"></a>

以下显示了来自的传入消息的事件记录 WhatsApp。从 WhatsApp 中接收`whatsAppWebhookEntry`的 JSON 以 JSON 字符串的形式接收，并且可以转换为 JSON。有关字段及其含义的列表，请参阅《*WhatsApp 商业平台云 API [参考》中的 Webhooks 通知负载](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components)参考*。

```
{
  "context": {
    "MetaWabaIds": [
      {
        "wabaId": "1234567890abcde",
        "arn": "arn:aws:social-messaging:us-east-1:123456789012:waba/fb2594b8a7974770b128a409e2example"
      }
    ],
    "MetaPhoneNumberIds": [
      {
        "metaPhoneNumberId": "abcde1234567890",
        "arn": "arn:aws:social-messaging:us-east-1:123456789012:phone-number-id/976c72a700aac43eaf573ae050example"
      }
    ]
  },
  "whatsAppWebhookEntry": "{\"...JSON STRING....",
  "aws_account_id": "123456789012",
  "message_timestamp": "2025-01-08T23:30:43.271279391Z",
  "messageId": "6d69f07a-c317-4278-9d5c-6a84078419ec"
}
```

你可以使用诸如 [jq 之类的工具将 J](https://jqlang.org/) SON 字符串转换为 JSON。以下是 JSON 格式的：`whatsAppWebhookEntry`

```
{
  "id": "503131219501234",
  "changes": [
    {
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "14255550123",
          "phone_number_id": "46271669example"
        },
        "statuses": [
          {
            "id": "wamid.HBgLMTkxNzM5OTI3MzkVAgARGBJBMTM4NDdGRENEREI5Rexample",
            "status": "sent",
            "timestamp": "1736379042",
            "recipient_id": "01234567890",
            "conversation": {
              "id": "62374592e84cb58e52bdaed31example",
              "expiration_timestamp": "1736461020",
              "origin": {
                "type": "utility"
              }
            },
            "pricing": {
              "billable": true,
              "pricing_model": "CBP",
              "category": "utility"
            }
          }
        ]
      },
      "field": "messages"
    }
  ]
}
```

## 用于接收媒体消息的 WhatsApp JSON 示例
<a name="managing-event-destination-dlrs-example-receive-media"></a>

以下显示了传入媒体消息的事件记录。要检索媒体文件，请使用 GetWhatsAppMessageMedia API 命令。有关字段及其含义的列表，请参阅 [Webhooks 通知负载](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components)参考

```
{
//AWS End User Messaging Social header
}
//Decoding the contents of whatsAppWebhookEntry
{
  "id": "365731266123456",
  "changes": [
    {
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "12065550100",
          "phone_number_id": "321010217760100"
        },
        "contacts": [
          {
            "profile": {
              "name": "Diego"
            },
            "wa_id": "12065550102"
          }
        ],
        "messages": [
          {
            "from": "14255550150",
            "id": "wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample",
            "timestamp": "1723506230",
            "type": "image",
            "image": {
              "mime_type": "image/jpeg",
              "sha256": "BTD0xlqSZ7l02o+/upusiNStlEZhA/urkvKf143Uqjk=",
              "id": "530339869524171"
            }
          }
        ]
      },
      "field": "messages"
    }
  ]
}
```