기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS End User Messaging Social의 메시지 및 이벤트 형식
<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 End User Messaging 소셜 이벤트 헤더
<a name="managing-event-destination-dlrs_body"></a>

이벤트에 대한 JSON 객체에는 AWS 이벤트 헤더와 WhatsApp JSON이 포함됩니다. 헤더에는 WhatsApp Business Account(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"
    }
  ]
}
```