

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.

# WhatsApp Business Messaging einrichten
<a name="whatsapp-integration"></a>

In den Themen in diesem Abschnitt wird erklärt, wie Sie WhatsApp Business Messaging für Amazon Connect einrichten und testen. Sie verwenden [AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html), um ein WhatsApp Geschäftskonto und eine Telefonnummer mit einer Amazon Connect-Instance zu verknüpfen, und importieren dann die verknüpfte Telefonnummer in Amazon Connect. Kunden können dann Nachrichten WhatsApp an Ihr Call Center senden. 

Sie können zudem Amazon Lex nutzen, um Antworten auf Kundenfragen zu automatisieren. Das spart Kundendienstmitarbeitern Zeit und Mühe. Weitere Informationen finden Sie unter [Erste Schritte mit Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) im *Entwicklerhandbuch zu Amazon Lex*.

**Topics**
+ [

## Voraussetzungen
](#whatsapp-prerequisites)
+ [

## Schritt 1: Aktivieren von Amazon Connect als Ereignisziel
](#enable-connect-destination)
+ [

## Schritt 2: Konfigurieren des eingehenden Gesprächsablaufs für Ihre Telefonnummer
](#inbound-contact-flow)
+ [

## Schritt 3: Senden und Empfangen von Testnachrichten
](#send-receive-test-messages)
+ [

## Nächste Schritte: Vorbereiten des Live-Starts
](#whatsapp-next-steps)
+ [

## Beheben häufiger Probleme
](#whatsapp-troubleshooting)
+ [

# WhatsApp Funktionen und Einschränkungen von Business Messaging mit Amazon Connect
](whatsapp-messaging-capabilities.md)

## Voraussetzungen
<a name="whatsapp-prerequisites"></a>

Bevor Sie die Integration WhatsApp mit Amazon Connect durchführen können, müssen Sie über die folgenden Elemente verfügen:
+ Ein WhatsApp Geschäftskonto.
+ Eine WhatsApp Telefonnummer. Die Nummer muss in der Lage sein, einen Sprachanruf oder eine SMS-Textnachricht zu empfangen, um den Verifizierungsprozess der Telefonnummer von Meta für WhatsApp Geschäftsnachrichten abzuschließen. Sie können eine Amazon Connect Connect-Sprachnummer oder eine AWS End User Messaging SMS Nummer für die WhatsApp Telefonnummer verwenden. Sie können auch eine Telefonnummer verwenden, die Sie außerhalb von besitzen AWS.

  Wenn Sie eine Amazon Connect Connect-Sprachnummer oder AWS End User Messaging SMS -Nummer verwenden, empfehlen wir, eine neue Nummer zu beantragen, die nicht für Live-Sprach- oder SMS-Verkehr verwendet wird, um eine mögliche Unterbrechung des Dienstes zu vermeiden.

  Sie können die AWS End User Messaging Social-Konsole unter verwenden [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/), um das WhatsApp Geschäftskonto und die Telefonnummer zu erstellen. Weitere Informationen finden Sie unter [Registrierung für WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded) im *AWS End User Messaging Social User Guide*. 

**Wichtig**  
WhatsApp verfügt über einen automatisierten Geschäftsverifizierungsprozess, dessen Abschluss bis zu 2 Wochen dauern kann. Wir empfehlen Ihnen, diesen Prozess frühzeitig zu beginnen. WhatsApp kann WhatsApp Geschäftskonten deaktivieren, wenn gegen die WhatsApp Geschäftsrichtlinie verstoßen wird oder die Geschäftsidentität nicht verifiziert werden kann.   
Wir empfehlen außerdem dringend, die [Best Practices für AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html) und [WhatsApp Best Practices](https://business.whatsapp.com/policy#best_practices) zu lesen, bevor Sie WhatsApp Ressourcen erstellen und verknüpfen. 

Nachdem Sie das Konto und die Telefonnummer erstellt haben, führen Sie die Schritte in den folgenden Abschnitten in der angegebenen Reihenfolge aus. 

## Schritt 1: Aktivieren von Amazon Connect als Ereignisziel
<a name="enable-connect-destination"></a>

In den folgenden Schritten wird erklärt, wie Sie AWS End User Messaging Social verwenden, um Amazon Connect als Veranstaltungsziel für Ihr verknüpftes WhatsApp Geschäftskonto zu aktivieren. Dadurch kann das System Ihre WhatsApp Telefonnummer importieren.

 Sie können die [AWS End User Messaging Social Console](https://console.aws.amazon.com/social-messaging/) oder die verwenden AWS CLI , um diese Aufgabe abzuschließen. Informationen zur AWS CLI Verwendung von finden Sie [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)in der *Amazon Connect API-Referenz* und [https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)in der *AWS End User Messaging Social API-Referenz*.

Im Folgenden wird die Verwendung der Konsole erläutert.

**So verwenden Sie die -Konsole:**

1. Melden Sie sich bei der AWS End User Messaging Social-Konsole unter an [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/).

1. Wählen Sie im Navigationsbereich **WhatsApp Geschäftskonten** und dann das gewünschte Konto aus.

1. Wählen Sie auf der Registerkarte **Ereignisziel** die Option **Ziel bearbeiten** aus. 

1.  Wählen Sie für **Zieltyp** die Option **Amazon Connect** aus. 

1.  Wählen Sie für **Connect-Instance** Ihre Amazon-Connect-Instance aus der Dropdown-Liste aus. 

1.  Wählen Sie für **Rollen-ARN** eine IAM-Rolle aus, die die Berechtigung erteilt, Nachrichten und Ereignisse zuzustellen und Telefonnummern zu importieren. Beispiele für IAM-Richtlinien finden [Hinzufügen eines Nachrichten- und Ereignisziels zu AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies) im *Benutzerhandbuch zu AWS End User Messaging Social*.  

1. Wählen Sie **Änderungen speichern ** aus.

   Dadurch wird der Import Ihrer Telefonnummer nach Amazon Connect gestartet. 

   Nach Abschluss des Vorgangs wird die Nummer auf der Admin-Website von Amazon Connect angezeigt.

**So blenden Sie die Nummer ein**
   + Wählen Sie im Navigationsmenü **Kanäle** und dann **Telefonnummern** aus. 

     Die Spalte **Aktive Kanäle** wird **WhatsApp**für alle WhatsApp Zahlen angezeigt.   
![\[Die Seite mit den Telefonnummern, auf der eine WhatsApp Nummer angezeigt wird.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/whats-app-imported-number.png)

## Schritt 2: Konfigurieren des eingehenden Gesprächsablaufs für Ihre Telefonnummer
<a name="inbound-contact-flow"></a>

Sie können einen eingehenden Kontaktfluss zur Verwendung mit Ihrer WhatsApp Telefonnummer erstellen oder einen vorhandenen Flow wiederverwenden. Wenn Sie einen Flow wiederverwendest, können Sie einen `CheckContactAttribute`-Block hinzufügen und die Verzweigung für den Flow aktivieren. Der Block ermöglicht es Ihnen, WhatsApp Kontakte an eine bestimmte Warteschlange zu senden oder eine andere Aktion auszuführen.

Weitere Informationen zum Aufbau des Gesprächsablaufs, einschließlich interaktiver Nachrichten und Rich-Link-Vorschauen, finden Sie unter [WhatsApp Funktionen und Einschränkungen von Business Messaging mit Amazon Connect](whatsapp-messaging-capabilities.md) weiter unten in diesem Abschnitt.

In den folgenden Schritten wird erklärt, wie Sie einen eingehenden Gesprächsablauf konfigurieren und ihm einen `CheckContactAttribute`-Block hinzufügen.

**So konfigurieren Sie einen Ablauf**

1. Starten Sie die Amazon Connect Connect-Konsole unter [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)

1. Wählen Sie im Navigationsmenü **Kanäle** und dann **Telefonnummern** aus. 

1. Wählen Sie die WhatsApp Nummer und dann **Bearbeiten**.

1. Wählen Sie unter **Gesprächsablauf/IVR** den Ablauf aus, den Sie aktualisiert haben.  
![\[Der Bereich Kontaktablauf/IVR auf der Bearbeitungsseite zeigt einen WhatsApp Flow.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/whatsapp-flow-ivr.png)

1. Wählen Sie **Speichern**.

**So fügen Sie den CheckContactAttribute-Block hinzu**

1. Führen Sie die Schritte 1 bis 4 [im vorherigen Abschnitt](#enable-connect-destination) aus.

1. Öffnen Sie die Seite **Eigenschaften** für den Ablauf.

1. Setzen Sie im Abschnitt **Zu prüfendes Attribut** den **Namespace** auf **Segmentattribute** und den **Schlüssel** auf **Subtype**. Weitere Informationen zu Segmentattributen finden Sie unter [SegmentAttributes](ctr-data-model.md#segmentattributes) an späterer Stelle in diesem Leitfaden.

1. Stellen Sie im Abschnitt **Zu prüfende Bedingungen** die **Bedingung** auf **Gleich** und den **Wert** für die **Verbindung** auf: ein. WhatsApp 

1. Wählen Sie **Speichern**.

## Schritt 3: Senden und Empfangen von Testnachrichten
<a name="send-receive-test-messages"></a>

In diesem Schritt verwenden Sie das Contact Control Panel (CCP) und ein Mobiltelefon, um WhatsApp Testnachrichten zu senden und zu empfangen. 

**So testen Sie die Integration**

1. Setzen Sie in Ihrem CCP Ihren Status auf **Verfügbar**. 

1. Starten Sie WhatsApp auf Ihrem Mobiltelefon eine Konversation, indem Sie die zuvor hinzugefügte Telefonnummer eingeben. 

   Die folgende Abbildung zeigt eine Meldung mit **Optionen** und die daraus resultierende Optionsliste.  
![\[Handybildschirm mit einer Beispielnachricht.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/whatsapp-options-results.png)

## Nächste Schritte: Vorbereiten des Live-Starts
<a name="whatsapp-next-steps"></a>

Nachdem Sie Ihre Integration getestet haben, empfehlen wir, Ihrem WhatsApp Messaging-Kanal die folgenden Funktionen und Fähigkeiten hinzuzufügen. 

### Hinzufügen von Amazon-Connect-Features
<a name="add-features"></a>

Die Links in der folgenden Liste führen Sie zu Informationen über Amazon-Connect-Features, die Sie in Kunden- und Kundendienstmitarbeiter-Erfahrungen ergänzen können.
+  Weitere Informationen zur [WhatsApp Funktionen und Einschränkungen von Business Messaging mit Amazon Connect](whatsapp-messaging-capabilities.md). 
+  [Zulassen, dass Kunden Chat-Konversationen in Amazon Connect fortsetzen](chat-persistence.md) – Kunden können frühere Konversationen fortsetzen und dabei den jeweiligen Kontext, die Metadaten und Transkripte verwenden. Sie müssen sich nicht wiederholen, wenn sie zu einem Chat zurückkehren, und die Kundendienstmitarbeiter haben Zugriff auf den gesamten Konversationsverlauf. 
+  [Erstellen von Schnellantworten zur Verwendung bei Chat- und E-Mail-Kontakten in Amazon Connect](create-quick-responses.md) – Kundendienstmitarbeiter haben Zugang zu vorgefertigten Antworten auf häufig gestellte Kundenanfragen, die sie beim Chat mit Kunden verwenden können. Schnellantworten ermöglichen es Kundendienstmitarbeitern, schneller auf Kunden zu reagieren. 

### Hinzufügen von Einstiegspunkten
<a name="add-entry-points"></a>

Über die Links in der folgenden Liste erhalten Sie Informationen zum Hinzufügen verschiedener Arten von Kundeneingangspunkten.
+ Einstiegspunkte: [5 Möglichkeiten, Leads und Kunden zu geschäftlichen Messaging-Konversationen zu leiten](https://business.whatsapp.com/blog/messaging-app-entry-points) (WhatsAppBlogbeitrag) 
+  QR-Codes: [Verwalten Sie den QR-Code Ihrer WhatsApp Geschäftsplattform](https://business.facebook.com/business/help/890732351439459) (Meta-Hilfeartikel) 
+  Click-to-WhatsAppAnzeigen: [Erstelle Anzeigen, auf die du WhatsApp im Ads Manager klickst](https://business.facebook.com/business/help/447934475640650?id=371525583593535) (Meta-Hilfeartikel) 

### So fügen Sie Ihrer Telefonnummer einen Anzeigenamen hinzu
<a name="add-display-name"></a>

Um einen verifizierten Anzeigenamen hinzuzufügen, der Kunden angezeigt wird, finden Sie in der Meta-Hilfe den [Anzeigenamen „Über WhatsApp Unternehmen](https://business.facebook.com/business/help/338047025165344)“.

### Skalieren von Traffic
<a name="scale-traffic"></a>

Nachdem Sie Live-Traffic in Ihre WhatsApp Integration integriert haben, empfehlen wir, die folgenden Kontingente zu überwachen.

**Kontingente für Amazon Connect**  
Weitere Informationen zu Standardkontingenten und deren Erhöhung finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md).
+ Kontingent [Gleichzeitig aktive Chats pro Instance](amazon-connect-service-limits.md#concurrent-active-chats). Weitere Informationen zum Überwachen dieses Kontingents finden Sie unter [Überwachen Sie Ihre Amazon Connect Connect-Instance mit CloudWatch](monitoring-cloudwatch.md).
+ Drosselungskontingent [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)
+ Drosselungskontingent [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html)
+ Drosselungskontingent `SendIntegrationEvent` Eine API nur für Berechtigungen, die von AWS End User Messaging Social verwendet wird, um eingehende WhatsApp Ereignisse zu veröffentlichen.

**Kontingente von End User Messaging Social**  
AWS End User Messaging Social erzwingt Ratenbegrenzungen für eine Reihe von Nachrichten APIs. Achten Sie APIs auf Folgendes, um festzustellen, ob Sie ein oder mehrere Kontingente ändern müssen. Die Links führen Sie zur *API-Referenz zu AWS End User Messaging Social*.
+  [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)
+  [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html)
+  [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html)

Weitere Informationen über die Erhöhung der Kontingente von AWS End User Messaging Social finden Sie in den folgenden Themen im *Benutzerhandbuch zu AWS End User Messaging Social*:
+ [Kontingente für AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html)
+ [Erhöhen Sie die Grenzwerte für Nachrichtenkonversationen WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html)
+ [Erhöhen Sie den Nachrichtendurchsatz in WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html)

## Beheben häufiger Probleme
<a name="whatsapp-troubleshooting"></a>

Verwenden Sie die folgenden Informationen, um häufig auftretende Probleme mit einer WhatsApp Integration zu beheben.

**Topics**
+ [

### Importierte Telefonnummern können in Ihrer Amazon-Connect-Instance nicht angezeigt werden
](#no-imported-number)
+ [

### Eingehende Nachrichten von Kunden werden nicht zugestellt
](#whatsapp-messages-not-delivered)

### Importierte Telefonnummern können in Ihrer Amazon-Connect-Instance nicht angezeigt werden
<a name="no-imported-number"></a>

Wenn Ihre importierte Nummer nicht auf der Admin-Website von Amazon Connect angezeigt wird, gehen Sie wie folgt vor:
+ Stellen Sie sicher, dass die IAM-Rolle des Ereignisziels über die erforderlichen Berechtigungen verfügt. Weitere Informationen finden Sie unter [Schritt 1: Aktivieren von Amazon Connect als Ereignisziel](#enable-connect-destination).
+ Prüfen Sie, ob das Kontingent für *Telefonnummern pro Instance* erhöht werden muss. Weitere Informationen finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md).
+ Um ein verknüpftes WhatsApp Geschäftskonto einer anderen Amazon Connect Connect-Instanz zuzuweisen, müssen Sie zunächst die importierten Telefonnummern aus der ursprünglichen Amazon Connect Connect-Instance freigeben. Nachdem die Telefonnummern veröffentlicht wurden, können Sie das Veranstaltungsziel in Ihrem verknüpften WhatsApp Geschäftskonto auf eine andere Amazon Connect Connect-Instanz aktualisieren.
**Wichtig**  
Geben Sie keine Nummern frei, unter denen Live-Kundenverkehr abgewickelt wird. Fordern Sie stattdessen [neue Telefonnummern](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html) an.
+ Um die Ursache des Importproblems zu ermitteln, durchsuchen Sie Ihre CloudTrail Protokolle nach `ImportPhoneNumber` Ereignissen und suchen Sie nach Fehlerdetails. Wenn der `ImportPhoneNumber`-Anruf erfolgreich ist, können Sie weitere `DescribePhoneNumber`-Fehlerdetails anfordern.

Nach der Problembehebung müssen Sie die Telefonnummern erneut importieren. Wiederholen Sie hierzu [Schritt 1: Aktivieren von Amazon Connect als Ereignisziel](#enable-connect-destination).

### Eingehende Nachrichten von Kunden werden nicht zugestellt
<a name="whatsapp-messages-not-delivered"></a>

Wenn die Zustellung WhatsApp eingehender Nachrichten stoppt, suchen Sie in Ihren AWS CloudTrail Protokollen nach `SendIntegrationEvent` und `SendChatIntegrationEvent` nach Fehlerdetails.

Sie können auch diese gängigen Szenarien überprüfen:
+ Stellen Sie sicher, dass für Ihr verknüpftes WhatsApp Geschäftskonto in AWS End User Messaging Social ein Amazon Connect Connect-Ereignisziel aktiviert ist.
+ Vergewissern Sie sich, dass die IAM-Rolle des Ereignisziels über die erforderlichen Berechtigungen verfügt. Weitere Informationen finden Sie in [Schritt 1: Aktivieren von Amazon Connect als Ereignisziel](#enable-connect-destination) weiter oben in diesem Abschnitt. Sie haben eine falsch konfigurierte Rolle, wenn CloudTrail `AccessDeniedException` Fehler von der `SendIntegrationEvent` API ausgegeben werden. 
+ Stellen Sie sicher, dass Ihre WhatsApp Telefonnummer erfolgreich in Ihre Amazon Connect Connect-Instance importiert wurde und dass der Nummer ein eingehender Kontaktfluss zugeordnet ist. Weitere Informationen finden Sie unter [Schritt 2: Konfigurieren des eingehenden Gesprächsablaufs für Ihre Telefonnummer](#inbound-contact-flow).
+ Eingehende Nachrichten wurden gelöscht, da sie noch nicht unterstützt werden. Weitere Informationen finden Sie unter [WhatsApp Funktionen und Einschränkungen von Business Messaging mit Amazon Connect](whatsapp-messaging-capabilities.md). 

# WhatsApp Funktionen und Einschränkungen von Business Messaging mit Amazon Connect
<a name="whatsapp-messaging-capabilities"></a>

Die WhatsApp Business Messaging-Integration bietet die folgenden Funktionen:
+ Textnachrichten
+ Interaktive Nachrichten. Weitere Informationen finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md).
+ Nachrichten mit Rich-Link-Vorschauen
+ Empfangs- und Lesebestätigungen für Geschäftsnachrichten
+ Anlagen

## Einschränkungen
<a name="whatsapp-messaging-limitations"></a>

Beachten Sie bei der Integration von WhatsApp Business Messaging mit Amazon Connect die folgenden Einschränkungen:

**Einschränkungen der Empfangsbestätigungen**
+ Lesebestätigungen für Kundennachrichten werden nicht unterstützt.
+ Empfangsbestätigungen für Kundennachrichten werden nicht unterstützt. Die Lieferbelege, die in erscheinen, WhatsApp geben an, dass die Nachricht erhalten WhatsApp wurde, nicht Amazon Connect. 



**Einschränkungen von Textnachrichten**
+ Eingehende Textnachrichten von Kunden mit mehr als 1 024 Zeichen werden nicht unterstützt. 



**Nicht unterstützte Nachrichtentypen**
+ Von Kunden gesendete eingehende Kontaktnachrichten werden nicht unterstützt. 
+ Von Kunden gesendete eingehende Kontaktnachrichten werden nicht unterstützt. 
+ Von Kunden gesendete Reaktionsnachrichten werden nicht unterstützt. 
+ Von Kunden gesendete Antwortnachrichten werden nicht unterstützt. Neue Nachrichteninhalte werden ohne den Antwortkontext übermittelt. 
+ Der Empfang von Statusmeldungen, dass eine Nachricht vom Kunden gelöscht wurde, wird nicht unterstützt. 



**Einschränkungen der Anhänge**
+ Alle Anhänge von Kunden bei der Initiierung eines neuen Kontakts oder einer neuen Konversation werden nicht unterstützt. Kunden können Anhänge nur während eines bestehenden Kontakts senden. 
+ Anhänge von Kunden, die größer als 20 MB sind, werden nicht unterstützt. 
+ Anhänge mit Untertiteln werden nicht unterstützt. Amazon Connect entfernt alle Untertitel und übermittelt den Anhang. 
+ Sticker-Anhänge werden nicht unterstützt. 