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 Ereignisziele in AWS End User Messaging Social Ein Ereignisziel ist ein Amazon SNS SNS-Thema oder eine Amazon Connect Connect-Instance, an die WhatsApp Ereignisse gesendet werden. Wenn Sie die Veröffentlichung von Ereignissen aktivieren, werden alle Ihre Sende- und Empfangsereignisse an die Nachricht und das Ziel des Ereignisses gesendet. Sie können mittels Ereignissen den Status ausgehender Nachrichten und eingehender Kundenmitteilungen überwachen, verfolgen und analysieren. Jedes WhatsApp Geschäftskonto (WABA) kann ein Veranstaltungsziel haben. Alle Ereignisse aus allen Ressourcen, die mit der WABA verknüpft sind, werden an diesem Ereignisziel protokolliert. Sie könnten beispielsweise eine WABA haben, der drei Telefonnummern zugeordnet sind, und alle Ereignisse von diesen Telefonnummern werden an dem einen Ereignisziel protokolliert. **Topics** + [Fügen Sie eine Nachricht und ein Ereignisziel zu AWS End User Messaging Social hinzu](managing-event-destinations-add.md) + [Nachrichten- und Ereignisformat in AWS End User Messaging Social](managing-event-destination-dlrs.md) + [WhatsApp Nachrichtenstatus](managing-event-destinations-status.md) # Fügen Sie eine Nachricht und ein Ereignisziel zu AWS End User Messaging Social hinzu Wenn Sie die Veröffentlichung von Nachrichten und Ereignissen aktivieren, werden alle von Ihrem WhatsApp Geschäftskonto (WABA) generierten Ereignisse an das Amazon SNS SNS-Thema gesendet. Dies schließt Ereignisse für jede Telefonnummer ein, die einer WABA zugeordnet ist. Ihrer WABA kann ein Amazon SNS SNS-Thema zugeordnet sein. ## Voraussetzungen Bevor Sie beginnen, müssen die folgenden Voraussetzungen erfüllt sein, um entweder ein Amazon SNS SNS-Thema oder eine Amazon Connect Connect-Instance als Nachrichten- und Ereignisziel verwenden zu können. **Amazon-SNS-Thema** + Ein Amazon SNS SNS-Thema wurde [erstellt](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) und [Berechtigungen](#managing-event-destinations-sns-policies) wurden hinzugefügt. **Anmerkung** Amazon-SNS-FIFO-Themen werden nicht unterstützt. + **(Optional)** Um ein Amazon SNS SNS-Thema zu verwenden, das mit AWS KMS Schlüsseln verschlüsselt ist, müssen Sie AWS End User Messaging Social-Berechtigungen für die [bestehende Schlüsselrichtlinie](#managing-event-destinations-topic-policies) gewähren. **Amazon-Connect-Instance** + Eine Amazon Connect Connect-Instanz wurde [erstellt](https://docs.aws.amazon.com/connect/latest/adminguide/tutorial1-set-up-your-instance.html) und [Berechtigungen](#managing-event-destinations-amazon-connect-policies) wurden hinzugefügt. ## Fügen Sie eine Nachricht und ein Ziel für ein Ereignis hinzu 1. Öffnen Sie die AWS End User Messaging Social-Konsole unter [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/). 1. Wählen Sie **Geschäftskonto** und anschließend ein WABA aus. 1. Wählen Sie auf der Registerkarte **Ereignisziel** die Option **Ziel bearbeiten** aus. 1. Um ein Veranstaltungsziel zu aktivieren, wählen Sie **Aktivieren**. 1. Wählen Sie als **Zieltyp** entweder Amazon SNS oder Amazon Connect 1. Um Ihre Ereignisse an ein Amazon SNS SNS-Ziel zu senden, geben Sie einen vorhandenen Themen-ARN in das Feld **Themen-ARN** ein. Beispiele für IAM-Richtlinien finden Sie unter [IAM-Richtlinien für Amazon-SNS-Themen](#managing-event-destinations-sns-policies). 1. Für Amazon Connect 1. Wählen **Sie für Connect-Instanz** eine Instanz aus dem Drop-down-Menü aus. 1. Wählen Sie für die **bidirektionale Kanalrolle eine** der folgenden Optionen aus: 1. **Bestehende IAM-Rolle auswählen** — Wählen Sie eine bestehende IAM-Richtlinie aus der Drop-down-Liste „**Bestehende IAM-Rollen**“ aus. Beispiele für IAM-Richtlinien finden Sie unter [IAM-Richtlinien für Amazon Connect](#managing-event-destinations-amazon-connect-policies). 1. **IAM-Rollen-ARN** eingeben — Geben Sie den ARN der IAM-Richtlinie unter **Vorhandenen IAM-Rollen-Arn verwenden** ein. Beispiele für IAM-Richtlinien finden Sie unter [IAM-Richtlinien für Amazon Connect](#managing-event-destinations-amazon-connect-policies). 1. Wählen Sie **Änderungen speichern ** aus. ## Themenrichtlinien für verschlüsselte Amazon SNS Sie können Amazon SNS SNS-Themen verwenden, die mit AWS KMS Schlüsseln verschlüsselt sind, um eine zusätzliche Sicherheitsebene zu gewährleisten. Diese zusätzliche Sicherheit kann hilfreich sein, wenn Ihre Anwendung private oder sensible Daten verarbeitet. Weitere Informationen zur Verschlüsselung von Amazon SNS SNS-Themen mithilfe von AWS KMS Schlüsseln finden Sie unter [Aktivieren der Kompatibilität zwischen Ereignisquellen von AWS Diensten und verschlüsselten Themen](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) im *Amazon Simple Notification Service Developer Guide*. **Anmerkung** Amazon-SNS-FIFO-Themen werden nicht unterstützt. In der Beispielanweisung werden die optionalen, aber empfohlenen `SourceArn` Bedingungen verwendet, `SourceAccount` um das Problem des verwirrten Stellvertreters zu vermeiden, und nur das Eigentümerkonto von AWS End User Messaging Social hat Zugriff. Weitere Informationen zum Problem des verwirrten Stellvertreters finden Sie unter [Das Problem des verwirrten Stellvertreters](https://docs.aws.amazon.com//IAM/latest/UserGuide/confused-deputy.html) im *[IAM-Benutzerhandbuch](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html)*. Der Schlüssel, den Sie verwenden, muss *symmetrisch* sein. Verschlüsselte Amazon SNS SNS-Themen unterstützen keine asymmetrischen Schlüssel AWS KMS . Die Schlüsselrichtlinie muss geändert werden, damit AWS End User Messaging Social den Schlüssel verwenden kann. Folgen Sie den Anweisungen [unter Ändern einer Schlüsselrichtlinie](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) im *AWS Key Management Service Entwicklerhandbuch*, um der vorhandenen Schlüsselrichtlinie die folgenden Berechtigungen hinzuzufügen: ``` { "Effect": "Allow", "Principal": { "Service": "social-messaging.amazonaws.com" }, "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "{ACCOUNT_ID}" }, "ArnLike": { "aws:SourceArn": "arn:{PARTITION}:social-messaging:{REGION}:{ACCOUNT_ID}:*" } } } ``` ## IAM-Richtlinien für Amazon-SNS-Themen Um eine bestehende IAM-Rolle zu verwenden oder eine neue Rolle zu erstellen, fügen Sie dieser Rolle die folgende Richtlinie hinzu, damit AWS End User Messaging Social sie übernehmen kann. Informationen zum Ändern der Vertrauensstellung einer Rolle finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) im [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html). Im Folgenden finden Sie die **Berechtigungsrichtlinie** für die IAM-Rolle. Die Genehmigungsrichtlinie ermöglicht die Veröffentlichung in Amazon SNS SNS-Themen. Nehmen Sie in der folgenden IAM-Berechtigungsrichtlinie die folgenden Änderungen vor: + *\$1PARTITION\$1*Ersetzen Sie es durch die AWS Partition, in der Sie AWS End User Messaging Social verwenden. + *\$1REGION\$1*Ersetzen Sie es durch AWS-Region die, in der Sie AWS End User Messaging Social verwenden. + *\$1ACCOUNT\$1*Ersetzen Sie durch die eindeutige ID für Ihre AWS-Konto. + *\$1TOPIC\$1NAME\$1*Ersetzen Sie es durch die Amazon SNS SNS-Themen, an die Nachrichten gesendet werden. ``` { "Effect": "Allow", "Principal": { "Service": [ "social-messaging.amazonaws.com" ] }, "Action": "sns:Publish", "Resource": "arn:{PARTITION}:sns:{REGION}:{ACCOUNT}:{TOPIC_NAME}" } ``` ## IAM-Richtlinien für Amazon Connect Wenn Sie möchten, dass AWS End User Messaging Social eine bestehende IAM-Rolle verwendet, oder wenn Sie eine neue Rolle erstellen, fügen Sie dieser Rolle die folgenden Richtlinien bei, damit AWS End User Messaging Social sie übernehmen kann. Informationen zum Ändern einer bestehenden Vertrauensstellung einer Rolle finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) im [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html). Diese Rolle wird sowohl für das Senden von Ereignissen als auch für den Import von Telefonnummern aus AWS End User Messaging Social in Amazon Connect verwendet. Gehen Sie wie folgt vor, um neue IAM-Richtlinien zu erstellen: 1. Erstellen Sie eine neue **Berechtigungsrichtlinie**, indem Sie den Anweisungen unter [Erstellen von Richtlinien mit dem JSON-Editor](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) im IAM-Benutzerhandbuch folgen. 1. Verwenden Sie in Schritt 5 die **Berechtigungsrichtlinie** für die IAM-Rolle, um die Veröffentlichung auf Amazon Connect zu ermöglichen. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowOperationsForEventDelivery", "Effect": "Allow", "Action": [ "connect:SendIntegrationEvent" ], "Resource": "*" }, { "Sid": "AllowOperationsForPhoneNumberImport", "Effect": "Allow", "Action": [ "connect:ImportPhoneNumber", "social-messaging:GetLinkedWhatsAppBusinessAccountPhoneNumber", "social-messaging:TagResource" ], "Resource": "*" } ] } ``` ------ 1. Erstellen Sie eine neue **Vertrauensrichtlinie**, indem Sie den Anweisungen unter [Erstellen einer Rolle mithilfe benutzerdefinierter Vertrauensrichtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) im IAM-Benutzerhandbuch folgen. 1. Verwenden Sie in Schritt 4 die **Vertrauensrichtlinie** für die IAM-Rolle. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": [ "social-messaging.amazonaws.com" ] }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Fügen Sie in Schritt 10 die **Berechtigungsrichtlinie** hinzu, die Sie im vorherigen Schritt erstellt haben. ## Nächste Schritte Sobald Sie Ihr Amazon SNS SNS-Thema eingerichtet haben, müssen Sie einen Endpunkt für das Thema abonnieren. Der Endpunkt beginnt, Nachrichten zu empfangen, die zu dem zugehörigen Thema veröffentlicht wurden. Weitere Informationen zum Abonnieren eines Themas finden Sie unter Amazon SNS [SNS-Thema abonnieren im Amazon SNS *SNS-Entwicklerhandbuch*](https://docs.aws.amazon.com//sns/latest/dg/sns-create-subscribe-endpoint-to-topic.html). # 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](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components) und [Message Status](https://developers.facebook.com/docs/whatsapp/conversation-types#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: + *1234567890abcde*ist die WABA-ID von Meta. + *abcde1234567890*ist die Rufnummer-ID von Meta. + *fb2594b8a7974770b128a409e2example*ist die ID des WhatsApp Geschäftskontos (WABA). + *976c72a700aac43eaf573ae050example*ist 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](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components) 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](https://jqlang.org/) 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](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components) 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" } ] } ``` # WhatsApp Nachrichtenstatus Wenn Sie eine Nachricht senden, erhalten Sie Statusmeldungen zu der Nachricht. Sie müssen die Ereignisprotokollierung aktivieren, um diese Benachrichtigungen zu erhalten, siehe[Nachrichten- und Ereignisziele in AWS End User Messaging SocialZiele für Nachrichten und Ereignisse](managing-event-destinations.md). ## Nachrichtenstatus Die folgende Tabelle enthält mögliche Nachrichtenstatus. **** | Name des Status | Description | | --- | --- | | akzeptiert | Die Nachricht wurde von WhatsApp zur Bearbeitung akzeptiert. | | deleted | Der Kunde hat die Nachricht gelöscht, und Sie sollten die Nachricht auch löschen, wenn sie auf Ihren Server heruntergeladen wurde. | | geliefert | Die Nachricht wurde erfolgreich an den Kunden zugestellt. | | failed | Die Nachricht konnte nicht gesendet werden. | | Die Wiederholungsversuche sind erschöpft und die Nachricht wurde gelöscht. | Die Nachricht konnte nicht WhatsApp innerhalb des 180-minütigen Wiederholungszeitraums weitergeleitet werden und wurde gelöscht. | | read | Der Kunde hat die Nachricht gelesen. Dieser Status wird nur gesendet, wenn der Kunde Lesebestätigungen aktiviert hat. | | gesendet | Die Nachricht wurde gesendet, befindet sich aber noch im Transit. | | warning | Die Nachricht enthält ein Element, das nicht verfügbar ist oder nicht existiert. | ## Weitere Ressourcen Weitere Informationen finden Sie unter [Nachrichtenstatus](https://developers.facebook.com/docs/whatsapp/conversation-types#message-status) in der *WhatsApp Business Platform Cloud API-Referenz*.