本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS 最終使用者傳訊社交中的訊息和事件格式
<a name="managing-event-destination-dlrs"></a>

事件的 JSON 物件包含 AWS 事件標頭和 WhatsApp JSON 承載。如需 JSON WhatsApp 通知承載和值的清單，請參閱 WhatsApp Business Platform Cloud API [參考中的 Webhooks 通知承載](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components)參考和[訊息狀態](https://developers.facebook.com/docs/whatsapp/conversation-types#message-status)。 *WhatsApp *

## AWS 最終使用者傳訊社交事件標頭
<a name="managing-event-destination-dlrs_body"></a>

事件的 JSON 物件包含 AWS 事件標頭和 WhatsApp JSON。標頭包含 WhatsApp 商業帳戶 (WABA) 和電話號碼的 AWS 識別符和 ARNs。

```
{
  "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 收到的 JSON `whatsAppWebhookEntry` 會以 JSON 字串形式接收，並可轉換為 JSON。如需欄位清單及其意義，請參閱 WhatsApp Business Platform Cloud API [參考中的 Webhooks 通知承載](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components)參考。 *WhatsApp *

```
{
  "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](https://jqlang.org/) 等工具，將 JSON 字串轉換為 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"
    }
  ]
}
```