Nachrichten- und Ereignisformat in AWS End User Messaging Social - AWS Social Messaging für Endbenutzer
AWS Endbenutzer-Nachrichtenübermittlung in der Kopfzeile für soziale EreignisseBeispiel WhatsApp JSON für eine Nachricht WhatsApp JSON-Beispiel für eine Mediennachricht

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Nachrichten- und Ereignisformat in AWS End User Messaging Social

Das JSON-Objekt für ein Ereignis enthält den AWS Event-Header und die WhatsApp JSON-Payload. Eine Liste der Nutzdaten und Werte für WhatsApp JSON-Benachrichtigungen finden Sie in der WhatsApp Business Platform Cloud API-Referenz unter Webhooks Notification Payload Reference und Message Status.

AWS Nachrichtenübermittlung an Endbenutzer in sozialen Netzwerken — Header

Das JSON-Objekt für ein Ereignis enthält den AWS Event-Header und WhatsApp JSON. Der Header enthält die AWS Identifikatoren sowie ARNs Ihr WhatsApp Geschäftskonto (WABA) und Ihre Telefonnummer.

{
  "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
}

Im vorherigen Beispielereignis:

  • 1234567890abcdeist die WABA-ID von Meta.

  • abcde1234567890ist die Rufnummer-ID von Meta.

  • fb2594b8a7974770b128a409e2exampleist die ID des WhatsApp Geschäftskontos (WABA).

  • 976c72a700aac43eaf573ae050exampleist die ID der Telefonnummer.

WhatsApp JSON-Beispiel für den Empfang einer Nachricht

Im Folgenden wird der Ereignisdatensatz für eine eingehende Nachricht von angezeigt WhatsApp. Das von WhatsApp in empfangene JSON whatsAppWebhookEntry wird als JSON-Zeichenfolge empfangen und kann in JSON konvertiert werden. Eine Liste der Felder und ihrer Bedeutung finden Sie unter Webhooks Notification Payload Reference in der WhatsApp Business Platform Cloud API-Referenz.

{
  "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"
}

Sie können ein Tool wie jq verwenden, um die JSON-Zeichenfolge in JSON zu konvertieren. Das Folgende ist whatsAppWebhookEntry in JSON-Form:

{
  "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-Beispiel für den Empfang einer Mediennachricht

Im Folgenden wird der Ereignisdatensatz für eine eingehende Mediennachricht angezeigt. Verwenden Sie den GetWhatsAppMessageMedia API-Befehl, um die Mediendatei abzurufen. Eine Liste der Felder und ihrer Bedeutung finden Sie unter Webhooks Notification Payload Reference

{
//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"
    }
  ]
}