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.

# Einrichten Ihrer Kanäle
<a name="set-channels"></a>

Amazon Connect ist eine einheitliche Omnichannel-Lösung, die darauf ausgelegt ist, personalisierte, effiziente und proaktive Erlebnisse auf allen bevorzugten Kanälen der Kunden zu ermöglichen. Sie können nahtlose Erlebnisse für Ihre Kunden maßschneidern, sei es über das Telefon, über In-App- und Webanrufe, Video, Chat, Short Message Service (SMS) oder E-Mail. Kunden können kanalübergreifend mit demselben Kundendienstmitarbeiter zusammenarbeiten. Aber wenn es sich um einen anderen Kundendienstmitarbeiter handelt, bleibt der Interaktionsverlauf erhalten, sodass sie sich nicht wiederholen müssen. Das Omnichannel-Contact-Center verbessert das Kundenerlebnis und reduziert gleichzeitig die Auflösungszeit.

![\[Das Kundenerlebnis von Amazon Connect – nahtlos, personalisiert und proaktiv auf allen Kanälen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/omnichannel-diagram.png)


**Topics**
+ [Einrichten Ihrer Telefonnummern](ag-overview-numbers.md)
+ [Einrichten des Chat-Erlebnisses Ihres Kunden](enable-chat-in-app.md)
+ [SMS-Messaging einrichten](setup-sms-messaging.md)
+ [Hinzufügen des Amazon-Connect-Widgets zu Ihrer Website](connect-widget-on-website.md)
+ [Aktivieren von Apple Messages for Business](apple-messages-for-business.md)
+ [WhatsApp Business Messaging einrichten](whatsapp-integration.md)
+ [Einrichten von In-App-, Web-, Videoanruf- und Bildschirmfreigabe-Funktionen](inapp-calling.md)
+ [Aufgaben einrichten](concepts-getting-started-tasks.md)
+ [Einrichten von E-Mail](setup-email-channel.md)
+ [Erstellen von Schnellantworten](create-quick-responses.md)

# Einrichten von Contact-Center-Telefonnummern für Amazon-Connect-Instances
<a name="ag-overview-numbers"></a>

Nachdem Sie eine Amazon-Connect-Instance erstellt haben, können Sie eine Telefonnummer zur Verwendung für Ihren Contact Center erhalten. Sie können mit dieser Nummer einen Testanruf an Ihr Kontaktzentrum tätigen, um sich zu vergewissern, dass sie ordnungsgemäß funktioniert. Sie können sie auch in Ihrer Produktionsumgebung verwenden.
+ Preisinformationen zu den angeforderten Telefonnummern finden Sie unter [Amazon Connect – Preise](https://aws.amazon.com/connect/pricing/). 
+ Eine Liste der Telefoniefunktionen, die Amazon Connect bietet, finden Sie im [Amazon Connect Telecoms Country Coverage Guide](https://d1v2gagwb6hfe1.cloudfront.net/Amazon_Connect_Telecoms_Coverage.pdf). 

Wenn Sie eine bereits vorhandene Telefonnummer behalten möchten, können Sie die Telefonnummer portieren und mit Amazon Connect verwenden. Nachdem eine Telefonnummer zu portiert wurde, wird sie in der Liste der verfügbaren Telefonnummern angezeigt, die Sie den Flows zuweisen können.

**Topics**
+ [Sprachkanal](concepts-telephony.md)
+ [Stir/Shaken-Bescheinigung](stirshaken.md)
+ [Design für niedrige Latenz](low-latency-design.md)
+ [Portieren der aktuellen Telefonnummer](port-phone-number.md)
+ [Beantragen und Verwalten von Telefonnummern](claim-and-manage-phonenumbers.md)
+ [Verwenden der Anruferidentifikation zum Personalisieren der Kundeninteraktion](caller-id-personalizing-customer-interaction.md)
+ [Nummern von Drittanbietern](third-party-numbers.md)
+ [Unterstützung des UIFN-Service – nur eingehende Anrufe](uifn-service.md)
+ [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern](phone-number-requirements.md)

# Der Sprachkanal in Amazon Connect
<a name="concepts-telephony"></a>

**Wichtig**  
Möchten Sie Amazon in Supportfragen kontaktieren? Weitere Informationen finden Sie unter [Amazon-Kundenservice](https://www.amazon.com/gp/help/customer/display.html) (Amazon-Bestellungen und -Lieferungen) oder [AWS Support](https://aws.amazon.com/premiumsupport/) (Amazon Web Services).

Amazon Connect stellt verschiedene Optionen bereit, mit deren Hilfe Ihr Unternehmen Telefonanrufe tätigen und empfangen kann. Einer der großen Vorteile von Amazon Connect ist die AWS Verwaltung der Telefonie-Infrastruktur für Sie: Carrier-Verbindungen, Redundanz und Routing. Zudem ist die Lösung so konzipiert, dass sie skaliert werden kann. 

In diesem Thema werden die Optionen vorgestellt, die Amazon Connect für Telefonie bereitstellt und mit denen Sie eine Lösung entwickeln können, die Ihren geschäftlichen Anforderungen entspricht.

**Topics**
+ [Telefoniearchitektur](#concepts-telephony-architecture)
+ [Anwendungsfälle für unterschiedliche Konfigurationen](#concepts-use-cases)

## Telefoniearchitektur
<a name="concepts-telephony-architecture"></a>

Amazon Connect bietet Funktionen zum Hosten von gebührenfreien Nummern und Direktwahlnummern (DID) in allen von Amazon Connect unterstützten AWS Regionen. Sie können beide Typen in einer einzigen Instance verwenden. Eine vollständige Liste der unterstützten Leistungen countries/regions und Kosten finden Sie auf der [Preisseite von Amazon Connect](https://aws.amazon.com/connect/pricing/).

AWS verwaltet die Konnektivität zu unserem Netzwerk von Mobilfunkanbietern und bietet verschiedene Verbindungen zu mehreren Mobilfunkanbietern in jeder von Amazon Connect unterstützten Region. Wenn Amazon Connect in einer Region bereitgestellt wird, nutzen wir die integrierte Redundanz des AWS Availability Zone-Designs, um mehrere Schnittstellen für Telefongesellschaften in mehreren Rechenzentren bereitzustellen. Wie das Design einer Region AWS verwaltet wird, können Sie [hier nachlesen](https://infrastructure.aws/).

Der Service von Amazon Connect ist nicht nur über mehrere Availability Zones verteilt, AWS unterstützt auch mehrere Telefonieanbieter. Diese Anbieter verfügen über mehrere Verbindungen in die Rechenzentren in diesen Availability Zones. Dadurch wird sichergestellt, dass beim Fehlschlagen einzelner oder sogar mehrerer Verbindungen von einer Telefongesellschaft alternative Routen verfügbar sind, die sicherstellen, dass der Service verfügbar bleibt. 

Weitere Informationen zur Architektur von Amazon Connect finden Sie unter[Hinweise zur Architektur für Amazon Connect](architecture-guidance.md).
+ **AWS verwaltet gebührenfreie Nummern als verantwortungsbewusstes Unternehmen**

  Diese Nummern sind Telefonnummern mit speziellen Vorwahlnummern, die für die anrufende Person keine Kosten verursachen. Solche Nummern ermöglichen es Anrufern, Unternehmen und and/or Privatpersonen außerhalb der Region zu erreichen, ohne dass für den Anruf eine Gebühr für Ferngespräche berechnet wird. 

  In den USA veröffentlicht die [Federal Communications Commission](https://www.fcc.gov/consumers/guides/what-toll-free-number-and-how-does-it-work) Regeln für Bezug und Verwendung gebührenfreier Telefonnummern. In anderen Ländern stellen ähnliche Regulierungsbehörden sicher, dass solche Telefonnummern nach Maßgabe der lokale Gesetzen verwaltet und verteilt werden.

  Wenn Sie eine gebührenfreie US-Nummer beantragen oder in Amazon Connect portieren, registrieren wir diese Nummer bei [SOMOS](https://www.somos.com/). Nachdem die Nummer registriert ist, können wir mehrere Telefongesellschaften auswählen, um Redundanz sowohl hinsichtlich der Routen als auch der Telefongesellschaften bereitzustellen. Dies sorgt für höchste Verfügbarkeit und stellt sicher, dass die Nummer auch bei einem vollständigen Ausfall der Telefongesellschaft verfügbar bleibt. Für diesen Service fallen zusätzliche Kosten an, da diese Nummern teurer als DID-Nummern sind. Die Zuverlässigkeit des Services und die hervorragende Kundenerfahrung machen ihn aber zur attraktivsten Option.
+ **Lokal formatierte Nummern**

  Direct Inward Dialing (DID) oder (in Europa) Direct Dial-In (DDI) bezeichnet einen Telekommunikationsservice, den Telefongesellschaften ihren Kunden anbieten. DID-Nummern sind dem lokal üblichen Telefonnummernformat entsprechende Nummern, die dem Wählmuster eines lokalen Teilnehmers entsprechen können. Beispiel: In Seattle, Washington, USA, ist das lokale Wählmuster \$11(206)-NXX-XXXX. Der Anbieter der DID-Nummer würde ein mit \$11(206) gebildetes Muster bereitstellen, um dieser Konvention zu folgen.

  In den USA werden DID-Nummern von State Public Utilities-Kommissionen reguliert. DID-Nummern werden von einer einzelnen Telefongesellschaft verwaltet. Sie sind zwar portabel, können aber nicht balanced/managed auf mehrere Mobilfunkanbieter verteilt werden. Dies macht sie weniger zuverlässig als gebührenfreie Nummern.

  DID-Nummern bieten die Möglichkeit, ausgehende Anrufe mit einer lokalen Leitungskennung zu tätigen und für Anrufer als lokales Ziel zu erscheinen. Dies kann nützlich sein, um die Wahrscheinlichkeit zu erhöhen, dass ausgehende und in die Warteschlange gestellte Rückrufe von Kunden beantwortet werden. Zudem demonstriert es Kunden lokale/regionale Präsenz und reduziert die Anrufkosten im Vergleich zu Ferngesprächen, wenn Sie keine gebührenfreie Nummer veröffentlichen.

  Da DID-Nummern an eine Telefongesellschaft gebunden sind, bietet Amazon Connect hinsichtlich der Telefongesellschaften bei DID-Nummern keine Redundanz. Wir bieten Verbindungsredundanz über mehrere Availability Zones hinweg, so dass eine Telefongesellschaft bei einem Verbindungsausfall weiterhin Anrufe vermitteln kann, wenn die Einrichtungen dieser Gesellschaft an einem anderen Ort weiter funktionsfähig sind. Für DID-Nummern gilt außerdem eine Kapazitätsbeschränkung hinsichtlich der Anzahl der Anrufe, die über eine einzelne Nummer möglich sind. Diese Beschränkung variiert regionsabhängig. Es ist wichtig, dass Sie mit Ihrem AWS Account-Team zusammenarbeiten, um sicherzustellen, dass Sie über die richtigen DID-Nummern verfügen, wenn Sie DID-Nummern als primären Eingangskanal verwenden möchten und mit mehr als 100 gleichzeitigen Anrufen pro Nummer rechnen müssen.

  DID-Nummern sind günstiger als gebührenfreie Rufnummern, bieten aber nicht deren Redundanz und geografische Abdeckung. Die Möglichkeit, lokal erscheinende Telefonnummern zu verwenden, kann gleichwohl für Unternehmen eine attraktive Option sein.

## Anwendungsfälle für unterschiedliche Konfigurationen
<a name="concepts-use-cases"></a>

### Ein Neuanfang mit Amazon Connect
<a name="concepts-new-config"></a>

Wählen Sie in diesem Fall einfach neue Telefonnummern im Rahmen des Verfahrens zum Beantragen von Telefonnummern aus. Detaillierte Anweisungen finden Sie unter [Erhalten einer lokalen gebührenfreien oder lokalen gebührenpflichtigen Amazon-Connect-Telefonnummer](get-connect-number.md).

### Migration zu Amazon Connect von einem anderen Anbieter/einer anderen Plattform
<a name="concepts-migrate-platforms"></a>

Wenn Sie eine Migration zu Amazon Connect von einer anderen Plattform vornehmen, empfehlen wir Ihnen, mit einem Proof of Concept zu beginnen und dann im Zeitverlauf nach Amazon Connect zu migrieren.
+ Eine bewährte Methode besteht darin, vorhandene Telefonnummern an die neuen Nummern weiterzuleiten, die in Amazon Connect beantragt wurden, bis die Konvertierung abgeschlossen ist. 
+ Nach Abschluss der Konvertierung können Sie die Telefonnummern mit dem [Portierungsverfahren](port-phone-number.md) zu Amazon Connect migrieren. 
+ So bleibt ein Fallback möglich, wenn bei der Migration Probleme auftreten.

### Pflegen zweier separater Plattformen
<a name="concepts-two-platforms"></a>

Gelegentlich werden Telefoniefunktionen nicht nur für eine Plattform für Kontaktzentren benötigt. Hier eine Übersicht zur Konfiguration:
+ Wählen Sie die Plattform, die Anrufe zunächst bearbeiten und dann an die andere Plattform weiterleiten soll. 
+ Wenn Amazon Connect die primäre Plattform zur Bearbeitung von Anrufen ist, können Sie Telefonnummern portieren oder beantragen. Sie entwerfen Flows, um Anrufe unter Verwendung einer im Flow angegebenen Telefonnummer an die andere Plattform zu übertragen. 
+ Wenn die externe Plattform die primäre Anrufbearbeitung übernehmen soll, müssen Sie diese Plattform so konfigurieren, dass Anrufe an eine Nummer weitergeleitet werden, die Sie in Amazon Connect beantragen. Wählen Sie dazu entweder eine gebührenfreie Telefonnummer für bessere Redundanz und mehr Kapazität zu höheren Kosten oder einen Satz DID-Nummern für die Anrufübernahme in Amazon Connect.
+ Für diesen Anwendungsfall empfehlen wir Ihnen, den Support für AWS Solution Architecture in Anspruch zu nehmen, um sicherzustellen, dass Ihr Kontaktzentrum gut strukturiert ist, um die bestmöglichen Ergebnisse zu erzielen.

# Stir/Shaken-Bescheinigung in Amazon Connect
<a name="stirshaken"></a>

Amazon Connect unterstützt die STIR/SHAKEN Bestätigung ausgehender Anrufe, um das Fälschen der Anrufer-ID zu verhindern. 

Bei Anrufen aus Vereinigte Staaten direct-inward-dial (DID) oder gebührenfreien Nummern zu Zielen im North American Numbering Plan (NANP) (Präfix \$11) signiert Amazon Connect Anrufe mit STIR/SHAKEN Kopfzeilen, die den Grad der Bestätigung angeben.

**Topics**
+ [Was ist STIR/SHAKEN?](#what-is-stirshaken)
+ [Bescheinigungsstufen in Amazon Connect](#attestation-levels)
+ [Anforderungen an eine Bescheinigung der Stufe A](#attestation-level-a)
+ [Anforderungen an eine Bescheinigung der Stufe B](#attestation-level-b)
+ [Beispiele für Bescheinigungen der Stufe C](#examples-c-attestation)
+ [Wissenswertes](#important-attestation)

## Was ist STIR/SHAKEN?
<a name="what-is-stirshaken"></a>

Das STIR/SHAKEN Framework wurde entwickelt, um betrügerisches Anrufer-ID-Spoofing in Telefonienetzen zu bekämpfen. Es besteht aus zwei Komponenten:
+ STIR (Secure Telephone Identity Revisited): Die zugrunde liegende Protokollsuite, die die kryptografische Signierung und Überprüfung von Rufnummern ermöglicht.
+ SHAKEN (Signature-based Handling of Asserted Information Using toKENs): Richtlinien für die Implementierung dieser Protokolle in Netzwerken.

Weitere Informationen zu STIR/SHAKEN finden Sie auf der Website der Federal Communications Commission (FCC) unter [Combating Spoofed Robocalls with Caller ID Authentication](https://www.fcc.gov/call-authentication). 

## Bescheinigungsstufen in Amazon Connect
<a name="attestation-levels"></a>

Amazon Connect weist beim Signieren ausgehender Anrufe eine von drei Bescheinigungsstufen zu:
+ Stufe A (vollständig) – Amazon Connect hat:
  + Den Anrufer authentifiziert
  + Seine Autorisierung zur Verwendung der Rufnummer bestätigt
+ Stufe B (partiell) – Amazon Connect hat:
  + Den Anrufer authentifiziert
  + Seine Autorisierung zur Verwendung der Rufnummer nicht verifiziert
+ Stufe C (Gateway) – Amazon Connect hat:
  + Den Anruf initiiert
  + Die Identität des Anrufers nicht verifizieren können
  + Die legitime Verwendung der Rufnummer nicht verifizieren können

## Anforderungen an eine Bescheinigung der Stufe A
<a name="attestation-level-a"></a>

Ihre Anrufe erhalten eine A-Level-Bestätigung, wenn Sie den AWS-Servicebedingungen unterliegen oder Kunde eines autorisierten Provider/Distribution AWS-Lösungsverkäufers sind UND eine der folgenden Bedingungen erfüllt ist:
+ Telefonnummer, die über das Amazon-Connect-Portal/die API angefordert wurde.
+ Telefonnummer, die in Amazon Connect portiert wurde.
+ Telefonnummer eines Drittanbieters, das Ihrem Konto mit validierter Dokumentation zugeordnet ist.

## Anforderungen an eine Bescheinigung der Stufe B
<a name="attestation-level-b"></a>

Ihre Anrufe erhalten eine Bescheinigung der Stufe B, wenn Folgendes zutrifft:
+ Sie wurden darüber informiert, dass weitere Angaben erforderlich sind, um die Bescheinigung der Stufe A aufrechtzuerhalten.
+ Wir haben Sie NICHT darüber informiert, dass wir die von Ihnen angegebenen Informationen erfolgreich validiert haben.

## Beispiele für Anrufe, die eine Bescheinigung der Stufe C erhalten
<a name="examples-c-attestation"></a>

Alle Anrufe, die keine Bescheinigung der Stufe A oder B erhalten, erhalten eine Bescheinigung der Stufe C. 

Im Folgenden finden Sie Beispiele für Anrufe, die eine Bescheinigung der Stufe C erhalten:
+ Anrufe von Kunden, die unautorisierte Lösungsanbieter verwenden.
+ Anrufe, die unter Verstoß gegen die AWS Servicebedingungen getätigt wurden (z. B. Umleitung von Anrufen).
+ Fälle, in denen wir Sie darüber informiert haben, dass weitere Angaben erforderlich sind, und wir die angeforderten Bescheinigungsunterlagen nicht bis zum festgelegten Datum erhalten haben.

## Wissenswertes
<a name="important-attestation"></a>
+ Amazon Connect stellt Spediteuren zwar STIR/SHAKEN Header zur Verfügung, die Bescheinigung kann jedoch end-to-end aufgrund veralteter Geräte in einigen Carrier-Netzwerken, die diese Header nicht übertragen können, möglicherweise nicht aufbewahrt werden.
+  Netzbetreiber können anhand dieser Bescheinigungsstufen entscheiden, ob sie Anrufe in ihrem Netzwerk vermitteln. 
+  Um die höchsten Bescheinigungsstufen für Ihre Anrufe beizubehalten, können Sie von Amazon Connect aufgefordert werden, zusätzliche Informationen anzugeben. In der an Sie gesendete Benachrichtigungs-E-Mail teilen wir Ihnen mit, bis wann Sie die angeforderten Informationen bereitstellen müssen. Jede Verzögerung bei der Bereitstellung der Informationen kann sich auf die Bescheinigungsstufe Ihrer Anrufe und daher auf den Erfolg der Anrufzustellung auswirken.

# Konzipieren des Amazon-Connect-Contact-Centers für niedrige Latenz, um die Anrufqualität sicherzustellen
<a name="low-latency-design"></a>

**Anmerkung**  
Seit Juli 2023 haben wir die Anforderungen für die Inanspruchnahme von Telefonnummern vereinfacht, die sich in Ländern außerhalb der AWS Region befinden, in der sich Ihre Amazon Connect Connect-Instance befindet. Der Prozess wurde vereinfacht, sodass keine Opt-in-Genehmigung mehr erforderlich ist. Stattdessen bieten wir Designleitfäden mit bewährten Verfahren. Dies erleichtert es Ihnen, eine Amazon-Connect-Instance zu verwenden, die beispielsweise in der Region USA-Ost erstellt wurde, und dann Nummern in Japan anzufordern. Oder, wenn Ihre Instance im asiatisch-pazifischen Raum (Singapur) erstellt wurde, müssen Sie sich nicht an den AWS-Support wenden, um Telefonnummern mit Sitz in Europa oder den USA zu beantragen.   
Wir erweitern die Unterstützung von Amazon Connect weiter, sodass Sie Telefonnummern in den Ländern, die Sie benötigen, anfordern können, wo immer Sie sie benötigen. 

Wenn Sie Ihre Amazon Connect Connect-Instance so konfigurieren, dass sie Telefonnummern außerhalb der AWS Heimatregion Ihres Landes unterstützt, empfehlen wir die folgenden bewährten Methoden.

1. Verankern Sie entweder Ihre Telefonnummern oder Agenten in derselben AWS Region, in der sie sich geografisch befinden. Wenn sich Ihre Agenten beispielsweise in einer Region der USA befinden, sollte Ihre Amazon Connect Connect-Instance auch in einer AWS Region in den USA erstellt werden. Oder, wenn sich Ihre Telefonnummern in einem EU-Land befinden, sollte Ihre Amazon-Connect-Instance auch in einer EU AWS -Region erstellt werden.

   1. **Wenn sich sowohl Ihre Telefonnummern als auch Ihre Agenten in einer AWS Region befinden, die sich von der Region unterscheidet, in der Ihre Amazon Connect Connect-Instance erstellt wurde, wird die Anruflatenz für Netzwerklatenz (WebRTC RTT) auf über 500 ms verlängert.** Diese Latenz kann zu Problemen mit der Anrufqualität führen.

1. Berechnen Sie Ihre Latenz, bevor Sie Ihr Amazon-Connect-Kontaktzentrum in der Produktion einrichten. Führen Sie in einer Testumgebung die folgenden Schritte aus:

   1. Verwenden Sie das [Amazon Connect Endpoint Test Utility](check-connectivity-tool.md), um die Latenz zu überprüfen. 

   1. Berechnen Sie die Latenz für die Weiterleitung der Telefonie vom Land zur AWS Region mithilfe internetbasierter, externer Tools wie. [WonderNetwork](https://wondernetwork.com/)

   1. Für Anrufe mit der besten Anrufqualität empfehlen wir Konfigurationen mit einer Latenz von weniger als 500 ms. end-to-end

   1. Sie können festlegen, dass die Anrufqualität bei einer Latenz von bis zu 900 ms sowohl für die Netzwerk- als auch für die Telefonielatenz akzeptabel ist. (900 ms ist die Summe aus 500 ms Netzwerklatenz und 400 ms Netzbetreiberlatenz.) Wenn Sie jedoch ein Problem mit der Anrufqualität feststellen, das auf Latenz zurückzuführen sein kann, und andere mögliche Ursachen ausgeschlossen sind (z. B. werden weder Paketverlust noch Jitter erkannt), empfehlen wir, Ihre Amazon-Connect-Instance oder Telefonie für eine geringere Latenz zu konfigurieren. Erstellen Sie beispielsweise Ihre Amazon-Connect-Instance in derselben Region wie Ihre Telefonie oder Kundendienstmitarbeiter. 
**Wichtig**  
Wenn die Anruflatenz mehr als 900 ms für Netzwerk und Telefonie beträgt, führt dies zu einer erheblichen Verzögerung zwischen Kundendienstmitarbeiter und Kunden.

1. Vergewissern Sie sich, dass die Latenz Ihrem Design entspricht.

   Nachdem Sie eine Nummer beansprucht haben, können Sie sie sofort anrufen, um zu erfahren, wie das Erlebnis für Ihre Kunden aussehen wird. Amazon Connect verwendet die [StandardFlows](contact-flow-default.md), um Ihre erste Erfahrung zu verbessern. 

   Um einen benutzerdefinierten GesprächsFlow zu testen, [weisen Sie eine Telefonnummer](associate-claimed-ported-phone-number-to-flow.md) zu und rufen diese an.

# Portieren einer aktuellen Telefonnummer nach Amazon Connect
<a name="port-phone-number"></a>

Sie können Ihre vorhandenen Telefonnummern auf Ihr Amazon-Connect-Kontaktzentrum portieren. 

**Topics**
+ [Wissenswertes über die Portierung](things-to-know-before-porting.md)
+ [Südkoreanische Portierungsrichtlinien für Ihre Amazon-Connect-Instance](porting-numbers-sk.md)
+ [Wissenswertes über die Portierung von Telefonnummern in Thailand](porting-numbers-th.md)
+ [Portierung Ihrer Telefonnummern](porting-your-phone-numbers.md)
+ [Nach Abschluss des Portierungsvorgangs](porting-troubleshoot.md)

# Wissenswertes vor der Portierung einer Telefonnummer zu Amazon Connect
<a name="things-to-know-before-porting"></a>

In den Themen in diesem Abschnitt wird erklärt, welche Nummern portiert werden können, wie lange es dauert und welche Gebühren für Sie anfallen könnten. 

In diesen Themen wird die folgende Terminologie verwendet:

**Letter of Authorization**  
Ein Letter of Authorization (LOA) ist ein rechtsgültiges Dokument, in dem Sie gegenüber dem Betreiber von Amazon Connect versichern, dass Sie befugt sind, Telefonnummern von Ihrem aktuellen Mobilfunkanbieter an den Betreiber von Amazon Connect zu übertragen. Gewöhnlich handelt es sich dabei um ein Papierdokument, das handschriftlich unterzeichnet sein muss.

**Losing carrier**  
Wird auch als Ihr aktueller Netzbetreiber bezeichnet. Es handelt sich dabei um den Betreiber, dem Ihre Telefonnummer derzeit gehört. Der Quellbetreiber überprüft alle Informationen auf dem Letter of Authorization (LOA) und auch, ob diese mit den Angaben übereinstimmen, die er über Sie gespeichert hat.

**Einvernehmlich vereinbartes Datum und Uhrzeit**  
Nachdem der LOA vom Quellbetreiber genehmigt wurde, vereinbaren der Quell- und der Zielbetreiber ein Datum und eine Uhrzeit für die Portierung.

**Portabilität von Telefonnummern**  
Aufgrund der Portierbarkeit von Telefonnummern können Sie Ihre Telefonnummern an andere Betreiber übertragen. Für bestimmte Betreiber und Länder sind möglicherweise gesonderte Flows und Verfahren erforderlich.

**Erfolgreicher Mobilfunkanbieter**  
Das ist der Betreiber von Amazon Connect. Es handelt sich dabei um den Betreiber, zu dem die Telefonnummer portiert wird, der nach Abschluss der Portierung Eigentümer der Telefonnummer ist. 

**Topics**
+ [Was ist die Portierung von Telefonnummern?](what-is-phone-number-porting.md)
+ [Was kostet das?](fees-for-number-porting.md)
+ [Kann meine Nummer portiert werden?](what-numbers-can-be-ported.md)
+ [Wie lange dauert es, bis Portnummern erhalten werden?](how-long-for-number-porting.md)
+ [Kann ich eine geplante Portierung stornieren?](cancel-port-request.md)
+ [Wann kündige ich meinen aktuellen Telekommunikationsdienst?](cancel-current-service.md)

# Was bedeutet es, Telefonnummern nach Amazon Connect zu portieren?
<a name="what-is-phone-number-porting"></a>

Beim Portieren einer Telefonnummer wird eine Telefonnummer von einem Telefondienstanbieter oder Mobilfunkanbieter zu einem anderen übertragen. Viele Unternehmen und Organisationen haben bereits eine Telefonnummer, die ihren Kunden mitgeteilt wird. Eine Änderung dieser Nummer wäre also störend.

Wenn Sie eine Telefonnummer von Ihrem aktuellen Mobilfunkanbieter auf Amazon Connect portieren, können Sie dieselbe Telefonnummer weiterhin für Ihr Kontaktzentrum verwenden. Auf diese Weise müssen Sie Ihre geschäftlichen Kontaktinformationen nicht aktualisieren.

## Ausfallzeiten und Betriebsunterbrechungen während des Portierungsprozesses
<a name="porting-downtime"></a>

Der Portierungsprozess erfordert, dass der unterlegene Mobilfunkanbieter Ihre Nummer aus seinen Systemen entfernt, der gewinnende Mobilfunkanbieter Ihre Nummer zu seinen Systemen hinzufügt und dass die Rufnummernweiterleitung aktualisiert wird. Die meisten Portierungsaktivitäten werden innerhalb von 15 bis 30 Minuten abgeschlossen, was zu Verbindungsunterbrechungen führen kann. Um sicherzustellen, dass ihnen Techniker zur Behebung von Problemen zur Verfügung stehen, führen die meisten unterlegenen Netzbetreiber Portierungsaktionen nur während der normalen Geschäftszeiten durch. Die Netzbetreiber teilen in der Regel ein Portierungsfenster von zwei Stunden mit, um eventuell auftretende Probleme zu lösen. 

Ausführliche Informationen zu den verfügbaren Portierungsdaten und -zeiten finden Sie unter [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md) für Ihr Land oder Ihre Region. 

## Was passiert mit einer Zahl, nachdem sie portiert wurde
<a name="what-happens-after-number-porting"></a>

Solange Sie weiterhin für die Telefonnummer bezahlen und sie nicht von Ihrer Amazon-Connect-Instance freigeben, bleibt sie Ihrem Konto zugewiesen, und Ihnen wird eine entsprechende Rechnung gestellt. 

Um eine Telefonnummer freizugeben, folgen Sie den Schritten unter[Geben Sie eine Telefonnummer von Amazon Connect zurück in den Lagerbestand](release-phone-number.md).

Wenn eine Telefonnummer von Ihrer Amazon-Connect-Instance freigegeben wird:
+ Es wird Ihnen nichts mehr in Rechnung gestellt.
+ Sie können die Telefonnummer nicht zurückfordern.
+ Amazon Connect behält sich das Recht vor, die Beantragung durch einen anderen Kunden zuzulassen.

Wenn Sie Ihr Kontaktzentrum von Amazon Connect wegziehen und Ihre Telefonnummer von Amazon Connect entfernen möchten, finden Sie weitere Informationen unter[Telefonnummern außerhalb von Amazon Connect portieren](port-away.md). 

# Was kostet die Portierung einer Telefonnummer nach Amazon Connect?
<a name="fees-for-number-porting"></a>

Amazon Connect erhebt keine Gebühren für die Portierung von Nummern. Bei Ihrem derzeitigen Mobilfunkanbieter fallen möglicherweise Gebühren im Zusammenhang mit der Unterbrechung und der vorzeitigen Beendigung Ihres Services an.

Nachdem eine Telefonnummer auf Amazon Connect portiert wurde, gelten die Standardpreise für die [Nutzung des Amazon-Connect-Services und die damit verbundenen Telefontarife](https://aws.amazon.com/connect/pricing/). 

# Telefonnummern, die nach Amazon Connect portiert werden können
<a name="what-numbers-can-be-ported"></a>

Nicht alle Telefonnummern können portiert werden. Die Fähigkeit, eine bestimmte Telefonnummer zu portieren, hängt von mehreren Faktoren ab. Beispiel:
+ Die Vorschriften in dem Land oder der Region der Telefonnummer. 
+ Vereinbarungen zwischen den unterlegenen und den gewinnenden Fluggesellschaften.
+ Der Typ der Telefonnummer, die portiert wird.
+ Ihr Servicevertrag mit Ihrem aktuellen Dienstanbieter.

Um herauszufinden, ob eine Telefonnummer, die Sie derzeit besitzen – ob lokal, mobil oder gebührenfrei – auf Amazon Connect portiert werden kann: 

1. Prüfen Sie, ob Ihr Land oder Ihre Region die Rufnummernportierung unterstützt:. [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md)

1. Dann [reichen Sie zunächst ein Amazon-Connect-Supportticket zur Nummernverifizierung](about-porting.md#step1-porting) ein. 

## Portierung von Nummern, die bei anderen Contact-Center-Anbietern gekauft wurden
<a name="numbers-from-other-providers"></a>

In den meisten Fällen können Sie Nummern, die von anderen Contact-Center-Anbietern gekauft wurden, portieren. Erkundigen Sie sich bei Ihrem aktuellen Contact-Center-Anbieter, der die Nummer zugewiesen hat, und arbeiten Sie mit diesem zusammen, um sicherzustellen, dass die richtigen Informationen im Letter of Authorization (LOA) enthalten sind. 

## Portieren Sie kurze Telefonnummern
<a name="port-short-numbers"></a>

Aufgrund der Telekommunikationsvorschriften in verschiedenen Ländern oder Regionen muss die Kurztelefonnummer auf einer bestimmten case-by-case Grundlage geprüft werden. Um zu überprüfen, ob Ihre Telefonnummer auf Amazon Connect portiert werden kann, [reichen Sie ein Amazon-Connect-Supportticket](about-porting.md#step1-porting) ein. 

## Portieren Sie eine Nummer nur in eine EU-Region
<a name="port-across-eu-regions"></a>

Die Amazon-Connect-Regionen EU-CENTRAL-1 und EU-WEST-2 sind symmetrische europäische Regionen, die dieselbe Netzabdeckung für Telefonie bieten. Wenn eine Telefonnummer nicht auf eine Instance in einer dieser Regionen portiert werden kann, kann sie auch nicht auf eine Instance in der anderen Region portiert werden. 

Wenn Sie eine Telefonnummer in die Regionen EU-CENTRAL-1 oder EU-WEST-2 portiert hatten und diese in die andere Region verschieben möchten, [reichen Sie ein Amazon-Connect-Supportticket ein](about-porting.md#step1-porting), um Unterstützung zu erhalten. 

Das Gleiche gilt für die nordamerikanischen Regionen US-EAST-1 und US-WEST-2. 

## Portieren Sie eine Teilmenge von Zahlen aus einem Block
<a name="port-subset-of-numbers"></a>

Wenn Sie einen Nummernblock haben, kann Amazon Connect in einigen Fällen eine Teilmenge oder einen Teil Ihrer Telefonnummern portieren. In anderen Fällen verlangt der Mobilfunkanbieter die Portierung eines vollständigen Telefonnummernblocks. 

Wenn Sie nur einen Teil der Telefonnummern, die Sie derzeit besitzen, auf Amazon Connect portieren möchten, [reichen Sie ein Amazon-Connect-Supportticket ein](about-porting.md#step1-porting), um zu überprüfen, ob die Telefonnummern portiert werden können. Wir werden überprüfen, welche Aktionen abgeschlossen werden können, und Ihnen bei den nächsten Schritten behilflich sein.

**Anmerkung**  
Wenn Sie nur einen Teil der Telefonnummern portieren, haften Sie trotzdem für die verbleibenden Telefonnummern beim ursprünglichen Mobilfunkanbieter und für alle damit verbundenen Gebühren.   
Wenn Sie beabsichtigen, die verbleibenden Telefonnummern freizugeben, die nicht auf Amazon Connect portiert wurden, empfehlen wir, zu warten, bis die angeforderte Portierung abgeschlossen ist, um Serviceunterbrechungen zu vermeiden. 

## Kompromißschreiben
<a name="letter-of-compromise"></a>

Vor der Portierung von Telefonnummern bitten einige Kunden um eine Kompromisserklärung, in der sie angeben, dass sie ihre Telefonnummern von Amazon Connect auf einen anderen Dienst übertragen dürfen, falls ihr Kontaktzentrum umzieht. Aufgrund der Telekommunikationsvorschriften in verschiedenen Ländern muss die Telefonnummer auf einer bestimmten case-by-case Grundlage bewertet werden. Um zu überprüfen, ob Ihre Telefonnummer auf Amazon Connect portiert werden kann, [reichen Sie ein Ticket an den Amazon-Connect-Support](about-porting.md#step1-porting) ein. 

# Wie lange dauert es, bis Telefonnummern nach Amazon Connect portiert werden?
<a name="how-long-for-number-porting"></a>

**Wichtig**  
Portierungsanfragen für lokale gebührenpflichtige (DID) und gebührenfreie Telefonnummern in den USA können nicht mehr als 30 Tage vor dem Portierungsdatum übermittelt werden.  
Stellen Sie einen Portierungsantrag für andere Länder so lange wie möglich vor dem geplanten Starttermin.

Wie lange es dauert, Nummern zu portieren, hängt vom Land, der Komplexität der Anfrage, der Art und Menge der zu portierenden Nummern und Ihrem aktuellen Mobilfunkanbieter ab. Telekommunikationsanbieter können aufgrund von Feiertagen und aufgrund von Netzwerkwartungsarbeiten auch Sperrtage für die Portierung einrichten. Aus diesem Grund verlangt Amazon Connect, dass Portierungsanfragen mehrere Monate vor den ausstehenden Go-Live-Terminen geöffnet sein müssen.

Eine Liste der Länder und ihrer Portabilitätsfenster finden Sie unter[Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md).

## In den USA und Kanada
<a name="how-long-porting-us"></a>

Die Portierung von Telefonnummern in den USA oder Kanada dauert in der Regel zwischen zwei und vier Wochen, nachdem die Übertragbarkeit der Telefonnummer überprüft wurde und alle erforderlichen Dokumente korrekt beim Mobilfunkanbieter eingereicht wurden. 

## Außerhalb der USA und Kanadas
<a name="how-long-non-us-porting"></a>

Bei Telefonnummern außerhalb der USA und Kanadas dauert es zwischen zwei und sechs Monaten, bis der gesamte Portierungsprozess abgeschlossen ist. Dies umfasst: 
+ Zeit für Sie, alle Dokumente beim AWS Support einzureichen.
+ Zeit für den Amazon-Connect-Dienstanbieter, zu überprüfen, ob er alle von Ihnen angeforderten Telefonnummern portieren kann.
+ Zeit für den unterlegenen Anbieter, die bereitgestellten Dokumente zu überprüfen.

Nachdem alle Dokumente vom unterlegenen Anbieter überprüft wurden, vereinbaren der unterlegene Anbieter und der Amazon-Connect-Serviceanbieter einen einvernehmlich vereinbarten Termin für die Portierung der Nummern auf Amazon Connect. 

## Was wirkt sich auf die Portierungszeitpläne aus?
<a name="what-affects-porting-timelines"></a>

Die Portierungsfristen können sich negativ auswirken, wenn auf dem erforderlichen Letter of Authorization (LOA) falsche Informationen angegeben werden. Dadurch wird die LOA abgelehnt und die Portierungszeitpläne werden zurückgesetzt. 

## Portieren Sie viele Nummern über mehrere Länder oder Netzbetreiber
<a name="porting-many-numbers-many-countries"></a>

Komplexe Portierungsanfragen haben ihre eigenen Zeitpläne. Die an anderer Stelle in diesem Thema erörterten Zeitpläne gelten nicht für komplexe Portierungsanfragen. 

Komplexe Portierungsanfragen für mehr als 10 verschiedene Nummernbereiche oder 10 verschiedene Standorte gelten als Projekt und erfordern eine vorherige Abstimmung mit Ihrem AWS Account-Team. Wenden Sie sich für Geschäfts- oder Enterprise-Kunden (Amazon Connect Solutions Architect (SA) oder Technical Account Manager (TAM) an Ihren Amazon Connect Solutions Architect (SA) oder Technical Account Manager (TAM) für Unterstützung bei der Planung Ihrer Rufnummern-Übertragung (TAM). 

Um den Prozess so reibungslos wie möglich zu gestalten, sollten Sie die folgenden Informationen sammeln, bevor Sie eine Portierungsanfrage einreichen: 
+ Ihre aktuelle Telefonrechnung von den Mobilfunkanbietern, die derzeit die zu portierenden Nummern bedienen. 
+ Die landesspezifischen Unterlagen sind erforderlich; siehe[Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md). 
+ Die Kontaktinformationen für einen zentralen Ansprechpartner, der im Namen Ihrer Organisation die Portierungsanfragen bearbeiten kann.

## Kann ich das Portierungsdatum wählen?
<a name="choosing-port-date"></a>

**Wichtig**  
Das Amazon-Connect-Serviceteam unterstützt die Portierung von Telefonnummern VON Montag 9 Uhr in Sydney, NSW (australische Zeitzone) BIS Freitag 17 Uhr in Seattle, WA (USA-Zeitzone).

Abhängig vom Land und den beteiligten Fluggesellschaften können Sie möglicherweise das Datum und die Uhrzeit der Portierung wählen. In den meisten Fällen wählt der unterlegene Transporteur jedoch Datum und Uhrzeit aus und teilt es Amazon Connect auf der Grundlage seines Zeitplans mit. 

Wenn Sie ein bestimmtes Datum und eine bestimmte Uhrzeit anfragen möchten, geben Sie die Informationen in Ihrem Support-Fall an. Wir werden mit unserem Spediteur zusammenarbeiten, um festzustellen, ob er das von Ihnen angeforderte Datum und die angeforderte Uhrzeit unterstützen kann. 

**Anmerkung**  
Die meisten Mobilfunkanbieter unterstützen Portierungsaktivitäten nur während ihrer normalen Geschäftszeiten. Ausführliche Informationen zu den verfügbaren Portierungsterminen und -zeiten für Ihr Land finden Sie unter[Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md).

# Kann ich eine geplante Portierung von Telefonnummern in Amazon Connect stornieren?
<a name="cancel-port-request"></a>

**Wichtig**  
Wenn Sie Ihre Portierung stornieren oder verschieben müssen, teilen Sie uns dies umgehend mit.

Je nach Land, in dem der Service angeboten wird, kann es schwierig sein, zu stornieren, nachdem ein einvernehmlich vereinbarter Termin und eine vereinbarte Uhrzeit festgelegt wurden. 

Aufgrund der erforderlichen Koordination zwischen den Transporteuren benötigt der Amazon-Connect-Support eine Frist von mindestens 5 Werktagen, um eine Portierungsanfrage zu stornieren oder zu verschieben, sofern die Nummer nicht bereits portiert wurde. Wenn Sie Ihre Portierung stornieren oder verschieben müssen, teilen Sie uns dies umgehend mit. 

Sie können einen Port nicht stornieren, nachdem er an die RespOrg (verantwortliche Organisation) verschoben wurde. Der Port ist abgeschlossen. Informationen zu dieser Situation finden Sie unter[Zurücksetzen der Telefonnummern auf den ursprünglichen Netzbetreiber nach der Portierung nach Amazon Connect](revert-porting-to-original-carrier.md). 

Wenn eine Portierung erfolgreich storniert wurde, werden die Zeitpläne für den Hafen neu festgelegt und die Netzbetreiber müssen ein anderes einvernehmlich vereinbartes Datum und eine andere Uhrzeit festlegen. Dies wird sich auf den Gesamtzeitplan für die Portierung Ihrer Nummern auswirken. 

**Anmerkung**  
Bitte beachten Sie, dass eine Portierungsanfrage manchmal aufgrund der Prozessautomatisierung nicht storniert werden kann. Der Amazon-Connect-Support wird jedoch jeden möglichen Versuch unternehmen, die Anfrage zu beenden.

# Wann muss ich meinen aktuellen Telekommunikationsdienst kündigen, wenn ich Telefonnummern nach Amazon Connect portieren möchte?
<a name="cancel-current-service"></a>

Kündigen Sie Ihren bestehenden Telekommunikationsdienst erst, wenn Ihre Telefonnummern portiert und bestätigt wurden, dass sie in Amazon Connect funktionieren. 

Wenn Sie Ihren bestehenden Telekommunikationsdienst kündigen, bevor Ihre Nummer portiert wurde, wird Ihre Rufnummernzuweisung aufgehoben, was dazu führen kann, dass Sie die Nummer verlieren.

# Richtlinien für die Portierung von Telefonnummern zu Ihrem Amazon-Connect-Projekt in Südkorea
<a name="porting-numbers-sk"></a>

Die Regeln für Südkorea unterscheiden sich von denen in anderen Ländern. Hier finden Sie hilfreiche Hinweise, um die Anforderungen in Südkorea zu erfüllen.
+ Bei der Planung Ihres Amazon-Connect-Projekts in Südkorea ist es besonders wichtig, vorauszuplanen und bereits im Vorfeld Informationen einzuholen. Zum Portieren von Nummern in Südkorea müssen Sie möglicherweise mehr als 5 Formulare ausfüllen und einreichen. Unter Umständen müssen Sie sich mit der örtlichen Aufsichtsbehörde in Verbindung setzen, bevor Genehmigungen für das Portieren von Nummern erteilt werden.
+ Alle geografischen Rufnummern (d. h. Nummern, bei denen es sich nicht um gebührenfreie, nationale, repräsentative Nummern oder 070-VOIP-Nummern handelt) müssen mindestens 6 Monate an einem physischen Anschluss bestehen, bevor sie in Amazon Connect portiert werden können. Wenn eine Nummer jedoch seit mindestens 3 Monaten besteht, können Sie sie portieren, indem Sie eine spezielle Anfrage beim koreanischen Ministerium für Telekommunikation einreichen. Nach der Genehmigung kann der Portierungsprozess beginnen. Amazon Connect kann Ihnen die Formulare zur Verfügung stellen, Sie müssen diese jedoch ausfüllen und direkt bei der Regulierungsbehörde einreichen.
+ Allen geografischen, repräsentativen oder gebührenfreien Nummern (GRTFN) wird eine 070-VOIP-Nummer zugewiesen, mit der die GRTFN-Nummer endet und die mit der GRTFN-Nummer des Betreibers verknüpft ist. Entfernen Sie diese 070-Nummer nicht aus Ihrer Amazon-Connect-Instance, bis die zugehörige GFTN-Nummer entfernt wurde. Andernfalls schlagen alle eingehenden und ausgehenden Anrufe fehl.
+ Für repräsentative Nummern (RN) gelten Mindestanforderungen für die Abrechnung von Sitzungen, die auf der vom Betreiber festgelegten „Attraktivität“ der RN basieren. Für repräsentative Nummern fallen je nach Umfang der Telefonnummern unterschiedliche Kosten an. Je nach Größe der von Ihnen bestellten repräsentativen Nummer müssen für den Service mindestens 2 bis 500 Kanäle in Rechnung gestellt werden. Dies wird erreicht, indem dem Konto eine Mindestanzahl von Telefonnummern hinzugefügt wird, die der Anzahl der benötigten Kanäle entspricht. Diese werden auf der Seite [Amazon Connect – Preise](https://aws.amazon.com/connect/pricing/) als Service mit gemeinsamen Kosten für 0,5433 USD pro Nutzungstag für das System angezeigt. Diesen zusätzlichen Nummern für gemeinsame Kosten können DIDs keine Anrufflows zugewiesen werden, und ausgehende Anrufe von ihnen schlagen fehl. Wenn Sie die Verbindung trennen RNs, müssen Sie auch die zugehörigen Sondernummern entfernen, um future Abrechnungen zu vermeiden. Die Entfernung oder Reduzierung der Sondernummer DIDs ohne Entfernung der zugrundeliegenden RN stellt einen Verstoß gegen die Nutzungsbedingungen von Amazon Connect dar. 

# Wissenswertes über die Portierung von Telefonnummern in Thailand
<a name="porting-numbers-th"></a>

Die Portierung in Thailand unterscheidet sich von anderen Ländern. Anstatt die Nummer direkt zu Amazon Connect übertragen zu können, müssen Sie die Anrufe von Ihrem aktuellen Anbieter an Amazon Connect weiterleiten. Hier finden Sie hilfreiche Tipps, um den Prozess zu planen.
+ Telefonnummern, die nach Amazon Connect portiert werden, dürfen nur vom E1- oder SIP-Dienst stammen.
+ Der E1- oder SIP-Service muss zusammen mit allen zugehörigen Nummern zuerst an das Netzwerk des Amazon-Connect-Anbieters weitergeleitet werden. Amazon Connect hilft Ihnen dabei, dies zu koordinieren. Abhängig von Ihrer Konfiguration können hierdurch für Ihren aktuellen Anbieter oder den Amazon-Connect-Anbieter, der die Umleitung unterstützt, zusätzliche Gebühren anfallen.
+ Wenn der E1- oder SIP-Service zum Amazon-Connect-Anbieter portiert wurde, können ausgewählte Nummern aus dem Service zur Verwendung in Amazon Connect aktiviert werden. Nach der Aktivierung verwenden die Nummern Amazon Connect sowohl für eingehende als auch für ausgehende Anrufe.

# Portierung Ihrer Telefonnummern von Ihrem Netzbetreiber nach Amazon Connect
<a name="porting-your-phone-numbers"></a>

Das Portieren von Telefonnummern von Ihrem bestehenden Mobilfunkanbieter zu Amazon Connect ist ein mehrstufiger Prozess. Es ist wichtig, dass Sie einige Monate vor Ihrem geplanten Go-Live-Termin beginnen und alle Ihre Unterlagen in Ordnung haben. 

**Topics**
+ [So portieren Sie Ihre Nummern auf Amazon Connect](about-porting.md)
+ [Anforderungen an die Dokumentation für die Portierung von Nummern nach Amazon Connect](porting-documentation-requirements.md)
+ [Wie verifiziert man Datenflüsse, bevor Zahlen portiert werden](verify-flows-before-porting.md)

# So portieren Sie Ihre Nummern auf Amazon Connect
<a name="about-porting"></a>

Die folgenden Schritte beziehen sich auf eine typische Portierungsanfrage. Dieser Prozess erfordert eine zeitnahe Kommunikation, um Fortschritte zu erzielen. Wenn Sie länger als 30 Tage benötigen, um auf Informationsanfragen zu antworten, kann Ihre Portierungsanfrage storniert, verschoben oder von Anfang an neu gestartet werden. 

**Dokumentierungsanforderungen**: Eine Liste der landesspezifischen Anforderungen für die Portierung von Nummern finden Sie unter [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md). 

## Schritt 1: Erstellen eines Amazon-Connect-Supportfalls
<a name="step1-porting"></a>

**Wichtig**  
Wenn Sie mehrere Nummern von verschiedenen Netzbetreibern und Ländern portieren, übermitteln Sie separate Tickets für jeden Satz von Telefonnummern, die von verschiedenen Netzbetreibern und verschiedenen Ländern portiert werden sollen. Hierdurch werden die Kommunikation, die Nachverfolgung und der LOA-Prozess optimiert.

1. Wählen Sie [Konto und Abrechnung](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-connect-number-management), um auf ein vorausgefülltes Formular in der AWS Support Konsole zuzugreifen. Sie müssen bei Ihrem AWS Konto angemeldet sein, um auf das Formular zugreifen zu können.

1. Für **Service** sollte **Connect (Nummernverwaltung)** ausgewählt sein, wie in der folgenden Abbildung gezeigt.  
![\[Seite „Fall erstellen“. für ein Portierungsantrag ausgefüllt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/porting-support1.png)

1. Wählen Sie **unter Kategorie** die Option **Number Porting Nordamerika (US/Canada/Mexico)** oder **Number Porting Non-North America** aus.

1. Wählen Sie den erforderlichen Schweregrad aus.

1. Klicken Sie auf **Next step (Nächster Schritt): Additional information (Zusätzliche Informationen)**

1. Führen Sie auf der Seite **Weitere Informationen** folgende Schritte aus:

   1. Geben Sie den Betreff ein.

   1. Geben Sie unter **Beschreibung** Folgendes an: 
      + ARN der Amazon-Connect-Instance. Anweisungen zu deren Auffinden erhalten Sie unter [Suchen Ihrer Instance-ID oder des ARN von Amazon Connect](find-instance-arn.md).

        Wenn Sie den ARN für eine Entwicklungs-Instance anstatt für eine Produktions-Instance angeben, können Sie die Telefonnummern nur dann selbst zwischen Instances verschieben, wenn sich die Instances in derselben Region und demselben AWS -Konto befinden. Einschränkungen und Anleitungen finden Sie unter [Verschieben einer Amazon-Connect-Telefonnummer zwischen Instances](move-phone-number-across-instances.md).
      + Telefonnummer. Verwenden Sie zum Beispiel das E.164-Format: [\$1][Landesvorwahl][Telefonnummer einschließlich Vorwahl]. 

        Wenn Sie mehr als eine Telefonnummer portieren, geben Sie mindestens eine der Telefonnummern an, die Sie portieren möchten.
      + Exakter Name des [Ablaufs](connect-contact-flows.md), dem die Nummern nach Erhalt der Portierungsgenehmigung [zugeordnet](associate-claimed-ported-phone-number-to-flow.md) werden müssen.
      + Datum der Portierung (yyyy-mm-dd). 
**Wichtig**  
Portierungsanfragen für lokale gebührenpflichtige (DID) und gebührenfreie Telefonnummern in den USA können nicht mit einer Frist von mehr als 30 Tagen übermittelt werden.
      + Portierungszeit (hh:mm AM/PM Zeitzone — 12-Stunden-Uhr)
      + Ihr aktueller Netzbetreiber.
      + Kontaktdaten der Person, die autorisiert ist, Änderungen an Ihrem derzeitigen Telefonservice vorzunehmen.
**Wichtig**  
Fügen Sie keine Dokumente bei, die persönliche Informationen enthalten. Nachdem wir Ihren Fall geprüft haben, senden wir Ihnen einen Link zu unserem sicheren Speicher (Amazon S3), damit Sie die erforderlichen Dokumente übermitteln können. Dieser Vorgang wird unter [Schritt 3: Übermitteln der erforderlichen Dokumente über einen von uns bereitgestellten Link](#step3-porting) beschrieben.

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Gehen Sie auf der Seite **Jetzt lösen oder uns kontaktieren** wie folgt vor:

   1. Wählen Sie die Registerkarte **Kontaktieren Sie uns** und dann Ihre **bevorzugte Kontaktsprache** und Ihre bevorzugte Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

1. Das Amazon Connect Team wird Ihr Ticket überprüfen und sich mit Ihnen in Verbindung setzen.

## Schritt 2: Ausfüllen des Genehmigungsschreibens (LOA)
<a name="step2-porting"></a>

Wenn die Telefonnummer für die Portierung in Frage kommt, stellt Ihnen das Amazon-Connect-Team ein Letter of Authorization (LOA) aus, das Sie ausfüllen müssen. Füllen Sie alle Pflichtfelder aus und unterschreiben Sie die LOA.

 Neben der LOA verlangen die Telekommunikationsvorschriften in vielen Ländern zusätzliche Dokumente für die Registrierung einer Nummer, wie z. B. einen Geschäftsnachweis, einen Adressnachweis und einen Identitätsnachweis. Eine Liste der landesspezifischen Anforderungen für die Portierung von Nummern finden Sie unter. [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md) 

### Wie vervollständige ich eine LOA
<a name="how-to-complete-loa"></a>

Für alle Portierungen ist der Abschluss eines Letter of Authorization (LOA) erforderlich. Das LOA autorisiert Ihren aktuellen Anbieter, Ihre Nummer freizugeben und die Portierung zu gestatten. 
+ Für die Nummern jedes unterlegenen Mobilfunkanbieters ist eine separate LOA erforderlich.

Geben Sie zum Ausfüllen einer LOA die folgenden Informationen an:
+ Die zu portierenden Nummern
+ Informationen über Ihren aktuellen Mobilfunkanbieter, z. B. dessen Firmenname und Kontaktinformationen.
+ Kontaktdaten der Person, die berechtigt ist, Änderungen an Ihrem Telefonservice vorzunehmen Der Name, die Adresse und die Informationen, die Sie auf der LOA angeben, müssen exakt mit den bei Ihrem aktuellen Mobilfunkanbieter hinterlegten Informationen übereinstimmen. Um sicherzustellen, dass der Portierungsprozess reibungslos verläuft, fügen Sie eine Kopie des Kundendienstprotokolls (CSR) oder die aktuelle Telefonrechnung Ihres Mobilfunkanbieters bei. Darauf werden Ihr Name, Ihre Adresse und die zugehörigen Telefonnummern stehen. **Vergewissern Sie sich, dass die Informationen auf Ihrer LOA genau mit Ihrer CSR übereinstimmen.** 
+ Wenn Sie Fragen zu bestimmten Details zu Ihrem aktuellen Service haben, wenden Sie sich an Ihren aktuellen Mobilfunkanbieter, um sicherzustellen, dass die Daten korrekt sind. Dadurch wird das Risiko minimiert, dass die LOA abgelehnt wird.

**Wichtig**  
Ihr LOA-Formular muss die folgenden Kriterien erfüllen:   
Es muss lesbar sein: deutlich geschrieben oder getippt. 
Es muss Ihren Firmennamen, die Firmenadresse und den Kontaktnamen enthalten. Diese Informationen müssen mit den Angaben in der CSR des aktuellen Transporteurs übereinstimmen.
Er muss eine traditionelle handschriftliche Unterschrift enthalten: ein physisches Dokument, das mit Stift und Tinte signiert ist, auch bezeichnet als handschriftliche Unterzeichnung. Die meisten Spediteure lehnen eine elektronische oder gedruckte Unterschrift ab.
Sie muss innerhalb der letzten 15 Tage datiert sein.
Wenn Sie auch gebührenfreie Nummern portieren möchten, müssen diese ebenfalls enthalten sein. In der LOA können bis zu 10 gebührenfreie Nummern aufgeführt werden. Wenn Sie die Portierung von mehr als 10 Telefonnummern beantragen, muss eine Tabelle beigefügt werden. Geben Sie in der LOA, in der die Telefonnummern aufgeführt werden sollen, „See Attached“ an. 
Es darf nur die Telefonnummern enthalten, die demselben aktuellen Mobilfunkanbieter und demselben Land gehören. Wenn Sie derzeit mehrere Fluggesellschaften und Länder haben, müssen Sie mehrere einreichen LOAs. 
Informationen zur weiteren Minimierung des Risikos, dass Ihre LOA abgelehnt wird, finden Sie unter. [Häufige Gründe, warum Spediteure eine LOA ablehnen](porting-documentation-requirements.md#why-port-request-rejected)

## Schritt 3: Übermitteln der erforderlichen Dokumente über einen von uns bereitgestellten Link
<a name="step3-porting"></a>

Nachdem das Amazon Connect Team mitgeteilt hat, dass Sie Telefonnummern portieren können, müssen Sie alle erforderlichen Dokumente einreichen. In den folgenden Schritten wird die Vorgehensweise erläutert.

**Anmerkung**  
AWS Support bietet einen sicheren Amazon S3 S3-Link zum Hochladen aller angeforderten Dokumente. Führen Sie die Schritte erst aus, wenn Sie den Link erhalten haben.

**So übermitteln Sie die erforderlichen Dokumente**

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

1. Melden Sie sich bei Ihrem an AWS-Konto und öffnen Sie dann den Amazon S3 S3-Upload-Link, der speziell für Ihr Konto generiert wurde.
**Anmerkung**  
Der Link läuft nach zehn Tagen ab. Er wurde speziell für das Konto generiert, das den Fall erstellt hat. Der Link erfordert einen autorisierten Benutzer aus dem Konto, um den Upload durchzuführen.

1. Wählen Sie die Option **Dateien hinzufügen** und dann die Dokumente aus, die für Ihre Anforderung erforderlich sind.

1. Erweitern Sie den Bereich „Berechtigungen“ und wählen Sie **Festlegen von individuellen ACL-Berechtigungen** aus.

1. Wählen Sie am Ende des Abschnitts **Zugriffskontrollliste (ACL)** die Option **Empfänger hinzufügen** aus und fügen Sie dann den von bereitgestellten Schlüssel AWS Support in das Feld **Stipendiat** ein.

1. Aktivieren Sie unter **Objekte** das Kontrollkästchen **Lesen** und wählen Sie dann „Hochladen“ aus.

Nachdem Sie den Letter of Authorization (LOA) und alle anderen erforderlichen Dokumente vorgelegt haben, überprüft das Amazon-Connect-Team mit Ihrem bestehenden Telefonnetzbetreiber, ob die Informationen auf dem LOA korrekt sind. Wenn die in dem LOA bereitgestellten Informationen nicht mit den Angaben übereinstimmen, die Ihrem Telefonnetzbetreiber vorliegen, nimmt das Amazon-Connect-Team Kontakt zu Ihnen auf, um die in dem LOA bereitgestellten Informationen zu aktualisieren.

## Schritt 4: Die Portierungsanfrage geht an den Amazon-Connect-Mobilfunkanbieter
<a name="step4-porting"></a>

Nachdem Sie alle erforderlichen Unterlagen eingereicht haben, leitet das Amazon-Connect-Team die Portierungsanfrage in Ihrem Namen an den Transporteur weiter, der den Zuschlag erhalten hat. 
+ Der unterlegene und der gewinnende Transporteur folgen einem branchenüblichen Verfahren zur Überprüfung des Inhalts der LOA und der eingereichten Unterlagen.
+ Wenn die LOA Unstimmigkeiten enthält, wird sie abgelehnt und Sie müssen die Unstimmigkeiten korrigieren und eine neue LOA einreichen. 
+ Nachdem die Spediteure die LOA erfolgreich validiert haben, bestätigen sie entweder den von Ihnen gewünschten Termin oder geben Ihnen ein verfügbares Datum für die tatsächliche Portierung an. Dies wird als „einvernehmlich vereinbartes Datum und vereinbarte Uhrzeit“ bezeichnet. 
+ Sie sollten überprüfen, ob das „einvernehmlich vereinbarte Datum und die Uhrzeit“ korrekt sind. 
**Wichtig**  
Wenn Ihr LOA mehrere Telefonnummern enthält, können einigen Nummern unterschiedliche „einvernehmlich vereinbarte Termine“ zugewiesen werden. Überprüfen Sie den Status und dates/times für jeden einzelnen.

Die meisten Fluggesellschaften verlangen, dass die Portierungen während der normalen Geschäftszeiten abgeschlossen werden. Informationen zu den landesspezifischen Geschäftszeiten finden Sie unter. [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md) 

## Schritt 5: Überprüfen der Nummer(n) in der Instance, Zuweisen der Telefonnummern zum Ablauf und Anfordern einer Erhöhung der Servicekontingente
<a name="step5-porting"></a>

Ungefähr 3-4 Tage vor dem vereinbarten Datum und der vereinbarten Uhrzeit lädt das Amazon-Connect-Supportteam die Telefonnummer, die in den von Ihnen angegebenen Instance-ARN portiert wird, und benachrichtigt Sie dann. Jetzt ist es an der Zeit, dass Sie die folgenden Schritte ausführen:

1. Loggen Sie sich auf Ihrer Amazon Connect Admin-Website ein und überprüfen Sie, ob Ihre Telefonnummer (n) aufgeführt sind. Detaillierte Anweisungen finden Sie unter [Auflisten oder Exportieren von Telefonnummern, für die Ihre Amazon-Connect-Instance beantragt wurden, in eine CSV-Datei](list-claimed-phone-numbers.md).

1. [Ordnen Sie die Telefonnummer dem gewünschten Flow zu](associate-claimed-ported-phone-number-to-flow.md), sodass die Telefonnummer nach Abschluss der Portierung für Telefonanrufe bereit ist. Wenn Sie Hilfe bei der Zuweisung mehrerer Telefonnummern zu Flows benötigen, teilen Sie uns dies in Ihrer Support-Anfrage mit. 
**Wichtig**  
Es wird erwartet, dass Sie oder Ihr Partner Ihre Telefonnummer mit dem Ablauf verknüpfen. 
Wenn Sie möchten, dass der AWS Support dies in Ihrem Namen tut, vermerken Sie dies in Ihrem Support-Ticket. Sie müssen den Flow angeben name/ARN , der jeder Telefonnummer zugeordnet werden soll.
Sie oder Ihr Partner müssen überprüfen, ob der jeweiligen Telefonnummer der richtige Ablauf zugeordnet wurde.

1. [Reichen Sie mindestens fünf Tage vor dem einvernehmlich vereinbarten Datum eine Anfrage für ein Servicekontingent](amazon-connect-service-limits.md) ein, um Änderungen an Ihren Servicekontingenten vorzunehmen, die zur Unterstützung Ihres Anwendungsfalls erforderlich sind. Beispielsweise müssen Sie möglicherweise die Anzahl gleichzeitiger Anrufe pro Instance erhöhen oder Länder für ausgehende Anrufe aktivieren. 

## Schritt 6: Checkliste der Aktivitäten an Ihrem Portierungsdatum
<a name="step6-porting"></a>

Die Portierung einer Nummer kann störend sein: Der Prozess beinhaltet die Aktualisierung der Weiterleitung von Telefonnummern zwischen Netzbetreibern in einem Land oder einer Region, einschließlich Netzbetreibern, die nicht an der eigentlichen Portierung beteiligt sind. In seltenen Fällen kann es mehrere Stunden dauern, bis alle Strecken aller Telekommunikationsanbieter vollständig aktualisiert sind.

### Schritte, die Sie ausführen, um Störungen Ihrer Telefondienste so gering wie möglich zu halten
<a name="step5a-porting"></a>

Führen Sie am einvernehmlich vereinbarten Portierungstermin (Datum und Uhrzeit) die folgenden Schritte durch: 
+ Vergewissern Sie sich, dass die in [Schritt 5](#step4-porting) aufgeführten Aktivitäten abgeschlossen wurden: 

  1. Überprüfen Sie, ob sich die portierten Telefonnummern in der angeforderten Amazon-Connect-Instance befinden und dem entsprechenden Ablauf zugewiesen wurden.

  1. Stellen Sie sicher, dass alle erforderlichen Erhöhungen oder Änderungen des Servicekontingents für Ihre Amazon-Connect-Instance implementiert wurden. Erhöhen Sie beispielsweise die Anzahl gleichzeitiger Anrufe pro Instance oder aktivieren Sie Länder für ausgehende Anrufe.
+ Überwachen Sie den Anrufverkehr von Ihrem bestehenden Kontaktzentrum aus, um sicherzustellen, dass der eingehende Verkehr eingestellt wurde.
+ Führen Sie Testanrufe an Ihre Amazon-Connect-Instance durch, um zu überprüfen, ob Anrufe an die richtigen Flows weitergeleitet werden.
+ Stellen Sie sicher, dass die Kundendienstmitarbeiter beim Contact Control Panel (CCP) angemeldet sind und eingehende Anrufe entgegennehmen können.
+ Überwachen Sie den Anrufverkehr zu Ihrer Amazon-Connect-Instance, um sicherzustellen, dass Sie den erwarteten Traffic erhalten.

### Schritte, die das Amazon-Connect-Team durchführt, um einen reibungslosen Übergang zu gewährleisten
<a name="step5b-porting"></a>

1. Nachdem das Amazon-Connect-Team die Bestätigung erhalten hat, dass die Portierung abgeschlossen wurde, führen wir letzte Tests durch, um zu bestätigen, dass die Portierung erfolgreich war und die Telefonnummer Anrufe an Amazon Connect erhält. 

1. Nachdem wir unsere Tests abgeschlossen haben, werden wir Sie benachrichtigen und Sie bitten, den erfolgreichen Abschluss der Portierung zu überprüfen.

# Anforderungen an die Dokumentation für die Portierung von Nummern nach Amazon Connect
<a name="porting-documentation-requirements"></a>

Das Letter of Authorization (LOA) ist ein branchenüblicher Dokumenttyp, der von Mobilfunkanbietern verwendet wird, um die Übertragung einer Telefonnummer von einem Mobilfunkanbieter zu einem anderen zu autorisieren. In vielen Fällen ist das LOA spezifisch für das Land oder die Region, die Fluggesellschaft oder die Hafenbeziehung zwischen der unterlegenen und der gewinnenden Fluggesellschaft. 

Wenn Ihre Nummer portiert werden kann, erhalten Sie vom Amazon-Connect-Team Folgendes:
+ Ein für die jeweilige Situation geeignetes LOA-Formular.
+ Ein Link zu einem sicheren Amazon-S3-Speicher, über den Sie den LOA und alle anderen erforderlichen Dokumente hochladen können. 

 Weitere Informationen finden Sie unter [Wie vervollständige ich eine LOA](about-porting.md#how-to-complete-loa). 

Darüber hinaus erfordern die Vorschriften in einigen Ländern eine lokale Geschäftsadresse und spezielle Dokumente, um eine Telefonnummer verwenden zu können. Informationen zu länderspezifischen Anforderungen finden Sie unter[Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md). Falls dies erforderlich ist, bitten wir Sie, diese Informationen zusammen mit der ausgefüllten LOA einzureichen.

## Häufige Gründe, warum Spediteure eine LOA ablehnen
<a name="why-port-request-rejected"></a>

Es gibt vier häufige Gründe dafür, dass eine LOA zunächst vom unterlegenen Mobilfunkanbieter abgelehnt werden kann: 
+ Unbefriedigende Geschäftsbeziehung

  Dies bedeutet in der Regel, dass Sie ein unbezahltes Guthaben haben oder dass der Transporteur eine Hafengebühr erhebt. Nachdem Sie die Rechnung oder Gebühr an Ihren Mobilfunkanbieter bezahlt haben, werden wir die Hafenanfrage erneut einreichen.
+ Name oder Adresse stimmen nicht überein

  Die Informationen, die Sie in Ihrem Letter of Authorization (LOA) angegeben haben, unterscheiden sich von den Informationen, die bei Ihrem Mobilfunkanbieter in dessen Kundendienstprotokoll (CSR) hinterlegt sind. Um dieses Problem zu beheben, wenden Sie sich an Ihren bestehenden Mobilfunkanbieter, um Ihre CSR-Informationen zu aktualisieren, die richtigen CSR-Informationen zu erhalten oder beides. Teilen Sie uns mit, wenn Ihre Daten aktualisiert werden, und wir werden die Hafenanfrage erneut einreichen. Oder senden Sie uns eine neue LOA mit den korrekten Informationen, die Sie von Ihrem bestehenden Mobilfunkanbieter erhalten haben. 
+ Die Nummer kann nicht portiert werden

  Wir werden mit allen Amazon-Connect-Transporteuren in einer Region zusammenarbeiten, um die Portierung Ihrer Nummern zu unterstützen. In einigen Fällen können jedoch bestimmte Nummern aufgrund regulatorischer Einschränkungen oder Einschränkungen des Mobilfunkanbieters möglicherweise nicht übertragen werden. In diesen Situationen sollten Sie erwägen, eine neue Nummer bei Amazon Connect zu beantragen.
+ Fehlende Informationen.

  Ein oder mehrere Felder wurden in der LOA leer gelassen. Dies kann eine fehlende Unterschrift, Telefonnummer, Adressinformationen oder andere angeforderte Informationen beinhalten. Überprüfe alle, LOAs bevor du sie abschickst, um sicherzustellen, dass du alle angeforderten Daten ausgefüllt hast. Nachdem die LOA mit allen erforderlichen Informationen aktualisiert wurde, werden wir die Portanfrage erneut einreichen.

# Überprüfen der Abläufe vor dem Portieren von Telefonnummern nach Amazon Connect
<a name="verify-flows-before-porting"></a>

Wir empfehlen Ihnen, Ihre AnrufFlows vor dem einvernehmlich vereinbarten Datum und der Uhrzeit der Portierung zu testen. Wenn Sie Ihre Anrufflows testen möchten, empfehlen wir Ihnen, eine in Amazon Connect verfügbare Rufnummer (Direct Inward Dial) oder eine gebührenfreie Telefonnummer zu beantragen und sie dem Anrufflow zum Testen zuzuweisen. 

Wenn Sie mit dem Testen fertig sind, können Sie die Nummer für Ihre Instance freigeben, sodass Ihnen dafür keine Gebühren mehr berechnet werden. Detaillierte Anweisungen finden Sie unter [Geben Sie eine Telefonnummer von Amazon Connect zurück in den Lagerbestand](release-phone-number.md).

Bis zur Freigabe der Nummer werden Ihnen der Tagessatz für die Inanspruchnahme einer Telefonnummer und der Minutentarif für die genutzten Telefonminuten berechnet. Weitere Informationen finden Sie in den Standardpreisen für die [Nutzung des Amazon-Connect-Services und den zugehörigen Telefontarifen](https://aws.amazon.com/connect/pricing/). 

# Beheben von Problemen nach dem Portieren von Telefonnummern nach Amazon Connect
<a name="porting-troubleshoot"></a>

Nachdem Sie Ihre Nummern auf Amazon Connect portiert haben, verwenden Sie die Themen in diesem Abschnitt, um Probleme zu beheben oder um Nummern freizugeben, die Sie nach der Portierung nicht mehr benötigen. 

**Topics**
+ [Was ist zu tun, wenn die portierte Nummer keine Anrufe empfängt](not-receiving-calls-after-porting.md)
+ [Geben Sie portierte Nummern an, die Sie nicht mehr benötigen](release-ported-numbers-you-do-not-need.md)
+ [Nach der Portierung zum ursprünglichen Mobilfunkanbieter zurückkehren](revert-porting-to-original-carrier.md)
+ [Portnummern entfernt](port-away.md)

# Auf der nach Amazon Connect portierten Telefonnummer werden keine Anrufe entgegengenommen
<a name="not-receiving-calls-after-porting"></a>

Wenn Sie nach Flow des geplanten Portierungsfensters keine Telefonanrufe über die portierte Telefonnummer erhalten, aktualisieren Sie Ihr Support-Ticket. Wir werden das Problem mit unserem Mobilfunkanbieter lösen, um den Portierungsstatus zu überprüfen und die nächsten Schritte zur Lösung des Problems zu ermitteln. 

Amazon Connect und unsere Transporteure bemühen sich nach besten Kräften, sicherzustellen, dass die Rufnummernportierung mit minimalen Ausfallzeiten und ohne Probleme erfolgt. In den meisten Fällen ist der unterlegene Transporteur dafür verantwortlich, die Rufnummernportierung einzuleiten und Ihre Nummer an den gewinnenden Transporteur weiterzugeben. 

In seltenen Fällen kann ein Problem mit der Rufnummernweiterleitung auftreten, was dazu führt, dass Anrufe vom Mobilfunkanbieter nicht bei Amazon Connect eingehen. 

# Freigeben der nach Amazon Connect portierten Telefonnummern, die nicht mehr benötigt werden
<a name="release-ported-numbers-you-do-not-need"></a>

Sie müssen Ihrer Amazon-Connect-Instance zugewiesene Telefonnummern nicht behalten. 

Wenn eine Telefonnummer von Ihrer Amazon-Connect-Instance freigegeben wird:
+ Es wird Ihnen nichts mehr in Rechnung gestellt.
+ Sie können die Telefonnummer nicht zurückfordern.
+ Amazon Connect behält sich das Recht vor, die Beantragung durch einen anderen Kunden zuzulassen.

**Freigeben einer Telefonnummer**

1. Melden Sie sich mit einem Amazon Connect Administratorkonto oder einem Benutzerkonto mit **Telefonnummern auf der Admin-Website an. Geben Sie die Berechtigung für das Sicherheitsprofil frei**. 

1. Wählen Sie im Navigationsmenü **Kanäle**, **Telefonnummern** aus. Diese Option wird nur angezeigt, wenn Sie in Ihrem Sicherheitsprofil über die Berechtigung **Telefonnummern – Anzeigen** verfügen.

1. Wählen Sie die Telefonnummer, die Sie freigeben möchten, und klicken Sie dann auf **Release (Freigeben)**. Diese Option wird nur angezeigt, wenn Sie in Ihrem Sicherheitsprofil über die Berechtigung **Telefonnummern – Freigeben** verfügen.

Wenn die Telefonnummer mit einem Vorgang verknüpft ist, wird dieser Vorgang deaktiviert, bis eine andere Nummer mit ihm verknüpft wird.

Wenn Kunden die freigegebene Telefonnummer anrufen, erhalten sie eine Nachricht, dass dies keine funktionierende Telefonnummer ist. 

# Zurücksetzen der Telefonnummern auf den ursprünglichen Netzbetreiber nach der Portierung nach Amazon Connect
<a name="revert-porting-to-original-carrier"></a>

Um die Portierung abzuschließen, nehmen sowohl der unterlegene als auch der übernehmende Mobilfunkanbieter Konfigurationsänderungen vor, um den Besitz der Telefonnummer weiterzugeben. Nach Abschluss der Portierung hat der übernehmende Mobilfunkanbieter die alleinige Kontrolle über die Telefonnummer. 

Um die Telefonnummer erneut zu verschieben, müssen Sie eine neue LOA und alle erforderlichen Unterlagen ausfüllen.

# Telefonnummern außerhalb von Amazon Connect portieren
<a name="port-away"></a>

1. Wählen Sie [Konto und Fakturierung](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-connect-number-management&categoryCode=phone-number-port-out) aus, um das vorausgefüllte Formular in der AWS Support -Konsole aufzurufen. Sie müssen bei Ihrem AWS -Konto angemeldet sein, um Zugriff auf das Formular zu erhalten.

1. Für **Service** sollte *Connect (Nummernverwaltung)* ausgewählt sein.

1. Als **Kategorie** sollte *Telefonnummernportierung* ausgewählt sein.

1. Wählen Sie den erforderlichen Schweregrad aus.

1. Klicken Sie auf **Next step (Nächster Schritt): Additional information (Zusätzliche Informationen)**

1. Führen Sie auf der Seite **Weitere Informationen** folgende Schritte aus:

   1. Geben Sie den Betreff ein.

   1. Gehen Sie unter **Beschreibung** wie folgt vor:

      1. Teilen Sie uns mit, dass Sie wegportieren.

      1. Der Name Ihrer Amazon-Connect-Instance und die Nummern, die Sie portieren.

      1. Der Name Ihres neuen Mobilfunkanbieters.

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Gehen Sie auf der Seite **Jetzt lösen oder uns kontaktieren** wie folgt vor:

   1. Wählen Sie die Registerkarte **Kontaktieren Sie uns** und dann Ihre **bevorzugte Kontaktsprache** und Ihre bevorzugte Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

1. Das Amazon Connect Team wird Ihr Ticket überprüfen und sich mit Ihnen in Verbindung setzen.

Als nächstes passiert Folgendes:

1. AWS Support kontaktiert Sie und gibt an, dass Sie den Vorgang mit der Fluggesellschaft beginnen sollten, die den Zuschlag erhalten hat.

1. Die gewinnende Fluggesellschaft wird Sie bitten, ihr die folgenden Informationen zur Verfügung zu stellen:
   + Eigentumsnachweis für die Nummern, die Sie übertragen möchten. Stellen Sie ihnen Screenshots der Amazon-Connect-Instance mit den Telefonnummern, die Sie portieren möchten, sowie Screenshots Ihrer AWS Rechnung zur Verfügung.
   + In der Regel benötigt der Transporteur, der den Zuschlag erhält, ein LOA (Letter of Authorization), das Sie ausfüllen müssen. Es ist wichtig, dass Sie die richtigen Kontaktdaten auf Ihrer AWS Rechnung angeben. 

1. Die Fluggesellschaft, die den Zuschlag erhalten hat, sendet die Anfrage an AWS Support. 

1. AWS Support wird überprüfen, ob die Anfrage der gewinnenden Fluggesellschaft mit den uns vorliegenden Informationen darüber übereinstimmt, wem diese Nummern gehören. Wenn alle Angaben **genau** übereinstimmen, werden wir die Anfrage genehmigen.
**Wichtig**  
Die Überprüfung der Echtheit der Port-Out-Anfrage des Gewinners ist für die Sicherheit Ihrer Telefonnummer von entscheidender Bedeutung. Wenn die Kontaktdaten nicht korrekt sind (z. B. weil der Name nicht übereinstimmt), kann es sein, dass Ihre Anfrage zur Deaktivierung abgelehnt wird, was zu Verzögerungen führt und Sie Ihre Anfrage erneut einreichen müssen.

1. Die Fluggesellschaft, die den Zuschlag erhalten hat, wird die Port-Out-Anfrage an dem Tag und zu der Uhrzeit bearbeiten, die Sie mit ihr vereinbaren. Arbeiten Sie mit der siegreichen Fluggesellschaft zusammen, um den Rest des Port-Out-Prozesses abzuschließen und einen reibungslosen Übergang zu gewährleisten.

# Beantragen und Verwalten von Telefonnummern in Amazon Connect
<a name="claim-and-manage-phonenumbers"></a>

In den Themen in diesem Abschnitt wird erklärt, wie Sie eine Amazon-Connect-Telefonnummer beantragen, Rufnummern auflisten, die für Ihre Instance beantragt wurden, eine Telefonnummer zwischen Amazon-Connect-Instances verschieben und sie freigeben.

**Topics**
+ [Beantragen einer Telefonnummer in Ihrem Land](get-connect-number.md)
+ [Anfordern einer SMS-fähigen Telefonnummer über AWS End User Messaging SMS](sms-number.md)
+ [Beantragen einer Rufnummer, die Sie bereits besitzen, in einem anderen Land](another-country.md)
+ [Listen Sie die Telefonnummern auf, für die Ihre Instance beansprucht wurde](list-claimed-phone-numbers.md)
+ [Anfordern von Telefonnummern in der Region Asien-Pazifik (Tokio)](connect-tokyo-region.md)
+ [Nummern oder internationale Nummern anfordern](number-request.md)
+ [Verschieben einer Telefonnummer zwischen Instances](move-phone-number-across-instances.md)
+ [Freigeben einer Telefonnummer](release-phone-number.md)

# Erhalten einer lokalen gebührenfreien oder lokalen gebührenpflichtigen Amazon-Connect-Telefonnummer
<a name="get-connect-number"></a>

Um in Ihrer aufrufen-Instance Anrufe zu tätigen oder entgegenzunehmen, müssen Sie eine DID- bzw. gebührenfreie Telefonnummer beantragen. Wenn Sie beim Erstellen der Amazon-Connect-Instance keine Nummer beantragt haben, führen Sie diese Schritte aus, um dies jetzt zu tun.

## So beantragen Sie eine Nummer für Ihr Kontaktzentrum
<a name="get-connect-number1"></a>

1. Melden Sie sich auf der Amazon Connect Admin-Website mit einem Administratorkonto oder einem Konto an, das einem Sicherheitsprofil mit **Telefonnummern zugewiesen ist — Berechtigungen beanspruchen**. 

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

1. Wählen Sie **Claim a number (Eine Telefonnummer beanspruchen)** aus. Sie können eine gebührenfreie Telefonnummer oder eine Direct Inward Dialing (DID)-Telefonnummer auswählen. Wenn Sie sich in den USA befinden, können Sie die gewünschte Vorwahl für Ihre Nummer angeben. Es werden dann nur verfügbare Nummern mit dieser Vorwahl angezeigt. Wenn Nummern zurückgegeben werden, wählen Sie eine aus.   
![\[Die Seite Telefonnummer anfordern, Registerkarte DID (Direct Inward Dialing).\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tutorial1-claim-number.png)
**Anmerkung**  
Erstellen Sie einen Fall, indem Sie für die folgenden Situationen die Option [Konto und Abrechnung](https://support.console.aws.amazon.com/support/home#/case/create) auswählen:   
Wenn Sie ein Land oder eine Region auswählen, aber keine Nummern angezeigt werden, können Sie zusätzliche Nummern für das Land oder die Region anfordern. 
Wenn Sie eine bestimmte Ortsvorwahl oder eine Vorwahl wünschen, die nicht aufgeführt ist, versuchen wir, Ihre Anfrage zu berücksichtigen.
Die folgende Abbildung zeigt die Option **Konto und Abrechnung** auf der Seite **Einen Fall erstellen** in der **Supportcenter-Konsole**.  

![\[Die Option „Konto und Abrechnung“ auf der Seite „Einen Fall erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/create-case-support.png)


1. Geben Sie eine Beschreibung für die Nummer ein und fügen Sie diese bei Bedarf an einen Flow in **Contact Flow / IVR (Flow/IVR)** an.

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

1. Wiederholen Sie diesen Vorgang, bis Sie alle erforderlichen Telefonnummern beansprucht haben.

1. Nachdem Sie Ihre Nummern beansprucht haben, [verknüpfen Sie sie mit Ihren Flows.](associate-claimed-ported-phone-number-to-flow.md) Ein Flow definiert den Weg Ihrer Kunden mit Ihrem Contact Center von Anfang bis Ende. 

## Wie viele Telefonnummern können Sie beanspruchen
<a name="service-quota-phone-numbers"></a>

Es gibt ein Service-Kontingent für die Anzahl der Telefonnummern, die Sie in jeder Instance haben können. Informationen zum Standarddienstkontingent finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md). Wenn Sie das Kontingent ausgeschöpft haben, können Sie eine der zuvor beantragten Nummern freigeben. Nach der Freigabe können Sie dieselbe Nummer nicht erneut beanspruchen. 

Wenn Sie mehr Telefonnummern benötigen, können Sie mit dem [Formulars zur Erhöhung des Amazon-Connect-Service-Kontingents](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-connect) eine Erhöhung des Service-Kontingents beantragen.

## Vermeiden Sie es, daran gehindert zu werden, zu viele Nummern zu beanspruchen oder freizugeben
<a name="avoid-being-blocked-claiming"></a>

Wenn Sie häufig Nummern anfordern und freigeben möchten, kontaktieren Sie uns, um eine Ausnahme des Servicekontingents zu erhalten. Andernfalls werden Sie möglicherweise daran gehindert, weitere Nummern anzufordern und freizugeben, bis zu 180 Tage nach dem Ablauf der ältesten freigegebenen Nummer.

Standardmäßig können Sie bis zu 200 % Ihrer maximalen Anzahl an aktiven Telefonnummern anfordern und freigeben. Wenn Sie während eines fortlaufenden 180-Tage-Zyklus, der 200% Ihres Telefonkontingents überschreitet, Rufnummern über die Benutzeroberfläche oder API beanspruchen und herausgeben, können Sie bis 180 Tage nach Ablauf der ältesten freigegebenen Nummer keine weiteren Nummern beanspruchen. 

Wenn Sie beispielsweise bereits 99 beanspruchte Nummern und ein Servicelevel-Kontingent von 99 Telefonnummern haben und Sie in einem beliebigen Zeitraum von 180 Tagen 99 freigeben, 99 beanspruchen und dann 99 freigeben, haben Sie das Limit von 200% überschritten. Ab diesem Zeitpunkt können Sie keine weiteren Nummern mehr beanspruchen, bis Sie ein AWS Support-Ticket öffnen.

## API-Anweisungen zur Beantragung von Telefonnummern
<a name="get-connect-number-programmatically"></a>

So fordern Sie eine Telefonnummer programmgesteuert an: 

1. Verwenden Sie die [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API, um nach verfügbaren Telefonnummern zu suchen, die Sie für Ihre Amazon Connect Connect-Instance beanspruchen können.

1. Verwenden Sie die [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API, um die Telefonnummer zu beanspruchen. 

   Wenn Sie eine Nummer mithilfe der [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API beanspruchen, wird die Nummer in einen der folgenden drei Zustände versetzt:`CLAIMED`,`IN_PROGRESS`,`FAILED`.

1. Führen Sie die [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)API aus, um den Status Ihres Verfahrens zur Beantragung der Nummer zu ermitteln. 
   + `CLAIMED`bedeutet, dass der vorherige [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)Vorgang [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)oder die Operation erfolgreich war.
   + `IN_PROGRESS`bedeutet, dass eine [ClaimPhoneNumber[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)Oder-Operation noch im Gange ist und noch nicht abgeschlossen wurde. Sie können zu einem späteren [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)Zeitpunkt anrufen, um zu überprüfen, ob der vorherige Vorgang abgeschlossen wurde.
   + `FAILED`zeigt an, dass der [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)vorherige [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)Oder-Vorgang fehlgeschlagen ist. Es wird eine Meldung enthalten, die den Grund für den Fehler angibt. Ein häufiger Grund für einen Ausfall kann sein, dass der `TargetArn` Wert, auf den Sie eine Telefonnummer beanspruchen oder auf den Sie eine Telefonnummer aktualisieren, das Limit für die Gesamtzahl der beanspruchten Nummern erreicht hat. Wenn Sie aufgrund eines API-Aufrufs von `ClaimPhoneNumber` den Status `FAILED` erhalten haben, haben Sie einen Tag Zeit, um erneut zu versuchen, die Telefonnummer zu beanspruchen, bevor die Nummer wieder in den Bestand aufgenommen wird, sodass andere Kunden sie anfordern können.

**Anmerkung**  
Wenn die Rufnummernanforderung fehlschlägt, wird Ihnen die Telefonnummer innerhalb des Zeitraums von einem Tag nicht in Rechnung gestellt. 

## „Wir konnten Ihre Nummer nicht anfordern“
<a name="phone-number-limit-message"></a>

Auch wenn Sie zum ersten Mal eine Telefonnummer beanspruchen, kann diese Fehlermeldung auftreten, wenn Sie versuchen, eine Nummer zu beanspruchen. Für alle Probleme, die zu dieser Fehlermeldung führen, ist AWS Support die Hilfe von erforderlich. 

 Kontaktieren Sie uns AWS Support und sie werden Ihnen weiterhelfen. Detaillierte Anweisungen finden Sie unter [Holen Sie sich administrativen Support für Amazon Connect](get-admin-support.md).

# Fordern Sie eine SMS-fähige Telefonnummer an über AWS End User Messaging SMS
<a name="sms-number"></a>

**Wichtig**  
In einigen Ländern müssen Telefonnummern und Absender für IDs die Nutzung im Land registriert sein. Die Bearbeitung einer eingereichten Registrierungsanfrage kann bis zu 15 Werktage dauern. Wir empfehlen dringend, diesen Prozess frühzeitig zu beginnen. Weitere Informationen zur Registrierung finden Sie unter [Registrierungen](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).

Mithilfe AWS End User Messaging SMS können Sie neue SMS-fähige Telefonnummern anfordern oder bestehende SMS-fähige Telefonnummern für die Verwendung in Amazon Connect wiederverwenden. Sie können Kurzwahlnummern, 10-stellige Langwahlnummern (10DLC) und gebührenfreie Nummern anfordern. Diese werden auch als Originationsidentitäten () bezeichnet. OIDs 

Anleitungen zur Beschaffung einer Telefonnummer für SMS-Nachrichten finden Sie unter [Anfordern einer Telefonnummer](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html) im *Benutzerhandbuch zu AWS End User Messaging SMS *. 

## Bewährte Methoden für die Anforderung von SMS-Nummern
<a name="bp-request-sms-number"></a>
+ Für jeden OID-Typ gilt ein anderes Registrierungsverfahren und die Leasingkosten variieren. Sehen Sie sich die Preise hier an: [AWS End User Messaging SMS  – Preise](https://aws.amazon.com/pinpoint/pricing/#Numbers). 
+ Wir empfehlen, bei der Entscheidung über die Art der zu beantragenden Telefonnummer Ihre Durchsatzanforderungen zu berücksichtigen. SMS-Nachrichten werden in 140-Byte-Abschnitten zugestellt, die als [Nachrichtenteile](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html) bezeichnet werden. Ihre Durchsatzrate ist die Anzahl der Nachrichtenteile, die Sie pro Sekunde versenden können.
  + **1–3 Nachrichtenteile pro Sekunde**: Verwenden Sie eine gebührenfreie Nummer. Wir empfehlen, eine 10DLC-Nummer oder eine Kurzwahlnummer zu verwenden, wenn Ihre Durchsatzanforderungen bei einer Ausweitung Ihrer Anwendungsfälle diese Grenzwerte überschreiten. Diese Nummerntypen bieten viel Spielraum für Wachstum, kosten aber auch mehr und die Bereitstellung dauert derzeit länger als bei gebührenfreien Nummern. Weitere Informationen zum Anfordern einer gebührenfreien Nummer in Amazon Pinpoint finden Sie unter Telefonnummer [anfordern](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html). 
  + **10–75 Nachrichtenteile pro Sekunde**: Verwenden Sie eine 10DLC-Nummer. Sie können auch eine Kurzwahlnummer verwenden, die zusätzlichen Spielraum für Wachstum bietet, aber auch mehr kosten würde. Weitere Informationen finden Sie unter [Anfordern dedizierter Langwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-long-code.html). 
  + **100 Nachrichtenteile pro Sekunde oder mehr**: Verwenden Sie eine Kurzwahlnummer. Wenn Sie Ihre Anfrage in der AWS Support Center-Konsole erstellen, geben Sie die Durchsatzrate an, die Ihr Shortcode unterstützen soll. 

    US-Kurzwahlnummern unterstützen standardmäßig 100 Nachrichtenteile pro Sekunde, doch die Durchsatzrate kann gegen eine zusätzliche monatliche Gebühr über diese Rate hinaus erhöht werden. Weitere Informationen finden Sie unter [Anfordern von Kurzwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request-short-code.html). 
+ Fordern Sie mindestens eine der oben genannten Optionen OIDs als `TRANSACTIONAL` Zahl von an Amazon Pinpoint.
+ Stellen Sie sicher, dass Sie alle bei der Registrierung angeforderten Informationen angeben. Es gibt keine Ausnahmen bei den gestellten Fragen. 
**Wichtig**  
Wenn Sie unvollständige oder ungenaue Informationen angeben, verlängert sich die Registrierungszeit. Ihre Registrierung muss bearbeitet und zur erneuten Überprüfung zurückgesendet werden.  
Die Registrierung für alle Arten von OIDs in den USA wird von einem Drittanbieter verwaltet. Anträge werden nicht von Amazon geprüft.
+ Die Registrierung gebührenfreier Telefonnummern ist mit dem geringsten Zeitaufwand möglich.
+ Sehen Sie sich den [10DLC-Registrierungsprozess](https://docs.aws.amazon.com/sms-voice/latest/userguide/registration-10dlc.html) an, der im *Benutzerhandbuch zu AWS End User Messaging SMS * erläutert wird.



# Beantragen einer Amazon-Connect-Rufnummer, die Sie bereits besitzen, in einem anderen Land
<a name="another-country"></a>

Angenommen, Ihr Unternehmen befindet sich in Deutschland. Sie haben auch Agenten in Japan, um Kunden in Japan zu bedienen, und benötigen für dieses Contact Center eine japanische Telefonnummer. Gehen Sie wie folgt vor, um einen Support-Fall zur Beantragung einer Telefonnummer, die Sie bereits in einem anderem Land besitzen, zu erstellen. 

Informationen zum Beantragen einer Nummer, die Sie nicht bereits in einem anderen Land bzw. einer anderen Region besitzen, finden Sie unter [Anfordern von Nummern oder internationalen Nummern](number-request.md).

1. Navigieren Sie zu [Fall erstellen](https://console.aws.amazon.com/support/cases#/create).

1. Wählen Sie **Service quota increase (Service-Kontingenterhöhung)** aus.

1. Wählen Sie unter **Limittyp** **Amazon Connect** aus.

1. Geben Sie in **Use case description (Anwendungsfallbeschreibung)** die Adresse Ihres Unternehmens im betreffenden anderen Land ein. 

1. Wählen Sie in **Contact options (Kontaktoptionen)** aus, ob wir per E-Mail oder Telefon mit Ihnen Kontakt aufnehmen sollen. 

1. Wählen Sie **Absenden** aus. 

Wir werden Kontakt mit Ihnen aufnehmen, um Sie in Bezug auf Ihre Anfrage zu unterstützen. 

# Auflisten oder Exportieren von Telefonnummern, für die Ihre Amazon-Connect-Instance beantragt wurden, in eine CSV-Datei
<a name="list-claimed-phone-numbers"></a>

Sie können die für Ihre Amazon Connect Connect-Instance beanspruchten Telefonnummern auflisten, indem Sie die Amazon Connect Admin-Website oder die [ListPhoneNumbersV2-API](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListPhoneNumbersV2.html) verwenden.

**Um Telefonnummern über die Amazon Connect Admin-Website aufzulisten**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*instance name*.my.connect.aws/ an.

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

   Die Liste der Telefonnummern, die für Ihre Amazon-Connect-Instance beansprucht wurden, wird angezeigt. 

**So laden Sie Telefonnummern in eine CSV-Datei herunter**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://.my.connect.aws/ an. *instance name*

1. Wählen Sie im Navigationsmenü die Optionen **Kanäle**, **Telefonnummern** und **CSV herunterladen** aus.
   + ALLE auf dieser Seite aufgeführten Telefonnummern werden in die CSV-Datei heruntergeladen, unabhängig davon, welche ausgewählt wurden.
   + Es werden nicht alle Telefonnummern heruntergeladen, die von Ihrer Amazon-Connect-Instance beantragt wurden.
   + Um die auf Seite 2 der Ergebnisse heruntergeladenen Nummern aufzulisten, müssen Sie bis Seite 2 navigieren und dann erneut **CSV herunterladen** auswählen.  
![\[Die Seite „Telefonnummern“ mit der Schaltfläche „CSV herunterladen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/download-phonenumbers-csv.png)

# Anfordern von Telefonnummern für Amazon Connect in der Region Asien-Pazifik (Tokio)
<a name="connect-tokyo-region"></a>

Um eine Telefonnummer für eine Amazon Connect Connect-Instance zu beanspruchen, die Sie in der Region Asien-Pazifik (Tokio) erstellen, öffnen Sie eine AWS Support-Anfrage und legen Sie Unterlagen vor, dass sich Ihr Unternehmen in Japan befindet. 

**Wichtig**  
Es sind drei Arten von Unterlagen erforderlich. Eine Liste der zulässigen Nachweise finden Sie unter [Japan (JP)](phone-number-requirements.md#japan-requirements) im Thema [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md). 

Sie können Nummern nicht für den persönlichen Gebrauch, sondern nur für den geschäftlichen Gebrauch anfordern. 

Amazon Connect unterstützt das Anfordern von Telefonnummern für Instances, die in der Region Asien-Pazifik (Tokio) erstellt wurden.
+ **DID-Nummern (Direct Inward Dialing)**: werden auch als örtliche Nummern bezeichnet.
  + Nummern mit Vorwahl 050.
  + Nummern mit Vorwahl 03 in Tokio. Amazon Connect bietet derzeit keine Telefonnummern für andere Städte in Japan an.
+ **Gebührenfreie Nummern**
  + Nummern mit Vorwahl 0120.
  + Nummern mit Vorwahl 0800.

**Anmerkung**  
Wenn Sie eine gebührenfreie Telefonnummer für Amazon Connect beantragen, wird damit nicht auch eine entsprechende DID-Nummer mit der Vorwahl 03 zugewiesen wie bei anderen gebührenfreien Telefonnummern in Japan. Wenn Sie eine DID-Nummer benötigen, können Sie diese in Amazon Connect beantragen.

# Anfordern von Nummern oder internationalen Nummern
<a name="number-request"></a>

**Wichtig**  
Um eine Telefonnummer zu erwerben und zu besitzen, erfordern die Bestimmungen des Landes oder der Region häufig:   
Eine lokale Büroadresse.
Spezifische Ausweisdokumente.
Informationen zu den Identifizierungsanforderungen nach Ländern finden Sie unter[Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md).   
In den meisten Ländern dauert es 2-6 Wochen, bis wir Ihre Anfrage erfüllen können. In einigen Fällen kann es bis zu 60 Tage dauern. Wenn Sie bis zu einem bestimmten Datum eine Nummer benötigen, teilen Sie uns dies in Ihrem Fall mit. AWS Support 

**Anmerkung**  
Amazon bietet Folgendes nicht an:  
Dienstleistungen zum Premiumtarif oder zu höheren Kosten
Vanity-Nummern wie 1-888-555-0000 oder eine genaue Zahl
Wenn Sie diese Dienstleistungen in Anspruch nehmen möchten, empfehlen wir Ihnen, sich an spezialisierte Anbieter zu wenden. Für Dienste mit Premium-Tarifen können Sie Anrufe an Amazon Connect DIDs weiterleiten, indem Sie die lokalen Landesbestimmungen einhalten. Bei Vanity-Nummern können Sie diese Nummern nach dem Kauf auf Amazon Connect übertragen, indem Sie sie portieren.

Um internationale Telefonnummern anzufordern, für die Unterlagen erforderlich sind, oder Nummern, die in einer bestimmten Region nicht verfügbar sind, erstellen Sie einen AWS Support Fall. Im Support-Fall müssen Sie genau angeben, wie viele Nummern Sie für jedes Land wünschen. 

Reichen Sie ein Amazon-Connect-Supportticket ein, um zu überprüfen, ob Ihre Telefonnummer auf Amazon Connect portiert werden kann. 

1. Wählen Sie [Konto und Fakturierung](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-connect-number-management) aus, um auf ein vorausgefülltes Formular in der AWS Support -Konsole zuzugreifen. Sie müssen in Ihrem AWS Konto angemeldet sein, um auf das Formular zugreifen zu können.

1. Für **Service** sollte **Connect (Nummernverwaltung)** ausgewählt sein.

1. Unter **Kategorie** sollte **Anforderung spezieller Telefonnummern** ausgewählt sein.

1. Wählen Sie den erforderlichen Schweregrad aus.

1. Klicken Sie auf **Next step (Nächster Schritt): Additional information (Zusätzliche Informationen)**

1. Führen Sie auf der Seite **Weitere Informationen** folgende Schritte aus:

   1. Geben Sie den Betreff ein.

   1. Geben Sie unter **Beschreibung** so viele Informationen wie möglich zu Ihrer Anfrage an. Sollten Sie nicht alle diese Details kennen, können Sie Informationen weglassen.
**Wichtig**  
Fügen Sie keine Dokumente bei, die persönliche Informationen enthalten. Nachdem wir Ihren Fall geprüft haben, senden wir Ihnen einen Link zu unserem sicheren Speicher (Amazon S3), damit Sie die erforderlichen Dokumente einreichen können. Dieser Vorgang wird in Schritt 10 unten beschrieben.

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Gehen Sie auf der Seite **Jetzt lösen oder uns kontaktieren** wie folgt vor:

   1. Wählen Sie die Registerkarte **Kontaktieren Sie uns** und dann Ihre **bevorzugte Kontaktsprache** und Ihre bevorzugte Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

1. Das Amazon Connect Team wird Ihr Ticket überprüfen und sich bei Ihnen melden. Sie erhalten einen Link zu unserem sicheren Speicher (Amazon S3), damit Sie die erforderlichen Dokumente einreichen können.

Nachdem Ihre Anfrage genehmigt wurde, wird die genaue Anzahl der angeforderten Telefonnummern in Ihrer Amazon-Connect-Konsole angezeigt, sodass Sie sie anfordern können. Sie haben keinen Zugriff auf alle verfügbaren Nummern in diesem Land.

# Verschieben einer Amazon-Connect-Telefonnummer zwischen Instances
<a name="move-phone-number-across-instances"></a>

Sie können eine Telefonnummer von einer Amazon Connect Connect-Instance oder Traffic-Verteilergruppe auf eine andere Amazon Connect Connect-Instance oder Traffic-Verteilergruppe im selben AWS Konto und in derselben Region, in verschiedenen AWS Konten oder in verschiedenen Regionen verschieben. 

Amazon Connect unterstützt die folgenden Szenarien für die Migration von Telefonnummern:
+ Beide Amazon Connect Connect-Instances befinden sich in derselben AWS Region und demselben AWS Konto. In diesem Szenario können Sie die Telefonnummern selbst verschieben. 
+ Die alten und neuen Amazon Connect Connect-Instances befinden sich in unterschiedlichen Regionen, haben aber dasselbe Konto. AWS Support muss die Nummern für Sie migrieren.
+ Die alten und neuen Amazon Connect Connect-Instances befinden sich in denselben AWS Regionen, aber unterschiedlichen AWS Konten. AWS Support muss die Nummern für Sie migrieren.

**Topics**
+ [Wissenswertes](#move-number-important)
+ [Eigenständiger Umzug: Gleiche Region und Konto AWS](#move-number-same-region-account)
+ [Verschiedene Regionen und/oder AWS Konten](#move-number-different-region-account)

## Wissenswertes
<a name="move-number-important"></a>

Die folgenden Informationen gelten für Telefonnummernmigrationen, die von durchgeführt werden. AWS Support
+ Wenn Ihr neuer Instanz-ARN zur Verkehrsverteilergruppe gehört, müssen Sie die Instanz und die Verkehrsverteilergruppe angeben AWS Support ARNs. Führen Sie einen [list-traffic-distribution-groups](https://docs.aws.amazon.com/cli/latest/reference/connect/list-traffic-distribution-groups.html)CLI-Befehl aus, um den ARN der Verkehrsverteilergruppe abzurufen. 
+ AWS Support kann Migrationen jederzeit zwischen Montag und Freitag planen. Ausnahmen sind lokale Nationalfeiertage, an denen keine Migrationen von Telefonnummern geplant werden können.
+ Wenn Datum und Uhrzeit der Migration eintreffen, müssen Sie sich vergewissern, dass die Telefonnummer in keiner Ihrer Warteschlangen mehr als Nummer für ausgehende Rückrufe konfiguriert ist. Andernfalls wird dadurch die Migration der Nummer AWS Support verhindert und der Vorgang kann verzögert werden.
+ Die Migration jeder Telefonnummer dauert zwischen 20 und 30 Minuten. Während einer Migration von Telefonnummern **können Anrufe blockiert werden und für die zu migrierende Nummer fehlschlagen**.
+ Um zusätzliche Ausfallzeiten zu vermeiden, vergewissern Sie sich, dass der Ablauf vorhanden ist und in der neuen Amazon-Connect-Instance veröffentlicht wird, wenn Sie einen Ablauf mit einer migrierten Telefonnummer in der neuen Amazon-Connect-Instance verknüpfen. Stellen Sie dem AWS Support den ARN des Ablaufs bereit, damit er bei der Migration mit der Telefonnummer verknüpft werden kann.
+ Je nach Telefonnummer ist eine Migration möglicherweise nicht möglich. Sie werden in Ihrem AWS Support Fall kontaktiert, falls dies auf Ihre Anfrage zutrifft. Informationen zur regionalen Verfügbarkeit von Telefonnummern in bestimmten Ländern finden Sie im [Leitfaden zur Telekommunikationsabdeckung nach Ländern durch Amazon Connect](https://d1v2gagwb6hfe1.cloudfront.net/Amazon_Connect_Telecoms_Coverage.pdf).
+ Nach dem Migrieren Ihrer Telefonnummer müssen Sie die Nummer für ausgehende Anrufe in Ihren Warteschlangen festlegen. Dies kann nicht von getan werden AWS Support.

AWS Support werden Sie bitten, die oben genannten Informationen zu bestätigen und zu verstehen, bevor sie die Migration Ihrer Telefonnummer planen.

## Eigenständiger Umzug: Gleiche Region und Konto AWS
<a name="move-number-same-region-account"></a>

Wenn sich beide Amazon Connect Connect-Instanzen in derselben Region und demselben AWS Konto befinden, können Sie die Telefonnummer mithilfe von [ListPhoneNumbersV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListPhoneNumbersV2.html) und selbst verschieben [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) APIs. 

**Anmerkung**  
Wenn Sie beim Ausführen von AWS CLI-Befehlen Fehler erhalten, stellen Sie sicher, dass Sie die [neueste AWS CLI-Version](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-troubleshooting.html) verwenden. 

Anleitungen und Beispiele für CLI-Befehle finden Sie unter [Wie migriere ich Telefonnummern von einer Amazon-Connect-Instance zu einer anderen?](https://repost.aws/knowledge-center/connect-migrate-phone-number) 

## Verschiedene Regionen und/oder AWS Konten
<a name="move-number-different-region-account"></a>

Wenn sich die alten und neuen Amazon Connect Connect-Instances in verschiedenen Regionen befinden, aber dasselbe AWS Konto verwenden, führen Sie die folgenden Schritte aus, um einen einzigen AWS Support Fall zu erstellen. 

Wenn die alten und neuen Amazon Connect Connect-Instances zu unterschiedlichen AWS Konten gehören, erstellen Sie zwei AWS Support Fälle, einen für jedes Konto, und gehen Sie dabei genauso vor. 

1. Melden Sie sich bei Ihrem AWS Konto an und klicken Sie dann [hier](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-connect-number-management), um auf ein vorausgefülltes Formular in der AWS Support Konsole zuzugreifen.

1. Wählen Sie im Formular unter **Service** die Option **Connect (Nummernverwaltung)** aus.

1. Wählen Sie unter **Kategorie** die Option **Migration von Telefonnummern** aus.

1. Wählen Sie den entsprechenden Schweregrad aus.

1. Wählen Sie **Next step: Additional information** (Nächster Schritt: Zusätzliche Informationen).

1. Führen Sie auf der Seite **Weitere Informationen** folgende Schritte aus:

   1. Geben Sie den Betreff ein.

   1. Geben Sie unter **Beschreibung** so viele Informationen wie möglich zu Ihrer Anfrage an, einschließlich der Telefonnummern (im E164-Format) und eines Schemas, falls Sie Ihre Nummern nach Abschluss der Migration zuweisen möchten Support .

1. Geben Sie unter **Helfen Sie uns, Ihren Fall schneller zu lösen**, alle erforderlichen Informationen ein, z. B. die Quell- und Zielinstanz ARNs sowie das gewünschte Datum und die Uhrzeit der Migration, einschließlich Zeitzone. 

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Gehen Sie auf der Seite **Jetzt lösen oder uns kontaktieren** wie folgt vor:

   1. Wählen Sie die Registerkarte **Kontaktieren Sie uns** und dann Ihre **bevorzugte Kontaktsprache** und Ihre bevorzugte Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

1. Das Amazon-Connect-Team wird Ihr Ticket überprüfen und sich mit Ihnen in Verbindung setzen.

# Geben Sie eine Telefonnummer von Amazon Connect zurück in den Lagerbestand
<a name="release-phone-number"></a>

Wenn Sie eine andere Telefonnummer möchten oder zusätzliche Nummern haben, die Sie nicht verwenden, können Sie diese im Bestand freigeben. Sie können dies über die Amazon Connect Connect-Konsole oder programmgesteuert mithilfe der [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API tun.

Wenn eine Telefonnummer von Ihrer Amazon-Connect-Instance freigegeben wird:
+ Es wird Ihnen nichts mehr in Rechnung gestellt.
+ Sie können die Telefonnummer nicht zurückfordern.
+ Amazon Connect behält sich das Recht vor, die Beantragung durch einen anderen Kunden zuzulassen.

**Tipp**  
Wenn Sie Ihr Amazon-Connect-Konto schließen möchten, führen Sie die folgenden Schritte für alle Ihre Telefonnummern aus. Auf diese Weise wird sichergestellt, dass Ihnen keine Gebühren in Rechnung gestellt werden, wenn Personen fälschlicherweise Nummern anrufen, die Sie beantragt haben, und Ihre Flows auslösen. Sie sollten auch [Ihre Instances löschen.](delete-connect-instance.md) 

**Freigeben einer Telefonnummer**

1. Melden Sie sich mit einem Amazon Connect Administratorkonto oder einem Benutzerkonto mit **Telefonnummern auf der Admin-Website an — Sicherheitsprofilberechtigung freigeben**. 

1. Wählen Sie im Navigationsmenü **Kanäle**, **Telefonnummern** aus. Diese Option wird nur angezeigt, wenn Sie in Ihrem Sicherheitsprofil über die Berechtigung **Telefonnummern – Anzeigen** verfügen.

1. Wählen Sie die Telefonnummer, die Sie freigeben möchten, und klicken Sie dann auf **Release (Freigeben)**. Diese Option wird nur angezeigt, wenn Sie in Ihrem Sicherheitsprofil über die Berechtigung **Telefonnummern – Freigeben** verfügen.

Wenn die Telefonnummer mit einem Vorgang verknüpft ist, wird dieser Vorgang deaktiviert, bis eine andere Nummer mit ihm verknüpft wird.

Wenn Kunden die freigegebene Telefonnummer anrufen, erhalten sie eine Nachricht, dass dies keine funktionierende Telefonnummer ist. 

**Um die ReleasePhoneNumber API zu verwenden**
+ Durch die Freigabe einer Nummer mithilfe der [ReleasePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReleasePhoneNumber.html)API wird die Nummer für bis zu 180 Tage in eine Abkühlphase versetzt. Die Telefonnummer kann erst nach Flow der Bedenkzeit gesucht oder abgerufen werden.
**Anmerkung**  
Während der 180-tägigen Bedenkzeit wird Ihnen die Telefonnummer nicht in Rechnung gestellt.

## Vermeiden Sie es, daran gehindert zu werden, zu viele Nummern zu beanspruchen oder freizugeben
<a name="avoid-being-blocked-releasing"></a>

Wenn Sie häufig Nummern anfordern und freigeben möchten, kontaktieren Sie uns, um eine Ausnahme des Servicekontingents zu erhalten. Andernfalls werden Sie möglicherweise daran gehindert, weitere Nummern anzufordern und freizugeben, bis zu 180 Tage nach dem Ablauf der ältesten freigegebenen Nummer.

Standardmäßig können Sie bis zu 200 % Ihrer maximalen Anzahl an aktiven Telefonnummern anfordern und freigeben. Wenn Sie während eines fortlaufenden 180-Tage-Zyklus, der 200% Ihres Telefonkontingents übersteigt, Rufnummern über die Benutzeroberfläche oder API beanspruchen und veröffentlichen, können Sie keine weiteren Nummern beanspruchen, bis die älteste freigegebene Nummer 180 Tage nach Ablauf der ältesten freigegebenen Nummer abgelaufen ist. 

Wenn Sie beispielsweise bereits 99 beanspruchte Nummern und ein Servicelevel-Kontingent von 99 Telefonnummern haben und Sie in einem beliebigen Zeitraum von 180 Tagen 99 freigeben, 99 beanspruchen und dann 99 freigeben, haben Sie das Limit von 200% überschritten. Ab diesem Zeitpunkt können Sie keine weiteren Nummern mehr beanspruchen, bis Sie ein AWS Support-Ticket öffnen.

# Verwenden der Anruferidentifikation zum Personalisieren der Kundeninteraktion
<a name="caller-id-personalizing-customer-interaction"></a>

Sie können Ihren Kunden ein personalisiertes Erlebnis bieten, indem Sie Metadatenattribute verwenden, die Informationen zum Anrufursprung bereitstellen. Sie können beispielsweise nach der Kontakt-ID eines Kunden suchen und ihn mit einer personalisierten Begrüßung willkommen heißen.

**Wichtig**  
Funktionen, die von Amazon Connect oder Drittanbietern bereitgestellt werden, können sich auf Anrufdaten stützen, um eingehende Anrufer zum Personalisieren von Kundeninteraktionen zu identifizieren oder Betrug zu erkennen. Sie können auch zusätzlichen allgemeinen Geschäftsbedingungen unterliegen. Netzwerkbezogene Anrufdaten, die den Anrufempfängern nicht angezeigt werden, dürfen zu keinem anderen Zweck als zur Betrugserkennung verwendet werden.

## Verwenden von Attributen für Telefonie-Anrufmetadaten
<a name="call-metadata-attributes"></a>

In der folgenden Tabelle werden die verfügbaren Attribute für Telefonie-Anrufmetadaten aufgeführt. Weitere Informationen zur Verwendung von Attributen finden Sie unter [Amazon-Connect-Kontaktattribute verwenden](connect-contact-attributes.md).


| Attribut | Description | Typ | JSONPath Referenz | 
| --- | --- | --- | --- | 
| P-Charge-Info | Die Partei, die für die Gebühren im Zusammenhang mit dem Anruf verantwortlich ist. | System (System) | \$1.Media.Sip.Headers.P-Charge-Info | 
| Aus | Die Identität des Endbenutzers, der mit der Anforderung verknüpft ist. | System (System) | \$1.Media.Sip.Headers.From | 
| Bis | Informationen zum angerufenen Teilnehmer oder zum Empfänger der Anforderung.  | System (System) | \$1.Media.Sip.Headers.To | 
| ISUP-OLI | Herkunftsleitungsanzeige (OLI). Zeigt die Art der Leitung an, die den Anruf tätigt (z. B. PSTN, 800-Serviceanruf, wireless/cellular PCS, Payphone). | System (System) | \$1.Media.Sip.Headers.ISUP-OLI | 
| JIP | Parameter zur Angabe der Gerichtsbarkeit (JIP). Zeigt den geografischen Standort des Anrufers/Switch an.  Beispielwert: 212555 | System (System) | \$1.Media.Sip.Headers.JIP | 
| Hop-Zähler | Hop-Zähler.  Beispielwert: 0  | System (System) | \$1.Media.Sip.Headers.Hop-Counter | 
| Herkunfts-Switch | Herkunfts-Switch.  Beispielwert: 710   | System (System) | \$1.Media.Sip.Headers.Originating-Switch | 
| Herkunfts-Trunk | Herkunfts-Trunk. Beispielwert: 0235 | System (System) | \$1.Media.Sip.Headers.Originating-Trunk | 
| Anzeige für Anrufweiterleitung | Anzeigen für Anrufweiterleitung (z. B. Umleitungsheader). Zeigt den inländischen oder internationalen Ursprung des Anrufs an.  Beispielwert: sip:\$115555555555@public-vip.us2.telphony-provider.com;reason=unconditional  | System (System) | \$1.Media.Sip.Headers.Call-Forwarding-Indikator | 
| Adresse des Anrufers | Adresse des Anrufers (Nummer). NPAC dip zeigt den echten Verbindungsstyp und den systemeigenen geografischen Switch an. Beispielwert: 15555555555;noa=4  | System (System) | \$1.Media.Sip.Headers.Calling-Party-Address | 
| Adresse des Anrufempfängers | Adresse des Anrufempfängers (Nummer).  Beispielwert: 15555555555;noa=4   | System (System) | \$1.Media.Sip.Headers.Called-Party-Address | 
| SIPREC-Metadaten |  SIPREC-Metadaten-XML, das vom Connector von Amazon Contact Lens empfangen wurde  | System (System) |  \$1.Media.Sip. SiprecMetadata | 

## Beheben von Problemen mit
<a name="ts-metadata"></a>

Die Verfügbarkeit von Telefonie-Metadaten ist nicht bei allen Telefonieanbietern einheitlich und möglicherweise nicht in allen Fällen gegeben. 

Bevor Sie einen AWS Support Koffer öffnen:
+ Wenn Ihnen Daten zu allen Anrufen fehlen, die von einem Amazon-Connect-Ready-Service eines Drittanbieters benötigt werden, vergewissern Sie sich, dass Sie den vom Drittanbieter bereitgestellten Service-Konfigurationsleitfaden befolgt haben. 

  Wenn Sie einen AWS Support Fall öffnen müssen, geben Sie die folgenden Informationen an:
  + **Service** = **Amazon Connect**
  + **Kontingent** = **Rufnummernzuweisung für Drittanbieter**
  + Dialogfeld **Beschreibung des Falls**:
    + Bestätigen Sie, dass Sie über eine Telefonnummer mit den erforderlichen Einstellungen verfügen.
    + Geben Sie den Namen Ihres Amazon-Connect-Ready-Dienstanbieters ein.
    + Beschreiben Sie das Problem, das mit den Telekommunikationsmetadaten aufgetreten ist.

  In den folgenden Abbildungen sind Fallbeispiele mit den Feldern dargestellt, in denen Sie diese Informationen eingeben können.  
![\[Der AWS Support-Fall für die Anforderung der Rufnummernzuweisung für Drittanbieter.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/3rd-party-mapping.png)  
![\[Das Dialogfeld „Beschreibung des Falls“, in dem Sie Hilfe bei der Rufnummernzuweisung für Drittanbieter anfordern können.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/case-description.png)
+ Wenn Sie partielle Daten zu einem Prozentsatz der Anrufe im Rahmen normaler Serviceanrufe erhalten: Beachten Sie, dass Daten nicht für alle Anrufe verfügbar sind. 

  Bestimmte Felder, wie z. B. ISUP-OLI, sind nur auf der Grundlage bestimmter Routen durch Netzwerke vorhanden. Es kann nicht garantiert werden, dass Daten für alle Anrufe verfügbar sind.

# Zuweisen von Nummern von Drittanbietern zu Ihrem Amazon-Connect-Konto
<a name="third-party-numbers"></a>

In einigen Ländern benötigen Sie möglicherweise eine Telefonnummer eines Drittanbieters, die direkt von einem Mobilfunkanbieter in diesem Land gehostet wird, anstatt von Amazon Connect gehostet zu werden. Der Transporteur ist mit Amazon Connect verbunden und bietet Abrechnungsdienste an. In diesen Situationen müssen Sie ein Ticket öffnen, AWS Support um Ihre AWS Konto-ID und Ihre Amazon Connect Connect-Instanz der Telefonnummer zuzuordnen.

**Um Ihrem Konto Nummern von Drittanbietern zuzuordnen**

Übermitteln Sie ein Amazon-Connect-Supportticket ein, um Nummern von Drittanbietern zuzuweisen. Im Folgenden finden Sie Anweisungen, falls Sie kein AWS Support Konto haben.

1. Navigieren Sie zum [Supportcenter](https://console.aws.amazon.com/support/home) und wählen Sie **Einen Fall erstellen** aus. 

1. Wählen Sie **Konto und Fakturierung** aus.

1. Wählen Sie im Feld **Service** in der Dropdown-Liste die Option **Connect (Nummernverwaltung)** aus.

1. Wählen Sie im Feld **Kategorie** die Option **Rufnummernzuweisung für Drittanbieter** aus.

1. Wählen Sie im Feld **Schweregrad** den für Ihre Situation zutreffenden Schweregrad aus.

1. Wählen Sie **Next step: Additional information** (Nächster Schritt: Zusätzliche Informationen).

1. Führen Sie auf der Seite **Weitere Informationen** folgende Schritte aus:

   1. Geben Sie den Betreff ein.

   1. Geben Sie unter **Beschreibung** so viele Informationen wie möglich zu Ihrer Anforderung an, z. B. Ihren ARN der Instance, Telefonnummern, Abläufe und mehr.
**Wichtig**  
Fügen Sie keine Dokumente bei, die persönliche Informationen enthalten. Nachdem wir Ihren Fall geprüft haben, senden wir Ihnen einen Link zu unserem sicheren Speicher (Amazon S3), damit Sie die erforderlichen Dokumente einreichen können. Dieser Vorgang wird in Schritt 12 unten beschrieben.

1. Geben Sie unter **Mit Ihrer Hilfe können wir Ihr Problem schneller lösen** alle erforderlichen Informationen ein. 

1. Klicken Sie auf **Next step: Solve now or contact us** ( ()Nächster Schritt): Jetzt lösen oder Support kontaktieren).

1. Gehen Sie auf der Seite **Jetzt lösen oder uns kontaktieren** wie folgt vor:

   1. Wählen Sie die Registerkarte **Kontaktieren Sie uns** und dann Ihre **bevorzugte Kontaktsprache** und Ihre bevorzugte Kontaktmethode aus.

1. Wählen Sie **Absenden** aus.

1. Das Amazon-Connect-Team wird Ihr Ticket überprüfen und sich mit Ihnen in Verbindung setzen. Sie erhalten einen Link zu unserem sicheren Speicher (Amazon S3), damit Sie die erforderlichen Dokumente einreichen können.

# Amazon-Connect-Unterstützung des UIFN-Service nur für eingehende Anrufe
<a name="uifn-service"></a>

Bei einer Universal International Freephone Number (UIFN) handelt es sich um eine einzigartige gebührenfreie Nummer **nur für eingehende Anrufe**, die auf der ganzen Welt verwendet werden kann. Sie ermöglicht gebührenfreie Anrufe von internationalen Standorten zu Ihrem Kontaktzentrum.

Amazon Connect unterstützt UIFN in mehr als [60 Ländern](#list-of-uifn-countries), die bei der International Telecommunications Union registriert sind, einer Organisation, die die Verwaltung des UIFN-Services unterstützt. 

**Anmerkung**  
Amazon Connect ermöglicht Ihnen die Aktivierung UIFNs in so vielen Ländern, wie Sie benötigen. Es sind jedoch mindestens 5 Länder erforderlich.

Eine UIFN besteht aus einem dreistelligen Ländercode für eine globale Serviceanwendung, z. B. **800**, und einer 8-stelligen globalen Abonnentennummer (GSN). Dies führt zu einem 11-stelligen festen Format. 

Ihre UIFN könnte beispielsweise \$1800 12345678 lauten, wobei 12345678 Ihre Nummer ist.

Aufgrund der besonderen Eigenschaften von UIFN wird der Versuch, eine UIFN von Amazon Connect aus in einem „Loopback-Modus“ aufzurufen, nicht unterstützt. UIFNs sind so konzipiert, dass sie von Endtelefonkonfigurationen aus dem öffentlichen Telefonnetz des Landes aus angerufen werden können.

## Erste Schritte mit einer UIFN
<a name="how-to-get-a-uifn"></a>

Um eine UIFN innerhalb eines bestimmten Bereichs anzufordern AWS-Region, erstellen Sie einen AWS Support Fall. Geben Sie im Supportfall die folgenden Informationen an.
+ Wählen Sie die Länder, die Sie aktivieren möchten, aus der [Liste der verfügbaren Länder aus](#list-of-uifn-countries). 
+ Die Amazon-Connect-Instance (en), die den neuen UIFN-Nummern zugeordnet sind. Amazon Connect kann Routing-Nummern in mehrere Regionen unterstützen, z. B. von Australien in die Region Asien-Pazifik (Sydney), von den Vereinigten Staaten in eine US-Region oder, falls gewünscht, zu einer einzelnen globalen Instance.
+ Die erforderliche ID-Überprüfung für Ihr Land. In den meisten Ländern gelten die [Standardanforderungen zur ID-Verifizierung](phone-number-requirements.md#uifn-requirements) für die Bestellung von UIFN-Nummern. Wir empfehlen jedoch, [Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect](phone-number-requirements.md) zur Sicherheit nach Ihrem Land zu suchen. 

  Aus Gründen der Nummernübertragbarkeit stellt Ihnen Amazon, nachdem Sie einen Fall eröffnet haben, ein Dokument zur *Service Provider Change Authorization and Designation of Agency* zur Verfügung.

Amazon Connect kann UIFNs an mehrere weiterleiten AWS-Regionen. Wenn eine UIFN beispielsweise für Australien aktiviert ist, kann sie an Ihre Amazon-Connect-Instance weitergeleitet werden, die sich in der Region Asien-Pazifik (Sydney) befindet. Wenn eine UIFN für **mehr** Länder aktiviert ist, kann jedes Land an Ihre Amazon-Connect-Instance weitergeleitet werden, die sich in jeder unterstützten Instance befinden kann. AWS-Region

Das folgende Bild zeigt den Text einer UIFN-Beispielanfrage, an die gesendet wurde. AWS Support Diese Anfrage ist für zwei Personen UIFNs. Die erste ist für eine UIFN, die für Argentinien, Brasilien und Kolumbien aktiviert und mit einer Amazon-Connect-Instance in der Region USA West (Oregon) verbunden ist. Die zweite Anfrage bezieht sich auf eine UIFN, die für Japan, Australien und Neuseeland aktiviert und mit einer Amazon-Connect-Instance in der Region Asien-Pazifik (Singapur) verbunden ist. 

![\[Ein Support-Fall, in dem zwei Personen angefordert UIFNs werden.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/uifn-example-request.png)


**Wichtig**  
**UIFN ist ein Service nur für eingehende Anrufe**. Bevor Sie ein Ticket öffnen, um eine UIFN anzufordern:  
Sie müssen wissen, dass diese Nummer nicht für ausgehende Anrufe verwendet werden kann.
Überprüfen Sie im folgenden Abschnitt unbedingt die nationale Erreichbarkeit des Landes.
Vollständige nationale Erreichbarkeit bedeutet, dass die UIFN alle lokalen (landesinternen) Netzwerke erreicht. UIFNs In einigen Ländern ist die Erreichbarkeit eingeschränkt und funktioniert nur in bestimmten Ländern, carriers/networks in denen Sie unterschiedliche Vorwahlen verwenden müssen, um die Nummer zu wählen (z. B. Japan).

## Länder, die unterstützen UIFNs
<a name="list-of-uifn-countries"></a>


| Land | Wie wählt man eine UIFN und Erreichbarkeit  | Wie viele Tage dauert es, bis eine UIFN eingerichtet ist | 
| --- | --- | --- | 
| Argentinien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alle Festnetze  | 10-25 | 
| Australien  | 0011-800-XXXX-XXXX Nationale Erreichbarkeit: Optus, Telstra, Vodafone Mobile  | 10-30 | 
| Österreich  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Belgien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Brasilien  | 0021-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt Die Aktivierung des internationalen Direktwahldienstes ist für Anrufe sowohl aus dem Festnetz als auch über Mobilfunk erforderlich. Der Abonnent muss die Verwendung der internationalen Ländervorwahl von Embratel/Claro (0021) aktiviert haben.  | 20-30 | 
| Bulgarien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-20 | 
| Kanada  | 011-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt Anrufe von öffentlichen Fernsprechern aus werden nicht unterstützt.  | 20-40 | 
| China  | 00-800-XXXX-XXXX Nationale Erreichbarkeit:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/uifn-service.html)  | 20-40 | 
| Kolumbien  | Wählformat: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/uifn-service.html) Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Costa Rica  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-30 | 
| Kroatien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alles Festnetz; T-Mobile-Netz  | 20-30 | 
| Tschechische Republik  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 20-30 | 
| Dänemark  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-20 | 
| Estland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-25 | 
| Frankreich  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt, einschließlich Monaco  | 10-15 | 
| Französisch-Guayana  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Deutschland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Griechenland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alles fest; Cosmotel-Mobilfunknetz  | 10-15 | 
| Guadeloupe  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Hong Kong  | 006-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt CLI nicht garantiert.  | 20-40 | 
| Ungarn  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt Die Aktivierung des internationalen Direktwahldienstes ist für Anrufe sowohl aus dem Festnetz als auch über Mobilfunk erforderlich.  Bei Anrufen über Mobiltelefone können Gebühren für die Gesprächsdauer erhoben werden.  | 10-15 | 
| Island  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alles Festnetz; Mobilfunknetze von Iceland Telecom, IMC, Vodafone.  | 10-20 | 
| Israel  | Wählformat: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/uifn-service.html) Nationale Erreichbarkeit: uneingeschränkt  | 20-50 | 
| Italien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alle Festnetze, einschließlich Vatikan und San Marino  | 10-15 | 
| Japan  | Wählformat: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/uifn-service.html) Nationale Erreichbarkeit: uneingeschränkt   | 20-40 | 
| Lettland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Litauen  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alle Festnetze; Telia-LT-Mobilfunknetze  | 15-30 | 
| Luxemburg  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Macau  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-25 | 
| Mazedonien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: MakTel Festnetz, T-Mobile-Netz  | 40-60 | 
| Malta  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: GO- und VANILLA-Festnetze. GO-Mobilfunknetze.  | 10-15 | 
| Martinique  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Mayotte  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Monaco  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 20-30 | 
| Niederlande  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Neuseeland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Peru  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: America Moviles, Weiterel, Telefonica Moviles, TESAM, Globalstar Networks.  Festnetz und Mobilfunknetz von Telefonica del Peru   | 30-50 | 
| Philippinen  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: alle Festnetze  | 10-15 | 
| Portugal  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Wiedersehen  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Rumänien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: Festnetz und Mobilfunknetz von Orange, Festnetz und Mobilfunknetz von Rodasy, Festnetz und Mobilnetz von Romtelekom, Mobilfunknetz Cosmote  | 10-30 | 
| St. Pierre und Miquelon  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 30-60 | 
| Singapur  | 001 800 XXXX XXXX Die Aktivierung des internationalen Direktwahldienstes ist für Anrufe sowohl aus dem Festnetz als auch über Mobilfunk erforderlich. Bei Anrufen über Mobiltelefone können Gebühren für die Gesprächsdauer erhoben werden. Anrufe von öffentlichen Starhub-Fernsprechern aus werden nicht unterstützt.  | 20-30 | 
| Slowakei  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-30 | 
| Slowenien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-30 | 
| Südafrika  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: eingeschränkt Für MTN- und Prepaid-Abonnenten nicht erreichbar.  | 10-15 | 
| Südkorea  | 002-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-20 | 
| Spanien  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt Gleichzeitige Anrufe: 100 gleichzeitige Anrufe  | 10-15 | 
| Schweiz  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Taiwan  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-15 | 
| Thailand  | 001-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 10-20 | 
| Großbritannien und Nordirland  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: BT-, Vodafone- und EE-Netze  | 20-40 | 
| Uruguay  | 00-800-XXXX-XXXX Nationale Erreichbarkeit: uneingeschränkt  | 15-25 | 

# Regionale Anforderungen für die Bestellung und Portierung von Telefonnummern in Amazon Connect
<a name="phone-number-requirements"></a>

Länder- bzw. Regionsvorschriften erfordern oft eine lokale Niederlassungsadresse und spezifische Ausweisdokumente, um eine Telefonnummer zu erwerben und zu besitzen. Die Adresse, die Sie angeben, kann die geschäftliche oder persönliche Adresse sein, an der die Telefonnummern verwendet werden. 

Eine Liste der Telefoniefunktionen, die Amazon Connect bietet, finden Sie im [Amazon Connect Telecoms Country Coverage Guide](https://d1v2gagwb6hfe1.cloudfront.net/Amazon_Connect_Telecoms_Coverage.pdf). Dieses Handbuch gibt Aufschluss darüber, welche Regionen unterstützt werden und ob es Ausnahmen beim Zugriff auf ein Land von einer beliebigen Handelsregion aus gibt.

Nachfolgend finden Sie eine Liste der ID-Anforderungen nach Land bzw. Region für die Bestellung und Portierung von Rufnummern. Sofern nicht anders angegeben, **werden alle AWS Regionen unterstützt — mit Ausnahme von Afrika (Kapstadt) und AWS GovCloud (USA West**). Wenn Sie [eine internationale Nummer beantragen](number-request.md), arbeiten wir mit Ihnen zusammen, um Ihre Dokumente einzureichen. 

**Wichtig**  
Adressen, die ohne Anwesenheit beantragt werden können, wie z. B. Postfachadressen, sind in keinem Land gültig.
Nachdem Ihre Nummern bestellt oder portiert wurden, wird die genaue Anzahl der angeforderten Telefonnummern auf der Amazon Connect Admin-Website auf der Seite „**Telefonnummern verwalten**“ angezeigt, sodass Sie sie [verwalten können](get-connect-number.md#get-connect-number1). Sie haben keinen Zugriff auf alle verfügbaren Nummern in diesem Land.

## Anguilla (AI)
<a name="anguilla-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ai-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="ai-porting"></a>

Die Portierung wird nicht unterstützt. 

## Antigua und Barbuda (AG)
<a name="antigua-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ag-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 268 | Ja | Aufträge müssen schriftlich erfolgen. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="ai-porting"></a>

Die Portierung wird nicht unterstützt.

## Argentinien (AR)
<a name="argentina-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ar-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Nein |   | 
| Gebührenfreie Vorwahlen: \$154 800 | Nein |   | 
| Vorwahlen für Kostenteilung: \$154 810  | Nein |  | 

### Übertragbarkeit von Nummern
<a name="ar-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 2 bis 4 Uhr oder 10 bis 12 Uhr oder von 15 bis 17 Uhr UTC-3 Zeit in Buenos Aires  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Australien (AU)
<a name="australia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements). 

### Für die Bestellung von Telefonnummern
<a name="au-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja |  Ihre Geschäftsadresse, ein Kontaktname und eine Telefonnummer. Eine Adresse in Australien ist erforderlich  | 
| Gebührenfreie Vorwahlen: \$161 1300, \$161 1800 | Nein | Ihre Geschäftsadresse, ein Kontaktname und eine Telefonnummer. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="au-porting"></a>


****  

| Art der Nummer | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
| Lokale Telefonnummern | Montag bis Freitag von 8 bis 17 Uhr AEST/AEDT  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| Gebührenfreie Präfixe: \$161 13, \$161 1800 | Montag bis Freitag von 8 Uhr bis 15:30 Uhr AEST/AEDT  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Österreich (AT)
<a name="austria-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="at-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Nachweis der Telekommunikationsdienste an Ihrer Adresse, der mit der angeforderten Stadtvorwahl übereinstimmen muss. Gültige Nachweise (müssen in den letzten 6 Monaten ausgestellt werden): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| Nationale Vorwahlen: \$143 720 | Ja | Nachweis der Telekommunikationsdienste an Ihrer Adresse, die sich innerhalb des Landes befinden muss. Gültige Nachweise (müssen in den letzten 6 Monaten ausgestellt werden): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| Gebührenfreie Vorwahlen: \$143 800 | Ja | Ihr Firmenname, Ihre Adresse und eine Kopie der Unternehmensregistrierung (global). Eine globale Adresse ist zulässig.  | 

### Übertragbarkeit von Nummern
<a name="at-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Belgien (BE)
<a name="belgium-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="be-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern:  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Mobile Vorwahlen: \$132 46 | Nein |  | 
| Gebührenfreie Vorwahlen: \$132 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="be-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

**Anmerkung**  
Die Bestellung und Portierung von nationalen Rufnummern \$132 78 wird nicht unterstützt.

## Bahamas (BS)
<a name="bahamas-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bs-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 242 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="bs-porting"></a>

Die Portierung wird nicht unterstützt.

## Barbados (BB)
<a name="barbados-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bb-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 246 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="bb-porting"></a>

Die Portierung wird nicht unterstützt. 

## Bolivien (BO)
<a name="bolivia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bo-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Nationale Vorwahlen: \$1591 50 | Nein |   | 

### Übertragbarkeit von Nummern
<a name="bo-porting"></a>

Die Portierung wird nicht unterstützt.

## Bonaire (BQ)
<a name="bonaire-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bq-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$1599 7 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="bq-porting"></a>

Die Portierung wird nicht unterstützt.

## Brasilien (BR)
<a name="brazil-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="br-ordering"></a>


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)

### Übertragbarkeit von Nummern
<a name="br-porting"></a>


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)

## Brunei (BN)
<a name="brunei-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="brunei-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Gebührenfreie Vorwahlen | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="brunei-porting"></a>

Die Portierung wird nicht unterstützt.

## Kanada (CA)
<a name="canada-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="ca-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |   | 
| Gebührenfreie Vorwahlen  | Nein |   | 

### Übertragbarkeit von Nummern
<a name="ca-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 7 bis 17 Uhr CST | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Chile (CL)
<a name="chile-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="cl-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja |  Rechtlicher Firmenname (Razón Social): Auszug aus dem Handelsregister Lokale Geschäftsadresse (muss sich in Chile befinden): Auszug aus dem Handelsregister mit der rechtlichen Geschäftsadresse Unterlagen zur Steuerregistrierung: Kopie der RUT (Rol Unico Tributario) – offizielle chilenische Steueridentifikation  | 
| Gebührenfreie Vorwahlen  | Ja |  Rechtlicher Firmenname (Razón Social): Auszug aus dem Handelsregister Lokale Geschäftsadresse (muss sich in Chile befinden): Auszug aus dem Handelsregister mit der rechtlichen Geschäftsadresse Unterlagen zur Steuerregistrierung: Kopie der RUT (Rol Unico Tributario) – offizielle chilenische Steueridentifikation  | 
| Nummern für Massenkommunikation (Serien 809 und 600) | Ja |  Rechtlicher Firmenname (Razón Social): Auszug aus dem Handelsregister Lokale Geschäftsadresse (muss sich in Chile befinden): Auszug aus dem Handelsregister mit der rechtlichen Geschäftsadresse Unterlagen zur Steuerregistrierung: Kopie der RUT (Rol Unico Tributario) – offizielle chilenische Steueridentifikation Zusätzliche Anforderung: ausgefülltes und unterschriebenes Formular „Erklärung zur Verwendung von Massenkommunikationsnummern – Chile“  | 

### Übertragbarkeit von Nummern
<a name="cl-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 21 Uhr bis 3 Uhr PST | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## China (CN)
<a name="china-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="cn-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="cn-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Kolumbien (CO)
<a name="colombia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="co-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |   | 
| Gebührenfreie Vorwahlen: \$157 800 | Nein |   | 

### Übertragbarkeit von Nummern
<a name="co-porting"></a>

Nicht unterstützt

## Costa Rica (CR)
<a name="costa-rica-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="cr-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |   | 
| Gebührenfreie Vorwahlen: \$1506 800 | Nein |   | 

### Übertragbarkeit von Nummern
<a name="cr-porting"></a>

Nicht unterstützt

## Kroatien (HR)
<a name="croatia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

## Curaçao (CW)
<a name="curaçao-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="cw-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$1599 9 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="cw-porting"></a>

Die Portierung wird nicht unterstützt.

## Zypern (CY)
<a name="cyprus-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="cy-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$1 357 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="cy-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Tschechische Republik (CZ)
<a name="czech-republic-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="cz-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern:  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$1420 800 | Ja | Name und Adresse Ihres Unternehmens. Eine globale Adresse ist akzeptabel. | 

### Übertragbarkeit von Nummern
<a name="cz-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 15 Uhr bis 16 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Dänemark (DK)
<a name="denmark-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="dk-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern:  | Ja | Ihr Firmenname, Ihre Adresse und eine Beschreibung der Servicenutzung. Eine globale Adresse ist akzeptabel.  | 
| Mobile Vorwahlen: \$145 9x | Nein |  | 
| Gebührenfreie Vorwahlen: \$145 808 | Ja | Ihr Firmenname, Ihre Adresse und eine Beschreibung der Servicenutzung. Eine globale Adresse ist akzeptabel. | 

### Übertragbarkeit von Nummern
<a name="dk-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Dominikanische Republik (DOM)
<a name="dom-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="dom-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Nein | –  | 
| Gebührenfreie Vorwahlen: \$11 8xx | Nein | N/A  | 

### Übertragbarkeit von Nummern
<a name="dom-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Portierung ist nur für **lokale Telefonnummern** verfügbar. Montag bis Freitag 22:00 Uhr bis 04:00 Uhr PST |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Ecuador (ECU)
<a name="ecu-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ecu-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Nein | –  | 
| Gebührenfreie Vorwahlen: \$1593-180000XXXX | Nein | –  | 

### Übertragbarkeit von Nummern
<a name="ecu-porting"></a>

Nicht unterstützt

## El Salvador (SV)
<a name="el-salvador-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="sv-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Unternehmen müssen ihren Namen, ihre Adresse und ihre RUC/TaxID-Nummer sowie eine Kopie der Unternehmensregistrierung und einen Adressnachweis angeben. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt); Regierungsdokumente (ausgestellt im Vorjahr); der Ausweisnachweis ist eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters. Eine lokale Adresse ist erforderlich.  | 
| Gebührenfreie Vorwahlen  | Ja | Unternehmen müssen eine Kopie der Gewerbeanmeldung und einen Adressnachweis vorlegen. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt); Regierungsdokumente (ausgestellt im Vorjahr); der Ausweisnachweis ist eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters.  | 

### Übertragbarkeit von Nummern
<a name="sv-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 03:00 Uhr bis 05:00 Uhr CST |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Estland (EE)
<a name="estonia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ee-ordering"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Gebührenfreie Vorwahlen: \$1372 800 | Nein |  | 
| Nationale Vorwahlen: \$1372 | Ja | Ihre Geschäftsadresse. Eine Kopie des Personalausweises/der Unternehmensregistrierung. Eine globale Adresse ist akzeptabel. | 

### Übertragbarkeit von Nummern
<a name="ee-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Finnland (FI)
<a name="finland-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="fi-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja |  Ihr Wohnsitz oder Ihre Geschäftsadresse. Bei beiden Adressen muss es sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$1358 800 | Nein |  | 
| Nationale Vorwahlen: \$1358 75 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="fi-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Frankreich (FR)
<a name="france-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="fr-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale geografische Telefonnummern: \$133 1, \$133 2, \$133 3, \$133 4, \$133 5 | Ja | Eine Geschäftsadresse in Frankreich ist erforderlich. Sie müssen eine Kopie der Unternehmensregistrierung (KBIS-, INPI- oder INSEE-Auszug, ausgestellt in den letzten 3 Monaten) vorlegen, in der die angegebene Adresse in Frankreich als Hauptgeschäftsadresse angegeben ist.  | 
| Nationale Mehrzwecknummern: \$133 9 7890 | Ja | Eine Geschäftsadresse in Frankreich ist erforderlich. Sie müssen eine Kopie der Unternehmensregistrierung (KBIS-, INPI- oder INSEE-Auszug, ausgestellt in den letzten 3 Monaten) vorlegen, in der die angegebene Adresse in Frankreich als Hauptgeschäftsadresse angegeben ist. | 
| Nationale verifizierte Mehrzwecknummern (zur Verwendung als Anrufer-ID durch automatisierte Anrufdienste): \$133 9 4847 | Ja | Eine Geschäftsadresse in Frankreich ist erforderlich. Sie müssen eine Kopie der Unternehmensregistrierung (KBIS-, INPI- oder INSEE-Auszug, ausgestellt in den letzten 3 Monaten) vorlegen, in der die angegebene Adresse in Frankreich als Hauptgeschäftsadresse angegeben ist. | 
| Nationale Mehrzwecknummern für die Kommunikation mit einer technischen Plattform: \$133 9 3937 | Ja | Eine Geschäftsadresse in Frankreich ist erforderlich. Sie müssen eine Kopie der Unternehmensregistrierung (KBIS-, INPI- oder INSEE-Auszug, ausgestellt in den letzten 3 Monaten) vorlegen, in der die angegebene Adresse in Frankreich als Hauptgeschäftsadresse angegeben ist. | 
| Gebührenfreie Vorwahlen: \$133 801 | Ja | Eine Geschäftsadresse in der Europäischen Union sowie eine Telefonnummer des Ansprechpartners sind erforderlich. | 

### Übertragbarkeit von Nummern
<a name="fi-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Die Übertragbarkeit von Nummern wird für alle gebührenfreien Vorwahlen von \$133 800 bis \$133 805, für geografische Vorwahlen von \$133 1 bis \$133 5 und für nationale Mehrzweckvorwahlen \$133 9 unterstützt.  | 

## Französisch-Guayana (GF)
<a name="gf-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="gf-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="gf-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Georgien (GE)
<a name="georgia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ge-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Nationale Vorwahlen: \$1995 70 | Nein |  | 
| Lokale Telefonnummern: (Tibilisi) | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Sie müssen die Adresse nachweisen. | 

### Übertragbarkeit von Nummern
<a name="ge-porting"></a>

Nicht unterstützt

## Deutschland (DE)
<a name="germany-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="de-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Sie müssen eine Kopie des Unternehmensregistrierungsdokuments (ausgestellt in den letzten 6 Monaten) als Adressnachweis vorlegen.  | 
| Nationale Vorwahlen: \$149 32 | Ja | Eine Geschäftsadresse in Deutschland ist erforderlich. Sie müssen eine Kopie des Unternehmensregistrierungsdokuments (ausgestellt in den letzten 6 Monaten) als Adressnachweis vorlegen.   | 
| Gebührenfreie Vorwahlen: \$149 800 | Ja |  Gebührenfreie Vorwahlen werden für Unternehmen mit einer Adresse in Deutschland (also Nummern, die innerhalb von Deutschland beantwortet oder beendet werden) oder alternativ für Unternehmen mit einer Adresse außerhalb von Deutschland (also außerhalb von Deutschland beantwortet oder beendet) unterstützt. Für Unternehmen mit einer Adresse in Deutschland (bevorzugt) müssen Sie die Nummer direkt von der örtlichen Aufsichtsbehörde anfordern und dann Ihr Nummernvergabezertifikat zur Nummernaktivierung an Amazon Connect weiterleiten. Details zum Vorgang werden bei Anforderungsstellung bereitgestellt.  Wenn sich Ihr Unternehmen außerhalb von Deutschland befindet, müssen Sie eine Kopie der Unternehmensregistrierung vorlegen, die als Nachweis der Unternehmensregistrierung und als Adressnachweis dient. Wenn auf der Unternehmensregistrierung keine Adresse angegeben ist, ist zusätzlich eine Stromrechnung (ausgestellt in den letzten 6 Monaten) erforderlich.  | 

### Übertragbarkeit von Nummern
<a name="de-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Griechenland (GR)
<a name="greece-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="gr-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern:  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Eine Kopie Ihrer Unternehmensregistrierung in Griechenland (Auszug innerhalb der letzten 12 Monate).  | 
| Gebührenfreie Vorwahlen: \$130 800 | Ja | Ihre Geschäftsadresse. Es muss eine Adresse in Griechenland sein. Eine Kopie Ihrer Unternehmensregistrierung in Griechenland (Auszug innerhalb der letzten 12 Monate). | 

### Übertragbarkeit von Nummern
<a name="gr-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Guatemala (GT)
<a name="guatemala-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="guatemala-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | Einschränkungen | 
| --- | --- | --- | --- | 
| Lokale Telefonnummern | Nein |   |  | 

### Übertragbarkeit von Nummern
<a name="guatemala-porting"></a>

Die Portierung wird nicht unterstützt.

## Guadeloupe (GP)
<a name="gp-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="gp-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="gp-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Honduras (HN)
<a name="honduras-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="honduras-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | Einschränkungen | 
| --- | --- | --- | --- | 
| Nationale DID | Nein |   |  | 
| Gebührenfreie Vorwahlen: \$1504 800 | Nein |   |  | 

### Übertragbarkeit von Nummern
<a name="honduras-porting"></a>

Die Portierung wird nicht unterstützt.

## Hongkong (HK)
<a name="hongkong-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="hk-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Unternehmen müssen ihren Namen, ihre Adresse, eine Kopie der Unternehmensregistrierung und einen Adressnachweis vorlegen. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt); Regierungsdokumente (ausgestellt im Vorjahr); der Ausweisnachweis ist eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters. Eine lokale Adresse ist erforderlich.   | 
| Nationale Vorwahlen: \$1852 58 | Ja | Unternehmen müssen ihren Namen, ihre Adresse, eine Kopie der Unternehmensregistrierung und einen Adressnachweis vorlegen. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt); Regierungsdokumente (ausgestellt im Vorjahr); der Ausweisnachweis ist eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters.  | 
| Gebührenfreie Vorwahlen: \$1852 800 | Ja | Unternehmen müssen einen Adressnachweis vorlegen. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt). Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="hk-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| – | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Ungarn (HU)
<a name="hungary-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="hu-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Sie müssen eine Kopie des Unternehmensregistrierungsdokuments (ausgestellt in den letzten 6 Monaten) als Adressnachweis vorlegen. Eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters ist ebenfalls erforderlich.  | 
| Gebührenfreie Vorwahlen: \$136 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="hu-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Island (IS)
<a name="iceland-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="iceland-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Ihre Geschäftsadresse in Island. Eine Kopie Ihrer Unternehmensregistrierung in Island.  | 
| Gebührenfreie Vorwahlen | Nein |   | 

### Übertragbarkeit von Nummern
<a name="iceland-porting"></a>

Die Portierung wird nicht unterstützt.

## Indonesien (ID)
<a name="indonesia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="id-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonvorwahlen: \$162 21, \$162 31, \$162 61 | Ja | Ihre Geschäftsadresse, ein Kontaktname und eine Telefonnummer. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Sie müssen auch eine Beschreibung zur Verwendung der Nummern angeben.  | 
| Mobile Vorwahlen: \$162 855 | Ja | Nachweis der Geschäftsadresse, eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters und die Geschäftsregistrierung. Sie müssen auch eine Beschreibung zur Verwendung der Nummern angeben.  | 
| Gebührenfreie Vorwahlen: \$162 800 | Nein |   | 

### Übertragbarkeit von Nummern
<a name="id-porting"></a>

Nicht unterstützt

## Irland (IE)
<a name="ireland-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ie-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. Sie müssen einen Adressnachweis (z. B. eine Stromrechnung) vorlegen.  | 
| Gebührenfreie Vorwahlen: \$1353 1800 | Ja | Ihre Geschäftsadresse in Irland und eine Kopie der Unternehmensregistrierung.  | 

### Übertragbarkeit von Nummern
<a name="ie-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Israel (IL)
<a name="il-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="il-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="il-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Italien (IT)
<a name="italy-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="it-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihr Firmenname, Ihre Adresse und Ihre Umsatzsteuer-Identifikationsnummer. Sie müssen die Adresse zusammen mit einer Kopie der Gewerbeanmeldung (innerhalb der letzten 6 Monate ausgestellt) nachweisen. Sie müssen die folgenden Angaben zu einem Bevollmächtigten angeben: Name und Anschrift, Geburtsort und Daten sowie Staatsangehörigkeit und Steuernummer. Legen Sie auch einen Nachweis der Identität des Bevollmächtigten vor, bei dem es sich um eine Kopie eines Personalausweises oder Reisepasses handeln kann. Der Name des Vertreters muss in der Gewerbeanmeldung stehen. Eine lokale Adresse in Italien ist erforderlich.  | 
| Gebührenfreie Vorwahlen: \$139 800 | Ja |  Ihr Firmenname, Ihre Adresse und Ihre Umsatzsteuer-Identifikationsnummer.  Sie müssen die folgenden Angaben zu einem Bevollmächtigten angeben: Name und Anschrift, Geburtsort und Daten sowie Staatsangehörigkeit und Steuernummer. Legen Sie auch einen Nachweis der Identität des Bevollmächtigten vor, bei dem es sich um eine Kopie eines Personalausweises oder Reisepasses handeln kann. Eine Geschäftsadresse in der Europäischen Union ist erforderlich.   | 

### Übertragbarkeit von Nummern
<a name="it-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Für lokale Nummern: Montag bis Freitag von 6 Uhr bis 9 Uhr MEZ Für gebührenfreie Nummern: Montag bis Freitag von 6 Uhr bis 16:00 Uhr MEZ  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Jamaika (JM)
<a name="jamaica-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="jm-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="jm-porting"></a>

Die Portierung wird nicht unterstützt.

## Japan (JP)
<a name="japan-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="jp-ordering"></a>


****  

| Unterstützte Regionen | Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | --- | 
|  Asien-Pazifik (Tokio) | Lokale Telefonnummern: \$181 3 | Ja | Unternehmen müssen drei Dokumente vorlegen:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Kopien dieser Dokumente sollten in einer einzigen ZIP-Datei erstellt werden.  | 
|  Alle | Lokale Vorwahlen: \$181 50 | Ja | Unternehmen müssen drei Dokumente vorlegen:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Kopien dieser Dokumente sollten in einer einzigen ZIP-Datei erstellt werden.  | 
|  Alle | Gebührenfreie Vorwahlen: \$181 120, \$181 800  | Ja | Unternehmen müssen die folgenden Unterlagen zur Verfügung stellen:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Kopien dieser Dokumente sollten in einer einzigen ZIP-Datei erstellt werden.  | 

### Übertragbarkeit von Nummern
<a name="jp-porting"></a>


****  

| Unterstützte -Regionen | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
| Alle für gebührenfreie Vorwahlen: \$181 120, \$181 800 | In der Regel am 1. und 15. des Folgemonats | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Übertragbarkeit Ihrer Nummer (n) zu überprüfen.  | 
| Asien-Pazifik (Tokio) für lokale Telefonnummern: \$181 3 | In der Regel am 1. und 15. des Folgemonats | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Portabilität Ihrer Nummer (n) zu überprüfen.  | 

## Lettland (LV)
<a name="latvia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="lv-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Gebührenfreie Vorwahlen: \$1371 80 | Ja | Unternehmen müssen eine Kopie der Gewerbeanmeldung zusammen mit einem Adressnachweis in Lettland (ausgestellt in den letzten 6 Monaten) vorlegen.  Gültige Nachweise: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| Nationale Vorwahlen: \$1371 6 | Ja | Unternehmen müssen einen Adressnachweis in Lettland vorlegen (ausgestellt in den letzten 6 Monaten).  Gültige Nachweise: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

### Übertragbarkeit von Nummern
<a name="lv-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Litauen (LT)
<a name="lithuania-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="lt-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht. | 
| Gebührenfreie Vorwahlen: \$1370 800 | Ja | Ihre Geschäftsadresse im Land. | 

### Übertragbarkeit von Nummern
<a name="lt-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Luxemburg (LU)
<a name="luxembourg-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="lu-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$1352 27 | Ja | Ihr Wohnsitz oder Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  Telefonnummer des Ansprechpartners | 
| Nationale Vorwahlen: | Ja | Eine Adresse in Luxemburg ist erforderlich. Unternehmen müssen eine Kopie der Gewerbeanmeldung vorlegen. Telefonnummer des Ansprechpartners | 
| Gebührenfreie Vorwahlen: \$1352 800 | Ja | Name und Adresse Ihres Unternehmens. Eine globale Adresse ist akzeptabel. Telefonnummer des Ansprechpartners | 

### Übertragbarkeit von Nummern
<a name="lu-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Macau (MO)
<a name="mo-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mo-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mo-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Mazedonien (MK)
<a name="mk-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mk-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mk-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Malaysia (MY)
<a name="malaysia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="my-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) | 
| Gebührenfreie Vorwahlen: \$160 1800 | Ja | Unterlagen zur Unternehmensregistrierung. Ihre Geschäftsadresse. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="my-porting"></a>

Nicht unterstützt

## Malta (MT)
<a name="mt-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mt-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mt-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Martinique (MQ)
<a name="mq-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mq-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mq-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Mayotte (YT)
<a name="yt-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="yt-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="yt-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Mexiko (MX)
<a name="mexico-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mx-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |  | 
| Gebührenfreie Vorwahlen: \$152 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="mx-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 10 Uhr bis 12 Uhr MEZ oder 14 Uhr bis 16 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Monaco (MC)
<a name="mc-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mc-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mc-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Neuseeland (NZ)
<a name="new-zealand-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="nz-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |  | 
| Gebührenfreie Vorwahlen: \$164 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="nz-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 7 Uhr bis 11 Uhr NZST | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Niederlande (NL)
<a name="netherlands-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="nl-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja |  Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$131 800 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel. Die geschätzte Durchlaufzeit von der Bestellung bis zur Aktivierung beträgt 6 Wochen.  | 
| Nationale Vorwahlen: \$131 85 | Ja | Ihre Geschäftsadresse im Land. | 
| Nationale Präfixe: \$131 88 | Ja | Sie müssen die Nummer direkt von der örtlichen Aufsichtsbehörde anfordern und dann Ihr Nummernvergabezertifikat zur Nummernaktivierung an Amazon Connect weiterleiten. Details zum Vorgang werden bei Anforderungsstellung bereitgestellt. | 

### Übertragbarkeit von Nummern
<a name="nl-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Nicaragua (NI)
<a name="nicaragua-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="nicaragua-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Mobile Vorwahlen: \$1505 (7)  | Nein | – | 

## Nigeria (NG)
<a name="nigeria-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ng-ordering"></a>


****  

| Unterstützte Regionen | Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | --- | 
| Afrika (Kapstadt)  | Lokale Telefonnummern | Ja | Die Unternehmen müssen eine Kopie der Gewerbeanmeldung vorlegen, die einen Adressennachweis enthält. Zu den gültigen Adressnachweisen gehören: von Dritten ausgestellte Kontoauszüge, Stromrechnungen (alle in den letzten 6 Monaten ausgestellt); Regierungsdokumente (ausgestellt im Vorjahr); der Ausweisnachweis ist eine Kopie des Personalausweises oder Reisepasses eines bevollmächtigten Vertreters. Die Geschäftsadresse muss sich in Nigeria befinden.  | 

### Übertragbarkeit von Nummern
<a name="ng-porting"></a>

Nicht unterstützt

## Norwegen (NO)
<a name="norway-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="no-ordering"></a>


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)

Nummern stehen nur Unternehmen zur Verfügung, nicht Einzelpersonen. Der DID-Typ ist Festnetz statt Geografisch. Dies liegt daran, dass alle früher geografischen Nummern jetzt als Festnetznummern klassifiziert sind und keine geografische Zone haben.

### Übertragbarkeit von Nummern
<a name="no-porting"></a>


****  

| Unterstützte Regionen | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
|  Europa (Frankfurt)  Europa (London)  | Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Panama (PA)
<a name="panama-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="pa-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: | Nein |  | 
| Gebührenfreie Vorwahlen: \$1507 800 | Ja | Ihre Geschäftsadresse. Sie können maximal 5 gebührenfreie Nummern in Panama pro Firmennamen haben. Eine globale Adresse ist akzeptabel. | 

### Übertragbarkeit von Nummern
<a name="pa-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag 12:00 Uhr bis 02:00 Uhr PST | **Für die Portierung lokaler Nummern**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) **Für die Portierung von gebührenfreien Nummern**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Peru (PE)
<a name="peru-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="pe-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |  | 
| Gebührenfreie Vorwahlen: \$151 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="pe-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 22 Uhr bis 4 Uhr PST |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Philippinen (PH)
<a name="ph-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ph-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Standort des Kundendienstmitarbeiters | Zulässige Identifikation | 
| --- | --- | --- | --- | 
| Lokale Telefonnummern: \$163 2 | Ja | Der Kundendienstmitarbeiter muss sich auf den Philippinen befinden. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| Gebührenfreie Vorwahlen: \$163 1800 | Ja | Der Kundendienstmitarbeiter muss sich auf den Philippinen befinden. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 
| UIFN | Ja | – | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Einschränkungen der Deckung
<a name="ph-limitations"></a>
+ TFN: Nationale Erreichbarkeit nur über: globales Netzwerk

### Übertragbarkeit von Nummern
<a name="ph-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Polen (PL)
<a name="poland-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="pl-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja |  Eine lokale Adresse, die der Vorwahl der Telefonnummer(n) entspricht, sowie eine Kopie Ihrer Unternehmensregistrierung als Adressnachweis.  | 
| Gebührenfreie Vorwahlen: \$148 800 | Ja | Ihre Geschäftsadresse in Polen. | 

### Übertragbarkeit von Nummern
<a name="pl-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag 0 Uhr MEZ  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Portugal (PT)
<a name="portugal-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="pt-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  Ihre Steuernummer (NIF)   Außerdem müssen Sie den geforderten Nachweis über die Erbringung von Telekommunikationsdiensten an dieser Adresse erbringen. | 
| Nationale Vorwahlen: \$1351 30 | Ja | Ihre Geschäftsadresse in Portugal. Außerdem müssen Sie den geforderten Nachweis über die Erbringung von Telekommunikationsdiensten an dieser Adresse erbringen.  | 
| Gebührenfreie Vorwahlen: \$1351 800 | Ja | Ihre Geschäftsadresse, Ihre Steuernummer und eine Kopie der Unternehmensregistrierung. Eine Geschäftsadresse in der Europäischen Union ist erforderlich.  | 

### Übertragbarkeit von Nummern
<a name="pt-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Puerto Rico (PR)
<a name="puerto-rico-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="pr-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 787, \$11 939 | Nein |  | 
| Gebührenfreie Vorwahlen: \$11 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="pr-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Wiedersehen (RE)
<a name="re-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="re-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="re-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Rumänien (RO)
<a name="romania-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="ro-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern:  | Ja | Ihre Adresse und Ihren Adressnachweis. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$140 800 | Nein |  | 
| Nationale Vorwahlen: \$140 376 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="ro-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Saba (BQ)
<a name="saba-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bq-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$1599 4 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="bq-porting"></a>

Die Portierung wird nicht unterstützt.

## St. Pierre und Miquelon (PM)
<a name="pm-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="pm-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="pm-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Serbien (RS)
<a name="serbia-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="rs-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 
| Gebührenfreie Vorwahlen | Nein |   | 

### Übertragbarkeit von Nummern
<a name="rs-porting"></a>

Nicht unterstützt

## St. Lucia (LC)
<a name="saintmartin-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mf-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="jm-porting"></a>

Die Portierung wird nicht unterstützt.

## St. Martin (MF)
<a name="saintmartin-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="mf-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 758 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="mf-porting"></a>

Die Portierung wird nicht unterstützt.

## Singapur (SG)
<a name="singapore-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="sg-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Nationale Vorwahlen: \$165 31 und \$165 6 | Ja | Adresse im Land erforderlich. Für das Unternehmen erforderliche Dokumente: Dokumente zur Unternehmensregistrierung  | 
| Gebührenfreie Präfixe: \$165 1800 | Ja |  Ihre Geschäftsadresse. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="sg-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 9 Uhr bis 17 Uhr SGT | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

Eine Portierung DIDs ist aufgrund der Marktpraxis nur für zusammenhängende Nummernblöcke mit 10 Nummern (... 0 bis... 9) möglich.

## Sint Eustatius (BQ)
<a name="sinteustatius-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="bq-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$1599 3 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="bq-porting"></a>

Die Portierung wird nicht unterstützt.

## Sint Maarten (SX)
<a name="sintmaarten-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="sx-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 721 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="sx-porting"></a>

Die Portierung wird nicht unterstützt.

## Slowakei (SK)
<a name="slovakia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="sk-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$1421 800 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="sk-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Slowenien (SI)
<a name="slovenia-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="si-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse. Es muss sich um eine lokale Adresse handeln, die der Vorwahl der Telefonnummer(n) entspricht.  | 
| Gebührenfreie Vorwahlen: \$1386 80 | Nein |  | 
| Nationale Vorwahlen: \$1386 82 | Ja | Eine Adresse in Slowenien ist erforderlich. | 

### Übertragbarkeit von Nummern
<a name="si-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Südafrika (ZA)
<a name="southafrica-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="za-ordering"></a>


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)

### Übertragbarkeit von Nummern
<a name="za-porting"></a>


****  

| Unterstützte Regionen | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
| Afrika (Kapstadt)  |  Montag bis Freitag von 17 Uhr bis 18 Uhr GMT\$12 (SAST)  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Südkorea (KR)
<a name="southkorea-requirements"></a>

**Anmerkung**  
Die Bestellung und Portierung von Nummern in Südkorea dauert länger als in den meisten anderen Ländern, da zusätzliche Schritte im Zusammenhang mit der Überprüfung durch die Aufsichtsbehörden erforderlich sind und viele der Schritte auf Koreanisch durchgeführt werden müssen. Weitere Informationen zur Bestellung und Portierung von Nummern in Südkorea finden Sie unter [Richtlinien für die Portierung von Telefonnummern zu Ihrem Amazon-Connect-Projekt in Südkorea](porting-numbers-sk.md).

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="kr-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| VoIP-Vorwahlnummern: \$182 70 | Ja |  Lokale Kunden sollten eine Kopie ihrer **Unternehmensregistrierungsbescheinigung (Finanzamt) vorlegen**, die von den örtlichen Steuerbehörden ausgestellt wurde und die registrierte Adresse des Unternehmens enthält. Reichen Sie ein Support Ticket ein, um die Dokumente für die Bestellung neuer Nummern zu überprüfen.  | 
| Repräsentative Nummern: \$182 15, \$182 16 | Ja | Ein Bestellformular für die repräsentative Nummer ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Neben diesem Formular werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Dokumente für die Bestellung neuer Nummern zu überprüfen. | 
| Gebührenfreie Präfixe: \$182 80 | Ja | Ihre Geschäftsadresse in Südkorea. Lokale Kunden sollten eine Kopie ihrer **Unternehmensregistrierungsbescheinigung (Finanzamt) vorlegen**, die von den örtlichen Steuerbehörden ausgestellt wurde und die registrierte Adresse des Unternehmens enthält. Reichen Sie ein Support Ticket ein, um die Dokumente für die Bestellung neuer Nummern zu überprüfen. Reichen Sie ein Support Ticket ein, um eine neue Nummer zu bestellen.  | 
| Geografische Vorwahlen: \$182 2 | Ja (per Portierung) |  Wie bei VOIP-Nummern, doch in dem vorgelegten Unternehmensregistrierungsdokument sollte ein physischer Standort angegeben sein, der der Zone \$1822 (Seoul) zugeordnet ist. Wenn jedoch aufgrund der koreanischen Vorschriften, nach denen neue lokale Nummern als ältere Dienste physisch installiert werden müssen, neue lokale Nummern benötigt werden, empfehlen wir, Migrationen im Voraus zu planen und sicherzustellen, dass Sie Nummern bei bestehenden Anbietern anfordern, bei denen die Nummer mindestens 6 Monate physisch installiert ist. Amazon Connect unterstützt die Migration einer großen Anzahl von Daten und kann Nummern DIDs, die älter als 6 Monate sind, direkt zu Amazon Connect portieren.  | 

### Übertragbarkeit von Nummern
<a name="kr-porting"></a>


****  

| Art der Nummer | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
| Geografische Vorwahlen: \$182 2 (jede \$182-Nummer außer \$1821, \$1825, \$1827, \$182308) | Montag bis Freitag von 9 Uhr bis 18 Uhr KST | Neues SIP-Bestellformular und SIP-Port-Formular für die bestehende(n) Nummer(n). Verwenden Sie die Formulare, die Ihnen bei Antragstellung zur Verfügung gestellt werden. Die Dokumente müssen von einem Mitarbeiter des Unternehmens unterzeichnet sein, dessen Geburtsmonat und -jahr vermerkt sind, und mit einem Firmenstempel versehen sein. Neben diesen Formularen werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Portabilität Ihrer Nummer (n) zu überprüfen.  | 
| Nationale Vorwahlen: \$182 50 | Montag bis Freitag von 9 Uhr bis 18 Uhr KST |  Neues SIP-Bestellformular und SIP-Port-Formular für die bestehende(n) Nummer(n). Verwenden Sie die Formulare, die Ihnen bei Antragstellung zur Verfügung gestellt werden. Die Dokumente müssen von einem Mitarbeiter des Unternehmens unterzeichnet sein, dessen Geburtsmonat und -jahr vermerkt sind, und mit einem Firmenstempel versehen sein. Neben diesen Formularen werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Portabilität Ihrer Nummer (n) zu überprüfen.  | 
| Repräsentative Nummern: \$182 15, \$182 16 | Montag bis Freitag von 9 Uhr bis 18 Uhr KST | Das RN/TFN-Änderungsformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Neben diesem Formular werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Portabilität Ihrer Nummer (n) zu überprüfen.  | 
| Gebührenfreie Präfixe: \$182 80 | Montag bis Freitag von 9 Uhr bis 18 Uhr KST | Das RN/TFN-Änderungsformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Neben diesem Formular werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Dokumente für die Bestellung neuer Nummern zu überprüfen.  | 
| VoIP-Vorwahlnummern: \$182 70 | Montag bis Freitag von 9 Uhr bis 18 Uhr KST | Eine Anrufweiterleitung zu einer anderen \$18270-Nummer ist möglich. Neues SIP-Bestellformular und SIP-Port-Formular für die bestehende(n) Nummer(n). Verwenden Sie die Formulare, die Ihnen bei Antragstellung zur Verfügung gestellt werden. Die Dokumente müssen von einem Mitarbeiter des Unternehmens unterzeichnet sein, dessen Geburtsmonat und -jahr vermerkt sind, und mit einem Firmenstempel versehen sein. Neben diesen Formularen werden folgende Dokumente benötigt: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Reichen Sie ein Support Ticket ein, um die Portabilität Ihrer Nummer (n) zu überprüfen.  | 

## Spanien (ES)
<a name="spain-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="es-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse in Spanien in der entsprechenden geografischen Zone und Ihre Unternehmenssteuernummer. Eine Kopie der Unternehmensregistrierung (Agencia Tributaria oder Registro Mercantil). Wenn sich die Adresse in der Unternehmensregistrierung von der für die Telefonnummern angegebenen Adresse unterscheidet, müssen Sie auch einen Adressnachweis vorlegen.  | 
| Gebührenfreie Vorwahlen: \$134 900 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="es-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Schweden (SE)
<a name="sweden-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="se-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern | Ja | Ihre Geschäftsadresse in Schweden, Ihre Mehrwertsteuernummer und eine Kopie der Unternehmensregistrierung  | 
| Nationale Vorwahlen: \$146 77 und \$146 10 | Ja | Ihre Geschäftsadresse in Schweden, Ihre Mehrwertsteuernummer und eine Kopie der Unternehmensregistrierung | 
| Mobile Vorwahlen: \$146 766 | Nein |   | 
| Gebührenfreie Vorwahlen: \$146 20 | Ja | Ihre Geschäftsadresse in der Europäischen Union, Ihre Mehrwertsteuernummer und eine Kopie der Unternehmensregistrierung | 

### Übertragbarkeit von Nummern
<a name="se-porting"></a>

Rufnummernportabilität ist für \$146 77-Nummern nicht verfügbar.


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Schweiz (CH)
<a name="switzerland-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="ch-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Ja | Ihre Geschäftsadresse im Land. Eine Kopie der ID/business Registrierung und ein Adressnachweis.  | 
| Gebührenfreie Vorwahlen: \$141 800 | Ja | Ihre Geschäftsadresse und eine Kopie der Gewerbeanmeldung. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="ch-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag-Freitag 10 Uhr bis 12 Uhr MEZ | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Taiwan (TW)
<a name="tw-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="tw-ordering"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

## Thailand (TH)
<a name="thailand-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="th-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | Einschränkungen | 
| --- | --- | --- | --- | 
| Lokale Telefonnummern  | Ja | **Für Geschäftsadressen innerhalb Thailands**: Das Unternehmen muss eine Kopie des Personalausweises eines bevollmächtigten Unternehmensvertreters und ein Unternehmenszertifikat vorlegen. **Für Geschäftsadressen außerhalb Thailands**: Nachweis der Geschäftsadresse und Nachweis des Personalausweises, z. B. die Gewerbeanmeldung. Außerdem eine Kopie des Ausweises oder Reisepasses eines bevollmächtigten Vertreters.  | Die internationale Anrufer-ID ist nicht garantiert. | 
| Gebührenfreie Vorwahlen: \$166 1800 | Ja | Nachweis der Geschäftsadresse und Ausweisnachweis, z. B. die Unternehmensregistrierung. Außerdem eine Kopie des Ausweises oder Reisepasses eines bevollmächtigten Vertreters. Die Adresse darf sich nicht in Thailand befinden.  |  | 

### Nummernübertragbarkeit (Umleitung)
<a name="ge-porting"></a>


****  

| Art der Nummer | Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | --- | 
| Lokale Telefonnummern | Montag bis Freitag von 9 Uhr bis 17 Uhr ICT | Die Geschäftsadresse muss sich in Thailand befinden. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Trinidad und Tobago (TT)
<a name="trinidad-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="tt-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 868 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="tt-porting"></a>

Die Portierung wird nicht unterstützt.

## Turks- und Caicosinseln (TC)
<a name="turks-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="tc-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$11 649 | Ja | Ein Bestellformular ist erforderlich. Verwenden Sie das Formular, das Ihnen bei Antragstellung zur Verfügung gestellt wird. Geben Sie die folgenden Informationen ein: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="tc-porting"></a>

Die Portierung wird nicht unterstützt.

## Uganda (UG)
<a name="uganda-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ug-ordering"></a>


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)

### Übertragbarkeit von Nummern
<a name="ug-porting"></a>

Nicht unterstützt

## Großbritannien und Nordirland (GB)
<a name="unitedkingdom-requirements"></a>

Unterstützt für UIFN-Nummern die [Standardregionen und -anforderungen](#uifn-requirements).

### Für die Bestellung von Telefonnummern
<a name="gb-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern: \$144 1, \$144 2 | Nein | Für Nummernbestellungen in bestimmten Vorwahlen kann eine lokale Adresse erforderlich sein.  | 
| Handypräfixe: \$144 7 | Nein |  | 
| Gebührenfreie Vorwahlen: \$144 800, \$144 808 | Nein |  | 
| Nationale Vorwahlen: \$144 33, \$144 84 | Nein |  | 

### Übertragbarkeit von Nummern
<a name="gb-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Für lokale (geografische) Nummern: Montag bis Freitag von 9 Uhr bis 11 Uhr GMT Für nicht geografische (nationale, gebührenfreie) Nummern: Montag bis Freitag von 9 Uhr bis 11 Uhr GMT oder von 0 Uhr bis 4 Uhr GMT  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html) Bei der Portierung von \$144 300-Nummern sind möglicherweise zusätzliche Dokumente erforderlich, um nachzuweisen, dass Sie eine öffentliche oder gemeinnützige Einrichtung sind.  | 

## Vereinigte Staaten (USA)
<a name="us-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="us-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern  | Nein |   | 
| Gebührenfreie Vorwahlen  | Nein |  | 

### Übertragbarkeit von Nummern
<a name="us-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Montag bis Freitag von 7 bis 17 Uhr CST  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/phone-number-requirements.html)  | 

## Uruguay (UY)
<a name="uy-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="uy-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="uy-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

## Venezuela (VE)
<a name="venezuela-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="ve-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| Lokale Telefonnummern\$1\$1 | Nein | Nicht zutreffend | 
| Gebührenfreie Vorwahlen | Nein | Nicht zutreffend  | 

**\$1\$1 Nationale Erreichbarkeit, teilweise** – Wir bieten nationale Erreichbarkeit (eingehend) mit den folgenden lokalen Anbietern an:
+ CANTV-Festnetz
+ Movilnet (Mobilfunknetz)
+ Telefonica-Movistar (Fest- und Mobilfunknetz)

Derzeit bieten wir mit Digitel keine nationale Erreichbarkeit für eingehende Anrufe an (Fest- und Mobilfunknetz).

### Übertragbarkeit von Nummern
<a name="ve-porting"></a>

Die Portierung wird nicht unterstützt.

## UIFN-Anforderungen
<a name="uifn-requirements"></a>

### Für die Bestellung von Telefonnummern
<a name="uifn-ordering"></a>


****  

| Art der Nummer | Gibt es Ausweispflichten? | Zulässige Identifikation | 
| --- | --- | --- | 
| UIFN | Ja | Ihr Firmenname, Ihre Adresse und Beschreibung der Nutzung des Services. Eine globale Adresse ist akzeptabel.  | 

### Übertragbarkeit von Nummern
<a name="uifn-porting"></a>


****  

| Fenster für Portabilität | Erforderliche Dokumente | 
| --- | --- | 
| Nur UIFN-Zeiten voreinstellen | Von Amazon zur Änderung der Genehmigung und Benennung der Behörde durch den Dienstanbieter  | 

# Einrichten des Chat-Erlebnisses Ihres Kunden in Amazon Connect
<a name="enable-chat-in-app"></a>

Sie können Ihren Kunden ein Chat-Erlebnis bieten, indem Sie eine der folgenden Methoden verwenden: 
+ [Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website](add-chat-to-website.md). 
+ [Anpassen des Chats mit dem Open-Source-Beispiel von Amazon Connect](download-chat-example.md). 
+ [Passen Sie Ihre Lösung mit Amazon Connect an APIs](integrate-with-startchatcontact-api.md). Wir empfehlen, bei der Anpassung Ihrer eigenen Chat-Erlebnisse mit der Amazon Connect ChatJS-Open-Source-Bibliothek zu beginnen. Weitere Informationen finden Sie im [Amazon Connect ChatJS](https://github.com/amazon-connect/amazon-connect-chatjs)-Repository auf Github. 

## Weitere Informationsquellen zur Anpassung des Chat-Erlebnisses
<a name="more-resource-customize-chat"></a>
+ Interaktive Nachrichten bieten Kunden sofortige und vorkonfigurierte Anzeigeoptionen, aus denen sie wählen können. Diese Nachrichten werden von Amazon Lex bereitgestellt und über Amazon Lex mithilfe eines Lambda konfiguriert. Anweisungen zum Hinzufügen interaktiver Nachrichten über Amazon Lex finden Sie in diesem Blog: [Interaktive Nachrichten für Ihren Amazon-Connect-Chatbot einrichten](https://aws.amazon.com/blogs/contact-center/easily-set-up-interactive-messages-for-your-amazon-connect-chatbot/).

  Amazon Connect unterstützt die folgenden Vorlagen: eine Listenauswahl und eine Zeitauswahl. Weitere Informationen finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md). 
+  [Aktivieren von Apple Messages for Business in Amazon Connect](apple-messages-for-business.md) 
+  [Amazon Connect Service API-Dokumentation](https://docs.aws.amazon.com/connect/latest/APIReference), insbesondere die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API.
+  [Participant Service API von Amazon Connect](https://docs.aws.amazon.com/connect-participant/latest/APIReference/Welcome.html). 
+  [Amazon Connect – Chat SDK und Beispielimplementierungen](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/) 
+  [Amazon-Connect-Streams](https://github.com/aws/amazon-connect-streams). Verwenden Sie diese, um vorhandene Apps in Amazon Connect zu integrieren. Sie können die Komponenten des CCP (Contact Control Panel) in die App einbetten. 
+  [Nachrichtenstreaming für KI-gestützten Chat aktivieren](message-streaming-ai-chat.md) 

# Der chat/SMS Kanal in Amazon Connect
<a name="web-and-mobile-chat"></a>

**Wichtig**  
**Versuchen Sie, Amazon für Support zu kontaktieren?** Weitere Informationen finden Sie unter [Amazon-Kundenservice](https://www.amazon.com/gp/help/customer/display.html?icmpid=docs_connect_messagingcap_customerservice) (Amazon-Bestellungen und -Lieferungen) oder [AWS Support](https://aws.amazon.com/premiumsupport/?icmpid=docs_connect_messagingcap_premiumsupport) (Amazon Web Services).

Mit Amazon Connect können Sie Chat-Messaging-Features – Mobil-Chat, Web-Chat, SMS und Messaging-Services von Drittanbietern – in Ihre Website und mobilen Apps integrieren. Das ermöglicht Kunden, von jeder Geschäftsanwendung aus, ob im Internet oder auf Mobilgeräten, mit Contact-Center-Mitarbeitern zu chatten. 

Die Interaktionen sind asynchron, d. h. Ihre Kunden können einen Chat mit einem Kundendienstmitarbeiter oder einem Amazon-Lex-Bot beginnen, ihn verlassen und das Gespräch dann wieder aufnehmen. Sie können sogar das Gerät wechseln und den Chat fortsetzen.

**Topics**
+ [Mehrere Kanäle, eine Umgebung](#unified-experience-chat)
+ [Erste Schritte](#enable-chat)
+ [Beispiel für ein Chat-Szenario](#example-chat-scenario)
+ [Wann enden Chats?](#when-do-chats-end)
+ [Preisgestaltung](#web-and-mobile-chat-pricing)
+ [Weitere Informationen](#chat-more-info)

## Mehrere Kanäle, eine Umgebung
<a name="unified-experience-chat"></a>

Kundendienstmitarbeiter haben eine einzige Benutzeroberfläche, über die sie Kunden bei der Nutzung von Sprachanrufen, Chat und Aufgaben unterstützen können. Dies reduziert die Anzahl der Tools, deren Umgang Kundendienstmitarbeiter erlernen müssen, und die Anzahl der Bildschirme, mit denen sie interagieren müssen. 

Chat-Aktivitäten lassen sich in Ihre bestehenden Flows im Contact Center und in die Automatisierung integrieren, die Sie für Sprachanrufe entwickelt haben. Sie erstellen Ihre Flows einmal und verwenden sie dann in mehreren Kanälen wieder. 

Die Erfassung von Metriken und die von Ihnen erstellten Dashboards profitieren automatisch von den vereinheitlichten Metriken für mehrere Kanäle.

## Erste Schritte
<a name="enable-chat"></a>

Um Ihrem Amazon-Connect-Contact-Center Chat-Funktionen hinzuzufügen und Ihren Kundendienstmitarbeitern die Teilnahme an Chats zu ermöglichen, führen Sie die folgenden Schritte durch:
+ Der Chat wird auf Instance-Ebene aktiviert, sobald [ein Amazon-S3-Bucket zum Speichern von Chat-Transkripten erstellt wird](amazon-connect-instances.md#get-started-data-storage).
+ [Fügen Sie „Chat“ zum Weiterleitungsprofil Ihres Kundendienstmitarbeiters](routing-profiles.md) hinzu.
+ Optional können Sie Chat-Untertypen wie etwa SMS-Nachrichten einrichten. Sie beschaffen sich eine SMS-fähige Telefonnummer, indem Sie sie verwenden AWS End User Messaging SMS, importieren sie in Amazon Connect und weisen sie dann Ihren Flows zu. Weitere Informationen finden Sie unter: 
  + [Fordern Sie eine SMS-fähige Telefonnummer an über AWS End User Messaging SMS](sms-number.md)
  + [Einrichten von SMS-Messaging in Amazon Connect](setup-sms-messaging.md)

Kundendienstmitarbeiter können ab dann Chats über das Contact Control Panel annehmen.

Sie können Echtzeit- und historische Messwerte für den Chat-Messaging-Kanal (z. B. Ankunftszeit, Bearbeitungszeit) als Teil der gesamten Chat-Kanal-Metriken in derselben Berichtserfahrung einsehen, die auch zur Bewertung der Leistung und Produktivität der Agenten verwendet wurde. calls/chats/tasks

Amazon Connect bietet verschiedene Ressourcen, mit denen Sie Ihrer Website einen Chat hinzufügen können. Weitere Informationen finden Sie unter [Einrichten des Chat-Erlebnisses Ihres Kunden in Amazon Connect](enable-chat-in-app.md).

## Beispiel für ein Chat-Szenario
<a name="example-chat-scenario"></a>

Ein Kunde und ein Kundendienstmitarbeiter chatten gerade. Der Kunde reagiert nicht mehr auf den Kundendienstmitarbeiter. Der Kundendienstmitarbeiter fragt: „Sind Sie da?“ und erhält keine Antwort. Der Kundendienstmitarbeiter verlässt den Chat. Jetzt ist der Chat nicht mehr mit einem Kundendienstmitarbeiter verknüpft. Ihr Flow bestimmt, was als Nächstes passiert. 

Wenn der Kunde beispielsweise eine weitere Nachricht sendet („Hallo, ich bin wieder da“), kann der Chat fortgesetzt werden. Abhängig von der im Flow definierten Logik kann der Chat dem ursprünglichen Kundendienstmitarbeiter oder einem anderen Kundendienstmitarbeiter bzw. einer anderen Warteschlange zugewiesen werden.

So erstellen Sie dieses Szenario:

1. Erstellen Sie einen TrennungsFlow. Die folgende Abbildung zeigt einen [Beispiel-Flow „Verbindungstrennung“ in Amazon Connect](sample-disconnect.md) im Flow-Designer. Dieser Flow umfasst die folgenden miteinander verbundenen Blöcke: **Wiedergabeaufforderung**, **Warten**, die zu drei **Wiedergabeaufforderungen** verzweigt (für **Kunde ist zurückgekehrt**, **Zeit abgelaufen** und **Fehler**), dann **In die Warteschlange übertragen** und **Verbindung trennen**.  
![\[Beispiel für einen VerbindungstrennungsFlow.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/sample-disconnect-flow.png)

1.  Fügen Sie in den TrennungsFlow einen [Wait (Warten)](wait.md)-Block ein. Der "Wait (Warten)"-Block enthält zwei Branches: 
   +  **Timeout (Zeitüberschreitung)**: Führen Sie diesen Branch aus, wenn der Kunde nach einer angegebenen Zeit keine Nachricht gesendet hat. Die Gesamtdauer des Chats darf, einschließlich mehrerer **Warten**-Blöcke, 7 Tage nicht überschreiten. 

      Sie können beispielsweise für diesen Zweig nur einen **Disconnect (Trennen)**-Block ausführen und den Chat beenden. 
   +  **Customer return (Kundenrückkehr)**: Führen Sie diesen Branch aus, wenn der Kunde zurückkehrt und eine Nachricht sendet. Mit diesem Branch können Sie den Kunden zum vorherigen Kundendienstmitarbeiter oder zur vorherigen Warteschlange leiten oder eine neue Arbeitswarteschlange bzw. einen neuen Kundendienstmitarbeiter zuweisen. 

1.  Fügen Sie dem Flow für eingehende Kontakte den Block [VerbindungstrennungsFlow festlegen](set-disconnect-flow.md) hinzu. Mit diesem Block geben Sie an, dass der VerbindungstrennungsFlow ausgeführt werden soll, wenn der Kundendienstmitarbeiter oder der Amazon-Lex-Bot die Verbindung zum Chat getrennt hat und nur der Kunde zurückbleibt. 

    Im folgenden Block haben wir beispielsweise angegeben, dass **Sample disconnect flow (BeispieltrennungsFlow)** ausgeführt werden soll.   
![\[Der Block „VerbindungstrennungsFlow festlegen“, das Dropdownmenü „Flow auswählen“ und die Beispieloption „VerbindungstrennungsFlow“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/set-disconnect-flow.png)

    Ein Beispiel, in dem der Block **Set Disconnect Flow (TrennungsFlow festlegen)** verwendet werden soll, finden Sie unter [Beispiel für den Flow bei eingehenden Anrufen](sample-inbound-flow.md). 

## Wann enden Chats?
<a name="when-do-chats-end"></a>

 Die Gesamtdauer einer Chat-Konversation, einschließlich der Wartezeit, während der der Kunde nicht aktiv ist, darf standardmäßig 25 Stunden nicht überschreiten. Sie können diese Standarddauer jedoch ändern und stattdessen eine benutzerdefinierte Chatdauer konfigurieren. Sie können die maximale Chatdauer auf einen Wert zwischen einer Stunde (60 Minuten) und bis zu 7 Tagen (10.080 Minuten) festlegen. Um eine benutzerdefinierte Chatdauer zu konfigurieren, rufen Sie die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API auf und fügen Sie den `ChatDurationInMinutes` Parameter hinzu. 

Während einer laufenden Chat-Sitzung ist die Häufigkeit, mit der ein Kunde eine bestehende Chat-Sitzung verlassen und wieder beitreten kann, unbegrenzt. Verwenden Sie dazu den Block [Warten](wait.md). Sie können beispielsweise zwölf Stunden als Zeit bis zur Rückkehr des Kunden in den Chat festlegen, bevor die Sitzung beendet wird. Wenn der Kunde versucht, den Chat nach Flow der zwölf Stunden fortzusetzen, können Sie im Flow einen Amazon-Lex-Bot fragen lassen, ob er Sie wegen des gleichen oder eines anderen Problems kontaktiert. 

Indem Sie eine Wartezeit angeben, die deutlich kürzer als die Chatdauer ist, tragen Sie dazu bei, dass die Kunden ein gutes Erlebnis haben. Bei einem Chat mit einer Dauer von 25 Stunden ist es beispielsweise möglich, dass der Kunde den Chat nach 24 Stunden und 58 Minuten wieder aufnimmt und dann nach zwei Minuten unterbrochen wird, weil das Gespräch nach 25 Stunden endet.

**Tipp**  
Wenn Sie Amazon Lex mit Chat nutzen, müssen Sie beachten, dass das Standard-Sitzungszeitlimit für eine Amazon Lex-Sitzung fünf Minuten beträgt. Die Gesamtdauer einer Sitzung darf 24 Stunden nicht überschreiten. Zum Ändern des Sitzungszeitlimits siehe [Festlegen von Sitzungs-Timeouts](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#context-mgmt-session-timeoutg) im *Amazon-Lex-Entwicklerhandbuch*. 

## Preisgestaltung
<a name="web-and-mobile-chat-pricing"></a>

Der Chat wird pro Nutzung abgerechnet. Es sind keine Vorauszahlungen, langfristigen Verpflichtungen oder monatlichen Mindestgebühren erforderlich. Sie zahlen pro Chat-Nachricht, unabhängig von der Anzahl der Kundendienstmitarbeiter oder Kunden, die sie versenden. Regional können abweichende Preise gelten. Weitere Informationen finden Sie unter [Amazon Connect – Preise](https://aws.amazon.com/connect/pricing/). 

## Weitere Informationen
<a name="chat-more-info"></a>

Weitere Informationen zum Chat finden Sie in den folgenden Themen:
+  [Testen von Sprach-, Chat- und Aufgabenerlebnissen in Amazon Connect](chat-testing.md) 
+  [Funktionsweise der Weiterleitung für mehrere Kanäle](about-routing.md#routing-profile-channels-works) 
+  [Erstellen eines Weiterleitungsprofils in Amazon Connect, um Warteschlangen mit Kundendienstmitarbeitern zu verknüpfen](routing-profiles.md) 
+  [Amazon Connect – Chat SDK und Beispielimplementierungen](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/) 

# Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website
<a name="add-chat-to-website"></a>

Um Kunden per Chat zu unterstützen, können Sie einer Website ein von Amazon Connect gehostetes Kommunikations-Widget hinzufügen. Sie können das Kommunikations-Widget auf der Amazon Connect Admin-Website konfigurieren. Sie können die Schriftart und die Farben anpassen und das Widget so sichern, dass es nur von Ihrer Website aus gestartet werden kann. Anschließend erhalten Sie ein kurzes Code-Snippet zur Integration in Ihre Website. 

Da Amazon Connect das Widget hostet, wird sichergestellt, dass die neueste Version immer auf Ihrer Website verfügbar ist. 

**Tipp**  
Die Verwendung des Kommunikations-Widgets unterliegt standardmäßigen Servicekontingenten, wie z. B. der Anzahl der erforderlichen Zeichen für jede Nachricht. Bevor Sie Ihr Kommunikations-Widget in Betrieb nehmen, stellen Sie sicher, dass Ihre Servicekontingente den Anforderungen Ihres Unternehmens entsprechen. Weitere Informationen finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md). 

**Topics**
+ [Unterstützte Widget-Snippet-Felder, die anpassbar sind](supported-snippet-fields.md)
+ [Unterstützte Browser](#chat-widget-supported-browsers)
+ [Schritt 1: Anpassen Ihres Kommunikations-Widgets](#customize-chat-widget)
+ [Schritt 2: Angeben der Website-Domains an, auf denen das Kommunikations-Widget angezeigt werden soll](#chat-widget-domains)
+ [Schritt 3: Bestätigen und Kopieren des Kommunikations-Widget-Codes und der Sicherheitsschlüssel](#confirm-and-copy-chat-widget-script)
+ [Werden Fehlermeldungen angezeigt?](#chat-widget-error-messages)
+ [Anpassen des Startverhaltens und des Schaltflächensymbols für das Widget](customize-widget-launch.md)
+ [Übergeben des Anzeigenamens des Kunden](pass-display-name-chat.md)
+ [Übergeben von Kontaktattributen](pass-contact-attributes-chat.md)
+ [Zusätzliche Anpassungen für Ihr Chat-Widget](pass-customization-object.md)
+ [Herunterladen des Transkripts für Ihr Chat-Widget](chat-widget-download-transcript.md)
+ [Herunterladen und Anpassen des Open-Source-Beispiels](download-chat-example.md)
+ [Starten Sie Chats in Ihren Anwendungen mithilfe von Amazon Connect APIs](integrate-with-startchatcontact-api.md)
+ [Senden von Browser-Benachrichtigungen an Kunden, wenn Chat-Nachrichten eintreffen](browser-notifications-chat.md)
+ [Programmgesteuertes Trennen des Chats](programmatic-chat-disconnect.md)
+ [Übergeben von benutzerdefinierten Eigenschaften zum Überschreiben der Standardeinstellungen im Kommunikations-Widget](pass-custom-styles.md)
+ [Richten Sie Ihre Widget-Schaltfläche und Ihren Widget-Rahmen mit CSS/ JavaScript](target-widget-button.md)
+ [Fehlerbehebung beim Kommunikations-Widget](ts-cw.md)
+ [Hinzufügen eines Vorab-Kontakt- oder Pre-Chat-Formulars](add-precontact-form.md)
+ [Umfrage nach dem Chat](enable-post-chat-survey.md)

# Unterstützte Widget-Snippet-Felder in Amazon Connect, die anpassbar sind
<a name="supported-snippet-fields"></a>

In der folgenden Tabelle werden die Snippet-Felder des Kommunikations-Widgets aufgeführt, die Sie anpassen können. Der Beispielcode hinter der Tabelle zeigt, wie die Code-Snippet-Felder verwendet werden.


| Feld „Snippet“ | Typ | Description | Ergänzende Dokumentation | 
| --- | --- | --- | --- | 
| `snippetId` | Zeichenfolge | Obligatorisch, automatisch generiert | – | 
| `styles` | Zeichenfolge | Obligatorisch, automatisch generiert | – | 
| `supportedMessagingContentTypes` | Array | Obligatorisch, automatisch generiert | – | 
| `customLaunchBehavior` | Objekt | Passen Sie an, wie Ihre Website das gehostete Widget-Symbol rendert und startet | [Anpassen des Startverhaltens und des Schaltflächensymbols für das Widget auf Ihrer Website, die in Amazon Connect gehostet wird](customize-widget-launch.md), weiter unten in diesem Thema | 
| `authenticate` | Funktion | Rückruffunktion zur Aktivierung der JWT-Sicherheit auf Ihrer Website | [Schritt 2: Angeben der Website-Domains an, auf denen das Kommunikations-Widget angezeigt werden soll](add-chat-to-website.md#chat-widget-domains), weiter oben in diesem Abschnitt. | 
| `customerDisplayName` | Funktion | Übergeben des Anzeigenamens des Kunden bei der Initialisierung eines Kontakts | [Übergeben des Anzeigenamens des Kunden beim Start eines Amazon-Connect-Chats](pass-display-name-chat.md), weiter unten in diesem Abschnitt. | 
| `customStyles` | Objekt | Überschreiben der Standard-CSS-Stile | [Übergeben von benutzerdefinierten Eigenschaften zum Überschreiben der Standardeinstellungen im Kommunikations-Widget in Amazon Connect](pass-custom-styles.md), weiter unten in diesem Abschnitt. | 
| `chatDurationInMinutes` | Zahl | Die Gesamtdauer der neu gestarteten Chat-Sitzung | Standard: 1500 - Min. 60, Max.: 10080 | 
| `enableLogs` | Boolesch | Aktivieren der Debugging-Protokolle | Standard: false | 
| `language` | Zeichenfolge |  Amazon Connect kann Übersetzungen für unterstützte Sprachcodes im ISO-639-Format durchführen. Weitere Informationen finden Sie unter [https://en.wikipedia. org/wiki/List\$1der\$1ISO\$1639-1\$1Codes.](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) Dadurch würden benutzerdefinierte Textüberschreibungen und Nachrichteninhalte (sowohl gesendet als auch empfangen) nicht übersetzt.  | Standard: en\$1US. Unterstützt werden: „cs\$1CZ“, „da\$1DK“, „de\$1DE“, „en\$1AU“, „en\$1CA“, „en\$1GB“, „en\$1US“, „es\$1ES“, „fi\$1FI“, „fr\$1FR“, „hu\$1HU“, „id\$1ID“, „it\$1IT“, „ja\$1JP“, „ko\$1KR“, „nl\$1NL“, „nn\$1NO“ „pt\$1BR“, „pt\$1PT“, „sk\$1SK“, „sv\$1SE“, „zh\$1CN“, „zh\$1TW“ | 
| `disableCSM` | Boolesch | Deaktivieren Sie das Tracking der clientseitigen Metriken über das Kommunikations-Widget. | Standard: false | 
| `nonce` | Zeichenfolge | Handshake-Wert zwischen iframe und CSP-Richtlinie für die Kundenwebsite. Beispiel: Kunden-CSP erlaubt den Nonce-Wert 1234. Ein iframe, der ein anderes Skript abruft, muss denselben 1234-Nonce-Wert haben, damit der Browser weiß, dass es sich um ein vertrauenswürdiges Skript der übergeordneten iframe-Website handelt. | Standard: undefiniert | 
| `customizationObject` | Objekt | Anpassen des Layouts und des Transkripts des Widgets | Weitere Informationen finden Sie unter [Zusätzliche Anpassungen für Ihr Chat-Widget von Amazon Connect](pass-customization-object.md), weiter unten in diesem Abschnitt. | 
| `contactAttributes` | Objekt | Übergeben von Attributen direkt aus dem Codeausschnitt an den Kontaktablauf, ohne dass eine JWT-Einrichtung erforderlich ist | Weitere Informationen finden Sie unter [Übergeben von Kontaktattributen, wenn ein Chat initialisiert wird](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html). | 
| `customDisplayNames` | Objekt | Überschreiben Sie die Einstellungen für den Anzeigenamen und das Logo des Systems oder des Bots, die auf der Admin-Website von Amazon Connect festgelegt wurden. | Weitere Informationen finden Sie unter [So übergeben Sie das Überschreiben von System- und Bot-Anzeigenamen und Logos für das Kommunikations-Widget](https://docs.aws.amazon.com/connect/latest/adminguide/pass-custom-styles.html#pass-override-system). | 
| `contactMetadataHandler` | Funktion | Rückruffunktion für den Zugriff auf contactId Fügen Sie beispielsweise einen Event-Listener hinzu, um Szenarien wie das Aufrufen der StopContact Funktion mit der contactId zu behandeln, wenn der Browser-Tab geschlossen ist, oder die Aufrechterhaltung der Chat-Persistenz mit einer vorherigen contactId.  |  | 
| `registerCallback` | Objekt | Auf diese Weise können Rückrufe für die exponierten Lebenszyklusereignisse ausgeführt werden.  Weitere Informationen finden Sie unter [amazon-connect-chatjs](https://github.com/amazon-connect/amazon-connect-chatjs).  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/supported-snippet-fields.html) | 
| `initialMessage` | Zeichenfolge | Nachricht, die an den neu erstellten Chat gesendet werden soll. Längenbeschränkungen: Minimum 1, Maximum 1 024. | Wenn Sie den im Kontaktablauf konfigurierten Lex-Bot mit einer ersten Nachricht aufrufen möchten, ändern Sie den Flow-Block [Kundeneingabe abrufen](get-customer-input.md), indem Sie die Option **Bot mit Nachricht initialisieren** auswählen. Weitere Informationen finden Sie unter [So konfigurieren Sie den Flow-Block „Kundeneingabe abrufen“](get-customer-input.md#get-customer-input-properties). | 
| `authenticationParameters` | Objekt | Dadurch wird der Flow-Block [Kundenauthentifizierung](authenticate-customer.md) aktiviert | Weitere Informationen finden Sie unter [Aktivieren der Kundenauthentifizierung](enable-connect-managed-auth.md). | 
| `mockLexBotTyping` | Boolesch | Aktivieren Sie die Anzeige für Mocking-Tippen für Lex-Bot-Nachrichten. | Standard: false | 
| `customStartChat` | Funktion | Rückruffunktion zum Aufrufen der Start-Chat-API von Ihrem Backend aus. | Weitere Informationen finden Sie unter [Benutzeroberfläche für gehostete Widgets mit benutzerdefinierter Start-Chat-API](https://github.com/amazon-connect/amazon-connect-chat-interface#option-3-hosted-widget-ui-with-custom-start-chat-api).  | 

Das folgende Beispiel zeigt, wie Sie dem HTML-Skript, das das Chat-Widget zu Ihrer Website hinzufügt, Snippet-Felder hinzufügen.

```
(function(w, d, x, id) {   /* ... */})(window, document, 
'amazon_connect', 'widgetId');
 amazon_connect('snippetId', 'snippetId');
 amazon_connect('styles', /* ... */);
 amazon_connect('registerCallback', {
    // Custom event example
    // WIDGET_FRAME_CLOSED
    /**
     * This event is triggered when user clicks on the chat widget close button, 
     * either widget close button was clicked when error in the chat session or normally by the user. 
     * This event can be used for webview use cases to go back to main app
     * 
     * @param {string} status - The reason for widget closure
     *   - "error_chat": Indicates the user clicked on widget close button due to an error in the chat session
     *   - "close_chat": Indicates the user clicked on widget close button normally by the user
     */
    'WIDGET_FRAME_CLOSED': (eventName, { status }) => {
        // You can implement custom logic based on the status value(error_chat or close_chat)
        if (status == "error_chat") {
            // handle error chat
        } else if (status == "close_chat") {
            // handle close chat  
        } 
    },
    // System event example
    /**
     * chatDetails: { 
     *     contactId: string, 
     *     participantId: string,
     *     participantToken: string,
     * }
     * data: {
     *     AbsoluteTime?: string,
     *     ContentType?: string,
     *     Type?: string,
     *     ParticipantId?: string,
     *     DisplayName?: string,
     *     ParticipantRole?: string,
     *     InitialContactId?: string
     * }
     */
    'PARTICIPANT_JOINED': (eventName, { chatDetails, data }) => {
        alert(`${data.ParticipantRole} joined the chat.`);
    },
    'event_Name_3': callback(function),
    'event_Name_4': callback(function),
    // ...
}); 
amazon_connect('initialMessage', 'Your initial message string');
// ... 
amazon_connect('snippetFieldHere', /* ... */);
<script/>
```

## Unterstützte Browser
<a name="chat-widget-supported-browsers"></a>

Das vorgefertigte Kommunikations-Widget unterstützt die folgenden (und höhere) Browserversionen: 
+ Google Chrome 85.0
+ Safari 13.1
+ Microsoft Edge Version 85
+ Mozilla Firefox 81.0

Das Kommunikations-Widget unterstützt Browserbenachrichtigungen für Desktop-Geräte. Weitere Informationen finden Sie unter [Senden von Browser-Benachrichtigungen an Kunden, wenn Chat-Nachrichten eintreffen](browser-notifications-chat.md).

## Schritt 1: Anpassen Ihres Kommunikations-Widgets
<a name="customize-chat-widget"></a>

In diesem Schritt passen Sie die Umgebung des Kommunikations-Widgets für Ihre Kunden an.

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*instance name*.my.connect.aws/ an. Wählen Sie **Kommunikations-Widget anpassen**.  
![\[Die Seite mit dem Konfigurationsleitfaden, der Link zum Anpassen des Kommunikations-Widgets.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-customize-chat-window-button.png)

1. Wählen Sie auf der Seite **Kommunikations-Widgets** die Option **Kommunikations-Widget hinzufügen** aus, um mit der Anpassung eines neuen Kommunikations-Widgets zu beginnen. Um ein vorhandenes Kommunikations-Widget zu bearbeiten, zu löschen oder zu duplizieren, wählen Sie aus den Optionen in der Spalte **Aktionen**, wie in der folgenden Abbildung gezeigt.   
![\[Klicken Sie auf der Seite „Kommunikations-Widgets“ auf die Schaltfläche „Kommunikations-Widget hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-add-chat-widget.png)

1. Geben Sie einen **Namen** und eine **Beschreibung** für das Kommunikations-Widget ein. 
**Anmerkung**  
Der Name muss für jedes Kommunikations-Widget, das in einer Amazon-Connect-Instance erstellt wurde, eindeutig sein. 

1. Legen Sie im Abschnitt **Kommunikationsoptionen** fest, wie Ihre Kunden mit Ihrem Widget interagieren können und wählen Sie dann **Speichern und weiter**.
**Anmerkung**  
Sie können ein Vorab-Kontaktformular für Aufgaben oder E-Mails nur aktivieren, wenn Chat und Sprachnachricht nicht aktiviert sind.

   In der folgenden Abbildung sind Optionen zu sehen, mit denen der Chat- und Nachrichtenempfang ermöglicht und ein Vorab-Chat-Formular für Kunden erstellt werden kann. Zum Aktivieren eines Vorab-Chat-Formulars müssen Sie zunächst eine [Ansicht](view-resources-sg.md) mit einer Schaltfläche für Verbindungsaktionen erstellen und die Aktion `StartChatContact` auswählen. Weitere Informationen zu Vorab-Chat- und Vorab-Kontaktformularen finden Sie unter [Hinzufügen des Amazon-Connect-Widgets zu Ihrer Website](connect-widget-on-website.md).  
![\[Die Seite „Kommunikations-Widget“, für Chat- und Webanrufe konfiguriert\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/comm-widget-page-chat.png)

1. Wählen Sie auf der Seite **Kommunikations-Widget erstellen** die Stile für die Widget-Schaltflächen sowie die Anzeigenamen und -stile aus.

   Bei der Auswahl dieser Optionen wird die Widget-Vorschau automatisch aktualisiert. Sie können also sehen, wie die Umgebung für die Kunden aussehen wird.  
![\[Die Vorschau des Kommunikations-Widgets.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/netra-chat-preview.png)

**Schaltflächenstile**

1. Wählen Sie die Farben für den Schaltflächenhintergrund aus. Geben Sie dazu Hexadezimalwerte ([HTML-Farbcodes](https://htmlcolorcodes.com/)) ein.

1. Wählen Sie **Weiß** oder **Schwarz** als Symbolfarbe aus. Die Farbe des Symbols kann nicht angepasst werden.

**Widget-Header**

1. Geben Sie Werte für Header-Nachricht und Farbe sowie für die Hintergrundfarbe des Widgets an. 

1. **Logo-URL**: Fügen Sie eine URL zu Ihrem Logo-Banner aus einem Amazon-S3-Bucket oder einer anderen Online-Quelle ein.
**Anmerkung**  
In der Vorschau des Kommunikations-Widgets auf der Anpassungsseite wird das Logo nicht angezeigt, wenn es aus einer anderen Online-Quelle als einem Amazon-S3-Bucket stammt. Das Logo wird jedoch angezeigt, wenn das benutzerdefinierte Kommunikations-Widget auf Ihrer Seite implementiert wird.

   Das Banner muss im .svg-, .jpg- oder .png-Format vorliegen. Das Bild kann 280 Pixel (Breite) mal 60 Pixel (Höhe) groß sein. Jedes Bild, das größer als diese Abmessungen ist, wird so skaliert, dass es in den Komponentenbereich des Logos von 280×60 passt.

   1. Anweisungen zum Hochladen einer Datei wie eines Logobanners auf S3 finden Sie unter [Hochladen von Objekten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) im *Benutzerhandbuch zu Amazon Simple Storage Service*.

   1. Vergewissern Sie sich, dass die Bildberechtigungen richtig eingestellt sind, sodass das Kommunikations-Widget über Berechtigungen für den Zugriff auf das Bild verfügt. Informationen dazu, wie Sie ein S3-Objekt öffentlich zugänglich machen, finden Sie unter [Schritt 2: Hinzufügen einer Bucket-Richtlinie](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteAccessPermissionsReqd.html#bucket-policy-static-site) im Thema *Berechtigungen für den Zugriff auf Websites einrichten*.

**Chat-Ansicht**

1.  **Schriftart**: Verwenden das Dropdown-Menü, um die Schriftart für den Text im Kommunikations-Widget auszuwählen.

1. 
   + **Anzeigename für Systemnachrichten**: Geben Sie einen neuen Anzeigenamen ein, um den Standardwert zu überschreiben. Die Standardeinstellung ist **SYSTEM\$1MESSAGE**.
   + **Anzeigename der Bot-Nachricht**: Geben Sie einen neuen Anzeigenamen ein, um den Standardwert zu überschreiben. Der Standardwert ist **BOT**.
   + **Platzhalter für Texteingabe**: Geben Sie einen neuen Platzhaltertext ein und überschreiben Sie so den Standardwert. Der Standardwert ist **Type a message**. 
   + **Text der Schaltfläche „Chat beenden“**: Geben Sie neuen Text ein, um den Standardtext zu ersetzen. Der Standardwert ist **Chat beenden**.

1. **Farbe der Chat-Blase für Kundendienstmitarbeiter**: Wählen Sie die Farben für die Nachrichtenblasen des Kundendienstmitarbeiters aus, indem Sie Hexadezimalwerte ([HTML-Farbcodes](https://htmlcolorcodes.com/)) eingeben.

1. **Farbe der Chat-Blase für Kunden**: Wählen Sie die Farben für die Nachrichtenblasen des Kunden, indem Sie Hexadezimalwerte ([HTML-Farbcodes](https://htmlcolorcodes.com/)) eingeben. 

1. Wählen Sie **Save and continue** aus.

## Schritt 2: Angeben der Website-Domains an, auf denen das Kommunikations-Widget angezeigt werden soll
<a name="chat-widget-domains"></a>

1. Geben Sie die Website-Domains ein, in denen Sie das Kommunikations-Widget platzieren möchten. Der Chat wird nur auf Websites geladen, die Sie in diesem Schritt auswählen. 

   Wählen Sie **Domain hinzufügen** aus, um bis zu 50 Domains hinzuzufügen.  
![\[Die Option „Domain hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-add-domain.png)

   Verhalten der Zulassungsliste für Domains:
   + Subdomains sind automatisch enthalten. Wenn Sie beispielsweise example.com zulassen, sind auch alle zugehörigen Subdomains (wie sub.example.com) zulässig.
   + Das Protokoll http:// oder https:// muss exakt mit Ihrer Konfiguration übereinstimmen. Geben Sie das genaue Protokoll an, wenn Sie zulässige Domains einrichten.
   + Alle URL-Pfade sind automatisch zulässig. Wenn beispielsweise example.com zulässig ist, werden alle Seiten darunter (z. B. example) zugelassen. com/cart or example.com/checkout) sind zugänglich. Sie können bestimmte Unterverzeichnisse nicht zulassen oder blockieren.
**Wichtig**  
Vergewissern Sie sich, dass Ihre Website URLs gültig ist und keine Fehler enthält. Geben Sie die vollständige URL beginnend mit https:// an.
Wir empfehlen die Verwendung von https:// für Ihre Produktionswebsites und -anwendungen.

1. Wir empfehlen, unter „**Sicherheit für Ihr Kommunikations-Widget hinzufügen**“ **Ja** auszuwählen und gemeinsam mit Ihrem Website-Administrator Ihre Webserver so einzurichten, dass sie JSON-Web-Tokens (JWTs) für neue Chat-Anfragen ausgeben. Dies bietet Ihnen mehr Kontrolle beim Initiieren neuer Chats, einschließlich einer Überprüfungsmöglichkeit, ob an Amazon Connect gesendete Chat-Anfragen von authentifizierten Benutzern stammen.  
![\[Die Aktivierung der Sicherheit für neue Kommunikations-Widget-Anfragen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-choose-security.png)

   Wenn Sie **Ja** auswählen, passiert Folgendes:
   + Amazon Connect stellt auf der nächsten Seite einen 44-stelligen Sicherheitsschlüssel bereit, mit dem Sie JSON-Web-Tokens (JWTs) erstellen können.
   + Amazon Connect fügt dem Einbettungsskript für das Kommunikations-Widget eine Callback-Funktion hinzu, die nach einem JWT (JSON Web Token) sucht, wenn ein Chat initiiert wird.

     Sie müssen die Callback-Funktion im Einbettungscode implementieren, wie im folgenden Beispiel gezeigt.

     ```
     amazon_connect('authenticate', function(callback) {
       window.fetch('/token').then(res => {
         res.json().then(data => {
           callback(data.data);
         });
       });
     });
     ```

   Wenn Sie diese Option wählen, erhalten Sie im nächsten Schritt einen Sicherheitsschlüssel für alle Chat-Anfragen, die auf Ihren Websites initiiert wurden. Bitten Sie Ihren Website-Administrator, Ihre Webserver so einzurichten, dass sie JWTs mit diesem Sicherheitsschlüssel ausgeben. 

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

## Schritt 3: Bestätigen und Kopieren des Kommunikations-Widget-Codes und der Sicherheitsschlüssel
<a name="confirm-and-copy-chat-widget-script"></a>

In diesem Schritt bestätigen Sie Ihre Auswahl, kopieren den Code für das Kommunikations-Widget und betten ihn in Ihre Website ein. Wenn Sie sich JWTs in [Schritt 2](#chat-widget-domains) für die Verwendung entschieden haben, können Sie auch die geheimen Schlüssel kopieren, um sie zu erstellen. 

### Sicherheitsschlüssel
<a name="chat-widget-security-key"></a>

Verwenden Sie diesen 44-stelligen Sicherheitsschlüssel, um JSON-Webtoken von Ihrem Webserver aus zu generieren. Sie können Schlüssel auch aktualisieren oder rotieren, wenn Sie sie ändern müssen. Wenn Sie dies tun, stellt Ihnen Amazon Connect einen neuen Schlüssel zur Verfügung und behält den vorherigen Schlüssel bei, bis Sie ihn ersetzen können. Nachdem Sie den neuen Schlüssel bereitgestellt haben, können Sie zu Amazon Connect zurückkehren und den vorherigen Schlüssel löschen.

![\[Der von Amazon Connect bereitgestellte Sicherheitsschlüssel.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-security-key.png)


Wenn Kunden mit dem Chat-Start-Symbol auf Ihrer Website interagieren, fordert das Chat-Widget vom Webserver ein JWT an. Wenn dieses JWT bereitgestellt wird, nimmt das Widget es als Teil der Chat-Anfrage des Endkunden an Amazon Connect auf. Amazon Connect verwendet dann den geheimen Schlüssel, um das Token zu entschlüsseln. Bei Erfolg wird bestätigt, dass das JWT von Ihrem Webserver ausgestellt wurde, und Amazon Connect leitet die Chat-Anfrage an Ihre Kundendienstmitarbeiter im Contact Center weiter.

#### Einzelheiten zum JSON-Web-Token
<a name="jwt"></a>
+ Algorithmus: **HS256**
+ Claims:
  + **Sub**: *widgetId*

    Ersetzen Sie `widgetId` durch Ihre eigene WidgetID. Um Ihre widgetId zu finden, sehen Sie sich das Beispiel-[Skript für das Kommunikations-Widget](#chat-widget-script) an.
  + **iat**: \$1Ausgabezeitpunkt.
  + **exp**: \$1Flow (maximal 10 Minuten).
  + **segmentAttributes (optional)**: ein Satz von systemdefinierten Schlüssel-Wert-Paaren, die mithilfe einer Attributzuordnung in einzelnen Kontaktsegmenten gespeichert werden. Weitere Informationen finden Sie SegmentAttributes in der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-SegmentAttributes)API.
  + **Attribute (optional)**: Objekt mit string-to-string Schlüssel-Wert-Paaren. Die Kontaktattribute müssen den von der API festgelegten Einschränkungen entsprechen. [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes)
  + **relatedContactId (optional)**: Zeichenfolge mit gültiger Kontakt-ID. Sie relatedContactId müssen die von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API festgelegten Einschränkungen einhalten.
  + **customerId (optional)**: Dies kann entweder eine ID von Amazon Connect Customer Profiles oder eine benutzerdefinierte Kennung aus einem externen System, z. B. einem CRM, sein. 

  \$1Informationen zum Datumsformat finden Sie im folgenden Dokument der Internet Engineering Task Force (IETF): [JSON Web Token (JWT)](https://tools.ietf.org/html/rfc7519), Seite 5. 

Der folgende Codeblock zeigt ein Beispiel für die Generierung eines JWT in Python:

```
import jwt 
import datetime 
CONNECT_SECRET = "your-securely-stored-jwt-secret" 
WIDGET_ID = "widget-id" 
JWT_EXP_DELTA_SECONDS = 500

payload = { 
'sub': WIDGET_ID, 
'iat': datetime.datetime.utcnow(), 
'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 
'customerId': "your-customer-id",
'relatedContactId':'your-relatedContactId',                    
'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } 
header = { 'typ': "JWT", 'alg': 'HS256' } 
encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
```

### Skript für das Kommunikations-Widget
<a name="chat-widget-script"></a>

Die folgende Abbildung zeigt ein Beispiel für das JavaScript , das Sie auf Websites einbetten, auf denen Kunden mit Agenten chatten sollen. Dieses Skript zeigt das Widget in der unteren rechten Ecke Ihrer Website an. 

![\[Das Skript für das Kommunikations-Widget\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-code.png)


Wenn Ihre Website geladen wird, sehen Kunden zuerst das Symbol **Start**. Wenn sie dieses Symbol wählen, wird das Kommunikations-Widget geöffnet und sie können eine Nachricht an einen Kundendienstmitarbeiter senden.

Sie können jederzeit Änderungen am Kommunikations-Widget über **Bearbeiten** vornehmen.

**Anmerkung**  
Gespeicherte Änderungen aktualisieren die Kundenumgebung in wenigen Minuten. Überprüfen Sie Ihre Widget-Konfiguration, bevor Sie sie speichern. 

![\[Der Link zum Bearbeiten in der Widget-Vorschau.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-edit.png)


Damit Änderungen an Widget-Symbolen auf der Website wirksam werden, müssen Sie Ihre Website direkt mit einem neuen Codeblock aktualisieren.

## Werden Fehlermeldungen angezeigt?
<a name="chat-widget-error-messages"></a>

Wenn Fehlermeldungen auftreten, finden Sie weitere Informationen unter [Fehlerbehebung beim Kommunikations-Widget von Amazon Connect](ts-cw.md).

# Anpassen des Startverhaltens und des Schaltflächensymbols für das Widget auf Ihrer Website, die in Amazon Connect gehostet wird
<a name="customize-widget-launch"></a>

Sie können die Darstellung und das Starten des Symbols für das gehostete Widget auf Ihrer Website weiter anpassen, das Startverhalten konfigurieren und das Standardsymbol ausblenden. Beispielsweise können Sie das Widget programmgesteuert über ein Schaltflächenelement mit der Bezeichnung „**Chatten Sie mit uns**“ starten, das auf Ihrer Website dargestellt wird.

**Topics**
+ [So konfigurieren Sie das benutzerdefinierte Startverhalten des Widgets](#config-widget-launch)
+ [Unterstützte Optionen und Beschränkungen](#launch-options-constraints)
+ [Konfigurieren des Widget-Starts für benutzerdefinierte Anwendungsfälle](#launch-usage)
+ [Aktivieren der Persistenz von Chat-Sitzungen auf allen Registerkarten](#chat-persistence-across-tabs)

## So konfigurieren Sie das benutzerdefinierte Startverhalten des Widgets
<a name="config-widget-launch"></a>

Verwenden Sie den folgenden Beispielcodeblock, um ein benutzerdefiniertes Startverhalten festzulegen, und betten Sie ihn in das Widget ein. Alle im folgenden Beispiel gezeigten Felder sind optional und es können beliebige Kombinationen verwendet werden.

```
amazon_connect('customLaunchBehavior', {
    skipIconButtonAndAutoLaunch: true,
    alwaysHideWidgetButton: true,
    programmaticLaunch: (function(launchCallback) {
        var launchWidgetBtn = document.getElementById('launch-widget-btn');
        if (launchWidgetBtn) {
            launchWidgetBtn.addEventListener('click', launchCallback);
            window.onunload = function() {
            launchWidgetBtn.removeEventListener('click', launchCallback);
            return;
            }
        }
    })
});
```

## Unterstützte Optionen und Beschränkungen
<a name="launch-options-constraints"></a>

In der folgenden Tabelle sind die unterstützten Optionen für ein benutzerdefiniertes Startverhalten aufgeführt. Die Felder sind optional und eine beliebige Kombination kann verwendet werden.


| Optionsname | Typ | Description | Standardwert | 
| --- | --- | --- | --- | 
|  `skipIconButtonAndAutoLaunch`  | Boolesch  | Eine Markierung für enable/disable den automatischen Start des Widgets, ohne dass der Benutzer auf die Seite klickt, lädt. | Nicht definiert | 
|  `alwaysHideWidgetButton`  | Boolesch  | Eine Markierung für enable/disable das Rendern der Widget-Symbolschaltfläche (sofern nicht gerade eine Chat-Sitzung läuft). | Nicht definiert | 
|  `programmaticLaunch`  | Funktion  |  | Nicht definiert | 

## Konfigurieren des Widget-Starts für benutzerdefinierte Anwendungsfälle
<a name="launch-usage"></a>

### Startschaltfläche für benutzerdefinierte Widgets
<a name="custom-launch-button"></a>

Das folgende Beispiel zeigt die am Widget vorzunehmenden Änderungen, um den programmgesteuerten Start so zu konfigurieren, dass das Widget nur geöffnet wird, wenn der Benutzer ein bestimmtes Schaltflächenelement an einer beliebigen Stelle auf Ihrer Website auswählt. Beispielsweise können sie eine Schaltfläche mit dem Namen **„Kontaktieren Sie uns“ oder ** **„Chatten Sie mit uns**“ verwenden. Optional können Sie das standardmäßige Widget-Symbol von Amazon Connect ausblenden, bis das Widget geöffnet wurde.

```
<button id="launch-widget-btn">Chat With Us</button>
```

```
<script type="text/javascript">
 (function(w, d, x, id){
    s=d.createElement("script");
    s.src="./amazon-connect-chat-interface-client.js"
    s.async=1;
    s.id=id;
    d.getElementsByTagName("head")[0].appendChild(s);
    w[x] =  w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) };
  })(window, document, 'amazon_connect', 'asfd-asdf-asfd-asdf-asdf');
  amazon_connect('styles', { openChat: { color: '#000', backgroundColor: '#3498fe'}, closeChat: { color: '#fff', backgroundColor: '#123456'} });
  amazon_connect('snippetId', "QVFJREFsdafsdfsadfsdafasdfasdfsdafasdfz0=")
  amazon_connect('customLaunchBehavior', {
        skipIconButtonAndAutoLaunch: true,
        alwaysHideWidgetButton: true,
        programmaticLaunch: (function(launchCallback) {
            var launchWidgetBtn = document.getElementById('launch-widget-btn');
            if (launchWidgetBtn) {
                launchWidgetBtn.addEventListener('click', launchCallback);
                window.onunload = function() {
                launchWidgetBtn.removeEventListener('click', launchCallback);
                return;
                }
            }
        }),
    });
</script>
```

### Hyperlink-Unterstützung
<a name="hyperlink-support"></a>

Das folgende Beispiel zeigt die erforderlichen Änderungen am `auto-launch` der Widget-Konfiguration, damit das Widget geöffnet wird, bevor ein Benutzer darauf klickt. Sie können es auf einer Seite Ihrer Website bereitstellen und so einen gemeinsam nutzbaren Hyperlink erstellen.

```
https://example.com/contact-us?autoLaunchMyWidget=true
```

```
<script type="text/javascript">
 (function(w, d, x, id){
    s=d.createElement("script");
    s.src="./amazon-connect-chat-interface-client.js"
    s.async=1;
    s.id=id;
    d.getElementsByTagName("head")[0].appendChild(s);
    w[x] =  w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) };
  })(window, document, 'amazon_connect', 'asfd-asdf-asfd-asdf-asdf');
  amazon_connect('styles', { openChat: { color: '#000', backgroundColor: '#3498fe'}, closeChat: { color: '#fff', backgroundColor: '#123456'} });
  amazon_connect('snippetId', "QVFJREFsdafsdfsadfsdafasdfasdfsdafasdfz0=")
  amazon_connect('customLaunchBehavior', {
        skipIconButtonAndAutoLaunch: true
    });
</script>
```

### Laden von Widget-Assets, wenn auf die Schaltfläche geklickt wird
<a name="load-assets"></a>

Das folgende Beispiel zeigt die erforderlichen Änderungen am Widget, damit die Seite Ihrer Website schneller geladen wird. Dazu werden statische Elemente des Widgets abgerufen, wenn ein Benutzer auf die Schaltfläche **Chatten Sie mit uns** klickt. In der Regel öffnet nur ein kleiner Prozentsatz der Kunden, die eine **Kontaktseite** besuchen, das Amazon-Connect-Widget. Das Widget könnte die Latenz beim Laden der Seite erhöhen, indem es Dateien vom CDN abruft, obwohl Kunden das Widget nie öffnen.

Eine alternative Lösung besteht darin, den Codeblock asynchron (oder nie) beim Klicken auf die Schaltfläche auszuführen. 

```
<button id="launch-widget-btn">Chat With Us</button>
```

```
var buttonElem = document.getElementById('launch-widget-btn');

buttonElem.addEventListener('click', function() {
    (function(w, d, x, id){
        s=d.createElement("script");
        s.src="./amazon-connect-chat-interface-client.js"
        s.async=1;
        s.id=id;
        d.getElementsByTagName("head")[0].appendChild(s);
        w[x] =  w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) };
    })(window, document, 'amazon_connect', 'asfd-asdf-asfd-asdf-asdf');
    amazon_connect('styles', { openChat: { color: '#000', backgroundColor: '#3498fe'}, closeChat: { color: '#fff', backgroundColor: '#123456'} });
    amazon_connect('snippetId', "QVFJREFsdafsdfsadfsdafasdfasdfsdafasdfz0=")
    amazon_connect('customLaunchBehavior', {
        skipIconButtonAndAutoLaunch: true
    });
});
```

### Starten eines neuen Chats in einem Browserfenster
<a name="new-chat-browser-window"></a>

Das folgende Beispiel zeigt die erforderlichen Änderungen am Widget, um ein neues Browserfenster zu öffnen und den Chat automatisch im Vollbildmodus zu starten.

```
<button id="openChatWindowButton">Launch a Chat</button>
```

```
<script> // Function to open a new browser window with specified URL and dimensions
    function openNewWindow() {
        var url = 'https://mycompany.com/support?autoLaunchChat=true';

        // Define the width and height
        var width = 300;
        var height = 540;

        // Calculate the left and top position to center the window
        var left = (window.innerWidth - width) / 2;
        var top = (window.innerHeight - height) / 2;

        // Open the new window with the specified URL, dimensions, and position
        var newWindow = window.open(url, '', 'width=${width}, height=${height}, left=${left}, top=${top}');
    }

    // Attach a click event listener to the button
    document.getElementById('openChatWindowButton').addEventListener('click', openNewWindow);
</script>
```

## Aktivieren der Persistenz von Chat-Sitzungen auf allen Registerkarten
<a name="chat-persistence-across-tabs"></a>

Wenn ein Chat auf einer Registerkarte geöffnet wird und der Benutzer dann eine neue Registerkarte öffnet und einen weiteren Chat startet, wird standardmäßig ein neuer Chat gestartet, anstatt eine Verbindung zum vorhandenen Chat herzustellen. Sie können die Chat-Sitzungspersistenz auf allen Registerkarten aktivieren, wenn Sie möchten, dass der Benutzer eine Verbindung mit dem vorhandenen Chat herstellt, der auf der ersten Registerkarte gestartet wurde. 

Die Chat-Sitzung wird im Sitzungsspeicher des Browsers in der Variablen `persistedChatSession` gespeichert. Sie müssen diesen Wert in den Sitzungsspeicher der neuen Registerkarte kopieren, wenn das Widget zum ersten Mal initialisiert wird. Folgen Sie den Anweisungen.

Wenn eine Verbindung mit derselben Chat-Sitzung hergestellt werden soll, wenn der Benutzer zu verschiedenen Subdomains navigiert, können Sie die Domaineigenschaft des Cookies festlegen. Sie besitzen beispielsweise zwei Subdomains: `domain1.example.com` und `domain2.example.com`. Sie können die Eigenschaft `domain=.example.com` hinzufügen, sodass von allen Subdomains aus auf das Cookie zugegriffen werden kann.

1. Kopieren Sie den folgenden Code neben den anderen amazon\$1connect-Funktionen im gehosteten Widget-Snippet. Dabei werden die `registerCallback`-Event-Handler verwendet, um die `persistedChatSession` als Cookie zu speichern, sodass auf der neuen Registerkarte darauf zugegriffen werden kann. Außerdem wird das Cookie bereinigt, wenn der Chat endet.

   

   ```
   amazon_connect('registerCallback', {
   'CONNECTION_ESTABLISHED': (eventName, { chatDetails, data }) => {
    document.cookie = `activeChat=${sessionStorage.getItem("persistedChatSession")}; SameSite=None; Secure`;
   }, 
   'CHAT_ENDED': () => {
     document.cookie = "activeChat=; SameSite=None; Secure";
   }
   });
   ```

1. Rufen Sie den Cookie-Wert ab, falls er vorhanden ist, und legen Sie den Wert für den Sitzungsspeicher auf der neuen Registerkarte fest.

   ```
   const cookie = document.cookie.split('; ').find(c => c.startsWith('activeChat='));
   if (cookie) {
     const activeChatValue = cookie.split('=')[1];
     sessionStorage.setItem('persistedChatSession', activeChatValue);
   }
   
   //Your hosted widget snippet should be on this page
   ```

# Übergeben des Anzeigenamens des Kunden beim Start eines Amazon-Connect-Chats
<a name="pass-display-name-chat"></a>

Um sowohl Kunden als auch Kundendienstmitarbeitern persönlicheren Komfort zu bieten, können Sie das Kommunikations-Widget von Amazon Connect so anpassen, dass es den Anzeigenamen des Kunden bei der Kontaktinitialisierung weitergibt. Der Name ist während der gesamten Chat-Interaktion sowohl für den Kunden als auch für den Kundendienstmitarbeiter sichtbar. Dieser Anzeigename wird im Chat-Protokoll aufgezeichnet.

Die folgenden Bilder zeigen den Anzeigenamen des Kunden in seiner Chat-Umgebung und seinen Namen im CCP des Kundendienstmitarbeiters.

![\[Der Name des Kunden in seiner Chat-Umgebung, der Name des Kunden im CCP des Kundendienstmitarbeiters.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-displayname.png)


1. So kann der Anzeigename des Kunden ihm über die Chat-Benutzeroberfläche angezeigt werden

1. So kann der Anzeigename des Kunden dem Kundendienstmitarbeiter im CCP angezeigt werden

## So übergeben Sie den Anzeigenamen eines Kunden im Kommunikations-Widget
<a name="setup-display-name"></a>

Um einen Kundenanzeigenamen zu übergeben, implementieren Sie Ihre Callbackfunktion im Codeblock. Amazon Connect ruft den Anzeigenamen automatisch ab.

1. Sofern noch nicht geschehen, führen die Schritte unter [Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website](add-chat-to-website.md) aus.

1. Passen Sie den vorhandenen Widget-Code an und fügen Sie einen Callback zum `customerDisplayName` hinzu. Das könnte zum Beispiel so aussehen:

   ```
   amazon_connect('customerDisplayName', function(callback) {
     const displayName = 'Jane Doe';
     callback(displayName);
   });
   ```

   Wichtig ist, dass der Name an `callback(name)` übergeben wird.

## Wichtige Informationen zum Anzeigename des Kunden
<a name="setup-display-name-important-notes"></a>
+ Es kann jeweils nur eine Funktion für den `customerDisplayName` vorhanden sein.
+ Der Anzeigename des Kunden muss den von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-Type-ParticipantDetails-DisplayName)API festgelegten Einschränkungen entsprechen. Das heißt, der Name muss eine Zeichenfolge zwischen 1 und 256 Zeichen sein.
+ Eine leere Zeichenfolge, Null oder undefiniert, ist keine gültige Eingabe für den Anzeigenamen. Um zu verhindern, dass diese Eingaben versehentlich offengelegt werden, protokolliert das Widget den Fehler `Invalid customerDisplayName provided` in der Browserkonsole und startet dann den Chat mit dem Standardanzeigenamen **Kunde**.
+ Da sich der Codeblock im Frontend Ihrer Website befindet, sollten Sie keine vertraulichen Daten als Anzeigenamen übergeben. Beachten Sie unbedingt die entsprechenden Sicherheitsmaßnahmen, um Ihre Daten zu schützen und sich vor Angriffen und böswilligen Akteuren zu schützen.

# Übergeben von Kontaktattributen an einen Kundendienstmitarbeiter im Contact Control Panel (CCP), wenn ein Chat gestartet wird
<a name="pass-contact-attributes-chat"></a>

Sie können [Kontaktattribute](what-is-a-contact-attribute.md) verwenden, um Informationen über den Kontakt zu erfassen, der das Kommunikations-Widget verwendet. Anschließend können Sie diese Informationen dem Kundendienstmitarbeiter über das Contact Control Panel (CCP) anzeigen oder sie an anderer Stelle im Flow verwenden.

Sie können den Flow beispielsweise so anpassen, dass der Name des Kunden in Ihrer Willkommensnachricht erwähnt wird. Oder Sie können für Ihr Unternehmen spezifische Attribute verwenden, z. B. Kundenkennungen wie Namen und E-Mails oder andere Metadaten, die mit einem Kontakt verknüpft sind. account/member IDs

## So übergeben Sie Kontaktattribute an das Kommunikations-Widget
<a name="how-to-contact-attributes-chatwidget"></a>

1. Aktivieren Sie die Sicherheitseinstellungen im Kommunikations-Widget wie unter [Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website](add-chat-to-website.md) beschrieben, falls Sie dies noch nicht getan haben:

   1. Wählen Sie in Schritt 2 unter **Zusätzliche Sicherheit für Ihr Chat-Widget** die Option **Ja** aus.

   1. Verwenden Sie in Schritt 3 den Sicherheitsschlüssel, um JSON-Webtoken zu generieren.

1. Fügen Sie die Kontaktattribute der Payload Ihres JWT als Claim `attributes` hinzu.

   Im Folgenden finden Sie ein Beispiel dafür, wie Sie ein JWT mit Kontaktattributen in Python generieren könnten:
**Anmerkung**  
Voraussetzung ist, dass JWT installiert ist. Führen Sie `pip install PyJWT` in Ihrem Terminal aus, es zu installieren.

   ```
   import jwt 
   import datetime 
   CONNECT_SECRET = "your-securely-stored-jwt-secret" 
   WIDGET_ID = "widget-id" 
   JWT_EXP_DELTA_SECONDS = 500
   
   payload = { 
   'sub': WIDGET_ID, 
   'iat': datetime.datetime.utcnow(), 
   'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 
   'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } 
   header = { 'typ': "JWT", 'alg': 'HS256' } 
   encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
   ```

   In der Payload müssen Sie den Zeichenfolgeschlüssel `attributes` (unverändert, alles in Kleinbuchstaben) mit einem Objekt als Wert erstellen. Dieses Objekt muss string-to-string Schlüssel-Wert-Paare haben. Wenn in einem der Attribute etwas anderes als eine Zeichenfolge übergeben wird, kann der Chat nicht gestartet werden. 

   Die Kontaktattribute müssen den von der API festgelegten Einschränkungen entsprechen: [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes) 
   + Schlüssel müssen eine Mindestlänge von 1 haben
   + Werte können eine Mindestlänge von 0 haben

Optional können Sie die SegmentAttributes-Zeichenfolge zur [SegmentAttributeValue](https://docs.aws.amazon.com/connect/latest/APIReference/API_SegmentAttributeValue.html)Objektübersicht in der Payload hinzufügen. Bei den Attributen handelt es sich um Standardattribute. Amazon Connect Auf sie kann in Abläufen zugegriffen werden. Die Kontaktattribute müssen den von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-SegmentAttributes)API festgelegten Einschränkungen entsprechen.

## Alternative Methode: Übergeben von Kontaktattributen direkt aus dem Codeausschnitt
<a name="pass-attributes-directly"></a>

**Anmerkung**  
Der Ausschnittcode stellt allen Kontaktattributschlüsseln `HostedWidget-` voran, die er übergibt. Im folgenden Beispiel wird dem Kundendienstmitarbeiter das Schlüssel-Wert-Paar `HostedWidget-foo: 'bar'` angezeigt.
Diese Attribute haben zwar den Gültigkeitsbereich des Präfixes `HostedWidget-`, sind aber dennoch clientseitig veränderbar. Verwenden Sie das JWT-Setup, wenn Sie PII oder unveränderliche Daten in Ihrem Ablauf benötigen. 

Das folgende Beispiel zeigt, wie Kontaktattribute direkt aus dem Codeausschnitt übergeben werden, ohne die Widget-Sicherheit zu aktivieren. 

```
<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...

  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>
```

### Verwenden der Attribute in Abläufen
<a name="contact-flow-usage-chat"></a>

Der Ablaufblock [Kontaktattribute prüfen](check-contact-attributes.md) ermöglicht den Zugriff auf diese Attribute mithilfe des Namespace **Benutzerdefiniert**, wie in der folgenden Abbildung dargestellt. Sie können den Ablaufblock verwenden, um Verzweigungslogik hinzuzufügen. Der vollständige Pfad lautet `$.Attributes.HostedWidget-attributeName`.

![\[Die Abbildung zeigt einen Ablaufblock, der zu den Prompts „Gültig“ und „Ungültig“ verzweigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/flow-check-contact-attrib.png)


## Wichtige Hinweise
<a name="contact-attributes-chatwidget-important-notes"></a>
+ Das Kommunikations-Widget hat ein Limit von 6144 Byte für das gesamte codierte Token. Da die UTF-16-Kodierung JavaScript verwendet wird, werden 2 Byte pro Zeichen verwendet, sodass die maximale Größe bei etwa 3000 Zeichen liegen `encoded_token` sollte.
+ Das encoded\$1token muss an `callback(data)` übergeben werden. Der Codeblock `authenticate` benötigt keine zusätzlichen Änderungen. Beispiel:

  ```
  amazon_connect('authenticate', function(callback) {
    window.fetch('/token').then(res => {
      res.json().then(data => {
        callback(data.data);
      });
    });
  });
  ```
+ Die Verwendung eines JWT zur Weitergabe von Kontaktattributen gewährleistet die Integrität der Daten. Wenn Sie das gemeinsame Geheimnis schützen und angemessene Sicherheitsmaßnahmen einhalten, schützen Sie die Daten vor Manipulation durch böswillige Akteure.
+ Kontaktattribute sind im JWT nur kodiert, nicht verschlüsselt, sodass es möglich ist, die Attribute zu dekodieren und zu lesen.
+ Wenn Sie die Chat-Umgebung mit der [simulierten Chat-Umgebung](chat-testing.md#test-chat) testen und Kontaktattribute einbeziehen möchten, müssen Sie sowohl den Schlüssel als auch den Wert in Anführungszeichen setzen, wie in der folgenden Abbildung dargestellt.  
![\[Die Seite mit den Testeinstellungen, ein Kontaktattributsschlüssel in Anführungszeichen, ein Wert in Anführungszeichen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/test-chat-contact-attributes.png)

# Zusätzliche Anpassungen für Ihr Chat-Widget von Amazon Connect
<a name="pass-customization-object"></a>

Sie können die folgenden optionalen Anpassungen zu Ihrer Chat-Benutzeroberfläche hinzufügen:
+ Anzeigen der Schaltfläche **Chat beenden** im Dropdown-Menü in der Kopfzeile statt in der Fußzeile.
+ Maskieren oder Ausblenden von Anzeigenamen.
+ Hinzufügen von Nachrichtensymbolen.
+ Überschreiben Sie Ereignisnachrichten.
+ Konfigurieren Sie ein Bestätigungsdialogfeld, das Kunden angezeigt wird, wenn sie auf die Schaltfläche **Chat beenden** klicken. In diesem Dialogfeld wird bestätigt, dass Kunden beabsichtigen, die Chat-Sitzung tatsächlich zu beenden. Sie können das Bestätigungsdialogfeld, den Titel, die Nachricht und den Schaltflächentext anpassen.
+ Überschreiben Sie die Nachricht zur Ablehnung von Anhängen.

## Konfigurieren des Anpassungsobjekts
<a name="configure-customization-object"></a>

Dieses Beispiel veranschaulicht, wie Sie einige der optionalen Anpassungen implementieren. Eine Liste aller möglichen Anpassungen finden Sie unter [Unterstützte Optionen und Beschränkungen](#customization-options-constraints). Da diese Anpassungen optional sind, können Sie einige oder alle der im folgenden Beispiel gezeigten Felder implementieren. Ersetzen Sie die Zeichenfolgen `eventNames.customer`, `eventNames.agent`, `eventNames.supervisor`, `eventMessages.participantJoined`, `eventMessages.participantDisconnect`, `eventMessages.participantLeft`, `eventMessages.participantIdle`, `eventMessages.participantReturned` und `eventMessages.chatEnded` nach Bedarf. Symbole müssen öffentlich gehostet werden. URLs

```
amazon_connect('customizationObject', {
        header: { 
            dropdown: true, 
            dynamicHeader: true,
        },
        transcript: { 
            hideDisplayNames: false, 
            eventNames: {
                customer: "User",
                agent: "Webchat Agent",
                supervisor: "Webchat Supervisor"
            },
            eventMessages: {
                participantJoined: "{name} has joined the chat",
                participantDisconnect: "",
                participantLeft: "{name} has dropped",
                participantIdle: "{name}, are you still there?",
                participantReturned: "",
                chatEnded: "Chat ended",
            },
            displayIcons: true,
            iconSources: { 
                botMessage: "imageURL",
                systemMessage: "imageURL",
                agentMessage: "imageURL",
                customerMessage: "imageURL",
            },
        },
        composer: {
            disableEmojiPicker: true,
            disableCustomerAttachments: true,
            alwaysHideToolbar: true,
            hide: false,
        },
        footer: {
            disabled:true,
            skipCloseChatButton: true,
        },
        endChat: {
            enableConfirmationDialog: true,
            confirmationDialogText: {
                title: "End Chat",
                message: "Are you sure you want to end this chat?",
                confirmButtonText: "End Chat",
                cancelButtonText: "Cancel",
        },
    },
    attachment: {
         // Default rejectedErrorMessage: Attachment was rejected.
        rejectedErrorMessage: "Custom Error Message: Files cannot exceed 15 MB." //this is customizable attribute 
    }
});
```

Die folgende Abbildung zeigt, wie die Anpassungen aussehen, wenn Sie das Beispiel verwenden:

![\[Das Diagramm zeigt die anpassbaren Anzeigenamen, Menüpositionen, Symbole und das Bestätigungsdialogfeld „Chat beenden“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-customization-diagram2.png)


## Unterstützte Optionen und Beschränkungen
<a name="customization-options-constraints"></a>

In der folgenden Tabelle sind die Namen von unterstützten Anpassungsfeldern und die empfohlenen Beschränkungen der Werte aufgeführt.


| Benutzerdefinierte Layoutoption | Typ | Beschreibung | 
| --- | --- | --- | 
|  `header.dropdown`  |  Boolesch  |  Rendert das Kopfzeilen-Dropdown-Menü anstelle der Standard-Fußzeile  Wenn Sie diese Option auf `true` setzen, wird die Schaltfläche **Transkript herunterladen** angezeigt und bleibt sichtbar, bis Sie die Option auf `false` setzen oder die Option entfernen.   | 
| `header.dynamicHeader` | Boolesch | Setzt den Header-Titel dynamisch auf „Chatten mit Bot/AgentName“. | 
| `header.hideTranscriptDownloadButton` | Boolesch | Blendet die Schaltfläche [Transkript herunterladen](chat-widget-download-transcript.md) im Kopfzeilen-Dropdown-Menü aus Der Standardwert ist false. | 
|  `transcript.hideDisplayNames`  |  Boolesch  |  Blendet alle Anzeigenamen aus und wendet Standardnamenmasken an, falls `eventNames` nicht angegeben ist  | 
|  `transcript.eventNames.customer`  |  Zeichenfolge  |  Maskiert den Anzeigenamen des Kunden  | 
|  `transcript.eventNames.agent`  |  Zeichenfolge  |  Maskiert den Anzeigenamen des Kundendienstmitarbeiters  | 
|  `transcript.eventNames.supervisor`  |  Zeichenfolge  |  Maskiert den Anzeigenamen des Supervisoren  | 
|  ` transcript.eventMessages.participantJoined`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn ein Teilnehmer dem Chat beigetreten ist. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name}` kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet `{name} has joined the chat`.   | 
|  `transcript.eventMessages.participantDisconnect`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn ein Teilnehmer vom Chat getrennt wird. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name}` kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet \$1`name} has been idle too long, disconnecting`.  | 
|  `transcript.eventMessages.participantLeft`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn ein Teilnehmer den Chat verlassen hat. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name}` kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet `{name} has left the chat`.  | 
|  `transcript.eventMessages.participantIdle`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn ein Teilnehmer inaktiv ist. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name}` kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet `{name} has become idle`.  | 
|  `transcript.eventMessages.participantReturned`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn ein Teilnehmer zum Chat zurückgekehrt ist. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name} `kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet `{name} has returned`.  | 
|  `transcript.eventMessages.chatEnded`  |  Zeichenfolge  |  Setzt die Ereignisnachricht im Transkript außer Kraft, wenn der Chat beendet wurde. Wenn eine leere Zeichenfolge angegeben ist, wird die Ereignisnachricht im Transkript weggelassen. `{name}` kann in der Nachricht übergeben werden und wird durch den Anzeigenamen des entsprechenden Teilnehmers ersetzt. Die Standardnachricht lautet `Chat has ended!`.  | 
|  `transcript.displayIcons`  |  Boolesch  |  Aktiviert Symbole für die Nachrichtenanzeige  | 
|  `transcript.iconSources.botMessage`  |  Zeichenfolge  |  Das Symbol, das für Bot-Nachrichten angezeigt wird, muss auf einer öffentlichen URL gehostet werden.  | 
|  `transcript.iconSources.systemMessage`  |  Zeichenfolge  |  Das Symbol, das für Systemnachrichten angezeigt wird, muss auf einer öffentlichen URL gehostet werden.  | 
|  `transcript.iconSources.agentMessage`  |  Zeichenfolge  |  Das Symbol, das für Kundendienstmitarbeiter-Nachrichten angezeigt wird, muss auf einer öffentlichen URL gehostet werden.  | 
|  `transcript.iconSources.customerMessage`  |  Zeichenfolge  |  Das Symbol, das für Kundennachrichten angezeigt wird, muss auf einer öffentlichen URL gehostet werden.  | 
|  `composer.alwaysHideToolbar`  |  Boolesch  |  Blendet die Formatierungssymbolleiste aus, die Textstilfunktionen wie Fett, Kursiv und Optionen für Aufzählungen und nummerierte Listen enthält.  | 
|  `composer.disableEmojiPicker`  |  Boolesch  |  Deaktiviert die Emoji-Auswahl bei Verwendung des [Rich-Text-Editors](enable-text-formatting-chat.md)  | 
| `composer.disableCustomerAttachments` | Boolesch | Hindert Kunden daran, Anhänge zu senden oder hochzuladen | 
| `composer.hide` | Boolesch | Blendet den Komponisten aus (`true`) oder zeigt ihn an (`false`). Verwenden `registerCallback` Sie diese Methode, um den Composer auf der Grundlage von Ereignissen umzuschalten (z. B. wenn ein Agent beitritt). `hideComposer` Weitere Informationen finden Sie unter [Unterstützte Widget-Snippet-Felder in Amazon Connect, die anpassbar sind](supported-snippet-fields.md).<pre>document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatInterface.hideComposer(false)</pre> | 
|  `footer.disabled`  |  Boolesch  |  Blendet die Standard-Fußzeile und die Schaltfläche **Chat beenden** aus  | 
|  `footer.skipCloseChatButton`  |  Boolesch  |  Schließt das Widget direkt, wenn Sie auf die Schaltfläche **Chat beenden** klicken, anstatt die Schaltfläche **Schließen** anzuzeigen  | 
| `endChat.enableConfirmationDialog` | Boolesch | Aktiviert das Bestätigungsdialogfeld „Chat beenden“. Standardtexte werden verwendet, wenn confirmationDialogText nicht angegeben ist. | 
| `endChat.confirmationDialogText.title` | Zeichenfolge | Setzt den Titel des Bestätigungsdialogfelds „Chat beenden“ außer Kraft | 
| `endChat.confirmationDialogText.message` | Zeichenfolge | Setzt die Nachricht des Bestätigungsdialogfelds „Chat beenden“ außer Kraft | 
| `endChat.confirmationDialogText.confirmButtonText` | Zeichenfolge | Setzt den Text der Bestätigungsschaltfläche im Bestätigungsdialogfeld „Chat beenden“ außer Kraft | 
| `endChat.confirmationDialogText.cancelButtonText` | Zeichenfolge | Setzt den Text der Schaltfläche „Abbrechen“ im Bestätigungsdialogfeld „Chat beenden“ außer Kraft | 
| `attachment.rejectedErrorMessage` | Zeichenfolge | Setzt die Fehlermeldung bei der Ablehnung von Anhängen an das Chat-Widget außer Kraft | 

# Herunterladen des Transkripts für Ihr Chat-Widget in Amazon Connect
<a name="chat-widget-download-transcript"></a>

Sie können eine PDF des Transkripts in Ihrem Chat-Widget herunterladen.

**Topics**
+ [Aktivieren des Kopfzeilen-Dropdown-Menüs](#chat-widget-download-transcript-enable-header-dropdown)
+ [Herunterladen des Chat-Transkripts als PDF](#chat-widget-download-transcript-pdf)

## Aktivieren des Kopfzeilen-Dropdown-Menüs
<a name="chat-widget-download-transcript-enable-header-dropdown"></a>

Die Schaltfläche zum Herunterladen des Transkripts befindet sich in einem Dropdown-Menü in der Kopfzeile. Zum Aktivieren des Dropdown-Menüs der Kopfzeile müssen wir das [customizationObject](pass-customization-object.md) unseres Chat-Widgets im Widget-Skript konfigurieren.

```
amazon_connect('customizationObject', {
        header: { 
            dropdown: true, 
        }
});
```

Beachten Sie, dass durch die Aktivierung des Dropdown-Menüs die Fußzeile automatisch deaktiviert wird, da die Funktion **Chat beenden** in das Dropdown-Menü der Kopfzeile verschoben wurde. Wenn Sie die Fußzeile behalten möchten, können Sie diese wie folgt erneut aktivieren:

```
amazon_connect('customizationObject', {
        header: { 
            dropdown: true, 
        },
        footer: {
            disabled: false,
        }
});
```

## Herunterladen des Chat-Transkripts als PDF
<a name="chat-widget-download-transcript-pdf"></a>

Nachdem Sie das Kopfzeilen-Dropdown-Menü aktiviert haben, sollte oben links im Chat-Widget ein Dreipunktmenü angezeigt werden. In diesem Dropdown-Menü sollten Sie eine Schaltfläche zum Herunterladen des **Chat-Transkripts** sehen.

![\[Zeigt die Schaltfläche zum Herunterladen des Chat-Transkripts an\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-widget-download-transcript-pdf-1.png)


Wenn Sie das Symbol zum Herunterladen des **Chat-Transkripts** auswählen, wird ein PDF-Download gestartet. In der PDF-Datei des Chat-Transkripts werden alle Nachrichten, Anzeigenamen, Zeitstempel und Nachrichtenereignisse angezeigt, wie z. B. Teilnehmer, die den Chat verlassen oder ihm beitreten.

![\[Beispiel für ein heruntergeladenes Chat-Transkript\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-widget-download-transcript-pdf-2.png)


# Anpassen des Chats mit dem Open-Source-Beispiel von Amazon Connect
<a name="download-chat-example"></a>

Sie können die Chat-Umgebung, in der Kunden mit Kundendienstmitarbeitern interagieren, weiter anpassen. Verwenden Sie die [Open-Source-Bibliothek von Amazon Connect](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/cloudformationTemplates/asyncCustomerChatUX) auf GitHub. Das ist eine Plattform, die Ihnen den schnellen Einstieg erleichtert. Funktionsweise:
+ Das GitHub Repository ist mit einer CloudFormation Vorlage verknüpft, die den Amazon API Gateway Gateway-Endpunkt startet, der eine Lambda-Funktion initiiert. Sie können diese Vorlage als Beispiel verwenden.
+ Nachdem Sie den AWS CloudFormation Stack erstellt haben, können Sie diese API von Ihrer App aus aufrufen, das vorgefertigte Kommunikations-Widget importieren, die Antwort an das Widget übergeben und mit dem Chatten beginnen. 

Weitere Informationen zum Anpassen der Chat-Umgebung finden Sie unter: 
+ [Amazon Connect Service API-Dokumentation](https://docs.aws.amazon.com/connect/latest/APIReference/welcome.html), insbesondere die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API. 
+  [Participant Service API von Amazon Connect](https://docs.aws.amazon.com/connect-participant/latest/APIReference/Welcome.html). 
+  [Amazon-Connect-Streams](https://github.com/aws/amazon-connect-streams). Verwenden Sie diese, um vorhandene Apps in Amazon Connect zu integrieren. Sie können die Komponenten des CCP (Contact Control Panel) in die App einbetten. 
+ [Amazon Connect – Chat SDK und Beispielimplementierungen](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/) 

# Starten Sie Chats in Ihren Anwendungen mithilfe von Amazon Connect APIs
<a name="integrate-with-startchatcontact-api"></a>

Verwenden Sie die StartChatContact API in Amazon Connect APIs , um Chats in Ihren eigenen Anwendungen zu starten.

Verwenden Sie die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, um einen Chat zu starten.

Wenn Sie die Chat-Umgebung kennenlernen, werden Sie feststellen, dass Chats in der Metrik **Eingehende Kontakte** im Bericht Verlaufsmetriken nicht gezählt werden. Dies liegt daran, dass **API** die Initiierungsmethode für den Chat im Kontaktverlaufsdatensatz ist. 

Das folgende Bild eines Kontaktdatensatzes zeigt die *Initiierungsmethode*, die auf *API* eingestellt ist. 

![\[Ein Kontaktdatensatz, die Initiierungsmethode ist auf API eingestellt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/ctr-api.png)


Nachdem ein Chat an einen Kundendienstmitarbeiter übertragen wurde, wird die Metrik **Eingehende Kontakte** erhöht. Der Kontaktverlaufsdatensatz für die Übertragung erhöht nicht mehr den API-Wert, sondern **Eingehende Kontakte**. 

# Senden von Browser-Benachrichtigungen an Kunden, wenn Chat-Nachrichten eintreffen
<a name="browser-notifications-chat"></a>

Das Kommunikations-Widget unterstützt Browserbenachrichtigungen für Kunden auf ihren Desktop-Geräten. Insbesondere werden Kunden im Webbrowser benachrichtigt, wenn sie eine neue Chat-Nachricht erhalten, aber nicht auf der Webseite mit dem Chatfenster aktiv sind. Wenn Kunden auf diese Benachrichtigung klicken oder tippen, werden sie automatisch auf die Webseite weitergeleitet, die das Chatfenster enthält. Ihre Kunden können Benachrichtigungen zu Beginn jeder Chat-Konversation aktivieren oder deaktivieren. 

Die folgende Abbildung zeigt ein Beispiel für das Benachrichtigungsbanner für Kunden, die sich nicht auf der Webseite mit dem Chatfenster befinden. Das Banner informiert Kunden über die neue Nachricht und zeigt den Namen der Website an. 

![\[Ein Google Chrome-Banner mit der Information, dass eine neue Nachricht empfangen wurde.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-notification-banner.png)


Kunden wird außerdem ein Benachrichtigungssymbol in Form eines roten Punkts im Kommunikations-Widget angezeigt, wenn es minimiert ist. Das folgende Bild zeigt das Benachrichtigungssymbol für Kunden, wenn das Chatfenster minimiert ist.

![\[Ein Benachrichtigungssymbol.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-browser-notification.png)


Beide Features sind automatisch im Kommunikations-Widget enthalten. Sie müssen nichts tun, damit sie den Kunden zur Verfügung stehen.

Ihre Kunden erhalten ein Pop-up mit einer allow/deny Benachrichtigung, wenn sie einen Chat initiieren und noch keine Benachrichtigungen von Ihrer Website oder Domain zugelassen haben. Nachdem Kunden die Berechtigung für Benachrichtigungen erteilt haben, erhalten sie im Browser jedes Mal eine Benachrichtigung, wenn ein Kundendienstmitarbeiter Nachrichten oder Anhänge sendet und sie sich nicht auf der Webseite mit dem Chatfenster befinden. Dies gilt auch dann, wenn Sie das Kommunikations-Widget bereits implementiert haben.

## So testen Sie
<a name="test-browser-notifications-chat"></a>

1. Wenn Sie als Testkunde Benachrichtigungen zugelassen haben und eine Verbindung zum Kundendienstmitarbeiter im Chat besteht, minimieren Sie Ihr Chatfenster und öffnen Sie eine neue Browser-Instance, so dass Sie sich nicht mehr auf der Webseite mit dem Chatfenster befinden.

1. Senden Sie eine Nachricht vom Fenster des Kundendienstmitarbeiters aus.

1. Als Testkunde sehen Sie das Benachrichtigungsbanner.

1. Klicken oder tippen Sie auf das Benachrichtigungsbanner. Sie werden automatisch zur Webseite mit dem Chatfenster weitergeleitet.

1. Da Sie das Chatfenster zuvor minimiert haben, wird auch im Kommunikations-Widget als Benachrichtigungssymbol ein roter Punkt angezeigt.

Wenn Ihnen die Browser-Benachrichtigung nicht angezeigt wird, prüfen Sie Folgendes: 
+ Verwenden Sie einen [unterstützten Browser](add-chat-to-website.md#chat-widget-supported-browsers)?
+ Die Benachrichtigungsberechtigung befindet sich in allowed/enabled Ihrem Browser für die Webseite mit Chat-Fenster.
+ Der Agent (oder Sie aus Ihrer Agenten-Chat-Sitzung) hat eine neue Nachricht gesendet, message/attachment während Sie sich auf einer Webseite befinden, die sich von der Webseite unterscheidet, die das Chatfenster enthält. Damit das Benachrichtigungssymbol als roter Punkt auf dem Widget sichtbar ist, minimieren Sie Ihr Chatfenster.
+ Benachrichtigungen aus dem Browser werden nicht in den Schlummermodus versetzt (vorübergehend ausgeblendet).

# Programmgesteuertes Trennen der Chat-Sitzung eines Kommunikations-Widgets von Amazon Connect
<a name="programmatic-chat-disconnect"></a>

Sie können die Chat-Sitzung eines Kommunikations-Widgets programmgesteuert mithilfe JavaScript von 'trennen, indem Sie die im Widget gespeicherte `disconnect` Methode aufrufen. `iframe` Im Host-Dokument des Widgets können Sie mithilfe des folgenden Codeausschnitts auf die `disconnect`-Funktion verweisen: 

```
document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatSession.disconnect()
```

Sie können es einfach zum vorhandenen Widget-Skript hinzufügen. Es folgt ein Beispiel für einen Codeausschnitt:

```
<script type="text/javascript">
  (function(w, d, x, id){
    s=d.createElement('script');
    s.src='https://your-instance-alias.my.connect.aws/connectwidget/static/amazon-connect-chat-interface-client.js';
    s.async=1;
    s.id=id;
    d.getElementsByTagName('head')[0].appendChild(s);
    w[x] =  w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) };
  })(window, document, 'amazon_connect', '...');
  amazon_connect('styles', { iconType: 'CHAT', openChat: { color: '#ffffff', backgroundColor: '#123456' }, closeChat: { color: '#ffffff', backgroundColor: '#123456'} });
  amazon_connect('snippetId', '...');
  amazon_connect('supportedMessagingContentTypes', [ 'text/plain', 'text/markdown', 'application/vnd.amazonaws.connect.message.interactive', 'application/vnd.amazonaws.connect.message.interactive.response' ]);
 
  // Add disconnect event listener
  window.addEventListener("pagehide", () => {
      document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatSession.disconnect();
  });
</script>
```

## Implementierung und Anwendungsfälle
<a name="implementation-chat-disconnect"></a>

Das programmgesteuerte Aufrufen von „Verbindung trennen“ kann in mehreren Fällen nützlich sein. Es bietet mehr Kontrolle darüber, wann die Konversation beendet werden soll, als manuell auf die Schaltfläche `End Chat` zu klicken. Im Folgenden sind einige häufige Anwendungsfälle für den Aufruf von `disconnect` aufgeführt.

### Beim Schließen oder beim Navigieren
<a name="close-chat-disconnect"></a>

Ein häufiger Anwendungsfall wäre das Anfügen der Funktion zum Trennen der Verbindung an Ereignisse, die ausgelöst werden, wenn der Browser- oder Registerkartenkontext zerstört wird. `pagehide` und `beforeunload` sind die häufigsten Ereignisse, die ausgelöst werden, wenn der Browser heruntergefahren wird. Diese werden ausgelöst, wenn ein Benutzer den Bildschirm aktualisiert, zu einer anderen URL navigiert oder die Registerkarte oder den Browser schließt. Obwohl beide Ereignisse ausgelöst werden, wenn der Browser-Kontext zerstört wird, gibt es keine Garantie dafür, dass die `disconnect`-Funktion vollständig ausgeführt werden kann, bevor die Ressourcen des Browsers bereinigt wurden.

`pagehide` ist ein moderneres Ereignis im Seitenlebenszyklus und wird von allen gängigen Browsern und Betriebssystemen unterstützt. `beforeunload` ist ein alternatives Ereignis, das Sie ausprobieren können, wenn das Ereignis `pagehide` „Verbindung trennen“ nicht konsistent aufruft. `beforeunload` wird vor `pagehide` ausgelöst. Dies kann zusätzliche Zuverlässigkeit bieten, falls die `disconnect`-Funktion nicht abgeschlossen werden kann, bevor der Browser geschlossen wird. Insbesondere bei iOS-Geräten gab es Zuverlässigkeitsprobleme im Hinblick auf `beforeunload`.

Es folgt ein Beispiel für einen Codeausschnitt:

```
// Call disconnect when `beforeunload` triggers
window.addEventListener("beforeunload", (event) => {
    document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatSession.disconnect();
});

// Call disconnect when `pagehide` triggers
window.addEventListener("pagehide", (event) => {
    document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatSession.disconnect();
});
```

### Beim Kontextwechsel
<a name="context-chat-disconnect"></a>

Ein weiterer Anwendungsfall wäre das Auslösen einer Unterbrechung, wenn der Benutzer den Kontext wechselt, z. B. wenn ein Benutzer den Bildschirm wechselt, minimiert oder seinen Bildschirm tab/app sperrt. Das `visibilitychange`-Ereignis funktioniert in diesen Szenarien, in denen der Kontext nicht mehr sichtbar ist, zuverlässig.

Es folgt ein Beispiel für einen Codeausschnitt:

```
window.addEventListener("visibilitychange", () => {
    if (document.visibilityState === "hidden") {
        document.getElementById("amazon-connect-chat-widget-iframe").contentWindow.connect.ChatSession.disconnect();
    } else if (document.visibilityState === "visible") {
        ...
    }
});
```

# Übergeben von benutzerdefinierten Eigenschaften zum Überschreiben der Standardeinstellungen im Kommunikations-Widget in Amazon Connect
<a name="pass-custom-styles"></a>

Sie können die Chat-Benutzeroberfläche weiter anpassen und die Standardeigenschaften mit Ihren eigenen Werten überschreiben. Beispielsweise können Sie die Breite des Widgets auf 400 Pixel und die Höhe auf 700 Pixel festlegen (im Gegensatz zur Standardgröße von 300 Pixeln mal 540 Pixeln). Sie können auch Ihre bevorzugten Schriftfarben und -größen verwenden.

## So übergeben Sie benutzerdefinierte Stile für das Kommunikations-Widget
<a name="chat-widget-pass-custom-styles"></a>

Um benutzerdefinierte Stile zu übergeben, verwenden Sie den folgenden Beispielcodeblock und betten Sie ihn in Ihr Widget ein. Amazon Connect ruft die benutzerdefinierten Stile automatisch ab. Alle im folgenden Beispiel gezeigten Felder sind optional.

```
amazon_connect('customStyles', {
 global: {
     frameWidth: '400px',
     frameHeight: '700px',
     textColor: '#fe3251',
     fontSize: '20px',
     footerHeight: '120px',
     typeface: "'AmazonEmber-Light', serif",
     customTypefaceStylesheetUrl: "https://ds6yc8t7pnx74.cloudfront.net/etc.clientlibs/developer-portal/clientlibs/main/css/resources/fonts/AmazonEmber_Lt.ttf",
     headerHeight: '120px',
 },
 header: {
     headerTextColor: '#541218',
     headerBackgroundColor: '#fe3',
 },
 transcript: {
     messageFontSize: '13px',
     messageTextColor: '#fe3',
     widgetBackgroundColor: '#964950',
     agentMessageTextColor: '#ef18d3',
     systemMessageTextColor: '#ef18d3',
     customerMessageTextColor: '#ef18d3',
     agentChatBubbleColor: '#111112',
     systemChatBubbleColor: '#111112',
     customerChatBubbleColor: '#0e80f2',
 },
 footer: {
     buttonFontSize: '20px',
     buttonTextColor: '#ef18d3',
     buttonBorderColor: '#964950',
     buttonBackgroundColor: '#964950',
     footerBackgroundColor: '#0e80f2',
     startCallButtonTextColor: '#541218',
     startChatButtonBorderColor: '#fe3',
     startCallButtonBackgroundColor: '#fe3',
 },
 logo: {
     logoMaxHeight: '61px',   
     logoMaxWidth: '99%',
 },
  composer: {
     fontSize: '20px', 
 },
  fullscreenMode: true // Enables fullscreen mode on the widget when a mobile screen size is detected in a web browser.
})
```

## Unterstützte Stile und Beschränkungen
<a name="chat-widget-supported-styles"></a>

In der folgenden Tabelle sind die Namen von unterstützten benutzerdefinierten Stilen und die empfohlenen Beschränkungen der Werte aufgeführt. Einige Stile sind sowohl auf globaler Ebene als auch auf Komponentenebene vorhanden. Der Stil `fontSize` ist beispielsweise global und in der Transkriptkomponente vorhanden. Stile auf Komponentenebene haben eine höhere Priorität und werden im Chat-Widget berücksichtigt.


|  Name des benutzerdefinierten Stils  |  Description  |  Empfohlene Beschränkungen  | 
| --- | --- | --- | 
|  `global.frameWidth`  |  Breite des gesamten Widget-Frames  |  Minimum: 300 Pixel Maximum: Fensterbreite Es wird empfohlen, eine Anpassung an die Fenstergröße vorzunehmen  | 
|  `global.frameHeight`  |  Höhe des gesamten Widget-Rahmens  |  Minimum: 480 Pixel Maximum: Fensterhöhe Es wird empfohlen, eine Anpassung an die Fenstergröße vorzunehmen  | 
|  `global.textColor`  |  Farbe für alle Texte  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `global.fontSize`  |  Schriftgröße für alle Texte  |  Für verschiedene Anwendungsfälle werden 12 bis 20 Pixel empfohlen  | 
|  `global.footerHeight`  |  Höhe der Widget-Fußzeile  |  Minimum: 50 Pixel Maximum: Rahmenhöhe Es wird empfohlen, eine Anpassung an die Rahmengröße vorzunehmen  | 
|  `global.typeface`  |  Die im Widget verwendete Schriftart  |  Beliebige Schriftart aus dieser Liste: Arial, Times New Roman, Times, Courier New, Courier, Verdana, Georgien, Palatino, Garamond, Book man, Tacoma, Trebuches MS, Arial Black, Impact, Comic Sans MS. Sie können auch eine benutzerdefinierte Schriftart/Schriftfamilie hinzufügen, aber Sie müssen die Schriftartdatei mit öffentlichem Lesezugriff hosten. Sie können sich beispielsweise die Dokumentation zur Verwendung der Amazon-Ember-Schriftfamilie in der [Amazon-Entwicklerbibliothek](https://developer.amazon.com/en-US/alexa/branding/echo-guidelines/identity-guidelines/typography) ansehen.   | 
|  `global.customTypefaceStylesheetUrl`  |  Speicherort, an dem die benutzerdefinierte Schriftartdatei mit öffentlichem Lesezugriff gehostet wird  |  Link zum öffentlichen HTTP-Speicherort, an dem die Schriftartdatei gehostet wird Der CDN-Speicherort für AmazonEmber Light Typeface lautet beispielsweise `https://ds6yc8t7pnx74.cloudfront.net/etc.clientlibs/developer-portal/clientlibs/main/css/resources/fonts/AmazonEmber_Lt.ttf`  | 
|  `header.headerTextColor`  |  Textfarbe für die Header-Nachricht  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `header.headerBackgroundColor`  |  Textfarbe für den Hintergrund der Kopfzeile  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `global.headerHeight`  |  Höhe der Widget-Kopfzeile  |  Es wird empfohlen, die Anpassung anhand eines Titel- oder Bildlogos oder beidem vorzunehmen.  | 
|  `transcript.messageFontSize`  |  Schriftgröße für alle Texte  |  Für verschiedene Anwendungsfälle werden 12 bis 20 Pixel empfohlen  | 
|  `transcript.messageTextColor`  |  Textfarbe für Transkriptnachrichten  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.widgetBackgroundColor`  |  Textfarbe für Transkript-Hintergrund  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.customerMessageTextColor`  |  Textfarbe für Kundennachrichten  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.agentMessageTextColor`  |  Textfarbe für Kundendienstmitarbeiter-Nachrichten  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.systemMessageTextColor`  |  Textfarbe für Systemnachrichten  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.agentChatBubbleColor`  |  Hintergrundfarbe für Nachrichtenblasen von Kundendienstmitarbeitern  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.customerChatBubbleColor`  |  Hintergrundfarbe für Nachrichtenblasen von Kunden  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `transcript.systemChatBubbleColor`  |  Hintergrundfarbe für Systemnachrichtenblasen  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.buttonFontSize`  |  Schriftgröße für den Text der Aktionsschaltfläche  |  Es wird empfohlen, eine Anpassung an die Höhe der Fußzeile vorzunehmen  | 
|  `footer.buttonTextColor`  |  Farbe für den Text der Aktionsschaltfläche  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.buttonBorderColor`  |  Farbe für den Rand der Aktionsschaltfläche  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.buttonBackgroundColor`  |  Farbe für den Hintergrund der Aktionsschaltfläche  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.BackgroundColor`  |  Farbe für den Fußzeilenhintergrund  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.startCallButtonTextColor`  |  Farbe für den Text der Schaltfläche zum Starten des Anrufs  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.startCallButtonBorderColor`  |  Farbe für den Rand der Schaltfläche zum Starten des Anrufs  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `footer.startCallButtonBackgroundColor`  |  Farbe für den Hintergrund der Schaltfläche zum Starten des Anrufs  |  Jeder zulässige CSS-Farbwert. Weitere Informationen finden Sie unter [Zulässige CSS-Farbwerte](https://www.w3schools.com/cssref/css_colors_legal.php).  | 
|  `logo.logoMaxHeight`  |  Maximale Höhe des Logos  |  Minimum: 0 Pixel Maximum: Höhe der Kopfzeile Es wird empfohlen, eine Anpassung an Bildgröße und Frame-Höhe vorzunehmen.  | 
|  `logo.logoMaxWidth`  |  Maximale Breite des Logos  |  Minimum: 0 Pixel Maximum: Kopfzeilenbreite Es wird empfohlen, eine Anpassung an Bildgröße und Frame-Breite vorzunehmen.  | 
|  `composer.fontSize`  |  Schriftgröße für den Composer-Text  |  Für verschiedene Anwendungsfälle werden 12 bis 20 Pixel empfohlen  | 
|  `fullscreenMode`  |  Aktiviert den Vollbildmodus im Widget, wenn die Bildschirmgröße eines Mobiltelefons in einem Webbrowser erkannt wird.  |  Typ: boolean  | 

Im Folgenden sind die Elemente aufgeführt, aus denen das Kommunikations-Widget besteht.

![\[Elemente, aus denen das Kommunikations-Widget besteht.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-elements.png)


## So übergeben Sie das Überschreiben von System- und Bot-Anzeigenamen und Logos für das Kommunikations-Widget
<a name="pass-override-system"></a>

Um die auf der Amazon Connect Admin-Website festgelegten Konfigurationen für den System/Bot Anzeigenamen und das Logo zu überschreiben, betten Sie den folgenden Codeblock in Ihr Widget-Code-Snippet ein. Alle im folgenden Beispiel gezeigten Felder sind optional.

```
amazon_connect('customDisplayNames', {
 header: {
     headerMessage: "Welcome!",
     logoUrl: "https://example.com/abc.png",
     logoAltText: "Amazon Logo Banner"
 },
 transcript: {
     systemMessageDisplayName: "Amazon System",
     botMessageDisplayName: "Alexa"
 },
 footer: {
     textInputPlaceholder: "Type Here!",     
      endChatButtonText: "End Session",      
      closeChatButtonText: "Close Chat",      
      startCallButtonText: "Start Call"
 },
})
```

### Unterstützte Eigenschaften und Beschränkungen
<a name="supported-properties-displaynames"></a>


| Name des benutzerdefinierten Stils | Description | Empfohlene Beschränkungen | 
| --- | --- | --- | 
|  `header.headerMessage`  | Textfarbe für die Kopfzeilennachricht | Mindestlänge: 1 Zeichen. Maximale Länge: 11 Zeichen  Es wird empfohlen, eine Anpassung an die Breite der Kopfzeile vorzunehmen. | 
|  `header.logoUrl`  | URL, die auf das Logobild verweist |  Maximale Länge: 2048 Zeichen Muss eine gültige URL sein, die auf eine PNG-, JPG- oder .SVG-Datei verweist | 
|  `header.logoAltText`  | Text, um das alt-Attribut für das Logo-Banner zu überschreiben |  Maximale Länge: 2048 Zeichen | 
|  `transcript.systemMessageDisplayName`  | Text zum Überschreiben des SYSTEM\$1MESSAGE-Anzeigenamens | Mindestlänge: 1 Zeichen. Maximale Länge: 26 Zeichen  | 
|  `transcript.botMessageDisplayName`  | Text zum Überschreiben des BOT-Anzeigenamens | Mindestlänge: 1 Zeichen. Maximale Länge: 26 Zeichen  | 
|  `footer.textInputPlaceholder`  | Text zum Überschreiben des Platzhalters bei der Texteingabe | Mindestlänge: 1 Zeichen. Maximale Länge: 256 Zeichen  | 
|  `footer.endChatButtonText`  | Text zum Überschreiben des Texts der Schaltfläche zum Beenden des Chats | Mindestlänge: 1 Zeichen. Maximale Länge: 256 Zeichen Es wird empfohlen, eine Anpassung an die Breite der Schaltfläche vorzunehmen.  | 
|  `footer.closeChatButtonText`  | Text zum Überschreiben des Texts der Schaltfläche zum Schließen des Chats | Mindestlänge: 1 Zeichen. Maximale Länge: 256 Zeichen Es wird empfohlen, eine Anpassung an die Breite der Schaltfläche vorzunehmen.  | 
|  `footer.startCallButtonText`  | Text zum Überschreiben des Texts der Schaltfläche zum Starten des Anrufs | Mindestlänge: 1 Zeichen. Maximale Länge: 256 Zeichen Es wird empfohlen, eine Anpassung an die Breite der Schaltfläche vorzunehmen.  | 

## Anzeigen einer Vorschau des Kommunikations-Widgets mit benutzerdefinierten Eigenschaften
<a name="chat-widget-preview"></a>

Stellen Sie sicher, dass Sie eine Vorschau Ihres Kommunikations-Widgets mit den benutzerdefinierten Eigenschaften aufrufen, bevor Sie das Widget in die Produktionsumgebung übertragen. Benutzerdefinierte Werte können die Darstellung der Benutzeroberfläche des Kommunikations-Widgets beeinträchtigen, wenn sie nicht korrekt eingestellt sind. Wir empfehlen Tests mit verschiedenen Browsern und Geräten, bevor Sie das Widget Ihren Kunden zur Verfügung stellen.

Im Folgenden finden Sie einige Beispiele für Fehler, die durch falsche Werte auftreten können, sowie Lösungsvorschläge dazu.
+ **Problem:** Das Widget-Fenster nimmt zu viel vom Bildschirm ein.

  **Lösung:** Verwenden Sie kleinere Werte für `frameWidth` und`frameHeight`.
+ **Problem:** Die Schriftgröße ist zu klein oder zu groß.

  **Lösung:** Passen Sie die Schriftgröße an.
+ **Problem:** Unter dem Ende des Chats (Fußzeile) befindet sich ein leerer Bereich.

  **Lösung:** Verwenden Sie einen kleineren Wert für `frameHeight` oder einen größeren Wert für `footerHeight`.
+ **Problem:** Die Schaltfläche „Chat beenden“ ist zu klein oder zu groß.

  **Lösung:** Passen Sie `buttonFontSize` an.
+ **Problem:** Die Schaltfläche zum Beenden des Chats befindet sich außerhalb des Fußzeilenbereichs.

  **Lösung:** Verwenden Sie einen größeren Wert für `footerHeight` oder einen kleineren Wert für `buttonFontSize`.

# Richten Sie die Schaltfläche und den Frame Ihres Amazon Connect Connect-Widgets mit CSS/ als Ziel aus JavaScript
<a name="target-widget-button"></a>

Das Kommunikations-Widget rendert die open/close Widget-Schaltfläche und den Widget-Frame direkt auf der Host-Website. Es gibt spezielle Selektoren, mit denen Sie diese Elemente entweder mithilfe von CSS gezielt ansprechen oder in ihnen referenzieren können. JavaScript 

**Tipp**  
Verwenden Sie die [Admin-Website von Amazon Connect](add-chat-to-website.md#customize-chat-widget), um die Farben der Widget-Schaltfläche oder die Stile des Widgets selbst zu aktualisieren. Für anpassbarere Stile können Sie [benutzerdefinierte Stile direkt an das Kommunikations-Widget übergeben](pass-custom-styles.md).

## Widget-Element IDs und Beispiele
<a name="widget-elementid"></a>

Die folgenden Abbildungen zeigen, wie die Chat-Widget-Schaltfläche auf dem Bildschirm des Benutzers angezeigt wird. Die erste Abbildung zeigt die Schaltfläche „Öffnen“ zum Öffnen des Chat-Widgets. Die zweite Abbildung veranschaulicht die Schaltfläche „Schließen“ zum Schließen des Chat-Widgets.

![\[Side-by-side Bilder des Chat-Widgets zum Öffnen und Schließen des Chat-Fensters.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/widget-elements.png)


1.  Schaltfläche „Widget öffnen“: `#amazon-connect-open-widget-button` 

1. Schaltfläche „Widget schließen“: `#amazon-connect-close-widget-button`

1. Widget-Frame: `#amazon-connect-widget-frame`

   1. Widget-Frame im geöffneten Zustand: `#amazon-connect-widget-frame.show`

   1. Widget-Frame im geschlossenen Zustand: `#amazon-connect-widget-frame:not(.show)`

Im Folgenden finden Sie ein Beispiel für ein CSS-Stylesheet, das diese Elemente ändert:

```
/* Target widget button while widget is minimized */
#amazon-connect-open-widget-button {
  ...
}

/* Target widget button while widget is showing */
#amazon-connect-close-widget-button {
  ...
}

/* Target widget frame */
#amazon-connect-widget-frame {
  ...
}

/* Target widget frame while it is showing */
#amazon-connect-widget-frame.show {
  ...
}

/* Target widget frame while it is minimized */
#amazon-connect-widget-frame:not(.show) {
  ...
}
```

Im Folgenden finden Sie ein Beispiel für die Referenzierung dieser Elemente mithilfe von JavaScript:

```
const openWidgetButton = document.getElementById("amazon-connect-open-widget-button");
const closeWidgetButton = document.getElementById("amazon-connect-close-widget-button");

const widgetFrame = document.querySelector("#amazon-connect-widget-frame");
const openWidgetFrame = document.querySelector("#amazon-connect-widget-frame.show");
const hiddenWidgetFrame = document.querySelector("#amazon-connect-widget-frame:not(.show)");
```

# Fehlerbehebung beim Kommunikations-Widget von Amazon Connect
<a name="ts-cw"></a>

Dieses Thema richtet sich an Entwickler, die Probleme untersuchen müssen, die bei der Konfiguration eines Kommunikations-Widgets auf der Amazon Connect Admin-Website auftreten können. 

**Topics**
+ [„Es ist ein Problem aufgetreten.“](#sww)
+ [Kunden, die keine Agentennachrichten erhalten: Netzwerk oder Verbindung unterbrochen WebSocket](#mam)
+ [Umgehen von CORS beim Öffnen der Links von Drittanbietern](#bcwotpl)

## „Es ist ein Problem aufgetreten.“
<a name="sww"></a>

Wenn Sie beim Laden Ihres Kommunikations-Widgets die Fehlermeldung **Ein Problem ist aufgetreten** sehen, öffnen Sie die Browser-Tools, um die Fehlerprotokolle einzusehen. 

![\[Eine Fehlermeldung, die besagt, dass ein Problem aufgetreten ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-error-message.png)


Folgende Probleme verursachen diesen Fehler häufig:

### 400 Ungültige Anfrage
<a name="400-invalid-request"></a>

Wenn in den Protokollen „400 Ungültige Anfrage“ erwähnt wird, gibt es mehrere mögliche Ursachen:
+ Ihr Kommunikations-Widget wird nicht auf einer zugelassenen Domain bereitgestellt. Sie müssen die Domains, in denen Sie Ihr Widget hosten werden, ausdrücklich angeben.
+ Die Anfrage an den Endpunkt ist nicht richtig formatiert. Dies tritt normalerweise nur auf, wenn der Inhalt des eingebetteten Codeblocks geändert wurde.

### 401 Nicht autorisiert
<a name="401-unauthorized"></a>

![\[Eine Fehlermeldung, die besagt, dass ein Problem aufgetreten ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/something-went-wrong.png)


Wenn in den Protokollen „401 Nicht autorisiert“ erwähnt wird, liegt ein Problem mit der Authentifizierung über das JSON Web Token (JWT) vor. Es zeigt die obige Fehlerseite an.

Nachdem Sie das JWT eingerichtet haben, müssen Sie es in der Callback-Funktion `authenticate` implementieren. Das folgende Beispiel zeigt das Implementieren, wenn das Token abgerufen und verwendet werden soll: 

```
amazon_connect('authenticate', function(callback) {
  window.fetch('/token').then(res => {
    res.json().then(data => {
      callback(data.data);
    });
  });
});
```

Dies ist eine vereinfachte Version dessen, was implementiert werden muss:

```
amazon_connect('authenticate', function(callback) {
   callback(token);
});
```

Eine Anleitung zum Implementieren von JWT finden Sie unter [Schritt 3: Bestätigen und Kopieren des Kommunikations-Widget-Codes und der Sicherheitsschlüssel](add-chat-to-website.md#confirm-and-copy-chat-widget-script).

Wenn Sie den Callback bereits implementiert haben, kann in den folgenden Situationen immer noch der Fehler 401 auftreten:
+ Ungültige Signatur
+ Abgelaufenes Token

### 404 Nicht gefunden
<a name="404-not-found"></a>

Ein 404-Statuscode wird normalerweise verursacht, wenn die angeforderte Ressource nicht existiert:
+ In der API-Anforderung ist eine ungültige widgetId angegeben.
+ Die widgetId ist gültig, aber der zugehörige Ablauf wurde gelöscht oder archiviert.
+ Das Widget wurde nicht veröffentlicht oder es wurde gelöscht.

Stellen Sie sicher, dass Ihr Snippet genau so ist, wie es von der Amazon Connect Admin-Website kopiert wurde, und dass sich keine der Kennungen geändert hat.

Wenn sich die Kennungen nicht geändert haben und Sie den Fehler 404 erhalten, wenden Sie sich an den AWS Support. 

### 500 Interner Serverfehler
<a name="500-internalservererror-chatwidget"></a>

Dieser kann darauf zurückzuführen sein, dass Ihre servicebezogene Rolle nicht über die erforderlichen Berechtigungen verfügt, um den Chat zu starten. Dies ist der Fall, wenn die Amazon-Connect-Instance vor Oktober 2018 erstellt wurde, weil Sie dann keine serviceverknüpften Rollen eingerichtet haben.

**Lösung**: Fügen Sie die Richtlinie `connect:*` für die Rolle hinzu, die Ihrer Amazon-Connect-Instance zugeordnet ist. Weitere Informationen finden Sie unter [Verwenden von serviceverknüpften Rollen und Rollenberechtigungen für Amazon Connect](connect-slr.md).

Wenn Ihre serviceverknüpfte Rolle die richtigen Berechtigungen hat, wenden Sie sich an den AWS Support.

## Kunden, die keine Agentennachrichten erhalten: Netzwerk oder Verbindung unterbrochen WebSocket
<a name="mam"></a>

Während einer Chat-Sitzung verliert ein Kunde, der eine Chat-Anwendung verwendet, seine network/WebSocket Verbindung. Die Verbindung wird schnell wieder hergestellt, aber Nachrichten, die während dieser Zeit vom Kundendienstmitarbeiter gesendet wurden, werden nicht in der Chat-Oberfläche des Kunden wiedergegeben. 

Die folgende Abbildung zeigt ein Beispiel für die Chat-Oberfläche des Kunden und das Kontakt-Control-Panel des Agenten side-by-side. Eine vom Kundendienstmitarbeiter gesendete Nachricht wird in der Chat-Sitzung des Kunden nicht wiedergegeben. Für den Kundendienstmitarbeiter sieht es jedoch so aus, als ob der Kunde sie erhalten hätte.

![\[Eine Nachricht im CCP, die nicht an den Kontakt gesendet wird.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tw-cw-001-message-not-sent.png)


Wenn die Chat-Anwendung des Kunden ihre network/WebSocket Verbindung verliert, muss die Chat-Benutzeroberfläche wie folgt vorgehen, um future Nachrichten sowie Nachrichten, die an sie gesendet wurden, während die Verbindung unterbrochen wurde, abzurufen: 
+ Stellen Sie die WebSocket Verbindung wieder her, um future eingehende Nachrichten erneut zu empfangen.
+ Stellen Sie eine [chatSession.getTranscript](https://github.com/amazon-connect/amazon-connect-chatjs?tab=readme-ov-file#chatsessiongettranscript)-Anforderung ([getTranscripts](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)-API), um alle fehlenden Nachrichten abzurufen, die gesendet wurden, während die Verbindung zum Kunden unterbrochen war.

Wenn der Kundendienstmitarbeiter eine Nachricht sendet, während die Chat-Benutzeroberfläche des Kunden unterbrochen ist, wird die Nachricht erfolgreich im Amazon-Connect-Backend gespeichert: Das CCP funktioniert wie erwartet und alle Nachrichten werden im Protokoll aufgezeichnet, aber das Gerät des Kunden kann keine Nachrichten empfangen. Wenn der Client erneut eine Verbindung zum herstellt WebSocket, besteht eine Nachrichtenlücke. Künftige eingehende Nachrichten werden wieder von der angezeigt WebSocket, aber die Lückenmeldungen fehlen immer noch, es sei denn, der Code ruft die [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)API explizit auf.

### Lösung
<a name="solution-network-disconnected"></a>

Verwenden Sie die [ChatSession. onConnectionEstablished](https://github.com/amazon-connect/amazon-connect-chatjs?tab=readme-ov-file#chatsessiononconnectionestablished)Event-Handler zum Aufrufen der [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)API. Der `chatSession.onConnectionEstablished` Event-Handler wird ausgelöst, wenn die WebSocket Verbindung wieder hergestellt wird. ChatJS verfügt über eine integrierte Heartbeat- und Wiederholungslogik für die Verbindung. WebSocket Da ChatJS das Transkript jedoch nicht speichert, müssen Sie der Chat-Benutzeroberfläche benutzerdefinierten Code hinzufügen, um das Transkript erneut manuell abzurufen.

Das folgende Codebeispiel zeigt, wie `onConnectionEstablished` implementiert wird, um `GetTranscript` aufzurufen.

```
import "amazon-connect-chatjs";

const chatSession = connect.ChatSession.create({
  chatDetails: {
    ContactId: "the ID of the contact",
    ParticipantId: "the ID of the chat participant",
    ParticipantToken: "the participant token",
  },
  type: "CUSTOMER",
  options: { region: "us-west-2" },
});

// Triggered when the websocket reconnects
chatSession.onConnectionEstablished(() => {
  chatSession.getTranscript({
    scanDirection: "BACKWARD",
    sortOrder: "ASCENDING",
    maxResults: 15,
    // nextToken?: nextToken - OPTIONAL, for pagination
  })
    .then((response) => {
      const { initialContactId, nextToken, transcript } = response.data;
      // ...
    })
    .catch(() => {})
});
```

```
function loadLatestTranscript(args) {
    // Documentation: https://github.com/amazon-connect/amazon-connect-chatjs?tab=readme-ov-file#chatsessiongettranscript
    return chatSession.getTranscript({
        scanDirection: "BACKWARD",
        sortOrder: "ASCENDING",
        maxResults: 15,
        // nextToken?: nextToken - OPTIONAL, for pagination
      })
      .then((response) => {
        const { initialContactId, nextToken, transcript } = response.data;
        
        const exampleMessageObj = transcript[0];
        const {
          DisplayName,
          ParticipantId,
          ParticipantRole, // CUSTOMER, AGENT, SUPERVISOR, SYSTEM
          Content,
          ContentType,
          Id,
          Type,
          AbsoluteTime, // sentTime = new Date(item.AbsoluteTime).getTime() / 1000
          MessageMetadata, // { Receipts: [{ RecipientParticipantId: "asdf" }] }
          Attachments,
          RelatedContactid,
        } = exampleMessageObj;

        return transcript // TODO - store the new transcript somewhere
      })
      .catch((err) => {
        console.log("CustomerUI", "ChatSession", "transcript fetch error: ", err);
      });
}
```

Ein weiteres Beispiel finden Sie unter dieser [Open-Source-Implementierung](https://github.com/amazon-connect/amazon-connect-chat-interface/blob/c88f854073fe6dd45546585c3bfa363d3659d73f/src/components/Chat/ChatSession.js#L408). GitHub 

## Umgehen von CORS beim Öffnen der Links von Drittanbietern
<a name="bcwotpl"></a>

Zur Verbesserung der Sicherheit arbeitet das Kommunikations-Widget in einer Sandbox-Umgebung. Daher können Links von Drittanbietern, die innerhalb des Widgets geteilt werden, nicht geöffnet werden.

**Lösung**

Es gibt zwei Möglichkeiten, CORS zu umgehen und das Öffnen der Links von Drittanbietern zuzulassen.
+ **(Empfohlen)**

  Aktualisieren Sie das Sandbox-Attribut, um das Öffnen von Links in einer neuen Registerkarte zu ermöglichen. Fügen Sie dazu dem Codeausschnitt das folgende Attribut hinzu:

  ```
  amazon_connect('updateSandboxAttributes', 'allow-scripts allow-same-origin allow-popups allow-downloads allow-top-navigation-by-user-activation allow-popups-to-escape-sandbox')
  ```
**Anmerkung**  
Der Attributwert kann nach Bedarf aktualisiert werden, um bestimmte Aktionen zuzulassen. Dies ist ein Beispiel dafür, wie das Öffnen von Links in einer neuen Registerkarte ermöglicht wird.
+ Entfernen Sie das Sandbox-Attribut, indem Sie dem Codeausschnitt das folgende Attribut hinzufügen:

  ```
  amazon_connect('removeSandboxAttribute', true)
  ```

# Hinzufügen eines Vorab-Kontakt- oder Pre-Chat-Formulars
<a name="add-precontact-form"></a>

Sie können Kundeninformationen erfassen, bevor Sie einen Kontakt aufnehmen:
+ **Vorab-Kontaktformular**: Fügen Sie dieses Formular hinzu, um Informationen vom Kunden zu erfassen, bevor Sie eine Aufgabe oder einen E-Mail-Kontakt aufnehmen.
+ **Pre-Chat-Formular**: Fügen Sie dieses Formular hinzu, um Informationen vom Kunden zu erfassen, bevor Sie einen Chat-Kontakt aufnehmen.

Nachdem Sie die Informationen erfasst haben, können Sie dem Kundendienstmitarbeiter über das Contact Control Panel (CCP) anzeigen oder sie an anderer Stelle im Flow verwenden.

Zum Aufsetzen des Formulars erstellen Sie eine benutzerdefinierte Ansicht und verwenden die Schaltflächenkomponente „Verbindungsaktion“. Weitere Informationen zu Ansichten finden Sie unter [Verwenden Sie den UI Builder in Amazon Connect für Ressourcen in step-by-step Leitfäden](no-code-ui-builder.md).

Mit der Aktionsschaltfläche „Verbinden“ können Sie Benutzereingaben aus dem Formular aufnehmen und auswählen, welche Aktion beim Absenden des Formulars ausgeführt werden soll — ein Formular starten task/email oder chatten.

# Aktivieren Sie die Umfrage nach dem Chat
<a name="enable-post-chat-survey"></a>

Mit einer Umfrage nach dem Chat können Sie unmittelbar nach dem Ende einer Chat-Konversation Feedback von Endkunden einholen. Mit dem **`DisconnectOnCustomerExit`**Parameter in der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API können Sie die automatische Unterbrechung der Agentenverbindung konfigurieren, wenn der Endkunde die Verbindung unterbricht. So stellen Sie sicher, dass der Verbindungsabbruch konsistent ausgelöst wird, unabhängig davon, welcher Teilnehmer zuerst die Verbindung trennt.

## Optionen für die Implementierung
<a name="post-chat-survey-implementation"></a>

Es gibt zwei Möglichkeiten, die Umfrage nach dem Chat zu aktivieren:

### Für ein benutzerdefiniertes Chat-Widget
<a name="post-chat-survey-custom-builder"></a>

Wenn Sie eine benutzerdefinierte Chat-Implementierung verwenden:

1. Führen Sie ein Upgrade auf die neueste Version von durch [amazon-connect-chatjs](https://github.com/amazon-connect/amazon-connect-chatjs).

1. Fügen Sie den `DisconnectOnCustomerExit` Parameter zu Ihrer [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API-Anfrage hinzu:

   ```
   {
       "DisconnectOnCustomerExit": ["AGENT"],
       // ... other StartChatContact parameters
   }
   ```

### Für das Amazon Connect Connect-Kommunikations-Widget
<a name="post-chat-survey-communication-widget"></a>

Wenn Sie das Amazon Connect Communication Widget verwenden:

1. Öffnen Sie die Amazon Connect Connect-Konsole und navigieren Sie zu **Kommunikations-Widgets**.

1. Aktivieren Sie die Einstellung für die Umfrage nach dem Chat auf der Seite „Kommunikations-Widgets“.  
![\[Die Seite mit den Einstellungen des Kommunikations-Widgets, auf der die Option für die Umfrage nach dem Chat angezeigt wird.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/post-chat-survey-communication-widget.png)

## Aktualisieren Sie den Kontaktablauf, um eine Umfrage nach dem Chat als Verbindungsablauf hinzuzufügen
<a name="post-chat-survey-disconnect-flow"></a>

Um die Umfrage nach dem Chat zu aktivieren, müssen Sie den Verbindungsablauf aktualisieren, der mit Ihrer Chat-Lösung verbunden ist. Nach der Konfiguration wird die Umfrage automatisch ausgelöst, wenn Kunden ihre Chat-Sitzungen beenden.

Informationen zum Erstellen eines Disconnect-Flows finden Sie unter[Beispiel für ein Chat-Szenario](web-and-mobile-chat.md#example-chat-scenario).

Es gibt zwei Möglichkeiten, eine Umfrage in Ihren Disconnect-Flow zu implementieren:
+ **Option \$11: ShowView Block verwenden** — Verwenden Sie den[Flow-Block in Amazon Connect: Ansicht anzeigen](show-view-block.md), um eine benutzerdefinierte Umfrageschnittstelle anzuzeigen.
+ **Option \$12: Lex verwenden** — Integration mit Amazon Lex für die textbasierte Erfassung von Umfragen. Weitere Informationen finden Sie unter [Einen Amazon-Lex-Bot zu Amazon Connect hinzufügen](amazon-lex.md).

**Anmerkung**  
Stellen Sie bei Barge-In-Szenarien für Supervisoren sicher, dass Sie vor der **Übertragung** in die [Flow-Block in Amazon Connect: Arbeitswarteschlange festlegen](set-working-queue.md) Warteschlange einen Block hinzufügen. Wenn Sie ihn weglassen, werden Chat-Kontakte für diese Funktion eher beendet als übertragen.  

![\[Ein Flussdiagramm, das den Block „Arbeitswarteschlange einrichten“ vor der Übertragung in die Warteschlange für Supervisor-Barge-in-Szenarien zeigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/post-chat-survey-set-working-queue-block.png)


**Trace Records kontaktieren**  
Wenn ein Kunde eine Chat-Sitzung beendet, setzt Amazon Connect `disconnectReason` auf `CUSTOMER_DISCONNECT` in der[ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord). Wenn `DisconnectOnCustomerExit` konfiguriert, generiert das System eine neue Kontakt-ID (`nextContactId`) und leitet den konfigurierten Verbindungsablauf ein.  
Beispiel:  

```
{
    "contactId": "104c05e3-abscdfre",
    "nextContactId": "4cbae06d-ca5b-1234567",
    "channel": "CHAT",
    "initiationMethod": "DISCONNECT",
    "disconnectReason": "CUSTOMER_DISCONNECT"
}
```
[So funktionieren Kontaktattribute in Amazon Connect](what-is-a-contact-attribute.md)wird in der Kontaktsuche und in den Kontaktdetails aktualisiert.  

![\[Kontaktdetails mit den Kontaktattributen für eine Umfrage nach dem Chat.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/post-chat-survey-contact-attributes.png)


## Weitere Ressourcen
<a name="post-chat-survey-additional-resources"></a>
+ [StartChatContact API](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)
+ [Beispiel für einen Flow bei eingehenden Anrufen in Amazon Connect (Erstkontakterfahrung)](sample-inbound-flow.md)
+ [Beispiel für ein Chat-Szenario](web-and-mobile-chat.md#example-chat-scenario)
+ [Flow-Block in Amazon Connect: Arbeitswarteschlange festlegen](set-working-queue.md)
+ [Flow-Block in Amazon Connect: An Warteschlange weiterleiten](transfer-to-queue.md)
+ [Amazon Connect ShowView](https://docs.aws.amazon.com/connect/latest/adminguide/show-view-block.html)
+ [Amazon Connect mit Lex](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-lex.html)
+ [So funktionieren Kontaktattribute in Amazon Connect](what-is-a-contact-attribute.md)

# Integrieren Amazon Connect Sie den Chat in eine mobile Anwendung
<a name="integrate-chat-with-mobile"></a>

In diesem Thema wird erläutert, wie Sie Amazon Connect Chat in Ihre mobile Anwendung integrieren. Verwenden Sie eine der folgenden Optionen: 
+ [WebView Integration](#webview)
+ Der [Amazon Connect Chat SDKs für iOS und Android](#integrate-chat-with-mobile-sdks-for-mobile)
+ [React-Native-Integration](#react-native-integration)

Verwenden Sie die Amazon Connect [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API, um Kontakt aufzunehmen. 

**Topics**
+ [Auswählen der passenden Integrationsoption](#integrate-options)
+ [Amazon Connect Arbeitsablauf bei der Chat-Integration](#integrate-chat-with-mobile-workflow)
+ [Beginnen Sie mit der Amazon Connect Chat-Integration](#integrate-chat-with-mobile-getting-started)

## Auswählen der passenden Integrationsoption
<a name="integrate-options"></a>

Dieser Abschnitt enthält eine Beschreibung der einzelnen Integrationsoptionen, um Ihnen bei der Entscheidung zu helfen, welche Option Sie für Ihre Lösung verwenden sollten. 

### WebView Integration
<a name="webview"></a>

Die Amazon Connect WebView Chat-Integration ermöglicht es Ihnen, das gesamte Chat-Erlebnis mit minimalem Entwicklungsaufwand in Ihre mobilen Anwendungen einzubetten. Diese Methode verwendet `WebView` unter Android und `WKWebView` unter iOS verwendet, um eine nahtlose und umfassende Chat-Oberfläche bereitzustellen. Sie ist ideal für Teams, die nach einer schnellen out-of-the-box Lösung suchen, um Chat-Funktionen ohne umfangreiche Anpassungen zu integrieren.

Dieser Ansatz gewährleistet eine sichere Kommunikation und nutzt die webbasierte Chat-Oberfläche von Amazon Connect. Sie müssen Ihre App jedoch so konfigurieren, dass sie Cookies JavaScript ordnungsgemäß verarbeitet.

Weitere Informationen zur Implementierung der WebView Integration finden Sie im Amazon Connect Chat [UI Examples](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples) GitHub Repository.

**Empfehlung**: Die WebView basierte Integration ist ideal für eine schnelle Entwicklung und minimalen Wartungsaufwand und gewährleistet gleichzeitig eine umfassende Chat-Funktionalität.

### Amazon Connect Chat SDKs für Mobilgeräte
<a name="integrate-chat-with-mobile-sdks-for-mobile"></a>

Der Amazon Connect Chat SDKs für iOS und Android vereinfacht die Integration von Amazon Connect Chat für native mobile Anwendungen. Sie SDKs helfen bei der Handhabung der clientseitigen Chat-Logik und der Back-End-Kommunikation, ähnlich der Amazon Connect ChatJS-Bibliothek.

Der Amazon Connect Chat SDKs umschließt den Amazon Connect Participant Service APIs und abstrakt die Verwaltung der Chat-Sitzung und WebSocket. Auf diese Weise können Sie sich auf die Benutzeroberfläche und das Benutzererlebnis konzentrieren und sich gleichzeitig auf das Amazon Connect Chat-SDK verlassen, um mit allen Back-End-Diensten zu interagieren. Bei diesem Ansatz müssen Sie immer noch Ihr eigenes Chat-Backend verwenden, um die Amazon Connect `StartChatContact` API aufzurufen und Kontakt aufzunehmen.
+ Weitere Informationen zum Swift-basierten iOS-SDK finden Sie auf der Seite [Amazon Connect Chat-SDK für iOS](https://github.com/amazon-connect/amazon-connect-chat-ios) GitHub .
+ Weitere Informationen zum Kotlin-basierten Android-SDK finden Sie auf der Seite [Amazon Connect Chat-SDK SDK for Android](https://github.com/amazon-connect/amazon-connect-chat-android) GitHub .

**Vorteile**: The Native SDKs bieten robuste Funktionalität und hohe Leistung und eignen sich daher ideal für Anwendungen, die umfassende Anpassungen und ein nahtloses Benutzererlebnis erfordern.

### React-Native-Integration
<a name="react-native-integration"></a>

Die React-Native-Integration von Amazon Connect Chat bietet eine plattformübergreifende Lösung. Sie ermöglicht Teams, Chat-Funktionen für Android und iOS mit einer gemeinsamen Codebasis zu erstellen. Diese Methode bringt Anpassung und Entwicklungseffizienz in Einklang und nutzt gleichzeitig die Funktionen von React Native zur Erstellung robuster mobiler Anwendungen.

Diese Integration verwendet native Bridges für den Zugriff auf erweiterte Features und gewährleistet eine konsistente Leistung sowie ein einheitliches Benutzererlebnis auf allen Plattformen. Es ist einfacher, wichtige Funktionen wie WebSocket Kommunikation mithilfe von Bibliotheken `react-native-websocket` und API-Aufrufen mit zu implementieren`axios`.

**Ideal für**: Teams, die die Wiederverwendung von Code maximieren und gleichzeitig die funktionale Flexibilität beibehalten möchten

## Amazon Connect Arbeitsablauf bei der Chat-Integration
<a name="integrate-chat-with-mobile-workflow"></a>

Das folgende Diagramm zeigt den Programmierablauf zwischen einem Kunden, der eine mobile App verwendet, und einem Kundendienstmitarbeiter. Der nummerierte Text im Diagramm entspricht dem nummerierten Text unter der Abbildung.

![\[Diagramm, das den Ablauf des Amazon Connect Chat-Programms zeigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/integrate-chat-mobile-diagram.png)


**Im Diagramm**

1. Wenn ein Kunde in der mobilen App einen Chat startet, sollte die App eine Anfrage an die Amazon Connect [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API senden. Dies erfordert bestimmte Parameter wie den API-Endpunkt sowie IDs für die [Instanz](amazon-connect-instances.md) und den [Kontaktablauf](connect-contact-flows.md), um den Chat zu authentifizieren und zu initiieren.

1. Die `StartChatContact`-API interagiert mit Ihrem Backend-System, um ein Teilnehmer-Token und eine Kontakt-ID zu erhalten, die als eindeutige Identifikatoren für die Chat-Sitzung dienen.

1. Die Benutzeroberfläche der App leitet die `StartChatContact`-Antwort an das mobile SDK weiter, damit das SDK ordnungsgemäß mit dem [Teilnehmerservice von Amazon Connect](https://docs.aws.amazon.com/connect/latest/APIReference/API_Operations_Amazon_Connect_Participant_Service.html) kommunizieren und die Chat-Sitzung des Kunden einrichten kann.

1. Das SDK stellt der Benutzeroberfläche ein [chatSession](https://github.com/amazon-connect/amazon-connect-chat-ios?tab=readme-ov-file#chatsession-apis)-Objekt zur Verfügung, das leicht verwendbare Methoden zur Interaktion mit der Chat-Sitzung enthält.

1. Im Grunde interagiert das SDK mithilfe des [AWS SDK](https://aws.amazon.com/developer/tools/) mit dem [Teilnehmerservice von Amazon Connect](https://docs.aws.amazon.com/connect/latest/APIReference/API_Operations_Amazon_Connect_Participant_Service.html). Die Kommunikation mit dem Teilnehmerservice von Amazon Connect ist für alle Kundeninteraktionen während der Chat-Sitzung verantwortlich. Dazu gehören Aktionen wie `CreateParticipantConnection`, `SendMessage`, `GetTranscript` oder `DisconnectParticipant`.

1. Das SDK verwaltet auch die WebSocket Verbindung, die für den Empfang von Nachrichten, Ereignissen und Anhängen vom Agenten erforderlich ist. All dies wird vom SDK verarbeitet und analysiert sowie in einer leicht zu bedienenden Struktur auf der Benutzeroberfläche angezeigt.

## Beginnen Sie mit der Amazon Connect Chat-Integration
<a name="integrate-chat-with-mobile-getting-started"></a>

Die folgenden Schritte und Ressourcen helfen Ihnen bei den ersten Schritten mit der Integration von Amazon Connect Chat in Ihre nativen mobilen Anwendungen:

1. Sie können schnell einen [CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)Stack einrichten, der das erforderliche Back-End zum Aufrufen bereitstellt, StartChatContact indem Sie sich unser [startChatContactAPI-Beispiel](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/cloudformationTemplates/startChatContactAPI) unter ansehen. GitHub

1. Beispiele, die zeigen, wie Sie Ihre mobile Chat-Benutzeroberfläche mit Amazon Connect Chat erstellen können SDKs, finden Sie in unserem GitHub Projekt [UI Examples](https://github.com/amazon-connect/amazon-connect-chat-ui-examples).

   Sehen Sie sich unsere Beispiel-Chat-Beispiele für [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOSChatExample) und [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/androidChatExample) an, die zeigen, wie Sie eine Chat-Anwendung mithilfe des Amazon Connect Chat SDK for iOS iOS/Android betreiben können.

1. Schauen Sie sich die GitHub Seiten [Amazon Connect Chat SDK for iOS](https://github.com/amazon-connect/amazon-connect-chat-ios) und [Amazon Connect Chat SDK for Android](https://github.com/amazon-connect/amazon-connect-chat-android) an. Die GitHub Seite enthält API-Dokumentation und eine Implementierungsanleitung, in der alle Voraussetzungen und Installationsschritte erläutert werden.

1. Einrichten der React-Native-Integration: Nutzen Sie das [React Native](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/connectReactNativeChat)-Beispiel, um Anleitungen zur Implementierung einer auf React Native basierenden Lösung zu erhalten.

1. Wenn es Fragen oder Probleme zur Einrichtung oder Verwendung des Amazon Connect Chat SDK in Ihren mobilen Anwendungen gibt, können Sie ein Problem entweder auf der Seite [Probleme mit dem Amazon Connect Chat SDK für iOS](https://github.com/amazon-connect/amazon-connect-chat-ios/issues) oder auf der Seite [Probleme mit dem Amazon Connect Chat SDK für Android](https://github.com/amazon-connect/amazon-connect-chat-android/issues) melden. Wenn es ein Problem mit den Beispielen für die Benutzeroberfläche des mobilen Chats gibt, können Sie ein Problem auf der Seite [Probleme mit Beispielen für die Benutzeroberfläche von Amazon Connect Chat](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/issues) melden.

# Aktivieren der Textformatierung für die Chat-Umgebung Ihrer Kunden in Amazon Connect
<a name="enable-text-formatting-chat"></a>

Mit der Nachrichtenformatierung von Amazon Connect können Ihre Kunden und Kundendienstmitarbeiter Chat-Nachrichten schnell Struktur und Klarheit verleihen. 

**Topics**
+ [Unterstützte Formatierungstypen](#supported-format-types)
+ [Aktivieren der Nachrichtenformatierung](#how-to-enable-message-formatting)
+ [So fügen Sie E-Mail- und Telefon-Links hinzu](#add-email-phone-links)
+ [So fügen Sie Chatbot-Nachrichten hinzu](#add-bot-messages)

## Unterstützte Formatierungstypen
<a name="supported-format-types"></a>

Mithilfe von Markdown können Sie sowohl auf der Chat-Benutzeroberfläche als auch in der Anwendung für Kundendienstmitarbeiter die folgenden Formatierungsarten angeben:
+ Fett
+ Kursiv
+ Aufzählungsliste
+ Nummerierte Liste
+ Hyperlinks
+ Emoji
+ Anlagen Folgen Sie den Anweisungen unter [Aktivieren von Anhängen in Ihrem CCP, damit Kunden und Kundendienstmitarbeiter Dateien teilen und hochladen können](enable-attachments.md), um Anlagen zu aktivieren.

## So aktivieren Sie die Nachrichtenformatierung
<a name="how-to-enable-message-formatting"></a>

1. Wenn Sie eine neue [Chat-Benutzeroberfläche](add-chat-to-website.md) erstellen, ist die Rich-Text-Formatierung standardmäßig aktiviert. Es ist keine zusätzliche Konfiguration erforderlich.

1. Um einer vorhandenen [Chat-Benutzeroberfläche](add-chat-to-website.md) Funktionen zur Textformatierung hinzuzufügen, aktualisieren Sie den [Kommunikations-Widget-Code](add-chat-to-website.md) mit dem folgenden Code, der fett hervorgehoben ist: 

   ```
       (function(w, d, x, id){
           s=d.createElement('script');
           s.src='https://your-instance-alias.my.connect.aws/connectwidget/static/amazon-connect-chat-interface-client.js';
           s.async=1;
           s.id=id;
           d.getElementsByTagName('head')[0].appendChild(s);
           w[x] =  w[x] || function() { (w[x].ac = w[x].ac || []).push(arguments) };
       })(window, document, 'amazon_connect', 'widget-id');
       amazon_connect('styles', { openChat: { color: 'white', backgroundColor: '#123456'}, closeChat: { color: 'white', backgroundColor: '#123456'} });
       amazon_connect('snippetId', 'snippet-id');
       amazon_connect('supportedMessagingContentTypes', [ 'text/plain', 'text/markdown' ]);
   ```

   Der rot hervorgehobene Code wird auf die richtigen Werte gesetzt, wenn Sie das Snippet von der Amazon Connect Konsole abrufen. Hinzuzufügen oder zu entfernen ist ausschließlich die letzte fettgedruckte Zeile für `supportedMessagingContentTypes`. 

1. Gehen Sie wie folgt vor, um Ihrer eigenen benutzerdefinierten Chat-Benutzeroberfläche (z. B. [Chat Interface](https://github.com/amazon-connect/amazon-connect-chat-interface) oder einer eigenen UI-Lösung zusätzlich zu [ChatJS](https://github.com/amazon-connect/amazon-connect-chatjs)) Textformatierungsfunktionen hinzuzufügen: 

   1. Rufen Sie die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)-API auf. Fügen Sie beim Aufrufen von `StartChatContact` den Parameter `SupportedMessagingContentTypes` hinzu, wie im folgenden Beispiel fett hervorgehoben:

      ```
      // Amazon Connect StartChatContact API
      {
          "Attributes": { 
              "string" : "string" 
          },
          "ClientToken": "string",
          "ContactFlowId": "your flow ID",
          "InitialMessage": { 
              "Content": "string",
              "ContentType": "string"
          },
          "InstanceId": "your instance ID",
          "ParticipantDetails": { 
              "DisplayName": "string"
          }
          
          // optional
         "SupportedMessagingContentTypes": [ "text/plain", "text/markdown" ]
      }
      ```

   1. Importieren Sie `chatjs` als Objekt, wie im folgenden Beispiel gezeigt:

      ```
      import "amazon-connect-chatjs";
      
      this.session = connect.ChatSession.create({
            ...
          });
      
      this.session.sendMessage({
            message: "message-in-markdown-format",
            contentType: "text/markdown"
      });
      ```

      Wenn Sie es nicht verwenden ChatJs, finden Sie in diesen Themen Informationen zum Senden von Markdown-Text über Amazon Connect APIs: [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)und [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html).

   1. Senden von Nachrichten mit Markdown Ein Beispiel für das Senden von Nachrichten finden Sie im vorherigen Codeausschnitt für den Import von `chatjs` als Objekt. Sie können einfaches Markdown zum Formatieren von Text in Chats verwenden. Wenn Sie [Chatjs bereits heute zum Senden von Klartext-Nachrichten verwenden](https://github.com/amazon-connect/amazon-connect-chatjs/blob/master/src/core/chatController.js#L66), können Sie Ihre bestehende Logik so ändern, dass Sie [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)mit `text/markdown` as aufrufen, `contentType` anstatt `text/plain` wann Sie Markdown-Nachrichten senden möchten. Achten Sie darauf, den Parameter `sendMessage` so zu aktualisieren, dass er das Markdown-Format Ihrer Nachrichten hat. Weitere Informationen finden Sie unter [Markdown Guide Basic Syntax](https://www.markdownguide.org/basic-syntax/).

   1. Implementieren Sie eine eigene Logik im UI-Paket, um Markdown-Nachrichten im Eingabebereich und im Chat-Transkript auszugeben. Wenn Sie React verwenden, können Sie [React-Markdown](https://github.com/remarkjs/react-markdown) als Referenz verwenden.

**Anmerkung**  
Funktionen zur Textformatierung stehen Kundendienstmitarbeitern nur zur Verfügung, wenn diese Features für Kunden in der Chat-Benutzeroberfläche aktiviert wurden. Wenn Textformatierung auf der kundenseitigen Chat-Benutzeroberfläche nicht unterstützt oder aktiviert wird, können Kundendienstmitarbeiter keine Nachrichten mit Textformatierung verfassen und senden.
Alle Textformatierungsfunktionen mit Ausnahme von Anhängen sind für [Schnellantworten](create-quick-responses.md) verfügbar.

## So fügen Sie E-Mail- und Telefon-Links hinzu
<a name="add-email-phone-links"></a>

Im folgenden Beispiel wird gezeigt, wie Sie Ihren Web- und Mobilanwendungen anklickbare und aufrufbare Links hinzufügen.

```
Call us today: [+1 (123) 456-7890](tel:+11234567890)
[Call Us](tel:+11234567890)
[Skype Us](callto:+91123-456-7890)
[Fax Us](fax:+91123-456-7890)
[Text Us](SMS:+91123-456-7890)
[Email Us](mailto:name@email.com)
```

## So fügen Sie Chatbot-Nachrichten hinzu
<a name="add-bot-messages"></a>

Wenn Sie Markdown für Chat-Nachrichten aktivieren, können Sie die Rich-Text-Formatierung für die folgenden Arten von Chatbot-Nachrichten verwenden:
+ Flows zum [Abspielen von Prompts](play.md)
+ Flows zum [Abrufen von Kundeneingaben](get-customer-input.md)
+ `SYSTEM_MESSAGE`
+ `Lex BOT`
+ `Third Party BOT`
+ `Lex BOT Lambda`

Die folgende Abbildung zeigt, wie Sie einen Prompt manuell in einem Ablaufblock zum [Abspielen von Prompts](play.md) aktivieren können:

![\[Bild eines Flow-Blocks und eines Prompts mit 2 Links, einem für häufig gestellte Fragen und einem für eine Telefonnummer.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-rtf-play-prompt-flow-1.png)


Die folgende Abbildung zeigt, wie Sie einen Prompt manuell in einem Ablaufblock zum [Abrufen von Kundeneingaben](get-customer-input.md) aktivieren und den Ablaufblock dann einem Amazon-Lex-Bot zuordnen:

![\[Bild eines Flow-Blocks und eines Prompts mit 2 Links, einem für häufig gestellte Fragen und einem für eine Telefonnummer.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-rtf-get-customer-flow.png)


Die folgende Abbildung zeigt, wie der Prompt in SYSTEM\$1MESSAGE und verschiedenen BOT-Nachrichtentypen angezeigt wird:

![\[Das Bild zeigt die Links „Häufig gestellte Fragen lesen“ und „Rufen Sie uns an“ in SYSTEM- und BOT-Nachrichten.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-rtf-sys-bot-messages.png)


Die folgende Abbildung zeigt, wie Sie einen Prompt in einer Bot-Absicht von Amazon Lex einrichten:

![\[Bild einer Amazon-Lex-Absicht mit einem Prompt und 2 Links, einem für häufig gestellte Fragen und einem für eine Telefonnummer.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-rtf-lex-flow.png)


Weitere Informationen zu Absichten finden Sie unter [Hinzufügen von Absichten](https://docs.aws.amazon.com/lexv2/latest/dg/add-intents.html) im *Entwicklerhandbuch zu Amazon Lex V2*. Weitere Informationen zu Lambda-Nachrichten finden Sie unter [Aktivieren benutzerdefinierter Logik mit AWS Lambda-Funktionen](https://docs.aws.amazon.com/lexv2/latest/dg/lambda.html), ebenfalls im *Amazon Lex V2 Developer Guide*.

# Aktivieren von Benachrichtigungen für Chat-Kunden in Amazon Connect
<a name="message-receipts"></a>

Sie können in Ihrer [Chat-Benutzeroberfläche](add-chat-to-website.md) „Nachricht *gesendet*“ und „Nachricht *gelesen*“ aktivieren, damit Ihre Kunden den Status der von ihnen gesendeten Nachrichten kennen. Dies bietet den Kunden Transparenz und verbessert das allgemeine Chat-Erlebnis. 

Unabhängig davon, ob Nachrichtenbestätigungen aktiviert sind, werden die Daten und Ereignisse der Nachrichtenbestätigung immer gesendet und können im Netzwerkprotokoll eingesehen werden. Das Aktivieren und Deaktivieren von Nachrichtenbestätigungen auf Ihrer Chat-Benutzeroberfläche wirkt sich nur darauf aus, ob die Empfangsbestätigungen im Protokoll des Kommunikations-Widgets angezeigt werden.

**Tipp**  
Standardmäßig sind Nachrichtenbestätigungen bereits in der [Test-Chat](chat-testing.md#test-chat)-Umgebung, im Contact Control Panel (CCP) und als [Open-Source-Beispiel für das Chat-Widget zum Herunterladen](download-chat-example.md) aktiviert.

**So aktivieren Sie den Empfang von Nachrichten in Ihrer Chat-Benutzeroberfläche**

1. Melden Sie sich auf der Amazon Connect-Admin-Website unter https://*instance name*.my.connect.aws/ an. Wählen Sie **Kommunikations-Widget anpassen**.  
![\[Die Seite mit dem Konfigurationsleitfaden, die Option zum Anpassen des Kommunikations-Widgets.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-customize-chat-window-button.png)

1. Wählen Sie **Bearbeiten** aus.  
![\[Die gespeicherte Seite zur Anpassung des Kommunikations-Widgets, die Schaltfläche „Bearbeiten“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-edit-messagereceipt.png)

1. Standardmäßig ist der **Empfang von Nachrichten** nicht aktiviert. Auf **Aktiviert** festlegen.  
![\[Die Option „Empfang von Nachrichten“ ist aktiviert.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-enable-messagereceipt.png)

Der Empfang von Nachrichten ist jetzt aktiviert. Kunden, die das Kommunikations-Widget verwenden, sehen sofort die Mitteilungen *Gesendet* und *Gelesen*. 

# Chat-Timeouts für Chat-Teilnehmer einrichten
<a name="setup-chat-timeouts"></a>

Wenn eine Chat-Konversation zwischen Kundendienstmitarbeitern und Kunden für einen bestimmten Zeitraum inaktiv war (es wurden keine Nachrichten gesendet), sollten Sie Chat-Teilnehmer möglicherweise als inaktiv betrachten und Kundendienstmitarbeiter sogar automatisch vom Chat trennen.

Zu diesem Zweck können Sie mit der Aktion sowohl Leerlauf-Timeouts als auch Timeouts für das automatische Schließen konfigurieren. [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)

**Tipp**  
In diesem Thema geht es um die Einrichtung von Chat-Timeouts für Konversationen zwischen Kunden und Kundendienstmitarbeitern. Wenn Sie nach Informationen zur Konfiguration von Chat-Timeouts für den Fall suchen, dass Kunden mit Lex interagieren, lesen Sie den Abschnitt [Konfigurierbare Timeouts für Chat-Eingaben während einer Lex-Interaktion](get-customer-input.md#get-customer-input-configurable-timeouts-chat) des Blocks [Flow-Block in Amazon Connect: Kundeneingabe abrufen](get-customer-input.md). 

**Sie können vier verschiedene Arten von Timern einstellen.**
+ Sie geben an, wie viel Zeit vergehen muss, bevor eine Aktion ausgeführt wird.
+ Jede Kombination von Timern kann verwendet werden.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/setup-chat-timeouts.html)

**Geben Sie alle Timer in Minuten an.**
+ Minimum: 2 Minuten
+ Maximum: 480 Minuten (8 Stunden)

**Timer gelten für die Rollen der Teilnehmer und für die Dauer des Chats.**
+ Sie konfigurieren Timer für Teilnehmerrollen wie Kundendienstmitarbeiter und Kunde und nicht für einzelne Teilnehmer.
+  Nachdem Sie die Timer festgelegt haben, gelten diese für die Dauer des Chats. Wenn ein Chat übertragen wird, gelten die Timer für die neue Interaktion. agent/customer 

## So funktionieren Chat-Timer
<a name="how-chat-timer-work"></a>

Timer funktionieren wie folgt:
+ Timer laufen, wenn sowohl ein Kundendienstmitarbeiter als auch ein Kunde mit dem Chat verbunden sind oder wenn ein Kunde und ein benutzerdefinierter Teilnehmer (z. B. ein benutzerdefinierter Bot) mit dem Chat verbunden sind. 
+ Die Timer beginnen, wenn ein agent/custom Teilnehmer dem Chat beitritt, und enden, wenn der agent/custom Teilnehmer den Chat verlässt.
+ Timer für Inaktivität werden vor Timern für die automatische Trennung der Verbindung ausgeführt, wenn beide für eine Rolle konfiguriert sind. Wenn beispielsweise beide Timer konfiguriert sind, startet der Timer für die automatische Trennung erst, wenn ein Teilnehmer als inaktiv eingestuft wird.
+ Wenn nur ein Timertyp für eine Rolle konfiguriert ist, wird dieser Timer sofort gestartet.
+ Wenn ein Teilnehmer zu irgendeinem Zeitpunkt eine Nachricht sendet, werden die Timer für diesen Teilnehmer zurückgesetzt. Wenn der Teilnehmer zuvor als untätig markiert wurde, wird er nun nicht mehr als untätig betrachtet.
+ Wenn einer Nachricht ein Anhang hinzugefügt wird, wird der Chat-Timer zurückgesetzt.
+  Die Konfiguration, die beim Beitritt des agent/custom Teilnehmers festgelegt wurde, gilt so lange, wie der agent/custom Teilnehmer im Chat bleibt. Wenn Sie die Timer-Konfiguration aktualisieren, während ein agent/custom Teilnehmer und ein Kunde bereits miteinander verbunden sind, wird die neue Konfiguration gespeichert, aber erst angewendet, wenn ein neuer agent/custom Teilnehmer eine Verbindung zum Chat herstellt.
+ Wenn eine automatische Verbindungstrennung erfolgt, wird die Verbindung aller Teilnehmer (z. B. des Kundendienstmitarbeiters, aller teilnehmenden Supervisors oder der benutzerdefinierten Teilnehmer) außer der des Kunden getrennt. Wenn der Kundendienstmitarbeiter die Verbindung unterbrochen hat und ein Block [Set disconnect flow (TrennungsFlow festlegen)](set-disconnect-flow.md) konfiguriert wurde, wird der Chat dorthin weitergeleitet.

### Ablauf des Leerlauf-Timers
<a name="idle-timer-expiry"></a>

Folgendes passiert, wenn ein Leerlauf-Timer während einer Interaktion zwischen einem Kunden und einem benutzerdefinierten Teilnehmer abläuft: 

1. Ein Ereignis im Leerlauf wird auf alle websockets/streaming Endgeräte übertragen.

1. Wenn ein Timer für die automatische Trennung konfiguriert ist, wird er gestartet. 

1. Wenn der Leerlauf-Timer abläuft, während sich der Chat-Kontakt in einem **Warte**-Block befindet, wird der Kontakt NICHT zur Verzweigung **Zeit abgelaufen** weitergeleitet. Wenn dieses Szenario eintritt, wird keine Aktion durchgeführt. 

### Automatisches Trennen der Verbindung von benutzerdefinierten Teilnehmern
<a name="auto-disconnecting"></a>

Wenn ein Timer für die automatische Trennung abläuft, wird der benutzerdefinierte Teilnehmer vom Chat getrennt. 

Amazon Connect führt einen der folgenden Schritte durch, wenn die Timer für die automatische Trennung ablaufen:

1. Der Chat befindet sich derzeit in einem [Wait](wait.md)-Block, der für einen benutzerdefinierten Teilnehmer konfiguriert ist. 
   + Der benutzerdefinierte Teilnehmer wird vom Chat getrennt. Der Chat setzt den Gesprächsablauf über die Verzweigung **Bot-Teilnehmer getrennt** fort.

1. Der Chat befindet sich derzeit in einem [Wait](wait.md)-Block, der für den Kunden konfiguriert ist, ODER der Chat befindet sich nicht in einem **Warte**-Block.
   + Der benutzerdefinierte Teilnehmer wird vom Chat getrennt und es werden keine weiteren Aktionen ausgeführt. 

## Den Teilnehmern angezeigte Nachrichten
<a name="chat-timeouts-events"></a>

Es werden allen Teilnehmern Nachrichten angezeigt, wenn eines der folgenden Ereignisse eintritt:
+ Ein Teilnehmer wird inaktiv.
+ Ein inaktiver Teilnehmer sendet eine Nachricht und ist daher nicht mehr inaktiv.
+ Es erfolgt eine automatische Trennung. Da der Kundendienstmitarbeiter nicht verbunden ist, kann er die Nachricht nicht sehen.

Diese Ereignisse werden weder in den Protokollen gespeichert noch in Rechnung gestellt.

Standardnachrichten (in allen unterstützten Sprachen) werden den Kundendienstmitarbeitern im Contact Control Panel (CCP) für jedes dieser Ereignisse angezeigt. 

Die folgende Abbildung zeigt Beispiele für Standardmeldungen, die Kundendienstmitarbeitern im CCP angezeigt werden. Beispiel: *Kundendienstmitarbeiter ist inaktiv*.

![\[Das CCP, die Standardmeldung bei Inaktivität.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chat-timeout-message.png)


## Empfohlene Verwendung
<a name="chat-timeouts-usage"></a>

Um die Timeout-Feature für Chats zu verwenden, empfehlen wir außerdem Folgendes:

1. Betten Sie einen Call to the [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)Action in einem Lambda in einen Kontaktablauf ein.

1. Platzieren Sie das Lambda je nach Anwendungsfall entweder unmittelbar nach dem Start des Chats (am Anfang des Flows) oder kurz bevor Sie den Kontakt in eine Warteschlange weiterleiten.

## Individuelle Anpassung der Chat-Benutzeroberfläche des Kunden bei Verbindungstrennung
<a name="chat-timeouts-ui"></a>

Sie können die Chat-Benutzeroberfläche Ihres Kunden bei einer Verbindungstrennung anpassen. Sehen Sie sich dazu die folgenden Methoden in [ChatJS](https://github.com/amazon-connect/amazon-connect-chatjs) an:
+ `onParticipantIdle(callback)`
+ `onParticipantReturned(callback)`
+ `onAutoDisconnection(callback)`

Verwenden Sie diese Methoden zum Registrieren von Callback-Handlern, die beim Eintreffen neuer Ereignisse ausgelöst werden.

# Aktivieren von Push-Benachrichtigungen für den mobilen Chat
<a name="enable-push-notifications-for-mobile-chat"></a>

Push-Benachrichtigungen für den mobilen Chat werden über [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html) konfiguriert. Sie können Push-Benachrichtigungen für den mobilen Chat auf iOS- oder Android-Geräten aktivieren, sodass Sie Kunden auch dann über neue Nachrichten informieren können, wenn diese Ihre mobile Anwendung nicht aktiv verwenden. Sie können diese Funktion in Ihrer vorhandenen App aktivieren, die in das [Amazon Connect Handy](https://docs.aws.amazon.com/connect/latest/adminguide/integrate-chat-with-mobile.html) integriert ist SDKs, einer [Webview-Lösung](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples) oder einer benutzerdefinierten nativen Lösung. 

 Die folgenden Schritte und Ressourcen helfen Ihnen beim Einstieg in die Integration von Amazon Connect Push-Benachrichtigungen in Ihre nativen mobilen Anwendungen: 

## Schritt 1: Besorgen Sie sich die Anmeldeinformationen von der FCM-Konsole von Apple APNs und Google
<a name="step-1-enable-push-notifications-for-mobile-chat"></a>

Um es Amazon Connect so einzurichten, dass Push-Benachrichtigungen an Ihre Apps gesendet werden können, müssen Sie zunächst Anmeldeinformationen von der FCM-Konsole von Apple APNs und Google abrufen, damit [AWS End User Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html) Benachrichtigungen an Ihre mobilen Anwendungen senden kann. Welche Anmeldeinformationen Sie angeben, hängt davon ab, welches Push-Benachrichtigungssystem Sie verwenden: 
+  Informationen zu den Anmeldedaten für den Apple Push Notification Service (APNs) finden Sie in der Apple Developer-Dokumentation unter Einen [Verschlüsselungsschlüssel und eine Schlüssel-ID von Apple](https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Obtain-an-encryption-key-and-key-ID-from-Apple) [beziehen und Ein Anbieterzertifikat von](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns#Obtain-a-provider-certificate-from-Apple) Apple beziehen. 
+  Die Anmeldeinformationen für Firebase Cloud Messaging (FCM) von Google können über die Firebase-Konsole abgerufen werden, siehe [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging). 

## Schritt 2: Erstellen Sie mithilfe der AWS Konsole eine Messaging-Dienstanwendung für AWS Endbenutzer und aktivieren Sie den Push-Benachrichtigungskanal für FCM oder APNs
<a name="step-2-enable-push-notifications-for-mobile-chat"></a>

 Bevor Sie Amazon Connect für das Senden von Push-Benachrichtigungen aktivieren können, müssen Sie zunächst [eine Anwendung von AWS End User Messaging erstellen und den Push-Benachrichtigungskanal](https://docs.aws.amazon.com/push-notifications/latest/userguide/procedure-enable-push.html) in der [AWS -Konsole](https://console.aws.amazon.com/push-notifications/) aktivieren.

 Folgen Sie diesen Anweisungen, um eine Anwendung zu erstellen und einen der Push-Kanäle zu aktivieren. Zum Abschließen dieses Verfahrens müssen Sie nur einen Anwendungsnamen eingeben. Sie können alle Push-Kanäle zu einem späteren Zeitpunkt aktivieren oder deaktivieren: 

1.  Öffnen Sie die AWS Endbenutzer-Nachrichten-Push-Konsole unter [https://console.aws.amazon.com/push-notifications/](https://console.aws.amazon.com/push-notifications/) 

1.  Wählen Sie **Create application** aus. 

1.  Geben Sie unter **Anwendungsname** den Namen Ihrer Anwendung ein. 

1.  (Optional) Folgen Sie diesem optionalen Schritt, um den **Apple Push-Benachrichtigungsdienst zu aktivieren (APNs)**. 

   1.  Wählen Sie für den **Apple Push Notification Service (APNs)** die Option **Aktivieren** aus. 

   1.  Wählen Sie für **Standard-Authentifizierungstyp** eine der folgenden Optionen aus: 

      1.  Wenn Sie „**Schlüsseldaten**“ wählen, geben Sie die folgenden Informationen aus Ihrem Apple-Entwicklerkonto ein. AWS End User Messaging Push benötigt diese Informationen, um Authentifizierungstoken zu erstellen. 

         1.  **Schlüssel-ID** – Die Ihrem Signaturschlüssel zugeordnete ID. 

         1.  **Bundle-ID** – Die Ihrer iOS-App zugeordnete ID. 

         1.  **Team-ID** – Die Ihrem Apple-Developer-Kontoteam zugewiesene ID. 

         1.  **Authentifizierungsschlüssel** – Die .p8-Datei, die Sie von Ihrem Apple-Developer-Konto herunterladen, wenn Sie einen Authentifizierungsschlüssel erstellen. 

      1.  Wenn Sie die Option **Certificate credentials (Zertifikatanmeldeinformationen)** auswählen, geben Sie die folgenden Informationen an: 

         1.  **SSL certificate** (SSL-Zertifikat) – Die .p12-Datei für Ihr TLS-Zertifikat. 

         1.  **Zertifikatpasswort** – Wenn Sie Ihrem Zertifikat ein Passwort zugewiesen haben, geben Sie es hier ein. 

         1.  **Typ des Zertifikats** – Wählen Sie den zu verwendenden Zertifikattyp aus. 

1.  (Optional) Folgen Sie diesem optionalen Schritt, um **Firebase Cloud Messaging (FCM**) zu aktivieren. 

   1.  Wählen Sie für **Firebase Cloud Messaging (FCM**) die Option **Aktivieren** aus. 

   1.  Wählen Sie **Token-Anmeldeinformationen** für den **Standardauthentifizierungstyp** und dann Ihre Service-JSON-Datei aus. 

1.  Wählen Sie **Create application** aus. 

## Schritt 3: Ordnen Sie die AWS End User Messaging-Anwendung einer Amazon Connect Instanz zu
<a name="step-3-enable-push-notifications-for-mobile-chat"></a>

 Um Push-Benachrichtigungen auf einer [Amazon Connect Instanz](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) zu aktivieren, müssen Sie eine AWS Endbenutzer-Messaging-Anwendung mit einer [Amazon Connect Instanz](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html) verknüpfen, indem Sie die [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)API mit der aufrufen `PINPOINT_APP` [IntegrationType](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html#API_CreateIntegrationAssociation_RequestSyntax). Sie können diese API mit der [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/connect/create-integration-association.html) oder dem [Amazon Connect SDK](https://aws.amazon.com/developer/tools/) für alle unterstützten Sprachen aufrufen. Dies ist ein einmaliger Onboarding-Schritt, der für jede Integration zwischen einer AWS Endbenutzer-Messaging-Anwendung und einer Amazon Connect Instanz erforderlich ist. 

## Schritt 4: Holen Sie sich das Geräte-Token mit FCM oder APNs SDK und registrieren Sie es bei Amazon Connect
<a name="step-4-enable-push-notifications-for-mobile-chat"></a>

Sie müssen das Geräte-Token abrufen und damit ein Endbenutzer-Mobilgerät mit einem Amazon Connect Chat-Kontakt registrieren, um Push-Benachrichtigungen für neue Nachrichten im Chat zu senden. In der folgenden FCM/APNs Entwicklerdokumentation erfahren Sie, wie das Geräte-Token generiert und von der mobilen Anwendung abgerufen wird.
+  Informationen zum Apple Push Notification Service (APN) finden Sie unter [App registrieren bei APNs](https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns) in der Apple-Dokumentation für Entwickler.
+  Informationen zu Firebase Cloud Messaging (FCM) finden Sie unter [Bewährte Methoden für die Verwaltung von FCM-Registrierungstoken](https://firebase.google.com/docs/cloud-messaging/manage-tokens).

 Wir empfehlen folgende Schritte, um das Gerät mit einem Chat-Kontakt zu registrieren: 

1.  Wenn die mobile Anwendung die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API aufruft, übergeben Sie die [Kontaktattribute `deviceToken`](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes) und`deviceType`. Weitere Informationen für Benutzer von Webview und gehosteten Kommunikations-Widgets finden Sie unter [So übergeben Sie Kontaktattribute an das Kommunikations-Widget](https://docs.aws.amazon.com/connect/latest/adminguide/pass-contact-attributes-chat.html#how-to-contact-attributes-chatwidget).

1.  Betten Sie einen Aufruf zur [CreatePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)Aktion in eine Lambda-Funktion in einen Kontaktablauf ein. Der Flow-Block sollte `deviceToken` sowie `deviceType` aus den benutzerdefinierten Kontaktattributen und die `initialContactId` aus den Systemattributen lesen und diese Werte dann an die Lambda-Funktion übergeben.

   1.  Platzieren Sie die Lambda-Funktion je nach Anwendungsfall entweder unmittelbar nach dem Start des Chats (am Anfang des Ablaufs), wenn Sie möchten, dass der Endbenutzer Push-Benachrichtigungen sofort erhält, oder kurz bevor Sie den Kontakt in eine Warteschlange weiterleiten, sodass er den Kontakt nur dann erhält, wenn der Kundendienstmitarbeiter dem Chat beitreten möchte. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät Push-Benachrichtigungen, wenn eine neue Nachricht vom Kundendienstmitarbeiter oder System eingeht. Standardmäßig werden Push-Benachrichtigungen für alle System- und Kundendienstmitarbeiter-Nachrichten gesendet.  
![\[Rufen Sie den Lambda-Funktionsablaufblock im Flow-Designer der Admin-Website von Amazon Connect auf.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/step-4-set-up-push-notifications-for-mobile-chat-1.png)

1.  (optional) Betten Sie einen Aufruf der [DeletePushNotificationRegistration](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)Aktion in eine Lambda-Funktion in einen Flow ein. Sobald der API-Aufruf erfolgt ist, empfängt das Gerät keine Push-Benachrichtigungen mehr, wenn eine neue Nachricht vom Kundendienstmitarbeiter oder System eingeht.

## Schritt 5: Empfangen von Push-Benachrichtigungen in Ihren mobilen Anwendungen
<a name="step-5-enable-push-notifications-for-mobile-chat"></a>

 Schauen Sie sich unser Projekt mit den [Beispielen für Amazon Connect Chat-Benutzeroberflächen](https://github.com/amazon-connect/amazon-connect-chat-ui-examples) an und sehen Sie sich unsere Beispielbeispiele für Chat-Webviews für [iOS](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/iOS-WKWebView-sample) und [Android](https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/mobileChatExamples/android-webview-sample) an, die zeigen, wie Sie das Onboard integrieren Amazon Connect APIs und Push-Benachrichtigungen empfangen können.

## Überwachen Ihrer Nutzung von Push-Benachrichtigungen
<a name="monitor-your-usage-for-push-notification"></a>

 Damit die Zuverlässigkeit, Verfügbarkeit und Leistung Ihrer Push-Benachrichtigungen sichergestellt werden, ist es wichtig, deren Nutzung zu überwachen. Sie können diese Informationen über mehrere Kanäle verfolgen: 

1.  AWS bietet umfassende Überwachungstools für Push-Benachrichtigungen. Weitere Informationen finden Sie unter [Überwachung von Push-Nachrichten für AWS Endbenutzer](https://docs.aws.amazon.com/push-notifications/latest/userguide/monitoring-overview.html). 

1.  Je nachdem, welchen Push-Benachrichtigungsservice Sie verwenden, können Sie über die jeweiligen Konsolen auf zusätzliche Nutzungsdaten zugreifen. 

   1.  Firebase Cloud Messaging (FCM): In der FCM-Dokumentation zum Thema [Grundlegendes zur Nachrichtenzustellung](https://firebase.google.com/docs/cloud-messaging/understand-delivery?platform=android) finden Sie Einblicke in Ihre FCM-Nutzung. 

   1.  Apple-Push-Benachrichtigungsdienst (APNs): Lesen Sie in der APNs Dokumentation nach, wie Sie [den Status von Push-Benachrichtigungen mithilfe von Metriken anzeigen und APNs](https://developer.apple.com/documentation/usernotifications/viewing-the-status-of-push-notifications-using-metrics-and-apns) Ihren Benachrichtigungsstatus überwachen können. 

# Zulassen, dass Kunden Chat-Konversationen in Amazon Connect fortsetzen
<a name="chat-persistence"></a>

Kunden beginnen häufig einen Chat, verlassen dann das Gespräch und kehren später zurück, um den Chat fortzusetzen. Dies kann im Laufe mehrerer Tage, Monate oder sogar Jahre mehrmals vorkommen. Um solche Chats mit langer Laufzeit zu unterstützen, aktivieren Sie den dauerhaften Chat. 

Mit dem dauerhaften Chat können Kunden frühere Gespräche fortsetzen, wobei der Kontext, die Metadaten und die Transkripte übernommen werden. Sie müssen sich nicht wiederholen, wenn sie zu einem Chat zurückkehren, und die Kundendienstmitarbeiter haben Zugriff auf den gesamten Konversationsverlauf. 

## Chat-Weiterführung
<a name="rehydration"></a>

Nachhaltiger Chat wird durch einen Prozess erreicht, der als Chat-Weiterführung bezeichnet wird. Dieser Prozess ermöglicht es, Chat-Transkripte von früheren Chat-Kontakten abzurufen und anzuzeigen. Er ermöglicht Kunden und Kundendienstmitarbeiter, Konversationen einfach dort fortzusetzen, wo sie aufgehört haben.

**Wichtig**  
Nur beendete Chat-Sitzungen dürfen in einer neuen Chat-Sitzung weitergeführt werden, da die Transkriptgenerierung asynchron erfolgt.   
Benutzer sollten 30–60 Sekunden warten, bevor sie versuchen, einen zuvor beendeten Chat weiterzuführen.

Amazon Connect unterstützt zwei Arten der Rehydratation:
+ `ENTIRE_PAST_SESSION`: Startet eine neue Chat-Sitzung und führt alle Chat-Segmente aus vergangenen Chat-Sitzungen weiter.
+ `FROM_SEGMENT`: Startet eine neue Sitzung und führt den Inhalt des angegebenen vergangenen Chat-Segments weiter.

Anwendungsfälle, die diese verschiedenen Weiterführungsmodi zeigen, finden Sie beispielsweise unter [Beispielanwendungsfälle](#persistentchatscenario).

## RelatedContactId
<a name="relatedcontactid"></a>

Ein neuer Kontakt kann über die `RelatedContactId` mit einem vorhandenen Kontakt verknüpft werden. Dieser neue Kontakt enthält eine Kopie der [Kontakteigenschaften](connect-attrib-list.md) des zugehörigen Kontakts.

Weitere Informationen dazu, wie die `RelatedContactId` in Kontaktdatensätzen modelliert ist, finden Sie unter [Datenmodell für Amazon-Connect-Kontaktdatensätze](ctr-data-model.md).

Bei einem dauerhaften Chat stellt die `RelatedContactId` die `contactId` dar, die für die Weiterführung des Chats verwendet wird.

## So aktivieren Sie den dauerhaften Chat
<a name="enable-persistent-chat"></a>

Es gibt zwei Möglichkeiten, den nachhaltigen Chat zu aktivieren:
+ Geben Sie beim Erstellen eines neuen Chats eine vorherige Kontakt-ID an. Detaillierte Anweisungen finden Sie unter [Aktivieren des nachhaltigen Chats, wenn Sie einen neuen Chat-Kontakt erstellen](#enable-persistent-chat-creating-new-chat-contact).
+ Fügen Sie den Block [Dauerhafte Kontaktverknüpfung erstellen](create-persistent-contact-association-block.md) einem Ablauf hinzu. Detaillierte Anweisungen finden Sie unter [Aktivieren von nachhaltigem Chat innerhalb eines Ablaufs](#enable-persistent-chat-within-contact-flow).

**Anmerkung**  
Sie können nur eine der beiden Methoden verwenden, um Chats dauerhaft zu speichern. Beispielsweise können Sie die Persistenz einer `SourceContactID` für einen neuen Chat nur einmal aktivieren.

Zum Bereitstellen nachhaltiger Chat-Umgebungen müssen Sie eine vorherige Kontakt-ID angeben, wenn Sie einen neuen Chat starten oder wenn Sie den Flow-Block [Dauerhafte Kontaktverknüpfung erstellen](create-persistent-contact-association-block.md) verwenden. Dies wird nicht automatisch für Sie erledigt. Wir empfehlen, ein Repository zum Speichern von Kontaktdatensatzdaten zu erstellen. Das Repository ermöglicht den Abruf dieser Daten für jeden Ihrer Kunden. 

 Es gibt zwei Möglichkeiten, Einträge in einem Repository zu erstellen: 
+ Verwenden Sie das [Streaming von Chat-Nachrichten](https://docs.aws.amazon.com/connect/latest/adminguide/chat-message-streaming.html), um einen Eintrag zu erstellen, wenn ein Chat beendet ist.
+ Sehen Sie sich [Kontaktereignisse](https://docs.aws.amazon.com/connect/latest/adminguide/contact-events.html#contact-events-data-model) an und verwenden Sie die [Funktion von AWS Lambda](https://docs.aws.amazon.com/connect/latest/adminguide/connect-lambda-functions.html) zum Erstellen von Einträgen in Ihrem Repository. 

Nachdem ein Repository eingerichtet wurde, können Sie die vorherige Kontakt-ID für den Kunden abrufen und sie angeben, wenn Sie einen neuen Chat starten oder im Flow-Block [Dauerhafte Kontaktzuordnung](create-persistent-contact-association-block.md).

Stellen Sie außerdem sicher, dass frühere Chat-Transkripte aus dem Amazon-S3-Bucket Ihrer Instance abgerufen werden können. Die beiden folgenden Umstände verhindern, dass Amazon Connect Transkripte abruft und Chats fortgeführt werden:
+ Sie verwenden mehrere Chat-Transkript-Buckets.
+ Sie ändern den Namen der Chat-Transkriptdatei, die von Amazon Connect generiert wird.

### Aktivieren des nachhaltigen Chats, wenn Sie einen neuen Chat-Kontakt erstellen
<a name="enable-persistent-chat-creating-new-chat-contact"></a>

Um beim Erstellen eines neuen Chat-Kontakts dauerhafte Chat-Erlebnisse einzurichten, geben Sie den vorherigen `SourceContactId` Wert `contactId` im [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API-Parameter an. Dadurch können die Chat-Transkripte früherer Kontakte weitergeführt werden. Die Transkripte werden im Chat sowohl dem Kunden als auch dem Kundendienstmitarbeiter angezeigt. Ein Beispiel finden Sie unter [Beispielanwendungsfälle](#persistentchatscenario).

### Aktivieren von nachhaltigem Chat innerhalb eines Ablaufs
<a name="enable-persistent-chat-within-contact-flow"></a>

So richten Sie nachhaltige Chat-Erlebnisse in einem Ablauf ein:

1. Nachdem ein Chat-Kontakt erstellt wurde, fügen Sie Ihrem Ablauf den Block [Dauerhafte Kontaktverknüpfung erstellen](create-persistent-contact-association-block.md) hinzu.

1. Verwenden Sie ein benutzerdefiniertes Attribut, um eine Quellkontakt-ID anzugeben.

Alternativ können Sie die [CreatePersistentContactAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePersistentContactAssociation.html)API verwenden, um eine Quellkontakt-ID anzugeben, um den aktuellen Chat dauerhaft zu machen.

Die Weiterführung beginnt, nachdem der Chat gestartet wurde, wenn der Flow-Block oder die API verwendet wird. Wenn die Weiterführung abgeschlossen ist, wird ein Ereignis ausgelöst, das Sie darüber informiert, dass die Weiterführung abgeschlossen ist.

## Beispielanwendungsfälle
<a name="persistentchatscenario"></a>

Ein Kunde startet beispielsweise eine Chat-Sitzung:

1. Kundendienstmitarbeiter a1 akzeptiert den Chat und das Gespräch zwischen dem Kunden und dem Kundendienstmitarbeiter a1 beginnt. Dies ist der erste Kontakt, der in der aktuellen Chat-Sitzung erstellt wurde. Die `contactId` **C1** könnte beispielsweise 11111111-aaaa-bbbb-1111-1111111111111 lauten. 

1. Kundendienstmitarbeiter a1 leitet den Chat dann an Kundendienstmitarbeiter a2 weiter. Dadurch wird ein weiterer Kontakt erstellt. Die `contactId` **C2** könnte beispielsweise 2222222-aaaa-bbbb-2222-222222222222222 lauten. 

1. Der Kundendienstmitarbeiter a2 beendet den Chat.

1. Der Kunde wird für eine Umfrage nach dem Chat, bei der ein weiterer Kontakt erstellt wird, in den VerbindungstrennungsFlow weitergeleitet. Die `contactId` **C3** könnte beispielsweise 33333333-aaaa-bbbb-3333333333333 lauten.

1. Die Umfrage nach dem Chat wird angezeigt und die Chat-Sitzung wird beendet. 

1. Später kehrt der Kunde zurück und möchte seine vergangene Chat-Sitzung fortsetzen.

An dieser Stelle gibt es potenziell zwei verschiedene Anwendungsfälle für den Kunden. Im Folgenden finden Sie die Anwendungsfälle für dauerhafte Chats, die der Kunde haben kann, und wie Sie die Amazon Connect für deren Bereitstellung konfigurieren.

### Anwendungsfall 1
<a name="persistentchatscenario-usecase1"></a>

Der Kunde möchte seine vergangene Chat-Sitzung fortsetzen, möchte aber die Umfrage nach dem Chat ausblenden. Verwenden Sie in diesem Fall die folgende Konfiguration, um das zu erreichen. 

**Anfrage:**

```
PUT /contact/chat HTTP/1.1
Content-type: application/json
{
   "Attributes": { 
      "string" : "string" 
   },
   "ContactFlowId": "string",
   "InitialMessage": { 
      "Content": "string",
      "ContentType": "string"
   },
   "InstanceId": "string",
   ... // other chat fields
     
   // NEW Attribute for persistent chat 
   "PersistentChat" : {
       "SourceContactId":"2222222-aaaa-bbbb-2222-222222222222222" 
       "RehydrationType":"FROM_SEGMENT"
   }
}
```

#### Konfiguration
<a name="usecase1-configuration"></a>
+ SourceContactId = 2222222-aaaa-bbbb-2222-2222222222222 (die contactId für C2)
+ RehydrationType = "`FROM_SEGMENT`"

#### Erwartetes Verhalten
<a name="usecase1-behavior"></a>
+ Diese Konfiguration startet eine dauerhafte Chat-Sitzung mit dem angegebenen beendeten Kontakt C2 (z. B. 2222222-aaaa-bbbb-2222-22222222222222222). 

  Transkripte der vergangenen Chat-Sitzungen C2 (2222222-aaaa-bbbb-2222-2222222222222) und C1 (11111111-aaaa-bbbb-1111-1111111111111) sind in der aktuellen dauerhaften Chat-Sitzung zugänglich. Beachten Sie, dass das Chat-Segment C3 (33333333-aaaa-bbbb-3333-3333333333333) aus der dauerhaften Chat-Sitzung gelöscht wird.
+ In diesem Fall gibt die Antwort C2 (2222222-aaaa-bbbb-2222-222222222222222) als "“ zurück. [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)ContinuedFromContactId
+ Die `RelatedContactId` für diese dauerhafte Chat-Sitzung lautet 2222222-aaaa-bbbb-222222222222222 (C2).

### Anwendungsfall 2
<a name="persistentchatscenario-usecase2"></a>

Der Kunde möchte die vergangene Chat-Sitzung fortsetzen und das Transkript des gesamten vergangenen Gesprächs sehen. Außerdem möchte er die Umfrage nach dem Chat nicht verstecken. Verwenden Sie in diesem Fall die folgende Konfiguration, um das zu erreichen. 

**Anmerkung**  
 Geben Sie für den `ENTIRE_PAST_SESSION`-Weiterführungstyp den ersten Kontakt (ursprüngliche `contactId`) der letzten Chat-Sitzung als `SourceContactId`-Attribut an.

**Anfrage:**

```
PUT /contact/chat HTTP/1.1
Content-type: application/json
{
   "Attributes": { 
      "string" : "string" 
   },
   "ContactFlowId": "string",
   "InitialMessage": { 
      "Content": "string",
      "ContentType": "string"
   },
   "InstanceId": "string",
   ... // other chat fields
     
   // NEW Attribute for persistent chat 
   "PersistentChat":{
        "SourceContactId":"11111111-aaaa-bbbb-1111-1111111111111" // (first contactId C1)
        "RehydrationType":"ENTIRE_PAST_SESSION"
   }
}
```

#### Konfiguration
<a name="usecase2-configuration"></a>
+ SourceContactId = (C1) `11111111-aaaa-bbbb-1111-1111111111111`
+ RehydrationType = „E`NTIRE_PAST_SESSION`“

#### Erwartetes Verhalten
<a name="usecase2-behavior"></a>
+ Dadurch wird eine dauerhafte Chat-Sitzung mit dem zuletzt beendeten Chat-Kontakt (C3) gestartet. Transkripte der vergangenen Chat-Sitzungen C3, C2 und C1 sind in der aktuellen dauerhaften Chat-Sitzung zugänglich.
+ In diesem Fall gibt die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)Antwort 33333333-aaaa-bbbb-333333333333333 (C3) als "“ zurück. ContinuedFromContactId
+ Die `RelatedContactId` für diese dauerhafte Chat-Sitzung lautet 33333333-aaaa-bbbb-3333-3333333333333 (C3).

**Anmerkung**  
Chat-Verknüpfungen sind kumulativ. Nachdem die Chat-Sitzungen verknüpft wurden, werden sie übertragen.  
Wird zum Beispiel ein Kontakt (`contactId` C2), der zu einer vergangenen Chat-Sitzung gehört, mit einem Kontakt (`contactId` C1) aus einer anderen vergangenen Chatsitzung verknüpft, dann führt eine neue dauerhafte Chat-Sitzung, die durch die Verknüpfung von C2-Ergebnissen erstellt wird, auch zu einer impliziten Verknüpfung von C1. Die neue dauerhafte Chat-Sitzung wird die folgende Verknüpfung haben: C3 → C2 → C1  
Die vorherige contactId, von der aus die persistente Chat-Sitzung fortgesetzt wird, wird in dem `ContinuedFromContactId` Feld in der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API-Antwort angezeigt. Sie befindet sich auch im [Kontaktdatensatz](ctr-data-model.md#ctr-ContactTraceRecord) für den Kontakt im RelatedContactId-Feld

## So greifen Sie auf das Transkript früherer Chat-Kontakte für einen dauerhaften Chat zu
<a name="access-past-chat-transcript"></a>

Beim Zugriff auf das Transkript eines vergangenen Chats für einen dauerhaften Chat wird das bestehende `NextToken`-Paginierungs-Modell verwendet. Der erste Aufruf einer neu gestarteten persistenten Chat-Sitzung enthält ein `NextToken` in der Antwort, falls frühere Chat-Nachrichten vorhanden sind. [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html) `NextToken`muss verwendet werden, um auf das Protokoll des letzten Chats zuzugreifen und beim nachfolgenden [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)Anruf `BACKWARD` auf `ScanDirection` zu setzen, um vergangene Chat-Nachrichten abzurufen. 

Wenn es mehrere vergangene Chat-Nachrichten gibt, wird ein neuer [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)zurückgegeben `NextToken` und derselbe Vorgang kann wiederholt werden, um weitere Chat-Transkripte abzurufen.

## Nicht unterstützt: Die Verwendung von – `StartPosition`und `contactId`-Filtern für dauerhafte Chats
<a name="startposition"></a>

Amazon Connect unterstützt nicht die Verwendung `StartPosition` und `contactId` Filterung von Attributen von [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)Abmeldelementen, die aus dem vergangenen Chat stammen, beim Anruf. 

# Aktivieren des Echtzeit-Streamings von Chat-Nachrichten in Amazon Connect
<a name="chat-message-streaming"></a>

Amazon Connect Chat bietet Ihnen [APIs](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html)die Möglichkeit, einen Echtzeit-Stream von Chat-Nachrichten zu abonnieren. Mit diesen APIs können Sie: 
+ APIs verwenden, um Nachrichten in Echtzeit zu streamen, wenn ein neuer Chat-Kontakt erstellt wird.
+ die aktuelle Funktion von Amazon-Connect-Chats erweitern, um Anwendungsfälle wie den Aufbau von Integrationen mit SMS-Lösungen und Messaging-Anwendungen von Drittanbietern, die Aktivierung von mobilen Push-Benachrichtigungen und die Erstellung von Analyse-Dashboards zur Überwachung und Nachverfolgung von Chat-Nachrichtenaktivitäten zu unterstützen. 

**Anmerkung**  
Auf dieser Seite wird beschrieben, wie Sie einen SNS-Endpunkt abonnieren, um Chat-Nachrichten in Amazon Connect in Echtzeit zu streamen. Wenn Sie versuchen, Nachrichtenstreaming für Konversations-AI-Interaktionen in Amazon Connect zu aktivieren, finden Sie weitere Informationen unter[Nachrichtenstreaming für KI-gestützten Chat aktivieren](message-streaming-ai-chat.md).

## Wie funktioniert das Nachrichten-Streaming APIs
<a name="how-chat-message-streaming-apis-work"></a>

Das [Amazon Connect-Nachrichtenstreaming APIs](https://docs.aws.amazon.com/connect/latest/APIReference/Welcome.html) wird ausgelöst, wenn bestimmte Ereignisse innerhalb eines Amazon Connect Chat-Kontakts auftreten. Sendet ein Kunde beispielsweise eine neue Chat-Nachricht, so sendet das Ereignis eine [Nutzlast](sns-payload.md) an einen bestimmten Endpunkt, die Daten über die gerade gesendete Nachricht enthält. Nachrichten werden mithilfe des [Amazon-Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/welcome.html) (Amazon SNS) an einem bestimmten Endpunkt veröffentlicht. 

In diesem Thema wird beschrieben, wie Sie Nachrichtenstreaming in Echtzeit mithilfe von Amazon Connect und Amazon SNS einrichten. Die Schritte sind: 

1. Verwenden Sie die Amazon SNS-Konsole, um ein neues Standard-SNS-Thema zu erstellen und die Nachrichten einzurichten.

1. Rufen Sie die [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API auf, um den Chat-Kontakt zu initiieren.

1. Rufen Sie die [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html)API auf, um das Nachrichtenstreaming zu initiieren. 

1. Rufen Sie die [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)API auf, um die Verbindung des Teilnehmers herzustellen.

## Schritt 1: Erstellen Sie ein Standard-SNS-Thema.
<a name="step1-chat-streaming"></a>

1. Rufen Sie die Amazon SNS-Konsole auf. 

1. [Erstellen Sie ein SNS-Thema](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) in Ihrem AWS Konto. Wählen Sie im Abschnitt **Details** für **Typ** die Option **Standard** aus, geben Sie einen Namen für das Thema ein und wählen Sie dann **Thema erstellen** aus.
**Anmerkung**  
Derzeit unterstützt das Nachrichten-Streaming APIs nur Standard-SNS für das Echtzeit-Streaming von Nachrichten. Sie unterstützen keine [Amazon SNS FIFO-Themen (First in, First out)](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html). 

1. Nachdem Sie das Thema erstellt haben, wird sein Amazon-Ressourcenname (ARN) im Abschnitt **Details** angezeigt. Kopieren Sie das Thema ARN in die Zwischenablage. Sie verwenden das Thema ARN im nächsten Schritt und in [Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt](#step3-chat-streaming). 

   Das Thema ARN sieht ähnlich wie im folgenden Beispiel aus: 

   ```
   arn:aws:sns:us-east-1:123456789012:MyTopic                                
   ```

1. Wählen Sie die Registerkarte **Zugriffsrichtlinie**, wählen Sie **Bearbeiten** und fügen Sie dann eine ressourcenbasierte Richtlinie zum SNS-Thema hinzu, sodass Amazon Connect die Erlaubnis hat, dort zu veröffentlichen. Im Folgenden finden Sie ein Beispiel für eine SNS-Richtlinie, die Sie in den JSON-Editor einfügen und dann mit Ihren Werten anpassen können: 

------
#### [ JSON ]

****  

   ```
   {
      "Version":"2012-10-17",		 	 	 
      "Statement":[
         {
            "Effect":"Allow",
            "Principal":{
               "Service":"connect.amazonaws.com"
            },
            "Action":"sns:Publish",
            "Resource":"arn:aws:sns:us-east-1:111122223333:TopicName",
            "Condition":{
               "StringEquals":{
                   "aws:SourceAccount":"111122223333"
               },
               "ArnEquals":{
               "aws:SourceArn":"arn:aws:connect:us-east-1:111122223333:instance/InstanceId"
               }
            }
         }
      ]
   }
   ```

------
**Anmerkung**  
Die standardmäßige **Zugriffsrichtlinie** enthält Bedingungen, die auf `sourceOwner` angewendet werden. Zum Beispiel:   

   ```
   "Condition": {
           "StringEquals": {
             "AWS:SourceOwner": "921772911154"
           }
         }
   ```
Stellen Sie sicher, dass Sie sie entfernen und mit `SourceAccount` ersetzen. Zum Beispiel:  

   ```
   "Condition":{
               "StringEquals":{
                  "aws:SourceAccount":"YOUR_AWS_ACCOUNT_ID"
               },
               "ArnEquals":{
                  "aws:SourceArn":"YOUR_CONNECT_INSTANCE_ARN"
               }
            }
   ```
Dies verhindert [serviceübergreifende Confused-Deputy](cross-service-confused-deputy-prevention.md)-Probleme. 

1. Wenn Sie serverseitige Verschlüsselung auf SNS verwenden, stellen Sie sicher, dass Sie die entsprechenden `connect.amazonaws.com`-Berechtigungen auf dem KMS key aktiviert haben. Im Folgenden finden Sie eine Beispielrichtlinie:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Id": "key-consolepolicy-3",
       "Statement": [
           {
               "Sid": "Enable IAM User Permissions",
               "Effect": "Allow",
               "Principal": {
                   "AWS": "arn:aws:iam::111122223333:root",
                   "Service": "connect.amazonaws.com"
               },
               "Action": "kms:*",
               "Resource": "*"
           },
           {
               "Sid": "Allow access for Key Administrators",
               "Effect": "Allow",
               "Principal": {
                   "AWS": "arn:aws:iam::111122223333:root",
                   "Service": "connect.amazonaws.com"
               },
               "Action": [
                   "kms:Create*",
                   "kms:Describe*",
                   "kms:Enable*",
                   "kms:List*",
                   "kms:Put*",
                   "kms:Update*",
                   "kms:Revoke*",
                   "kms:Disable*",
                   "kms:Get*",
                   "kms:Delete*",
                   "kms:TagResource",
                   "kms:UntagResource",
                   "kms:ScheduleKeyDeletion",
                   "kms:CancelKeyDeletion"
               ],
               "Resource": "*"
           }
       ]
   }
   ```

------

## Schritt 2: Initiieren des Chat-Kontakts
<a name="step2-chat-streaming"></a>

1. Rufen Sie die Amazon Connect [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)Connect-API auf, um den Chat-Kontakt zu initiieren. 

   Informationen zum Erstellen des SDK-Clients für den Aufruf von Amazon Connect APIs finden Sie in den folgenden Themen:
   + [Klasse AmazonConnectClientBuilder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/connect/AmazonConnectClientBuilder.html) 
   + [Erstellen von Service-Clients](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/creating-clients.html) 

1. Behalten Sie den Überblick über `ContactId` und `ParticipantToken` von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)Antwort, da diese Antwortattribute für das Aufrufen anderer Chats verwendet werden, die für das Streaming APIs erforderlich sind. Dies wird in den nächsten Schritten beschrieben.

## Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt
<a name="step3-chat-streaming"></a>
+ Rufen Sie an [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html), um das Streamen von Nachrichten in Echtzeit zu Ihrem SNS-Thema zu aktivieren.
  + **Einschränkungen**: Sie können bis zu zwei SNS-Themen pro Kontakt abonnieren.
  + Wenn Sie anrufen [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html), müssen Sie den Amazon-Ressourcennamen (ARN) des SNS-Themas angeben (siehe[Schritt 1: Erstellen Sie ein Standard-SNS-Thema.](#step1-chat-streaming)).

    Ein einziger SNS-Themen-ARN kann für mehrere verwendet werden AWS-Konten, er muss sich jedoch in derselben Region wie Ihre Amazon Connect Connect-Instance befinden. **Wenn sich Ihr Themen-ARN beispielsweise in **us-east-1** befindet, muss sich Ihre Amazon Connect Connect-Instance in us-east-1 befinden.**
  + Für erste Chat-Nachrichten, die nicht auf dem Streaming-Endpunkt empfangen werden, können Sie die [GetTranscript](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_GetTranscript.html)API aufrufen, um die ersten Nachrichten zu empfangen.

## Schritt 4: Erstellen der Teilnehmerverbindung
<a name="step4-chat-streaming"></a>
+ Rufen Sie auf, [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)wobei das `ConnectParticipant` Attribut als wahr übergeben wurde. 
  + Sie müssen [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)innerhalb von fünf Minuten nach der Erstellung des Chats anrufen.
  + Ein Anruf [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)mit der `ConnectParticipant` Einstellung „true“ funktioniert nur, wenn Sie das Einstreamen aktiviert haben [Schritt 2: Initiieren des Chat-Kontakts](#step2-chat-streaming) und der Anrufer dies `Customer` tut.
  + Dieser Schritt (Erstellen der Teilnehmerverbindung) ist optional, wenn Sie bereits mit `WEBSOCKET` erfolgreich eine Verbindung zum Chat-Kontakt hergestellt haben.

## Nächste Schritte
<a name="nextsteps-chat-streaming"></a>

Sie sind bereit, mit dem Nachrichtenstreaming APIs zu arbeiten.

1. Um sicherzustellen, dass es funktioniert, überprüfen Sie, ob die Nachrichten unter dem von Ihnen erstellten SNS-Thema veröffentlicht wurden. Sie können dies mithilfe von CloudWatch Amazon-Metriken tun. Anweisungen finden Sie unter [Überwachung von Amazon SNS unter Verwendung CloudWatch von](https://docs.aws.amazon.com/sns/latest/dg/sns-monitoring-using-cloudwatch.html). 

1. Da SNS nur eine [begrenzte Aufbewahrung](https://aws.amazon.com/blogs//aws/sns-ttl-control/) hat, empfehlen wir Ihnen, [Amazon Simple Queue Service (Amazon SQS)](https://aws.amazon.com/sqs/), [Amazon Kinesis](https://aws.amazon.com/kinesis/) oder einen anderen Dienst zur Aufbewahrung von Nachrichten einzurichten. 

1. Die Verwendung [StopContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactStreaming.html)ist optional und nicht erforderlich, wenn die Chats im Rahmen eines Kontaktablaufs [unterbrochen](disconnect-hang-up.md) werden oder wenn der Kunde die Chat-Verbindung unterbricht. `StopContactStreaming` bietet jedoch die Möglichkeit, das Nachrichten-Streaming zum SNS-Thema zu beenden, auch wenn der Chat aktiv und andauernd ist.

# Verwenden der Amazon-SNS-Nutzdaten nach Aktivierung des Nachrichten-Streamings in Amazon Connect
<a name="sns-payload"></a>

Nachdem Sie das Nachrichtenstreaming erfolgreich aktiviert haben, müssen Sie die Nachricht möglicherweise filtern, um sie an den vorgesehenen Teilnehmer zu senden: Kundendienstmitarbeiter, Kunde oder alle.

Um nach Teilnehmern zu filtern, lesen Sie das spezifische SNS-Header-Attribut `MessageVisibility`, um festzustellen, ob die Nachricht nur für Kunden, nur für Kundendienstmitarbeiter oder für alle bestimmt ist. 
+ Nur an den Kunden senden: Für den gesamten Code, der für den Kunden bestimmt ist, müssen Clients Nachrichten herausfiltern, die für den Kunden bestimmt sind, und die folgende Logik für die Weiterleitung der Nachricht an sie erstellen.

  ```
  if ( ( MessageVisibility == CUSTOMER || MessageVisibility == ALL)  && ParticipantRole != CUSTOMER )
  ```
+ Nur an den Kundendienstmitarbeiter senden:

  ```
  if ( ( MessageVisibility == AGENT || MessageVisibility == ALL)  && ParticipantRole != AGENT )
  ```

Sie können die Filterfunktion in Amazon SNS auch nutzen, indem Sie benutzerdefinierte [Abonnementfilterrichtlinien](https://docs.aws.amazon.com/sns/latest/dg/sns-subscription-filter-policies.html) erstellen. Dadurch wird die Nachrichtenfilterlogik vom SNS-Themen-Subscriber auf den SNS-Service selbst verlagert.

## Nachrichtenattribute in der Nutzlast
<a name="sns-message-attributes"></a>

Im Folgenden finden Sie eine Beschreibung der einzelnen Nachrichtenattribute in der Amazon SNS-Nutzlast:
+ `InitialContactId`: Die erste Kontakt-ID des Chats.
+ `ContactId`: Die aktuelle Kontakt-ID des Chats. Das `InitialContactId` und `ContactId` kann unterschiedlich sein, wenn es einen neuen Agenten im Chat oder im queue-to-queue Kontaktablauf gab.
+ `ParticipantRole`: Der Teilnehmer, der die Nachricht gesendet hat.
+ `InstanceId`: Die Amazon-Connect-Instance-ID
+ `AccountId`: Die AWS Konto-ID.
+ `Type`: Mögliche Werte: `EVENT`, `MESSAGE`.
+ `ContentType`: Mögliche Werte: `application/vnd.amazonaws.connect.event.typing`, `application/vnd.amazonaws.connect.event.participant.joined`, `application/vnd.amazonaws.connect.event.participant.left`, `application/vnd.amazonaws.connect.event.transfer.succeeded`, `application/vnd.amazonaws.connect.event.transfer.failed`, `application/vnd.amazonaws.connect.message.interactive`, `application/vnd.amazonaws.connect.event.chat.ended` und weitere. 
+ `MessageVisibility`: Mögliche Werte: `AGENT`, `CUSTOMER`, `ALL`.

## Beispiel-SNS-Nutzlast
<a name="sns-message-payload"></a>

```
{
  "Type" : "Notification",
  "MessageId" : "ccccccccc-cccc-cccc-cccc-ccccccccccccc",
  "TopicArn" : "arn:aws:sns:us-west-2:009969138378:connector-svc-test",
  "Message" :  "{\"AbsoluteTime\":\"2021-09-08T13:28:24.656Z\",\"Content\":\"help\",\"ContentType\":\"text/plain\",\"Id\":\"333333333-be0d-4a44-889d-d2a86fc06f0c\",\"Type\":\"MESSAGE\",\"ParticipantId\":\"bbbbbbbb-c562-4d95-b76c-dcbca8b4b5f7\",\"DisplayName\":\"Jane\",\"ParticipantRole\":\"CUSTOMER\",\"InitialContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\",\"ContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\"}",
  "Timestamp" : "2021-09-08T13:28:24.860Z",
  "SignatureVersion" : "1",
  "Signature" : "examplegggggg/1tEBYdiVDgJgBoJUniUFcArLFGfg5JCvpOr/v6LPCHiD7A0BWy8+ZOnGTmOjBMn80U9jSzYhKbHDbQHaNYTo9sRyQA31JtHHiIseQeMfTDpcaAXqfs8hdIXq4XZaJYqDFqosfbvh56VPh5QgmeHTltTc7eOZBUwnt/177eOTLTt2yB0ItMV3NAYuE1Tdxya1lLYZQUIMxETTVcRAZkDIu8TbRZC9a00q2RQVjXhDaU3k+tL+kk85syW/2ryjjkDYoUb+dyRGkqMy4aKA22UpfidOtdAZ/GGtXaXSKBqazZTEUuSEzt0duLtFntQiYJanU05gtDig==",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-11111111111111111111111111111111.pem",
  "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:000000000000:connector-svc-test:22222222-aaaa-bbbb-cccc-333333333333",
  "MessageAttributes" : {
    "InitialContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "MessageVisibility" : {"Type":"String","Value":"ALL"},
    "Type" : {"Type":"String","Value":"MESSAGE"},
    "AccountId" : {"Type":"String","Value":"999999999999"},
    "ContentType" : {"Type":"String","Value":"text/plain"},
    "InstanceId" : {"Type":"String","Value":"dddddddd-b64e-40c5-921b-109fd92499ae"},
    "ContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "ParticipantRole" : {"Type":"String","Value":"CUSTOMER"}
  }
}
```

# Fehlerbehebung beim Nachrichten-Streaming in Amazon Connect
<a name="troubleshoot-message-streaming"></a>

## Nachrichten werden nicht in SNS veröffentlicht
<a name="message-not-published-to-sns"></a>

In diesem Fall empfehlen wir, die Informationen in [Schritt 1: Erstellen Sie ein Standard-SNS-Thema.](chat-message-streaming.md#step1-chat-streaming) zu überprüfen:
+ Stellen Sie sicher, dass Sie Standard-SNS verwenden und nicht [Amazon SNS FIFO (First in, First out](https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html)). Derzeit APIs unterstützt das Nachrichten-Streaming nur Standard-SNS für das Echtzeit-Streaming von Nachrichten.
+ Stellen Sie sicher, dass eine auf SNS-Ressourcen basierende Berechtigung in Ihrem Konto korrekt angewendet wurde.
  + Wenn serverseitige Verschlüsselung aktiviert ist, müssen Sie demselben Amazon-Connect-Service-Prinzipal die Berechtigung zum Verschlüsseln und Entschlüsseln erteilen.

## Flow startet nicht
<a name="contact-flow-not-starting"></a>

Wenn Sie das Nachrichtenstreaming APIs anstelle von Websockets verwenden, senden Sie ein Verbindungsbestätigungsereignis; siehe. [Schritt 4: Erstellen der Teilnehmerverbindung](chat-message-streaming.md#step4-chat-streaming) Dies ist gleichbedeutend mit einer Verbindung zu einem Websocket. Der Flow beginnt erst nach dem Verbindungsbestätigungsereignis.

Rufen Sie [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)danach an [StartContactStreaming](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactStreaming.html), um es `Customer` als verbunden zu markieren; siehe. [Schritt 3: Aktivieren des Nachrichtenstreamings für den Kontakt](chat-message-streaming.md#step3-chat-streaming) Dadurch werden Nachrichten erst gesendet, nachdem Sie bestätigt haben, dass der Kunde bereit ist, sie zu empfangen.

## Das Problem wurde nicht gelöst?
<a name="other-issues-message-streaming"></a>

Wenn Sie nach dem Testen der vorherigen Lösungen immer noch Probleme mit dem Nachrichtenstreaming haben, wenden Sie sich an uns, Support um Hilfe zu erhalten. 

Amazon-Connect-Administratoren haben folgende Möglichkeiten, den Support zu kontaktieren:
+ Wenn Sie ein AWS Support-Konto haben, gehen Sie zum [Support Center](https://console.aws.amazon.com/support/home) und reichen Sie ein Ticket ein.
+ Öffnen Sie andernfalls die [AWS-Managementkonsole](https://console.aws.amazon.com/) und wählen Sie **Amazon Connect**, **Support,**, **Fall erstellen**.

Es ist hilfreich, die folgenden Informationen anzugeben:
+ Ihre Contact Center-Instance-ID/ARN. Informationen zum Suchen des Instance-ARN finden Sie unter [Suchen Ihrer Instance-ID oder des ARN von Amazon Connect](find-instance-arn.md). 
+ Ihre Region. 
+ Eine ausführliche Beschreibung des Problems.

# Anpassen der Chat-Ablauferlebnisse in Amazon Connect, indem Sie benutzerdefinierte Teilnehmer integrieren
<a name="chat-customize-flow"></a>

Sie können mit Amazon-Connect-Chat andere Lösungen, wie Bots, integrieren, um angepasste Chat-Flow-Erlebnisse zu schaffen.

Im Folgenden finden Sie eine Übersicht darüber, wie Sie Ihr Chat-Flow-Erlebnis anpassen können. Implementieren Sie diese Schritte für jedes Chat-Segment, nachdem die Chat-Konversation gestartet wurde. Wir empfehlen, einen [AWS Lambda Funktion](invoke-lambda-function-block.md) Block hinzuzufügen, um den APIs in Ihrem Chat-Flow anzurufen. 

**Wichtig**  
Füge einen [Play prompt (Telefonansage wiedergeben)](play.md)-Block vor einem [AWS Lambda Funktion](invoke-lambda-function-block.md)-Block hinzu. Dies ist nur erforderlich, wenn ein Block „** AWS Lambda aufrufen**“ der erste Block in Ihrem eingehenden Chat-Flow ist.

1.  [Aktivieren Sie das Echtzeit-Streaming von Chat-Nachrichten](chat-message-streaming.md). 

1. Rufen Sie die Amazon Connect [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)Connect-API auf, um dem Chat-Kontakt einen benutzerdefinierten Teilnehmer (`ParticipantRole`=`CUSTOM_BOT`) hinzuzufügen.

   1. Informationen zum Erstellen des SDK-Clients für den Aufruf von Amazon Connect APIs finden Sie in den folgenden Themen:
      + [Klasse AmazonConnectClientBuilder](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/connect/AmazonConnectClientBuilder.html)
      + [Erstellen von Service-Clients](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/creating-clients.html)

   1. Behalten Sie `ParticipantToken` das, was Sie erhalten haben [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html), um anzurufen [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html). `CreateParticipantConnection`gibt a zurück`ConnectionToken`, mit dem Sie andere Amazon Connect Connect-Teilnehmer anrufen können APIs. 

      Wenn Sie anrufen [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html), um eine Verbindung für einen benutzerdefinierten Teilnehmer herzustellen:
      + Stellen Sie `ConnectParticipant` auf `True`, um den benutzerdefinierten Teilnehmer für das Nachrichtenstreaming als verbunden zu markieren.
      + Gehen `Type` Sie weiter`CONNECTION_CREDENTIALS`, um den nachfolgenden Amazon Connect Connect-Teilnehmerservice anzurufen APIs.
      + `CreateParticipantConnection` sollte innerhalb von 15 Sekunden nach dem Aufruf von `CreateParticipant` aufgerufen werden.

1. Nachdem der Teilnehmer dem Kontakt hinzugefügt wurde, kann er über den Amazon Connect Participant Service Nachrichten mit dem Kunden austauschen APIs.

1. Rufen Sie die [ DisconnectParticipant](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_DisconnectParticipant.html)API auf, um die Verbindung zum Teilnehmer zu trennen. 

**Anmerkung**  
Ein benutzerdefinierter Teilnehmer kann nicht zu einem Chat hinzugefügt werden, wenn ein Kundendienstmitarbeiter oder Amazon-Lex-Bot bereits in dem Kontakt anwesend ist. 
Ein benutzerdefinierter Teilnehmer wird getrennt, wenn ein Kundendienstmitarbeiter oder Amazon-Lex-Bot einem Kontakt beitritt.
Bei einem Kontakt kann nur ein benutzerdefinierter Teilnehmer anwesend sein.
Ein benutzerdefinierter Teilnehmer darf nicht auf Anhänge zugreifen, die ein Kunde hochladen kann.

Sie sollten einstellen, wie lange ein benutzerdefinierter Teilnehmer mit einem Kontakt chatten kann:
+ Stellen Sie die Eigenschaft **Timeout** auf dem [Wait](wait.md)-Block für `ParticipantRole` = `CUSTOM_BOT` ein.
+ Wird der benutzerdefinierte Bot-Teilnehmer nicht vor Flow des Timeouts getrennt, so wird der Kontakt über die Verzweigung **Time Expired** weitergeleitet. Auf diese Weise können Sie entscheiden, welcher Block als Nächstes ausgeführt werden soll, um die Anfrage des Kunden zu lösen.

**Anmerkung**  
Wird ein Kontakt über die Verzweigung **Time Expired** weitergeleitet, so wird er nicht vom Kontakt getrennt. Sie müssen die [ DisconnectParticipant](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_DisconnectParticipant.html)API aufrufen, um die Verbindung zum Teilnehmer zu trennen.

## Aktivieren von Timern für Kunden, die einem Chat mit einem benutzerdefinierten Teilnehmer beitreten
<a name="integrate-bot-extension-client"></a>

Sie können Timer für Kunden aktivieren, die einem Chat mit benutzerdefinierten Teilnehmern beitreten, z. B. benutzerdefinierten Bots. Auf diese Weise können Sie erkennen, wenn ein Kunde nicht mehr reagiert, sodass Sie die Bot-Konversation beenden und den nächsten Schritt im Ablauf ausführen können. Indem Sie inaktive Teilnehmer beenden, können Sie die Anzahl offener Chats reduzieren, bei denen ein Kunde, der nicht reagiert, einen benutzerdefinierten Teilnehmer in Anspruch nimmt.

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Bot-Erweiterung für inaktive Teilnehmer zu integrieren und optional benutzerdefinierte Timer-Werte festzulegen. Bei diesen Schritten wird davon ausgegangen, dass Sie das benutzerdefinierte Teilnehmer-Feature bereits für den Chat verwenden. 

1. Rufen Sie die [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)API für den Kunden auf, bevor der benutzerdefinierte Teilnehmer dem Chat beitritt.

   1. Timer werden nur für den Kunden aktiviert. Bei benutzerdefinierten Teilnehmern gibt es keine Timer für inaktive Teilnehmer oder automatische Trennungen der Verbindung. 

   1. Sie können die Methode zum Aufrufen der API auswählen. 

   1. In diesem Schritt konfigurierte Timer-Werte gelten für die Dauer des Chats. Wenn Sie unterschiedliche Timer-Werte für die **Interaktion zwischen Kunden und Kundendienstmitarbeiter** wünschen, finden Sie weitere Informationen unter Schritt 2. 

   1. Wenn Ihr Client bereits auf diese Weise eingerichtet ist, müssen Sie keine weiteren Maßnahmen ergreifen, um Ihren benutzerdefinierten Teilnehmer zu integrieren. 

1. (Optional) So konfigurieren Sie unterschiedliche Timer und Timer-Werte für die **Interaktion zwischen Kunde und Kundendienstmitarbeiter** und die **Interaktion zwischen Kunde und dem benutzerdefinierten Teilnehmer**:
   + Bevor der Agent dem Chat beitritt, rufen Sie die [UpdateParticipantRoleConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantRoleConfig.html)API erneut mit den gewünschten Konfigurationen auf.

Weitere Informationen zu Chat-Timern finden Sie unter [Chat-Timeouts für Chat-Teilnehmer einrichten](setup-chat-timeouts.md).

### Starten von Timern
<a name="starting-timers"></a>

Für den Kunden beginnt ein Timer, nachdem der benutzerdefinierte Teilnehmer über die [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html)API eine Verbindung zu ihm hergestellt hat.

### Was passiert, wenn nicht kompatible Teilnehmer einem Chat mit einem benutzerdefinierten Teilnehmer beitreten
<a name="non-compatible-participants"></a>

Folgendes passiert, wenn ein Kundendienstmitarbeiter oder Lex-Bot-Teilnehmer einem Chat mit einem benutzerdefinierten Teilnehmer beitritt und es sich dabei um nicht kompatible Teilnehmer handelt: 

1. Der benutzerdefinierte Teilnehmer wird automatisch vom Chat getrennt. 

1. Alle zuvor aktiven Timer werden beendet und es werden neue Timer für die verbundenen Teilnehmer erstellt (sofern Timer konfiguriert sind).

1. Jeder neue Timer wird ebenfalls mit der neuesten Konfiguration aktualisiert (falls erforderlich). Dadurch wird effektiv eine neue „Leerlaufsitzung“ für die neue Gruppe von aktiven Teilnehmern im Chat eingerichtet.

### Interaktion mit dem Timer des Blocks „Warten“
<a name="interaction-wait-block-timer"></a>

Der Leerlauf-Timer hat keinen Einfluss darauf, wie der Block [Wait](wait.md) funktioniert. 

Der Timer des Blocks **Warten**, der startet, wenn der Chat-Kontakt in einen Block **Warten** gelangt, funktioniert weiterhin. Wenn der Timer des Blocks **Warten** abläuft, setzt der Kontakt den Ablauf fort und wird in die Verzweigung **Zeit abgelaufen** weitergeleitet, unabhängig davon, ob die Timer inaktiver Teilnehmer aktiv sind.

## Tipps zur Problembehebung
<a name="ts-chat-custom-bot"></a>
+ `ResourceNotFoundException`: 

  Wenn Sie beim Aufrufen der API `CreateParticipantConnection` für den benutzerdefinierten Teilnehmer `ResourceNotFoundException` erhalten, überprüfen Sie, ob die `CreateParticipantConnection` API innerhalb von 15 Sekunden nach der `CreateParticipant` API aufgerufen wurde.
+ `AccessDeniedException`: 

  Wenn Sie eine Fehlermeldung `AccessDeniedException` erhalten und es sich bei der Teilnehmerrolle um einen CUSTOM\$1BOT handelt, bedeutet dies, dass der Bot versucht, auf Anhänge zuzugreifen. Die Teilnehmerrolle CUSTOM\$1BOT ist nicht berechtigt, auf Anhänge zuzugreifen, die Kunden hochladen.

# Einrichten der Kundenauthentifizierung für Chat-Kontakte in Amazon Connect
<a name="customer-auth"></a>

Sie können Ihre Kunden während eines Chats auffordern, sich anzumelden und zu authentifizieren. Beispielsweise können nicht authentifizierte Kunden, die mit einem Chat-Bot interagiert haben, aufgefordert werden, sich anzumelden, bevor sie an einen Kundendienstmitarbeiter weitergeleitet werden. 

Diese integrierte Funktion nutzt Amazon Connect Customer Profiles und [Amazon Cognito](https://aws.amazon.com/cognito/). Für die Verwendung von Customer Profiles fallen keine zusätzlichen Kosten an. Es ist bereits in Ihrer Amazon-Connect-Instance [aktiviert](enable-customer-profiles.md), wenn Sie bei der Einrichtung die Standardeinstellungen ausgewählt haben. Weitere Informationen zu den Amazon-Cognito-Preisen finden Sie auf der Seite [Preise für Amazon Cognito](https://aws.amazon.com/cognito/pricing/).

So richten Sie die Kundenauthentifizierung für den Chat ein:

1. [Aktivieren Sie die Kundenauthentifizierung](enable-connect-managed-auth.md#enable-customer-auth) für Ihre Amazon-Connect-Instance.

1. [Aktivieren der Authentifizierungsnachricht](enable-connect-managed-auth.md#enable-auth-message).

1. Fügen Sie Ihrem Flow einen [Kundenauthentifizierung](authenticate-customer.md)-Block hinzu.

Wenn Ihr Contact Center eine bestehende Authentifizierungslösung außerhalb von Amazon Connect verwendet, finden Sie weitere Informationen unter [Authentifizierung vor dem Chat](pre-chat-auth.md).

# Aktivieren der Kundenauthentifizierung für gehostete Kommunikations-Widgets
<a name="enable-connect-managed-auth"></a>

In diesem Thema wird erklärt, wie Sie die Authentifizierung einrichten, wenn Sie das gehostete Kommunikations-Widget von Amazon Connect für den Chat verwenden. Sie aktivieren die Kundenauthentifizierung für Ihre Amazon-Connect-Instance und anschließend eine Authentifizierungsnachricht, die einen Link enthält, über den ein Popup zur von Amazon Cognito gehosteten Benutzeroberfläche geöffnet wird. 

## Erforderliche IAM-Richtlinien
<a name="auth-page-iam-policies"></a>

Wenn Sie benutzerdefinierte IAM-Richtlinien verwenden, um den Zugriff auf die Amazon-Connect-Konsole zu verwalten, finden Sie unter [Erforderliche Berechtigungen für benutzerdefinierte IAM-Richtlinien](security-iam-amazon-connect-permissions.md) eine Liste der Berechtigungen, die für den Zugriff auf die Seite **Kundenauthentifizierung** erforderlich sind.

## Aktivieren der Kundenauthentifizierung in Ihrer Amazon-Connect-Instance
<a name="enable-customer-auth"></a>

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

1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias.  
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)

1. Wählen Sie im linken Navigationsmenü **Anwendungen**, **Kundenauthentifizierung** aus. Wenn Sie diese Option nicht sehen, ist sie möglicherweise in Ihrer AWS Region nicht verfügbar. Weitere Informationen dazu, wo die Kundenauthentifizierung verfügbar ist, finden Sie unter [Verfügbarkeit von Kundenauthentifizierung nach Region](regions.md#customerauthentication_region). 

1. Wählen Sie auf der Seite **Kundenauthentifizierung** die Option **Benutzerpool in Amazon Cognito erstellen** aus. Dadurch wird die Amazon-Cognito-Konsole geöffnet.

1. Erstellen Sie einen neuen Benutzerpool mit ihrem Identitätsanbieter. Anleitungen finden Sie unter [Erste Schritte mit Benutzerpools](https://docs.aws.amazon.com/cognito/latest/developerguide/getting-started-user-pools.html) im *Entwicklerhandbuch zu Amazon Cognito*. 
**Anmerkung**  
Sie müssen bei der Konfiguration Ihres App-Clients von Amazon Cognito die Option **Kein Client-Geheimnis generieren** auswählen. Es werden nur App-Clients von Amazon Cognito ohne geheimen Clientschlüssel unterstützt. Weitere Informationen finden Sie unter [Anwendungsspezifische Einstellungen mit App-Clients](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html) im *Entwicklerhandbuch zu Amazon Cognito*.

1. Nachdem Sie einen Amazon-Cognito-Benutzerpool erstellt haben, kehren Sie zur Seite **Kundenauthentifizierung** zurück und wählen **Benutzerpool zuordnen** aus.

1. Wählen Sie im Abschnitt **Benutzerpool** den erstellten Benutzerpool aus dem Dropdown-Menü aus und klicken Sie auf **Bestätigen**.

   Dadurch wird der Benutzerpool Ihrer Amazon-Connect-Instance zugeordnet. Es ermöglicht dem [Kundenauthentifizierung](authenticate-customer.md)-Flow-Block den Zugriff auf den Benutzerpool.

1. Fahren Sie mit dem nächsten Schritt fort:[Aktivieren der Authentifizierungsnachricht](#enable-auth-message).

## Aktivieren der Authentifizierungsnachricht
<a name="enable-auth-message"></a>

Um die Authentifizierungsnachricht zu aktivieren, fügen Sie die Snippet-Variable für den Authentifizierungsparameter an das Ende Ihres Snippets an. Informationen zum Hinzufügen von Snippet-Variablen finden Sie unter [Unterstützte Widget-Snippet-Felder in Amazon Connect, die anpassbar sind](supported-snippet-fields.md). Der folgende Code ist ein Beispiel für das Authentifizierungsparameter-Snippet, das Sie hinzufügen müssen.

```
amazon_connect('authenticationParameters', { 
    redirectUri: 'your_redirect_url', // https://example.com 
    identityProvider: 'your_identity_provider_name' //optional
 });
```

Wobei Folgendes gilt:
+ `redirectUri` ist die Weiterleitungs-URI, die Sie in Ihrem IdP (Identitätsanbieter) und Amazon Cognito konfiguriert haben. Hier wird Ihr Kunde nach der Anmeldung automatisch weitergeleitet. Auf dieser Seite können Sie die URL-Parameter überprüfen. Wenn es einen Code und einen Status gibt, können Sie die [UpdateParticipantAuthentication](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateParticipantAuthentication.html)API mit diesen Werten aufrufen. Schließen Sie nach Abschluss des API-Aufrufs das Popup. Der Kunde wird zurück zum Chat-Erlebnis geleitet.
+ `identityProvider` ist der Name des Identitätsanbieters, den Sie in Amazon Cognito konfiguriert haben. Dies ist ein optionales Feld. Wenn ein Wert angegeben wird, leitet der Anmeldelink den Kunden automatisch zur Anmeldeseite des Identitätsanbieters weiter und nicht zur von Amazon Cognito verwalteten Anmeldeseite, auf der er einen Identitätsanbieter für die Anmeldung auswählen müsste.

 Wenn der Flow den [Kundenauthentifizierung](authenticate-customer.md)-Block erreicht, können Sie einen Rückruf registrieren und den Status lokal speichern, um ihn in der Umleitungs-URI zu validieren, wie im folgenden Beispielcode-Snippet gezeigt:

```
amazon_connect('registerCallback', {
       'AUTHENTICATION_INITIATED' : (eventName, data) => {
            console.log(data.state)
        },
      });
```

Nachdem Sie die Kundenauthentifizierung aktiviert haben, fügen Sie Ihrem Flow einen [Kundenauthentifizierung](authenticate-customer.md)-Block hinzu. Dieser Block authentifiziert Chat-Kontakte während des Flows und leitet sie auf der Grundlage des Authentifizierungsergebnisses an bestimmte Pfade weiter.

# Authentifizierung vor dem Chat mithilfe der Amazon Connect Connect-API StartChatContact
<a name="pre-chat-auth"></a>

Kunden, die sich vor dem Start eines Chats auf Ihrer Website oder in Ihrer mobilen Anwendung authentifizieren, können als authentifiziert erkannt werden, wenn ein Chat initiiert wird. Sie können dies mithilfe der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API tun.

Nachdem ein authentifizierter Kunde einen Chat gestartet hat, legen Sie seinen Status mithilfe der Parameter in der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API fest, wie im folgenden Codeausschnitt dargestellt:

```
"SegmentAttributes": {
    "connect:CustomerAuthentication" : { 
        "ValueMap": {
            "Status": {
                "ValueString": "AUTHENTICATED"
            }
        }
    },
    "CustomerId": "12345"
```

`CustomerId` ist ein optionales Feld zur Identifizierung des Kunden. Dies kann entweder eine ID von Amazon Connect Customer Profiles oder eine benutzerdefinierte Kennung aus einem externen System, z. B. einem CRM, sein.

# Nachrichtenstreaming für KI-gestützten Chat aktivieren
<a name="message-streaming-ai-chat"></a>

Amazon Connect unterstützt Nachrichtenstreaming für KI-gestützte Chat-Interaktionen. Antworten von KI-Agenten erscheinen schrittweise, während sie generiert werden, was das Kundenerlebnis bei Gesprächen verbessert.

Im Folgenden sind die Integrationsoptionen sowie die Funktionen der einzelnen Optionen aufgeführt:
+ Kundendienstmitarbeiter von Amazon Connect
  + Beseitigt die Timeout-Beschränkungen von Amazon Lex
  + Zeigt während der Bearbeitung Versandnachrichten an (z. B. „Einen Moment, während ich Ihr Konto überprüfe“)
  + Zeigt Teilantworten mit progressivem Text an (wachsende Textblase)
+ Bots von Drittanbietern über Amazon Lex oder Lambda
  + Beseitigt die Timeout-Beschränkungen von Amazon Lex
  + Standardverhalten bei Bot-Antworten

Instances, die ab Dezember 2025 erstellt wurden, werden automatisch für diese Funktion aktiviert. Für bestehende Instanzen müssen Sie das Nachrichtenstreaming manuell über die API oder über die Konsole aktivieren.

## Aktivieren Sie das Nachrichtenstreaming mithilfe der API
<a name="message-streaming-enable-api"></a>

Verwenden Sie die [UpdateInstanceAttribute](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateInstanceAttribute.html)API, um das Nachrichtenstreaming zu aktivieren. Legen Sie für das Attribut `MESSAGE_STREAMING` `true` fest.

```
aws connect update-instance-attribute \
  --instance-id your-instance-id \
  --attribute-type MESSAGE_STREAMING \
  --value true
```

Um sich abzumelden, setzen Sie das Attribut auf`false`.

## Aktivieren Sie das Nachrichtenstreaming über die Konsole
<a name="message-streaming-enable-console"></a>

Für neu erstellte Instanzen ist das Nachrichtenstreaming standardmäßig aktiviert.

Für bestehende Instanzen:

1. Öffnen Sie die Amazon Connect Connect-Konsole und wählen Sie Ihre Instance aus.

1. Wählen Sie im Navigationsbereich **Flows** > **Amazon Lex Bots** aus.

1. Wählen Sie unter **Lex-Bots-Konfiguration** die Option **Nachrichten-Streaming in Amazon Connect aktivieren** aus.

**Anmerkung**  
Wenn Sie das Nachrichten-Streaming über die Konsole aktivieren, wird die erforderliche `lex:RecognizeMessageAsync` Berechtigung automatisch zur ressourcenbasierten Bot-Alias-Richtlinie hinzugefügt. Wenn Sie die API verwenden, müssen Sie diese Berechtigung manuell hinzufügen.

![\[Aktivieren Sie die Nachrichten-Streaming-Option in der Amazon Connect Connect-Konsole.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-streaming-ai-chat-enablement.png)


## Aktualisieren Sie die Lex-Bot-Berechtigungen
<a name="message-streaming-lex-permissions"></a>

Nachdem das Nachrichtenstreaming aktiviert wurde, benötigt Amazon Connect die Erlaubnis, die Amazon Lex-API aufzurufen:

```
lex:RecognizeMessageAsync
```

Sie müssen die ressourcenbasierte Richtlinie für jeden Amazon Lex Lex-Bot-Alias aktualisieren, der von der Amazon Connect Connect-Instance verwendet wird.

### Wann muss die ressourcenbasierte Richtlinie des Bots aktualisiert werden
<a name="message-streaming-when-to-update"></a>
+ **Neue Instances** — Jeder neu zugeordnete Amazon Lex Lex-Bot-Alias wird standardmäßig `lex:RecognizeMessageAsync` in seiner Alias-Richtlinie aufgeführt.
+ **Bestehende Instances mit vorhandenen Bots** — Wenn die Instance zuvor Amazon Lex verwendet hat und Sie das Nachrichtenstreaming jetzt aktivieren, müssen Sie die ressourcenbasierte Richtlinie für alle zugehörigen Amazon Lex Lex-Bot-Aliase aktualisieren, um die neue Berechtigung einzubeziehen.

### Beispielausschnitt für eine ressourcenbasierte Richtlinie mit Lex-Bot-Alias
<a name="message-streaming-rbp-example"></a>

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "connect-us-west-2-MYINSTANCEID",
      "Effect": "Allow",
      "Principal": {
        "Service": "connect.amazonaws.com"
      },
      "Action": [
        "lex:RecognizeMessageAsync",
        "lex:RecognizeText",
        "lex:StartConversation
      ],
      "Resource": "arn:aws:lex:us-west-2:123456789012:bot-alias/MYBOT/MYBOTALIAS",
      "Condition": {
        "StringEquals": {
          "AWS:SourceAccount": "123456789012"
        },
        "ArnEquals": {
          "AWS:SourceArn": "arn:aws:connect:us-west-2:123456789012:instance/MYINSTANCEID"
        }
      }
    }
  ]
}
```

Sie können diese Berechtigung hinzufügen, indem Sie die Amazon Lex [UpdateResourcePolicy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateResourcePolicy.html)Lex-API aufrufen, um die ressourcenbasierte Amazon Lex-Bot-Alias-Richtlinie so zu aktualisieren, dass sie die `lex:RecognizeMessageAsync` Aktion für die ARN-Ressource der Amazon Connect Connect-Instance einschließt.

**Wichtig**  
Diese Funktion unterstützt derzeit nicht, zu demselben [Flow-Block in Amazon Connect: Kundeneingabe abrufen](get-customer-input.md) Flow-Block zurückzukehren oder einen Amazon Lex Lex-Bot mit demselben Alias in einem anderen **Get Customer Input-Block** wiederzuverwenden. Erstellen Sie stattdessen einen neuen Block **Get Customer Input** mit einem anderen Amazon Lex-Bot-Alias.

## Timeout-Grenzwerte
<a name="message-streaming-timeout-limits"></a>

Für Chat-Erlebnisse gelten die folgenden Timeout-Limits:
+ **Standard-Chat-Erlebnis** — 10-Sekunden-Timeout
+ **Chat-Streaming** — 60-Sekunden-Timeout

# Aktivieren Sie die Schwärzung sensibler Daten und die Nachrichtenverarbeitung während des Fluges
<a name="redaction-message-processing"></a>

Amazon Connect unterstützt die Nachrichtenverarbeitung, bei der Chat-Nachrichten abgefangen und geändert werden, bevor sie einen Teilnehmer erreichen. Diese Funktion ermöglicht die automatische Bearbeitung vertraulicher Daten und die Verarbeitung benutzerdefinierter Nachrichten, sodass Unternehmen die Einhaltung von Compliance- und Sicherheitsstandards einhalten können.

Im Folgenden sind die Verarbeitungsoptionen sowie die Funktionen der einzelnen Optionen aufgeführt:
+ Integrierte Schwärzung sensibler Daten
  + Erkennt und entfernt automatisch Kreditkartennummern, Sozialversicherungsnummern und andere personenbezogene Daten
  + Unterstützt mehrere Sprachen, darunter englische, französische, portugiesische, deutsche, italienische und spanische Varianten. Eine Liste der Sprachen, für die die Contact-Lens-Redaktionsfunktion unterstützt wird, finden Sie unter [Von Amazon-Connect-Features unterstützte Sprachen](supported-languages.md).
  + Wählen Sie, ob Sie ausgewählte oder alle sensiblen Datenentitäten redigieren möchten
  + Ersetzen Sie sie durch generische Platzhalter ([PII]) oder entitätsspezifische Platzhalter ([NAME], [CREDIT\$1CARD])
+ Benutzerdefinierte Nachrichtenprozessoren (über Lambda). Weitere Informationen finden Sie unter [Was ist Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)? im AWS *Lambda Developer's Guide*.
  + Integrieren Sie Dienste von Drittanbietern für Sprachübersetzungen
  + Wenden Sie die Filterung nach Schimpfwörtern an
  + Transformieren Sie Nachrichten mithilfe von Diensten AI/LLM 
  + Implementieren Sie geschäftsspezifische Nachrichtenänderungen

Um die Nachrichtenverarbeitung zu konfigurieren, definieren Sie im Block **Aufzeichnungs- und Analyseverhalten festlegen** Regeln zum Schwärzen. Weitere Informationen finden Sie unter [Aktivieren der Schwärzung sensibler Daten](enable-analytics.md#enable-redaction). Sie können auch eine Lambda-Funktion für die benutzerdefinierte Verarbeitung angeben.

Ihr benutzerdefinierter Prozessor Lambda nimmt eine JSON-Eingabe im folgenden Format auf:

```
{
  "version": "1.0",
  "instanceId": "string",
  "associatedResourceArn": "string",
  "chatContent": {
    "absoluteTime": "string",
    "content": "string",
    "contentType": "string",
    "id": "string",
    "participantId": "string",
    "displayName": "string",
    "participantRole": "string",
    "initialContactId": "string",
    "contactId": "string"
  }
}
```

Und geben Sie eine JSON-Datei im folgenden Format aus:

```
{
  "status": "string", // "PROCESSED"|"APPROVED"|"FAILED"|"REJECTED"
  "result": {
    "processedChatContent": {
      "content": "string",
      "contentType": "string" // "text/plain"|"text/markdown"|"application/json"
    }
  }
}
```

Der verarbeitete Chat-Inhalt ersetzt die ursprüngliche Nachricht, wenn er für die Chat-Teilnehmer veröffentlicht wird.

# Einrichten von SMS-Messaging in Amazon Connect
<a name="setup-sms-messaging"></a>

Sie können SMS-Nachrichten aktivieren, Amazon Connect damit Ihre Kunden Ihnen von ihrem Mobilgerät aus eine SMS senden können. Mit Amazon Lex können Sie Antworten auf ihre Fragen automatisieren und so den Kundendienstmitarbeitern wertvolle Zeit und Mühe sparen.

In diesem Thema wird erklärt, wie Sie SMS-Nachrichten für einrichten und testen Amazon Connect. Sie verwenden AWS End User Messaging SMS , um eine SMS-fähige Telefonnummer zu beziehen, bidirektionale SMS-Nachrichten für die Nummer zu aktivieren und sie dann in Amazon Connect zu importieren. 

Die Verwendung einer einzigen Telefonnummer, die sowohl für Sprach- als auch für SMS-Nachrichten gemeinsam genutzt wird, wird nicht unterstützt.

**Topics**
+ [Schritt 1: Anfordern einer Nummer in AWS End User Messaging SMS](#get-sms-number)
+ [Schritt 2: Aktivieren bidirektionaler SMS für die Telefonnummer](#enable-twoway-sms)
+ [Schritt 3: Aktualisieren der Datenströme, um SMS-Kontakte zu verzweigen](#branch-on-sms-contacts)
+ [Schritt 2: Testen des Sendens und Empfangens von SMS-Nachrichten](#test-sms)
+ [Schritt 5: Voraussetzungen für den Produktionsstart](#verify-sms-config)
+ [Kunden erhalten keine SMS-Nachrichten?](#ts-sms-config)
+ [Nächste Schritte](#sms-nextsteps)

## Schritt 1: Fordere eine Nummer an in AWS End User Messaging SMS
<a name="get-sms-number"></a>

**Wichtig**  
In einigen Ländern müssen Telefonnummern für die Verwendung im Land registriert werden. Die Bearbeitung einer eingereichten Registrierungsanfrage kann bis zu 15 Werktage dauern. Wir empfehlen dringend, diesen Prozess frühzeitig zu beginnen. Weitere Informationen zur Registrierung finden Sie unter [Registrierungen](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).  
Wir empfehlen außerdem dringend, [Bewährte Methoden für die Anforderung von SMS-Nummern](sms-number.md#bp-request-sms-number) zu überprüfen, bevor Sie eine Nummer anfordern.

Eine Anleitung zur Verwendung der CLI für diesen Schritt finden Sie unter [Anfordern einer Telefonnummer](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html) im *Benutzerhandbuch zu AWS End User Messaging SMS *.

1. Öffnen Sie die AWS SMS Konsole unter [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Telefonnummern** und dann **Absender anfordern** aus.

1. Auf der Seite **Land auswählen** müssen Sie aus dem Dropdown-Menü das **Zielland der Nachricht** auswählen, an das die Nachrichten gesendet werden sollen. Wählen Sie **Weiter** aus.

1. Geben Sie im Abschnitt **Anwendungsfall für Messaging** Folgendes ein:
   + Wählen Sie unter **Rufnummernfunktionen** entsprechend Ihren Anforderungen entweder **SMS** oder **Sprachnachrichten** aus.
**Wichtig**  
Die Funktionen für SMS und Sprache können nach dem Kauf der Telefonnummer nicht mehr geändert werden.
     + **SMS** – Wählen Sie dies aus, wenn Sie SMS-Funktionen benötigen.
     + **Sprache (Text zu Audio)** – Wählen Sie dies aus, wenn Sie Sprachfunktionen benötigen.
   + Wählen Sie unter **Geschätztes monatliches SMS-Nachrichtenvolumen – optional** die geschätzte Anzahl der SMS-Nachrichten aus, die Sie jeden Monat versenden werden.
   + Wählen Sie für **Firmensitz – optional** eine der folgenden Optionen aus:
     + **Lokal** – Wählen Sie diese Option, wenn sich Ihr Firmensitz im selben Land befindet wie Ihre Kunden, die SMS-Nachrichten erhalten werden. Sie würden diese Option beispielsweise wählen, wenn sich Ihr Hauptsitz in den USA befindet und sich Ihre Benutzer, die Nachrichten erhalten, ebenfalls in den USA befinden.
     + **International** – Wählen Sie diese Option, wenn sich Ihr Firmensitz nicht im selben Land befindet wie Ihre Kunden, die SMS-Nachrichten erhalten werden.
   + Wählen Sie für **bidirektionales Messaging** **Ja** aus, wenn Sie bidirektionales Messaging benötigen.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unter **Absendertyp auswählen** einen der empfohlenen Rufnummerntypen oder einen der verfügbaren Rufnummerntypen aus. Die verfügbaren Optionen basieren auf den Anwendungsfallinformationen, die Sie in den vorherigen Schritten ausgefüllt haben. 
   + Wenn Sie 10DLC auswählen und bereits eine registrierte Kampagne haben, können Sie die Kampagne unter **Mit registrierter Kampagne verbinden** auswählen.
   + Wenn der gewünschte Nummerntyp nicht verfügbar ist, können Sie **Zurück** wählen, um zurückzugehen und Ihren Anwendungsfall zu ändern. Überprüfen Sie auch [Unterstützte Länder und Regionen (SMS-Kanal)](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html), um sicherzustellen, dass der gewünschte Absendertyp im Zielland unterstützt wird.
   + Wenn Sie einen Kurz- oder Langcode anfordern möchten, müssen Sie einen Fall mit öffnen Support. Weitere Informationen finden Sie unter [Anfordern von Kurzwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request-short-code.html) und [Anfordern von dedizierten Langwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-long-code.html). 

1. Wählen Sie **Weiter** aus.

1. Unter **Überprüfung und Anfrage** können Sie Ihre Anfrage überprüfen und bearbeiten, bevor Sie sie absenden. Wählen Sie **Anfrage** aus.

1. Abhängig von der Art der von Ihnen angeforderten Telefonnummer wird möglicherweise das Fenster **Registrierung erforderlich** angezeigt. Ihre Telefonnummer ist mit dieser Registrierung verknüpft und kann erst dann Nachrichten senden, wenn Ihre Registrierung genehmigt wurde. Weitere Informationen zu den Registrierungsanforderungen finden Sie unter [Registrierungen](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).

   1. Geben Sie unter **Name des Anmeldeformulars** einen benutzerfreundlichen Namen ein.

   1. Wählen Sie **Registrierung beginnen**, um die Registrierung der Telefonnummer abzuschließen, oder **Später registrieren**.
**Wichtig**  
Ihre Telefonnummer kann erst dann Nachrichten senden, wenn Ihre Registrierung genehmigt wurde.  
 Ihnen wird weiterhin die wiederkehrende monatliche Leasinggebühr für die Telefonnummer in Rechnung gestellt, unabhängig vom Registrierungsstatus. 

## Schritt 2: Aktivieren bidirektionaler SMS für die Telefonnummer
<a name="enable-twoway-sms"></a>

Nachdem Sie erfolgreich eine Telefonnummer von abgerufen haben AWS End User Messaging SMS, aktivieren Sie die bidirektionale SMS-Funktion für die Telefonnummer, die Amazon Connect als Nachrichtenziel angegeben ist. Sie können bidirektionale SMS-Nachrichten für einzelne Telefonnummern aktivieren. Wenn einer Ihrer Kunden eine Nachricht an Ihre Telefonnummer sendet, wird der Nachrichtentext an Amazon Connect gesendet.

Eine Anleitungen zur Verwendung der CLI für diesen Schritt finden Sie unter [Bidirektionales SMS-Messaging](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-two-way-sms.html) im *Benutzerhandbuch zu AWS End User Messaging SMS *.

**Anmerkung**  
Amazon Connect für bidirektionale SMS ist in den AWS Regionen verfügbar, in denen sie aufgeführt sind. [Messaging-Integrationen](regions.md#messaging-integrations_region) 

1. Öffnen Sie die AWS SMS Konsole unter. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)

1. Wählen Sie im Navigationsbereich unter **Konfigurationen** die Option **Telefonnummern**.

1. Wählen Sie auf der Seite **Telefonnummern verwalten** eine Telefonnummer.

1. Wählen Sie auf der Registerkarte **Bidirektionale SMS** die Schaltfläche **Einstellungen bearbeiten**.

1. Wählen Sie auf der Seite **Einstellungen bearbeiten** die Option **Bidirektionale Nachricht aktivieren** aus, wie in der folgenden Abbildung illustriert.  
![\[Die Seite AWS End User Messaging SMS „Einstellungen bearbeiten“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/sms-edit-settings.png)

1. Wählen Sie für **Zielart** **Amazon Connect** aus.

1. Wählen Sie für Amazon Connect in der **bidirektionalen Kanal-Rolle** die Option **Bestehende IAM-Rollen auswählen**. 

1. Wählen Sie im Dropdown-Menü **Bestehende IAM-Rollen** eine bestehende IAM-Rolle als Nachrichtenziel aus. Beispiele für IAM-Richtlinien finden Sie unter [IAM-Richtlinien für Amazon Connect](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-two-way-sms.html#phone-number-two-way-connect-iam-policy) im *Benutzerhandbuch zu AWS End User Messaging SMS *. 
**Tipp**  
Wenn Sie keine Richtlinie oder Rolle erstellen können, überprüfen Sie noch einmal, ob sich Ihre Amazon-Connect-Instance in einer [Region befindet, die von Amazon Connect SMS unterstützt wird](regions.md#messaging-integrations_region). 

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

1. Gehen Sie im Fenster **Telefonnummer zu Amazon Connect importieren** wie folgt vor:

   1. Wählen Sie in der Dropdown-Liste **Ziel für eingehende Nachrichten** die Amazon-Connect-Instance aus, die eingehende Nachrichten empfangen soll.  
![\[Die Seite zum AWS End User Messaging SMS Importieren von Telefonnummern.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/sms-import-phone-number.png)

   1. Wählen Sie **Telefonnummer importieren**.

1. Nachdem die Nummer erfolgreich importiert wurde Amazon Connect, können Sie sie auf der Amazon Connect Admin-Website einsehen: Wählen Sie in der linken Navigationsleiste **Kanäle**, **Telefonnummern** aus. Die SMS-Nummer wird auf der Seite mit den **Telefonnummern** angezeigt, wie in der folgenden Abbildung dargestellt.  
![\[Die Amazon Connect Admin-Website, die Seite mit den Telefonnummern.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/golden-sms-channel.png)

## Schritt 3: Aktualisieren der Datenströme, um SMS-Kontakte zu verzweigen
<a name="branch-on-sms-contacts"></a>

Wenn Sie bereits Datenströme haben, die Sie verzweigen möchten, wenn ein Kontakt SMS verwendet, fügen Sie Ihren Datenströmen einen [Check contact attributes (Kontaktattribute prüfen)](check-contact-attributes.md)-Block hinzu. Mit diesem Block können Sie SMS-Kontakte an eine bestimmte Warteschlange senden oder eine andere Aktion ausführen. 

1. Fügen Sie Ihrem Datenstrom einen [Check contact attributes (Kontaktattribute prüfen)](check-contact-attributes.md)-Block hinzu und öffnen Sie die Seite **Eigenschaften**.

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 [SegmentAttributes](ctr-data-model.md#segmentattributes) im *ContactTraceRecord*Thema.

1.  Setzen Sie im Abschnitt **Zu prüfende Bedingungen** **Bedingung** auf **Gleich** und **Wert** auf **connect:SMS**.

   Die folgende Abbildung zeigt eine **Eigenschaften**-Seite, die so konfiguriert ist, dass sie sich verzweigt, wenn der Kontakt in den SMS-Kanal kommt.  
![\[Die Seite „Eigenschaften“ des Blocks „Kontaktattribute prüfen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/golden-check-attributes-block.png)

1. Ordnen Sie die SMS-Telefonnummer dem Datenstrom zu: Wählen Sie in der linken Navigationsleiste **Kanäle**, **Telefonnummern**, wählen Sie die SMS-Nummer aus und dann **Bearbeiten**.  
![\[Die Seite „Telefonnummer bearbeiten“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/golden-sms-number.png)

1. Wählen Sie unter **Datenstrom/IVR** den Datenstromaus, den Sie aktualisiert haben, und wählen Sie dann **Speichern**.  
![\[Die Seite „Eigenschaften“ des Blocks „Kontaktattribute prüfen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/golden-assign-flow-sms-number.png)

**Tipp**  
Wenn Sie zum ersten Mal eine Telefonnummer kaufen, lautet der Status der Telefonnummer **Ausstehend**. Wenn die Telefonnummer einsatzbereit ist, lautet der Status der Telefonnummer **Aktiv**. Wenn für die Telefonnummer eine [Registrierung](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html) erforderlich ist, müssen Sie diesen Schritt abschließen, bevor der Status der Telefonnummer zu **Aktiv** geändert wird.

## Schritt 2: Testen des Sendens und Empfangens von SMS-Nachrichten
<a name="test-sms"></a>

In diesem Schritt verwenden Sie das Contact Control Panel (CCP) und ein Mobiltelefon, um das Senden und Empfangen von SMS-Nachrichten zu testen.

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

1. Senden Sie mit einem Mobilgerät eine SMS an die Telefonnummer, die Sie in [Schritt 1: Fordere eine Nummer an in AWS End User Messaging SMS](#get-sms-number) angefordert haben. 
**Tipp**  
Wenn sich Ihre AWS End User Messaging SMS Telefonnummer noch in der SMS-Sandbox befindet, können Sie das Senden und Empfangen von SMS-Nachrichten nur mit verifizierten Zielnummern testen, die Sie konfiguriert haben. Weitere Anleitungen finden Sie unter [Übergang von der SMS-Sandbox zur Produktionsumgebung](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).   
![\[Der CCP des Kundendienstmitarbeiters und das Telefon des Kunden, das SMS-Nachrichten sendet.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/sms-testing2.png)

## Schritt 5: Voraussetzungen für den Produktionsstart
<a name="verify-sms-config"></a>

Bevor Sie SMS im Produktionsmodus verwenden, stellen Sie sicher, dass Sie die folgenden Voraussetzungen für AWS End User Messaging SMS erfüllt haben. 

1. [Beenden Sie den SMS/MMS Sandbox-Modus mit Ihrem Konto](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html)

1. [Einrichten Ihrer Registrierung für SMS/MMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html)

1. [Vergewissern, dass Ihr Ausgabenkontingent Ihren Nutzungsanforderungen entspricht](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html)

1. [Erledigen Ihrer Opt-Out-Listen](https://docs.aws.amazon.com/sms-voice/latest/userguide/opt-out-list.html)

## Kunden erhalten keine SMS-Nachrichten?
<a name="ts-sms-config"></a>

Bevor Sie ein AWS Support-Ticket öffnen, vergewissern Sie sich bitte, dass Sie den Vorgang abgeschlossen haben[Schritt 5: Voraussetzungen für den Produktionsstart](#verify-sms-config).

## Nächste Schritte
<a name="sms-nextsteps"></a>

Wir empfehlen die folgenden Schritte, um den Komfort für Ihre Kundendienstmitarbeiter und Kunden zu optimieren.
+ [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): Stellen Sie Ihren Kundendienstmitarbeitern vorgefertigte Antworten auf häufig gestellte Kundenanfragen zur Verfügung, die sie beim Chat mit Kunden verwenden können. Schnellantworten ermöglichen es Kundendienstmitarbeitern, schneller auf Kunden zu reagieren.

# Hinzufügen des Amazon-Connect-Widgets zu Ihrer Website, um Chat-, Aufgaben-, E-Mail- und Webanrufkontakte anzunehmen
<a name="connect-widget-on-website"></a>

Die Themen in diesem Abschnitt beschreiben, wie Sie ein Kommunikations-Widget für Ihre Website erstellen und anpassen. Sie erstellen ein Kontaktformular, das das Verhalten für Kontakte bestimmt, die über Ihr Widget erstellt wurden, und passen dann das Erscheinungsbild und die Funktionalität des Widgets an.

**Topics**
+ [Schritt 1: Erstellen eines Kontaktformulars für Ihr Widget](#create-web-form)
+ [Schritt 2: Passen Sie Ihr Kommunikations-Widget an](#customize-communications-widget)
+ [Schritt 3: Geben Sie die Website-Domains an, auf denen das Kommunikations-Widget voraussichtlich angezeigt werden soll](#communications-widget-domains)
+ [Schritt 4: Bestätigen und kopieren Sie den Code und die Sicherheitsschlüssel für das Kommunikations-Widget](#confirm-and-copy-communications-widget-script)

## Schritt 1: Erstellen eines Kontaktformulars für Ihr Widget
<a name="create-web-form"></a>

In diesem Schritt erstellen und passen Sie eine Ansicht an, die das Verhalten für Kontakte bestimmt, die über Ihr Widget erstellt wurden.

1. Melden Sie sich auf der Amazon Connect Admin-Website unter an[https://instance name.my.connect.aws/](https://instance name.my.connect.aws/). Wählen Sie auf der Registerkarte **Weiterleitung** die Option **Abläufe** aus.

1. Klicken Sie links oben auf **Ansichten**.

1. Wählen Sie **Ansicht erstellen** aus.

1. Hier können Sie mithilfe des [No-Code-Builders](no-code-ui-builder.md) ein Kontaktformular für Ihre Kunden konfigurieren. Einige wichtige Tipps:
   + Mithilfe der Formularkomponente können Sie Formulareingaben bei der Erstellung mit Ihrem Kontakt verknüpfen. Durch die Verknüpfung von Formularen können Sie Eingaben direkt von allen Personen entgegennehmen, die mit Ihrem Widget interagieren, und die Informationen verwenden, die diese bei der Kontakterstellung in das Formular eingeben.
   + Die Verbindungsaktionskomponente ist das wichtigste Element im Formular zum Erstellen eines Kontakts. Diese Komponente sollte ohne andere Komponenten vom Typ Schaltfläche im Formular verwendet werden.
   + Genau eine Verbindungsaktionskomponente muss vorhanden sein, um das Widget „Ansicht mit Kontaktformular“ verwenden zu können.
   + Für die Connect Action-Komponente werden drei Optionen unterstützt: ConnectActionType 
     + StartEmailContact
     + StartTaskContact
     + StartChatContact

     Sowohl E-Mail als auch Aufgabe können in einem Kontaktformular verwendet werden. Informationen zum Erstellen eines Pre-Chat-Formulars für Chat-Kontakte finden Sie unter [Hinzufügen eine Chat-Benutzeroberfläche zu Ihrer von Amazon Connect gehosteten Website](add-chat-to-website.md).
   + Es gibt viele Stiloptionen für die Ansichtskomponenten, mit denen Sie das Formular an Ihre Umgebung anpassen können.

1. Nachdem Sie Ihrem Formular eine **Verbindungsaktionsschaltfläche** hinzugefügt haben, können Sie Werte für die durch das Formular erstellten Kontakte festlegen, indem Sie sie mit den Optionen in der Verbindungsaktionsschaltfläche verknüpfen. Komponenten, die Sie verknüpfen möchten, müssen sich in der Ansicht im selben Formular wie die **Verbindungsaktionsschaltfläche** befinden.   
![\[Die Aktivierung der Sicherheit für neue Kommunikations-Widget-Anfragen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/create-web-form-components-1.png)

   Folgende Komponenten werden für die Formularverknüpfung unterstützt:
   + Formulareingabe
   + Dropdown (Mehrfachauswahl ausschalten)
   + Datumsauswahl
   + Textbereich
   + Zeitauswahl

1. Sobald Ihre Ansicht fertig ist, wählen Sie **Veröffentlichen** aus.

## Schritt 2: Passen Sie Ihr Kommunikations-Widget an
<a name="customize-communications-widget"></a>

In diesem Schritt passen Sie die Umgebung des Kommunikations-Widgets für Ihre Kunden an.

1. Melden Sie sich auf der Admin-Website von Amazon Connect unter [https://instance name.my.connect.aws/](https://instance name.my.connect.aws/) an. Wählen Sie **Kommunikations-Widget anpassen**.

1. Wählen Sie auf der Seite „Kommunikations-Widgets“ die Option **Kommunikations-Widget hinzufügen** aus, um mit der Anpassung eines neuen Kommunikations-Widgets zu beginnen. Wenn Sie ein vorhandenes Kommunikations-Widget bearbeiten, löschen oder duplizieren möchten, wählen Sie die entsprechende Option in der Spalte **Aktionen** aus, wie in der folgenden Abbildung gezeigt.

1. Geben Sie einen **Namen** und eine **Beschreibung** für das Kommunikations-Widget ein.
**Anmerkung**  
Der Name muss für jedes Kommunikations-Widget, das in einer Amazon-Connect-Instance erstellt wurde, eindeutig sein.

1. Wählen Sie im Bereich **Kommunikationsoptionen** die Option **Kontaktformular hinzufügen** aus.

1. Wählen Sie die Ansicht aus, die Sie im vorherigen Schritt konfiguriert haben. Wenn für die Verbindungsaktionskomponente in der Ansicht kein Kontaktablauf festgelegt ist, müssen Sie hier einen Ablauf festlegen.

1. Klicken Sie auf **Save and Continue (Speichern und fortfahren)**.

Wählen Sie auf der Seite **Kommunikations-Widget erstellen** die Stile für die Widget-Schaltflächen sowie die Anzeigenamen und -stile aus. Bei der Auswahl dieser Optionen wird die Widget-Vorschau automatisch aktualisiert. Sie können also sehen, wie die Umgebung für die Kunden aussehen wird.

**Anmerkung**  
In der Vorschau wird das von Ihnen erstellte Ansichtskontaktformular nicht angezeigt. Es wird nur das Kopfzeilendesign angezeigt.

### Anzeigetyp
<a name="display-types"></a>

Sie können zwischen zwei Anzeigetypen für Kontaktformular-Widgets wählen:
+ Mit der *schwebenden Aktionsschaltfläche* können Sie Ihr Widget als interaktive Schaltfläche in der unteren rechten Ecke der Webseite anheften.
+ Mit der *eingebetteten Inline-Option* können Sie Ihr Widget direkt in die Webseite einbetten, ohne dass Sie zum Laden eine Taste drücken müssen

### Schaltflächenstile
<a name="button-styles"></a>

1. Wählen Sie die Farben für den Schaltflächenhintergrund aus. Geben Sie dazu Hexadezimalwerte (HTML-Farbcodes) ein.

1. Wählen Sie Weiß oder Schwarz als Symbolfarbe aus. Die Farbe des Symbols kann nicht angepasst werden.

### Widget-Header
<a name="widget-header"></a>

1. Geben Sie Werte für Header-Nachricht und Farbe sowie für die Hintergrundfarbe des Widgets an.

1. *Logo-URL*: Fügen Sie eine URL zu Ihrem Logo-Banner aus einem Amazon-S3-Bucket oder einer anderen Online-Quelle ein.

**Wichtig**  
In der Vorschau des Kommunikations-Widgets auf der Anpassungsseite wird das Logo nicht angezeigt, wenn es aus einer anderen Online-Quelle als einem Amazon-S3-Bucket stammt. Das Logo wird jedoch angezeigt, wenn das benutzerdefinierte Kommunikations-Widget auf Ihrer Seite implementiert wird.

Das Banner muss im .svg-, .jpg- oder .png-Format vorliegen. Das Bild kann 280 Pixel (Breite) mal 60 Pixel (Höhe) groß sein. Jedes Bild, das größer als diese Abmessungen ist, wird so skaliert, dass es in den Komponentenbereich des Logos von 280×60 passt.
+ Anweisungen zum Hochladen einer Datei wie eines Logobanners auf S3 finden Sie unter [Hochladen von Objekten](#) im *Benutzerhandbuch zu Amazon Simple Storage Service*.
+ Vergewissern Sie sich, dass die Bildberechtigungen richtig eingestellt sind, sodass das Kommunikations-Widget über Berechtigungen für den Zugriff auf das Bild verfügt. Informationen dazu, wie Sie ein S3-Objekt öffentlich zugänglich machen, finden Sie unter [Schritt 2: Hinzufügen einer Bucket-Richtlinie](#) im Thema „Berechtigungen für den Zugriff auf Websites einrichten“.

## Schritt 3: Geben Sie die Website-Domains an, auf denen das Kommunikations-Widget voraussichtlich angezeigt werden soll
<a name="communications-widget-domains"></a>

1. Geben Sie die Website-Domains ein, in denen Sie das Kommunikations-Widget platzieren möchten. Das Widget wird nur in Websites geladen, die Sie in diesem Schritt auswählen. 

   Wählen Sie **Domain hinzufügen** aus, um bis zu 50 Domains hinzuzufügen.  
![\[Die Option „Domain hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-add-domain.png)

   Verhalten der Zulassungsliste für Domains:
   + Subdomains sind automatisch enthalten. Wenn Sie beispielsweise example.com zulassen, sind auch alle zugehörigen Subdomains (wie sub.example.com) zulässig.
   + Das Protokoll http:// oder https:// muss exakt mit Ihrer Konfiguration übereinstimmen. Geben Sie das genaue Protokoll an, wenn Sie zulässige Domains einrichten.
   + Alle URL-Pfade sind automatisch zulässig. Wenn beispielsweise example.com zulässig ist, werden alle Seiten darunter angezeigt (z. B. Beispiel). com/cart or example.com/checkout) sind zugänglich. Sie können bestimmte Unterverzeichnisse nicht zulassen oder blockieren.
**Wichtig**  
Vergewissern Sie sich, dass Ihre Website URLs gültig ist und keine Fehler enthält. Geben Sie die vollständige URL beginnend mit https:// an.
Wir empfehlen die Verwendung von https:// für Ihre Produktionswebsites und -anwendungen.

1. Wir empfehlen, unter **Sicherheit für Ihr Kommunikations-Widget hinzufügen** die Option **Ja** auszuwählen und mit Ihrem Website-Administrator zusammenzuarbeiten, um Ihre Webserver so einzurichten, dass sie JSON-Webtoken (JWTs) für neue Kontaktanfragen ausgeben. Dies bietet Ihnen mehr Kontrolle beim Initiieren neuer Kontakte, einschließlich einer Überprüfungsmöglichkeit, ob an Amazon Connect gesendete Anfragen von authentifizierten Benutzern stammen.  
![\[Die Aktivierung der Sicherheit für neue Kommunikations-Widget-Anfragen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-choose-security.png)

   Wenn Sie **Ja** auswählen, passiert Folgendes:
   + Amazon Connect stellt auf der nächsten Seite einen 44-stelligen Sicherheitsschlüssel bereit, mit dem Sie JSON-Web-Tokens (JWTs) erstellen können.
   + Amazon Connect fügt dem Einbettungsskript für das Kommunikations-Widget eine Rückruffunktion hinzu, die nach einem JWT (JSON Web Token) sucht, wenn ein Kontakt initiiert wird.

     Sie müssen die Callback-Funktion im Einbettungscode implementieren, wie im folgenden Beispiel gezeigt.

     ```
     amazon_connect('authenticate', function(callback) {
       window.fetch('/token').then(res => {
         res.json().then(data => {
           callback(data.data);
         });
       });
     });
     ```

   Wenn Sie diese Option auswählen, erhalten Sie im nächsten Schritt einen Sicherheitsschlüssel für alle Kontaktanfragen, die auf Ihren Websites initiiert wurden. Bitten Sie Ihren Website-Administrator, Ihre Webserver so einzurichten, dass sie JWTs mit diesem Sicherheitsschlüssel ausgeben. 

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

## Schritt 4: Bestätigen und kopieren Sie den Code und die Sicherheitsschlüssel für das Kommunikations-Widget
<a name="confirm-and-copy-communications-widget-script"></a>

In diesem Schritt bestätigen Sie Ihre Auswahl, kopieren den Code für das Kommunikations-Widget und betten ihn in Ihre Website ein. Wenn Sie sich JWTs in [Schritt 3](#communications-widget-domains) für die Verwendung entschieden haben, können Sie auch die geheimen Schlüssel kopieren, um sie zu erstellen. 

### Sicherheitsschlüssel
<a name="communications-widget-security-key"></a>

Verwenden Sie diesen 44-stelligen Sicherheitsschlüssel, um JSON-Webtoken von Ihrem Webserver aus zu generieren. Sie können Schlüssel auch aktualisieren oder rotieren, wenn Sie sie ändern müssen. Wenn Sie dies tun, stellt Ihnen Amazon Connect einen neuen Schlüssel zur Verfügung und behält den vorherigen Schlüssel bei, bis Sie ihn ersetzen können. Nachdem Sie den neuen Schlüssel bereitgestellt haben, können Sie zu Amazon Connect zurückkehren und den vorherigen Schlüssel löschen.

![\[Der von Amazon Connect bereitgestellte Sicherheitsschlüssel.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-security-key.png)


Wenn Kunden mit dem Kommunikations-Widget auf Ihrer Website interagieren, fordert das Widget von Ihrem Webserver ein JWT an. Wenn dieses JWT bereitgestellt wird, nimmt das Widget es als Teil der Kontaktanfrage des Endkunden an Amazon Connect auf. Amazon Connect verwendet dann den geheimen Schlüssel, um das Token zu entschlüsseln. Bei Erfolg wird bestätigt, dass das JWT von Ihrem Webserver ausgestellt wurde, und Amazon Connect leitet die Kontaktanfrage an Ihre Kundendienstmitarbeiter im Contact Center weiter.

#### Einzelheiten zum JSON-Web-Token
<a name="jwt"></a>
+ Algorithmus: **HS256**
+ Claims:
  + **Sub**: *widgetId*

    Ersetzen Sie `widgetId` durch Ihre eigene WidgetID. Um Ihre widgetId zu finden, sehen Sie sich das Beispiel-[Skript für das Kommunikations-Widget](#communications-widget-script) an.
  + **iat**: \$1Ausgabezeitpunkt.
  + **exp**: \$1Flow (maximal 10 Minuten).
  + **segmentAttributes (optional)**: ein Satz von systemdefinierten Schlüssel-Wert-Paaren, die mithilfe einer Attributzuordnung in einzelnen Kontaktsegmenten gespeichert werden. Weitere Informationen finden Sie SegmentAttributes in der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-SegmentAttributes)API.
  + **Attribute (optional)**: Objekt mit string-to-string Schlüssel-Wert-Paaren. Die Kontaktattribute müssen den von der API festgelegten Einschränkungen entsprechen. [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-StartChatContact-request-Attributes)
  + **relatedContactId (optional)**: Zeichenfolge mit gültiger Kontakt-ID. Sie relatedContactId müssen die von der [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html)API festgelegten Einschränkungen einhalten.
  + **customerId (optional)**: Dies kann entweder eine ID von Amazon Connect Customer Profiles oder eine benutzerdefinierte Kennung aus einem externen System, z. B. einem CRM, sein. 

  \$1Informationen zum Datumsformat finden Sie im folgenden Dokument der Internet Engineering Task Force (IETF): [JSON Web Token (JWT)](https://tools.ietf.org/html/rfc7519), Seite 5. 

Der folgende Codeblock zeigt ein Beispiel für die Generierung eines JWT in Python:

```
import jwt 
import datetime 
CONNECT_SECRET = "your-securely-stored-jwt-secret" 
WIDGET_ID = "widget-id" 
JWT_EXP_DELTA_SECONDS = 500

payload = { 
'sub': WIDGET_ID, 
'iat': datetime.datetime.utcnow(), 
'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 
'customerId': "your-customer-id",
'relatedContactId':'your-relatedContactId',                    
'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } 
header = { 'typ': "JWT", 'alg': 'HS256' } 
encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
```

### Skript für das Kommunikations-Widget
<a name="communications-widget-script"></a>

Die folgende Abbildung zeigt ein Beispiel für JavaScript das, was Sie auf Websites einbetten, auf denen Kunden mit Ihrem Kontaktzentrum interagieren sollen. Dieses Skript zeigt das Widget in der unteren rechten Ecke Ihrer Website an. 

**Anmerkung**  
Fügen Sie das Widget-Skript in das HTML-Element ein, das das Widget rendern muss, wenn Sie den eingebetteten Inline-Stil verwenden.

![\[Skript für das Kommunikations-Widget\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-code.png)


Wenn Ihre Website geladen wird, sehen Kunden zuerst das Widget-Symbol. Wenn sie dieses Symbol auswählen, wird das Kommunikations-Widget geöffnet und die Kunden können einen Kontakt mit Ihren Kundendienstmitarbeitern initiieren.

Sie können jederzeit Änderungen am Kommunikations-Widget über **Bearbeiten** vornehmen.

**Anmerkung**  
Gespeicherte Änderungen aktualisieren die Kundenumgebung in wenigen Minuten. Überprüfen Sie Ihre Widget-Konfiguration, bevor Sie sie speichern. 

![\[Der Link zum Bearbeiten in der Widget-Vorschau.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-edit.png)


Damit Änderungen an Widget-Symbolen auf der Website wirksam werden, müssen Sie Ihre Website direkt mit einem neuen Codeblock aktualisieren.

# Aktivieren von Apple Messages for Business in Amazon Connect
<a name="apple-messages-for-business"></a>

Ihre Kunden können über die Nachrichten-Anwendung auf ihrem iPhone, iPad und Mac direkt mit Ihrem Contact Center interagieren. 

Wenn Sie Apple Messages for Business aktivieren, können Ihre Kunden Antworten auf ihre Fragen finden und Kundendienstmitarbeiter um Hilfe bitten, um Probleme zu lösen. Dabei nutzen sie weiterhin die vertraute Nachrichten-Anwendung, mit der sie täglich mit Freunden und Familie chatten. Immer, wenn Kunden die Suche, Safari, Spotlight, Siri oder Maps verwenden, um Ihre registrierte Telefonnummer anzurufen, erhalten sie die Möglichkeit, mit Ihrem Contact Center zu chatten. 

Durch die Integration von Apple Messages for Business in Amazon Connect können Sie dieselbe Benutzeroberfläche für die Konfiguration, Analyse- und Weiterleitungsfunktionen sowie Kundendienstmitarbeiter verwenden, die Sie bereits für den [Amazon-Connect-Chat](web-and-mobile-chat.md) nutzen.

## Voraussetzungen: Feststellen, ob Apple Messages for Business der richtige Kanal für Ihren Anwendungsfall ist
<a name="apple-messages-for-business-prerequisites"></a>

Um sich als Unternehmen zu qualifizieren, stellen Sie sicher, dass Sie die in der [Dokumentation zu Apple Messages for Business](https://register.apple.com/resources/messages/messaging-documentation/#qualifying-as-a-business) aufgeführten Kriterien erfüllen.

Wenn Sie feststellen, dass Apple Messages for Business der richtige Kanal für Ihr Unternehmen ist, füllen Sie die folgenden Formulare aus:
+ [Dokument zur Bereitschaft für Apple Messages for Business](https://register.apple.com/resources/messages/messaging-documentation/resources/Messages-for-Business_Readiness.pdf)
+ [Beschreibung Ihrer vier Hauptanwendungsfälle für Apple Messages for Business](https://register.apple.com/resources/messages/messaging-documentation/resources/Messages-for-Business_UseCases.pdf)

## Schritt 1: Registrieren bei Apple
<a name="register-with-apple"></a>

Integrieren Sie Apple Messages for Business in Amazon Connect, indem Sie sich zunächst als Marke bei Apple registrieren. Wenn Sie dies tun, erhalten Sie eine eindeutige Konto-ID für Apple Messages for Business und können dann Ihr Konto bei Apple Messages for Business mit Amazon Connect verknüpfen. 

1. Rufen Sie die Seite [Apple Messages for Business](https://register.apple.com/business-chat) auf. Wählen Sie in dem Feld **As a business, I want to connect with my customers in the Messages app** die Option **Get Started** aus.

1. Erstellen Sie eine Apple-ID für Ihr Unternehmen, falls Sie noch keine haben.

   Eine Apple-ID ist in der Regel für den privaten Gebrauch von Apple-Services vorgesehen, z. B. zum Speichern persönlicher Inhalte in der iCloud und zum Herunterladen von Apps aus dem App Store. Wenn Sie eine persönliche Apple-ID haben, empfehlen wir, zum Verwalten von Messages for Business getrennt davon eine ID mit der E-Mail-Adresse Ihres Unternehmens zu erstellen. Mit einer separaten administrativen Apple-ID können Sie Nachrichten in Messages for Business besser von Ihrer privaten Apple-Kommunikation unterscheiden.

1. Registrieren Sie ein Profil für ein neues Konto bei Messages for Business, indem Sie die **Nutzungsbedingungen von Apple** akzeptieren. Wir empfehlen die Erstellung eines [kommerziellen Messages-for-Business-Kontos](https://register.apple.com/resources/messages/messaging-documentation/register-your-acct#create-a-commercial-business-chat-account). Anschließend geben Sie Geschäftsdetails wie ein Logo und die Geschäftszeiten des Supports an.

1. Wählen Sie Amazon Connect als Ihren Serviceanbieter für Messaging aus. Wählen Sie dazu Amazon Connect in der Dropdownliste aus oder geben Sie die folgende URL ein:
   + **https://messagingintegrations.connect.amazonaws.com/applebusinesschat**

Nachdem Sie die Anfrage an Apple gesendet haben, wird der Status der Anfrage oben auf der Seite **Messages for Business Account** angezeigt.

Weitere Informationen zur Registrierung bei Apple finden Sie in den folgenden Artikeln auf der Apple-Website: [Getting Started with Messages for Business](https://register.apple.com/resources/business-chat/BC-GettingStarted.pdf) und [Messages for Business Policies and Best Practices](https://register.apple.com/resources/business-chat/BC-Policies_and_Best_Practices.pdf). 

## Schritt 2: Zusammenstellen erforderlicher Informationen
<a name="gather-apple-messages-for-business-information"></a>

Stellen Sie die folgenden Informationen zusammen, damit Sie sie griffbereit haben, wenn Sie in Schritt 3 ein Support-Ticket öffnen:

1. **ID des Kontos bei Apple Messages for Business**: Nachdem Ihre Anfrage von Apple Messages for Business bestätigt wurde, erhalten Sie eine ID für Ihr Konto bei Apple Messages for Business. Informationen dazu, wie Sie die ID Ihres Kontos bei Apple Messages for Business finden, erhalten Sie unter [Suchen der ID Ihres Kontos bei Apple Messages for Business für Ihre Integration in Amazon Connect](find-apple-messages-for-business-account-id.md). 
**Anmerkung**  
Die ID Ihres Kontos bei Apple Messages for Business besteht aus einer zufälligen Folge von Zahlen und Buchstaben. Sie entspricht nicht Ihrer Apple-ID. 

1. **Apple-Token**: Dies ist eine eindeutige ID, mit der Ihr Konto authentifiziert wird. Hilfe dazu, wie Sie Ihr Apple-Token finden, erhalten Sie unter [Suchen Ihres Apple-Tokens bei der Integration von Apple Messages for Business in Amazon Connect](find-apple-token-id.md).

1. **ARN der Amazon-Connect-Instance**: Dies ist die Kennung für die Instance, die Sie mit Ihrem Apple-Geschäftskonto verknüpfen möchten. Informationen dazu, wie Sie Ihre Instance-ID finden, erhalten Sie unter [Suchen Ihrer Instance-ID oder des ARN von Amazon Connect](find-instance-arn.md).
**Anmerkung**  
Stellen Sie sicher, dass serviceverknüpfte Rollen für die Integration aktiviert sind.   
Wenn Ihre Instance vor **Oktober 2018** erstellt wurde, fügen Sie die Richtlinie `connect:*` für die Rolle hinzu, die Ihrer Amazon-Connect-Instance zugeordnet ist. Weitere Informationen zu serviceverknüpften Rollen finden Sie unter [Verwenden von serviceverknüpften Rollen und Rollenberechtigungen für Amazon Connect](connect-slr.md). 

1. **Flow-ID von Amazon Connect**: Dies ist die Kennung für den Flow, den Sie für eingehende Chats verwenden möchten. Informationen dazu, wie Sie Ihre Flow-ID finden, erhalten Sie unter [Suchen der Ablauf-ID bei der Integration von Apple Messages for Business in Amazon Connect](find-contact-flow-id.md).

## Schritt 3: Verknüpfen der ID von Apple Messages for Business mit Amazon Connect
<a name="link-apple-messages-for-business"></a>

In diesem Schritt erstellen Sie ein Support-Ticket in Amazon Connect, um Ihre ID von Apple Messages for Business mit Amazon Connect zu verknüpfen. 

1. Erstellen Sie ein [spezielles Support Ticket](https://support.console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-chime-end-user&categoryCode=other), um Ihre Apple Messages for Business mit Amazon Connect zu verknüpfen.

   Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem AWS Konto an. 
**Tipp**  
Sie benötigen technischen Support? [Eröffnen Sie hier ein Support Ticket](https://console.aws.amazon.com/support/home). 

1. Wählen Sie **Konto und Fakturierung** aus.

1. Wählen Sie über das Dropdown-Feld die Option **Chime (Endbenutzer)** aus. Wählen Sie als **Kategorie** die Option **Aktivierung** und dann **Nächster Schritt: Zusätzliche Informationen** aus.

1. Geben Sie als **Betreff** den Text **Integrationsanfrage für Apple Messages for Business** ein.

1. Fügen Sie in das Feld **Beschreibung** die folgende Vorlage ein: 

   ```
   Subject: Apple Messages for Business Integration request
      Body:
   
      Apple Messages for Business Account ID (required): enter your account ID
      Apple Token (required): enter your Apple token
      Amazon Connect Instance ARN (required): enter your instance ARN
      Amazon Connect Flow ID (required): enter your flow ID
   ```

1. Fügen Sie die beiden Formulare aus dem Abschnitt [Voraussetzungen](#apple-messages-for-business-prerequisites) dem Support-Ticket an.
**Anmerkung**  
Dieser Schritt ist erforderlich. Ihre Anfrage wird nicht bearbeitet, wenn Sie diese Formulare nicht anfügen.

   Die folgende Abbildung zeigt ein Beispiel für ein abgeschlossenes Ticket.  
![\[Ein Beispiel für ein abgeschlossenes Ticket\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-sample-use-case-description.png)

1. Klicken Sie auf **Nächster Schritt**.

1. Wählen Sie **Kontaktieren Sie uns** aus, geben Sie Ihre **Bevorzugte Kontaktsprache** an und wählen Sie **Web** als Kontaktmethode aus, falls die Option nicht standardmäßig ausgewählt ist.  
![\[Die Kontaktmöglichkeiten\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-contact-support-options.png)

1. Wählen Sie **Absenden** aus.

1. Support wird bei Ihrer Anfrage direkt mit dem Amazon Connect Connect-Team zusammenarbeiten und sich bei weiteren Fragen melden.

### Nächste Schritte
<a name="enable-apple-messages-for-business-next-steps"></a>

Nachdem Apple Messages for Business für Ihre Amazon-Connect-Instance aktiviert wurde, können Sie Features[ von Apple Messages for Business zu Ihren Nachrichten hinzufügen](add-apple-messages-for-business-features.md). Beispiele:
+ Umleiten von Anrufen mit Apple Message Suggest
+ Einbetten der Schaltflächen von Apple Messages for Business in Ihre Website
+ Hinzufügen von Elementen zur Listen- und Zeitauswahl, Formularen sowie Schnellantworten zu Ihren Nachrichten
+ Hinzufügen von Apple Pay, iMessage-Apps und Authentifizierung zu Ihrer Integration
+ Verwenden Sie umfangreiche Links für URLs.
+ Routing von Nachrichten in Apple Messages for Business mithilfe von Kontaktattributen
+ Aktivieren von Anhängen für Ihre Integration

Zusätzlich müssen Sie die [Überprüfung des Benutzererlebnisses durch Apple](https://register.apple.com/resources/messages/messaging-documentation/xp-review) bestehen.

## Schritt 4: Erstellen und Senden einer Aufzeichnung des Benutzererlebnisses zur späteren Überprüfung
<a name="experience-apple-messages-for-business"></a>

Nehmen Sie ein Demo-Benutzererlebnis zur späteren Überprüfung durch Amazon Connect und Apple Messages for Business auf. Das Video muss die Benutzerführung im Produktivbetrieb des Kontos (über alle Anwendungsfälle hinweg) genau wiedergeben. Laden Sie ausschließlich eine Aufzeichnung aus der Sicht des Benutzers (vom Gerät des Benutzers) hoch. Sie müssen keine Aufzeichnungen von der Kundendienstmitarbeiterkonsole oder dem im Backend aktivierten Bot senden. Sie können das Video bei Bedarf in mehrere Teile aufteilen. Demonstrieren Sie die [umfangreichen Features](https://register.apple.com/resources/messages/messaging-documentation/customer-journey#interactive-features), die Sie in das Erlebnis, die Interaktion mit den Live-Kundendienstmitarbeitern und alle [Nachrichten außerhalb der Geschäftszeiten](https://register.apple.com/resources/messages/messaging-documentation/ux-design#automated-messaging) integriert haben. Stellen Sie sicher, dass Sie die [bewährten Methoden](https://register.apple.com/resources/messages/messaging-documentation/ux-design#best-practices) und [Richtlinien](https://register.apple.com/resources/messages/messaging-documentation/policies) von Apple Messages for Business befolgen.

**Tipps zur Entwicklung des Benutzererlebnisses**
+ **Einführungs-/Willkommensnachricht:** Die automatische Antwort auf die erste Nachricht in einer neuen Konversation sollte innerhalb von 5 Sekunden durch ein automatisiertes System erfolgen. Wenn der Kunde eine Konversation mit einem automatisierten System beginnt, stellen Sie eine Nachricht wie **Das ist ein automatisierter Agent** oder **Ich bin ein automatisierter Agent** bereit. Weitere Informationen finden Sie unter [Automatisiertes Messaging](https://register.apple.com/resources/messages/messaging-documentation/ux-design#automated-messaging).
+ **Nutzungsbedingungen und Datenschutzerklärungen:** Diese sollten über einen [Rich Link](https://register.apple.com/resources/messages/msp-rest-api/type-richlink#rich-link-messages) zur Website der Marke abgewickelt werden, sodass Benutzer die vollständigen Nutzungsbedingungen nach Belieben lesen können. Senden Sie keine großen Textblöcke mit rechtlichen Hinweisen in der Konversation. Diese sollten nur beim ersten Kontakt eines Benutzers mit dem Kanal der Marke gesendet werden oder wenn die Nutzungsbedingungen aktualisiert wurden.
+ **Erste Einstufung:** Zu Beginn der Interaktion sollte ein Einstufungsmenü gesendet werden. So können Sie den Benutzer schnell anleiten und ihm helfen. Sie können eine Schnellantwortnachricht verwenden (bis zu 5 Optionen). Weitere Informationen finden Sie unter [Einstufen von Kunden](https://register.apple.com/resources/messages/messaging-documentation/ux-design#triage-customers).
+ **Vorstellen:** Stellen Sie Live-Kundendienstmitarbeiter immer vor, wenn eine Konversation beginnt und nachdem ein Kunde an einen neuen Kundendienstmitarbeiter weitergeleitet wurde.
+ **Verfügbarkeit des Live-Supports:** Wenn ein Kunde außerhalb der normalen Kundenservicezeiten Hilfe anfordert, wenn Live-Kundendienstmitarbeiter nicht verfügbar sind, sollte er in einer automatisierten Antwort darüber informiert werden, wann ein Live-Kundendienstmitarbeiter antworten kann. Weitere Informationen finden Sie unter [Automatisiertes Messaging](https://register.apple.com/resources/messages/messaging-documentation/ux-design#automated-messaging).
+ **Den Wechsel von einem automatisierten Agent zu einem Live-Kundendienstmitarbeiter erlauben:** Ein Live-Kundendienstmitarbeiter muss immer dann erreichbar sein, wenn der Kunde das Wort „Hilfe“ sendet. Zusätzlich muss ein automatisierter Agent, wenn er eine Anfrage nicht versteht, nahtlos zu einem Live-Kundendienstmitarbeiter überleiten, nachdem er eine Nachricht wie „Ich leite Ihre Nachricht an einen Live-Kundendienstmitarbeiter weiter, um Sie besser zu unterstützen“ angezeigt hat.
+ **Nicht nach zuvor bereitgestellten Informationen fragen:** Kundendienstmitarbeiter können auf den gesamten Konversationsverlauf zugreifen, einschließlich früherer Antworten und letzter Transaktionen, sodass Sie einen Kunden nicht bitten müssen, Informationen zu wiederholen.
+ **Rich Link:** Alle URLs sollten als Rich Links gesendet werden. Das bedeutet, dass keine tap-to-load Probleme oder In-Text-Links gesendet werden sollten. Weitere Informationen finden Sie unter [Verwenden Sie Rich-Links für URLs](add-apple-messages-for-business-features.md#rich-links).
+ **Feature-Textblöcke:** Sollten über ein relevantes Vorschaubild und einen Call-to-Action-Text verfügen, damit Kunden den Inhalt des Features klar verstehen und sie als ein Element erkennen, auf das getippt werden kann
+ **Wir empfehlen die Verwendung von Zufriedenheitsumfragen:** Sobald Sie eine Interaktion mit einem Kunden abgeschlossen haben, möchten Sie ihm möglicherweise eine Umfrage zur Kundenservicezufriedenheit (Customer Service Satisfaction, CSAT) anbieten. Für ein besseres Kundenerlebnis sollten Sie die CSAT-Umfragen erst nach dem Erlebnis und nicht nach jeder häufig gestellten Frage durchführen. Weitere Informationen finden Sie unter [Umfragen zur Kundenzufriedenheit](https://register.apple.com/resources/messages/messaging-documentation/ux-design#satisfaction-surveys).
+ **Eingabeindikatoren:** Wenn ein Live-Kundendienstmitarbeiter oder ein automatisierter Agent mit der Eingabe beginnt, sollte der Eingabeindikator angezeigt werden, damit das Erlebnis einheitlich ist. Der Eingabeindikator sollte vor jedem Nachrichtentyp (Text oder interaktiv) angezeigt werden. Verwenden Sie für Nachrichten, die von Bots gesendet werden, sowie für Nachrichten, die nacheinander gesendet werden, vor jeder Nachricht nur 1 Sekunde lang Eingabeindikatoren. Weitere Informationen finden Sie unter [Eingabeindikatornachricht](https://register.apple.com/resources/messages/msp-rest-api/common-specs#typingindicatormessage).

Nachdem Ihre Aufzeichnung des Benutzererlebnisses zur späteren Überprüfung erstellt wurde, können Sie erneut ein Amazon-Connect-Supportticket zum Teilen erstellen. Vor der endgültigen Genehmigung erhalten Sie Feedback von Amazon Connect und Apple Messages for Business.

1. Erstellen Sie ein [spezielles Support Ticket](https://support.console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=service-chime-end-user&categoryCode=other), um Ihre Aufzeichnung der Erlebnisbewertung mit anderen zu teilen. Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem AWS Konto an.

1. Wählen Sie **Konto und Fakturierung** aus.

1. Wählen Sie über das Dropdown-Feld die Option **Chime (Endbenutzer)** aus. Wählen Sie als **Kategorie** die Option **Aktivierung** und dann **Nächster Schritt: Zusätzliche Informationen** aus.

1. Geben Sie als **Betreff** **Anfrage zur Überprüfung des Benutzererlebnisses durch Apple Messages for Business** ein.

1. Fügen Sie in das Feld **Beschreibung** die folgende Vorlage ein:

   ```
   Subject: Apple Messages for Business Experience Review request
   
   Body:
   
      Apple Messages for Business Account ID (required): enter your account ID
   ```

1. Fügen Sie die Aufzeichnung des Benutzererlebnisses zur späteren Überprüfung an.

1. Klicken Sie auf **Nächster Schritt**.

1. Wählen Sie **Kontaktieren Sie uns** aus, geben Sie Ihre **Bevorzugte Kontaktsprache** an und wählen Sie **Web** als Kontaktmethode aus, falls die Option nicht standardmäßig ausgewählt ist.

1. Wählen Sie **Absenden** aus.

1. Support arbeitet bei Ihrer Anfrage direkt mit dem Amazon Connect Connect-Team zusammen und beantwortet Ihr Feedback.

# Senden einer Testnachricht für Apple Messages for Business zum Testen der Integration in Amazon Connect
<a name="send-test-message"></a>

Gehen Sie nach dem Onboarding für das Konto bei Apple Messages for Business wie folgt vor, um eine Testnachricht zu senden und so sicherzustellen, dass die Integration ordnungsgemäß eingerichtet ist.

## Schritt 1: Hinzufügen interner Tester zu Ihrem Konto bei Messages for Business
<a name="add-internal-tester"></a>

1. Melden Sie sich bei [Apple Business Register](https://register.apple.com/) an. 

1. Wählen Sie **Messages for Business Accounts** und dann das Konto aus, um Tester hinzuzufügen. 

1. Scrollen Sie auf der Seite nach unten zu **Account Testing**.

1. Fügen Sie das Apple IDs Ihrer internen Tester hinzu. 

1. Wenn Ihre Liste vollständig ist und Sie mit Tests beginnen können, wählen Sie **Send to new testers** aus, um Ihren Testern eine E-Mail mit einer Anleitung zu senden. 

Eine E-Mail mit einer Anleitung und einem Link zu Ihrer Konversation in Messages for Business wird an die mit der Apple-ID verknüpfte E-Mail-Adresse der einzelnen Tester gesendet. Wenn Tester die E-Mail nicht erhalten, überprüfen Sie noch einmal, ob ihre E-Mail-Adresse im Abschnitt „Account Testing“ angegeben ist. Die E-Mail-Adresse ist möglicherweise falsch oder nicht mit einer Apple-ID verknüpft. Aus Sicherheitsgründen kann Apple E-Mail-Adressen, die mit Apple-IDs verknüpft sind, nicht verifizieren. 

## Schritt 2: Testen des Sendens und Empfangens von Nachrichten
<a name="test-send-receive-messages"></a>

Wenn Ihre Tester die E-Mail mit der Anleitung erhalten, müssen sie den darin enthaltenen Link aktivieren. Danach können sie Nachrichten an Ihre Kundendienstmitarbeiter senden, die dann vom Contact Control Panel (CCP) aus antworten können. 

Beachten Sie Folgendes:

1. Entwerfen Sie einen Test, mit dem sich alle Ihre Features von Apple Messages for Business auslösen lassen.

1. Sie sollten beobachten können, dass Nachrichten, die von einem iOS-Gerät gesendet werden, in Ihrem Testunternehmen ankommen. Mitarbeiter, die von Ihrem Desktop für Kundendienstmitarbeiter aus testen, sollten in der Lage sein, auf diese Testnachrichten antworten können.

1. Ihre Tester stellen möglicherweise fest, dass Ihre Markenfarben in der Nachrichtenkopfzeile nicht sichtbar sind. Markenfarben sind nicht verfügbar, solange sich Ihr Konto im Testmodus befindet. Die Farben für Ihre Marke werden korrekt angezeigt, nachdem Ihr Konto online gegangen ist. 

1. Wenn Sie den Testlink an eine Person senden, deren E-Mail-Adresse nicht im Abschnitt „Account Testing“ aufgeführt ist, kann diese keine Nachrichten senden.

1. Wenn Sie eine Weiterleitungsseiten-URL angeben und Ihre Tester versuchen, Messages for Business auf einem nicht unterstützten Gerät aufzurufen, wird ihnen entweder eine Standardseite oder eine weitergeleitete Seite angezeigt. Sie können Ihre Weiterleitungsseiten-URL im Abschnitt **Unsupported Devices** unten auf Ihrer Kontoseite bei Messages for Business festlegen.

**Beginnen Sie Tests wie folgt**

1. Vergewissern Sie sich, dass Ihre Tester ein Gerät mit einer unterstützten Betriebssystemversion verwenden: iOS 11.3 und höher oder macOS 10.13.4.

1. Bitten Sie Ihre Tester, Folgendes zu tun: 

   1. Suchen der an sie gesendeten E-Mail auf Ihren unterstützten Geräten

   1. Öffnen der E-Mail auf dem unterstützten Gerät und Auswählen des Links. Die Tester werden zu einer Messages-for-Business-Konversation in der Nachrichten-App weitergeleitet.

## Fehlerbehebung
<a name="troubleshoot-test-messages"></a>

Wenn beim Senden der Testnachricht Probleme auftreten, gehen Sie wie folgt vor: 

1. Bestätigen Sie, dass Sie Ihre address/Apple E-Mail-ID als Tester in Ihrem Messages for Business-Konto zugelassen haben.

1. Prüfen Sie die folgenden Einstellungen auf Ihrem Apple-Gerät:
   + Gehen Sie zu **Einstellungen** > **Nachrichten** und überprüfen Sie, ob **iMessage** aktiviert ist.
   + Gehen Sie zu **Einstellungen** > **Nachrichten** > **Senden & Empfangen** und überprüfen Sie, ob die Apple-ID korrekt ist und Nachrichten empfangen werden dürfen.

1. Vergewissern Sie sich, dass Sie eine unterstützte iOS-Version verwenden. Apple-Geräte mit iOS 11.3 und höher oder macOS 10.13.4 und höher unterstützen Messages for Business.

1. Als Sie Amazon Connect als Ihren MSP in Ihrem Apple-Konto ausgewählt haben: Haben Sie **Amazon Connect** in der Dropdownliste ausgewählt? Oder haben Sie die folgende URL eingegeben:
   + https://messagingintegrations.connect.amazonaws.com/applebusinesschat

   Wenn Sie die URL eingegeben haben, prüfen Sie sie auf Tippfehler.

1. Bestätigen Sie im [Apple Business Register](https://register.apple.com/), dass Ihr Apple-Geschäftskonto **online** ist. Befindet sich das Konto im Status „Ausstehend“, wählen Sie **Zur Überprüfung senden** aus. Dies muss wiederholt werden, nachdem Sie weitere Änderungen an der Apple-ID-Zulassungsliste oder andere Änderungen an der Konfiguration des Apple-Geschäftskontos vorgenommen haben.

# Aktivieren der Authentifizierung für Apple Messages for Business
<a name="enabling-authentication-for-apple-messages-for-business"></a>

Navigieren Sie zunächst zu Ihrem Identitätsanbieter, um mit dem Einrichtungsprozess zu beginnen.

## Konfiguration des Identitätsanbieters
<a name="apple-messages-for-business-identity-provider-configuration"></a>

 Die folgende Amazon-Connect-Domain muss als zulässiges Umleitungs-URI für die zur Authentifizierung verwendeten Identitätsanbieter registriert werden: 

```
https://participant.connect.region.amazonaws.com/participant/authentication/update
```

## Integration in Amazon Cognito
<a name="apple-messages-for-business-integration-with-aws-cognito"></a>

 Sie können [Ihre Identitätsanbieter zu einem bestehenden Amazon-Cognito-Benutzerpool hinzufügen](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-provider.html) oder einen neuen [Amazon-Cognito-Benutzerpool](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html) erstellen.

 In diesem Benutzerpool können Sie einen [App-Client](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html) erstellen und einige oder alle Ihrer Identitätsanbieter auswählen. Notieren Sie sich die Client-ID des App-Clients. Für diesen App-Client muss die folgende Amazon-Connect-Domain als zulässige Rückruf-URL hinzugefügt werden: 

```
https://participant.connect.region.amazonaws.com/participant/authentication/update
```

**Anmerkung**  
Sie müssen bei der Konfiguration des App-Clients von Amazon Cognito die Option **Kein Client-Geheimnis generieren** auswählen. Es werden nur App-Clients von Amazon Cognito ohne geheimen Clientschlüssel unterstützt.

## Konfigurieren Ihres App-Clients von Amazon Cognito mit dem Apple Messages for Business Portal
<a name="configuring-your-cognito-app-client-with-the-apple-messages-for-business-portal"></a>

 **Konfigurieren Sie bei der **integrierten OAuth2 Authentifizierung** Ihre Client-ID der Amazon Cognito-App als **Client-ID** und den [Autorisierungsendpunkt](https://docs.aws.amazon.com/cognito/latest/developerguide/authorization-endpoint.html) Ihrer Amazon Cognito Cognito-Benutzerpool-Domain als URL. OAuth **

![\[Kundenauthentifizierung für Amazon-Cognito-Benutzerpools\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/configuring-your-cognito-app-client-with-the-apple-messages-for-business-portal.png)


## Konfigurieren Ihres Benutzerpools mit Amazon Connect
<a name="configuring-your-user-pools-with-connect"></a>

 Ordnen Sie auf der Seite **Kundenauthentifizierung** in der Amazon-Connect-Konsole den Benutzerpool zu, der für die Authentifizierung verwendet werden soll. 

![\[Kundenauthentifizierung für Amazon-Cognito-Benutzerpools\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/configuring-your-user-pools-with-connect.png)


## Aktivieren von Amazon Connect Customer Profiles
<a name="apple-messages-for-business-configuring-amazon-connect-customer-profiles"></a>

**Aktivieren von Customer Profiles**

 Stellen Sie auf der Seite **Customer Profiles** in der Amazon-Connect-Konsole sicher, dass Customer Profiles für Ihre Instance aktiviert ist. Wenn **Mit dieser Instance von Amazon Connect ist keine Customer-Profiles-Domain verknüpft.** angezeigt wird, dann siehe [Aktivieren von Customer Profiles für die Amazon-Connect-Instance](enable-customer-profiles.md).

![\[Aktivieren von Kundenprofilen in der Amazon-Connect-Konsole\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/apple-messages-for-business-configuring-amazon-connect-customer-profiles.png)


### Erteilen von Customer-Profile-Berechtigungen für Sicherheitsprofile (optional)
<a name="apple-messages-for-business-grant-customer-profile-permissions"></a>

 Informationen zum Erteilen von Benutzerberechtigungen (Agent, Administrator) für view/edit/publish Kundenprofile im Arbeitsbereich für Agenten finden Sie unter. [Aktualisieren von Customer-Profile-Berechtigungen für Kundendienstmitarbeiter](security-profile-customer-profile-agent.md) Nachdem die Berechtigungen für Sicherheitsprofile erteilt wurden, sollten Benutzer auf die Features im Workspace für Kundendienstmitarbeiter zugreifen können. 

 Eine ausführliche Liste der Berechtigungen finden Sie unter [Customer-Profiles-Sicherheitsprofilberechtigungen](security-profile-list.md#customerprofiles-permissions-list). 

## Konfigurieren des Ablaufblocks „Kunden authentifizieren“
<a name="apple-messages-for-business-authenticate-customer-flow-block"></a>

Detaillierte Anweisungen finden Sie unter [Flow-Block in Amazon Connect: Kundenauthentifizierung](authenticate-customer.md).

# Hinzufügen der Features von Apple Messages for Business
<a name="add-apple-messages-for-business-features"></a>

## Umleiten von Anrufen mit Apple Message Suggest
<a name="call-deflection"></a>

Mit [Message Suggest](https://register.apple.com/resources/messages/messaging-documentation/message-with-customers#triggering-message-suggest) können Sie es Nutzern ermöglichen, zwischen Sprach- und Nachrichtenservices zu wählen, wenn sie in Safari, Maps, Siri oder der Suche auf Ihre geschäftliche Telefonnummer tippen. 

Aktivieren Sie Message Suggest wie folgt: Senden Sie unter **registry@apple.com** eine E-Mail mit den folgenden Informationen an das Team von Apple Messages for Business. Apple kann den Kanal dann für Sie einrichten: 
+ Geben Sie alle Ihre primären Telefonnummern an, einschließlich Telefonnummern mit hohem Anrufaufkommen.
+ Geben Sie die Geschäftszeiten für Anrufe an, um die Erwartungen der Kunden bezüglich Nachrichten außerhalb der Geschäftszeiten zu steuern.
+ Geben Sie Parameter für Absicht, Gruppe und Text an, die den einzelnen Telefonnummern zugeordnet werden sollen.
+ Geben Sie eine Schätzung an, wie viele Kunden Ihre Kundendienstmitarbeiter pro Tag betreuen können. Dies kann je nach Betriebskapazität erhöht oder verringert werden.

Weitere Informationen zur Aktivierung von Message Suggest finden Sie unter [Message Suggest von Apple FAQs](https://register.apple.com/resources/business-chat/faq/business-chat-suggest-faqs.html). 

## Einbetten der Schaltflächen von Apple Messages for Business
<a name="embed-apple-messages-for-business-buttons"></a>

Betten Sie Schaltflächen von Apple Messages for Business wie folgt in Ihre Website oder mobile App ein:

1. Fügen Sie die JS-Bibliothek Messages for Business (JavaScript) von Apple zu Ihren Webseitenüberschriften hinzu.

1. Fügen Sie einen `div`-Container für die Schaltfläche hinzu.

1. Passen Sie das Banner, die Fallback-Unterstützung und die Farbe der Schaltfläche an die Anforderungen Ihrer Marke an.

Die Schaltfläche „Messages for Business“ muss mindestens Folgendes enthalten:
+ Ein Klassenattribut zur Angabe des Containertyps: Banner, Telefon oder Nachricht 
+ Ein data-apple-business-id Attribut mit der Geschäfts-ID, die Sie bei der Registrierung Ihres Unternehmens bei Messages for Business erhalten haben.

## Authentifizierung
<a name="add-apple-messages-for-busines-authentication"></a>

Durch die Authentifizierung können sich Kunden während einer Chat-Konversation bei einem oder mehreren Identitätsanbietern ihrer Wahl anmelden. Die Authentifizierungsfunktion nutzt das OAuth2 und das OIDC-Framework, um die Identität des Kunden bei erfolgreicher Anmeldung zu überprüfen. Weitere Informationen finden Sie unter. [Aktivieren der Authentifizierung für Apple Messages for Business](enabling-authentication-for-apple-messages-for-business.md)

## Starten eines Chats über eine URL
<a name="start-chat-from-url"></a>

Sie können Ihren Kunden ermöglichen, über Ihre Website oder eine E-Mail-Nachricht ein Gespräch mit Ihnen zu beginnen.

So können Kunden etwa einen Chat über eine von Ihnen angegebene URL starten. Wenn sie auf die URL klicken, leitet das System sie zur Nachrichten-Anwendung weiter, sodass sie Ihrem Unternehmen eine Nachricht senden können.

Sie entscheiden, wie und wo Sie die URL angeben. Sie können sie als Link in eine E-Mail-Nachricht oder auf Ihrer Website einfügen oder sie als Aktion für eine Schaltfläche in Ihrer App verwenden.

Verwenden Sie die URL **https://bcrw.apple.com/urn:biz:** und ersetzen Sie sie durch die Unternehmens-ID*your-business-id*, die Sie von Apple nach der Registrierung *your-business-id* bei Messages for Business erhalten haben.

Im Folgenden finden Sie optionale Abfragezeichenfolge-Parameter, die Sie in die URL aufnehmen können:
+ `biz-intent-id`: Wird verwendet, um die Absicht oder den Zweck des Chats anzugeben
+ `biz-group-id`: Wird verwendet, um die Gruppe, Abteilung oder Person anzugeben, die am besten für die Bearbeitung der jeweiligen Frage oder des jeweiligen Problems von Kunden geeignet ist
+ `body`: Wird verwendet, um die Nachricht vorab auszufüllen, sodass Kunden nur auf **Senden** klicken müssen, um das Gespräch zu beginnen

Im Folgenden finden Sie ein Beispiel dafür, wie die URL für Kunden aussehen könnte, die bezüglich ihrer Kreditkarte eine Frage an die Fakturierungsabteilung haben:
+ `https://bcrw.apple.com/urn:biz:22222222-dddd-4444-bbbb-777777777777?biz-intent-id=account_question&biz-group-id=billing_department&body=Order%20additional%20credit%20card`.

## Hinzufügen von Elementen zur Listen- und Zeitauswahl, Formularen, Anhängen sowie Schnellantworten
<a name="add-list-pickers-time-pickers"></a>

Über eine Listenauswahl werden Kunden aufgefordert, ein Element auszuwählen, z. B. ein Produkt oder den Grund für die Anfrage. Über eine Zeitauswahl werden Kunden aufgefordert, ein verfügbares Zeitfenster auszuwählen, z. B. um einen Termin zu vereinbaren. Über eine Schnellantwort werden Kunden aufgefordert, eine einfache Inline-Antwort auszuwählen. Mithilfe von Formularen können Sie umfangreiche, mehrseitige interaktive Abläufe für Kunden erstellen.

Informationen zum Einrichten von Listenauswahl, Zeitauswahl, Formularen und Schnellantworten finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md). 

Informationen zum Aktivieren von Anhängen finden Sie unter [Aktivieren von Anhängen zum Teilen von Dateien im Chat](enable-attachments.md).

## Apple Pay
<a name="apple-pay"></a>

Apple Pay ermöglicht es Verbrauchern, Einkäufe abzuschließen, ohne Bargeld oder physische Bankkarten verwalten zu müssen. Mit Apple Messages for Business können Verbraucher Transaktionen mit ihren Lieblingsmarken abschließen, ohne die Nachrichten-App verlassen zu müssen.

Apple Pay ist ein eigenständiges Feature, weist jedoch Ähnlichkeiten mit Apple Pay in der App und Apple Pay im Internet auf. Wenn ein Unternehmen einen Kunden, der Waren und Dienstleistungen über Apple Messages for Business kauft, um eine Zahlung bittet, kann der Kunde Apple Pay für die Zahlung verwenden.

![\[Ein Bild eines Smartphones, das Apple Pay verwendet\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/apple-pay-1.png)


Weitere Informationen zu Apple Pay finden Sie unter [Apple Pay für Entwickler](https://developer.apple.com/apple-pay/).

Informationen zum Einrichten von Apple Pay mithilfe von Connect finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md).

## iMessage-Apps
<a name="imessage-apps"></a>

iMessage-Apps oder Apple Custom Interactive Messages (CIM) erhöhen die Interaktivität zwischen Endkunden und Geschäftskunden, sodass Endkunden iMessage-Apps von Unternehmen erhalten können. Diese iMessage-Apps enthalten umfangreichere Informationen, mit denen Endkunden vollständig innerhalb der Nachrichten-App von Apple interagieren können. So kann der Endkunde in der Konversation bleiben, um dieselben Interaktionen durchzuführen. Dadurch ist eine Apple CIM anpassbarer als andere bestehende interaktive Nachrichtentypen. 

Die folgende Abbildung zeigt ein Beispiel für eine iMessage-App, die über eine Apple CIM mit einer detaillierten Karte und einer Standortnadel gesendet wurde:

![\[Ein Bild einer iMessage-App, die über eine Apple CIM gesendet wurde, mit detaillierter Karte und Standortnadel\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/imessage-apps-1.png)


Informationen zum Einrichten von iMessage-Apps mithilfe von Amazon Connect finden Sie unter [Hinzufügen von interaktiven Amazon-Lex-Nachrichten für Kunden im Chat](interactive-messages.md).

## Verwenden Sie Rich-Links für URLs
<a name="rich-links"></a>

Rich Links zeigen eine Inline-Vorschau einer URL an, die ein Bild oder Video enthält. Anders als üblich URLs können Kunden die Bild- oder Videovorschau sofort in einem Chat ansehen, ohne die Meldung „Vorschau durch Tippen laden“ auswählen zu müssen. 

### Anforderungen für die Verwendung von Rich Links in Amazon Connect
<a name="rich-links-requirements"></a>

Zur Verwendung von Rich Links in Amazon-Connect-Chatnachrichten müssen Ihre URL und Bilder die folgenden Anforderungen erfüllen:
+ Ihre Website muss Open-Graph-Tags von Facebook verwenden. Weitere Informationen finden Sie unter [Leitfaden zum Teilen für Webmaster](https://developers.facebook.com/docs/sharing/webmasters/). 
+ Das Bild zur URL muss im Format JPEG, JPG oder PNG sein.
+ Die Website muss im HTML-Format sein.

**Anmerkung**  
Wenn Sie das Feature für Rich Links das erste Mal verwenden, empfehlen wir, die URL in einer von Ihrem Chat-Text getrennten Nachricht zu senden, wie im folgenden Beispiel zu sehen. In der ersten Nachricht wird die URL vorgestellt. In der nächsten Nachricht ist die URL enthalten.  

![\[Eine in einer Chat-Nachricht gesendete URL\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-rich-link.png)


## Verwenden der Kontaktattribute von Apple Messages for Business in Kontakt-Flows
<a name="apple-messages-for-business-flows"></a>

Kontaktattribute ermöglichen das Speichern temporärer Informationen über den Kontakt, sodass Sie diese im Flow verwenden können. 

Wenn du zum Beispiel verschiedene Geschäftsbereiche hast, die Apple Messages for Business verwenden, kannst du je nach **AppleBusinessChatGroup**Kontaktattribut zu unterschiedlichen Flows wechseln. Oder, wenn du Nachrichten von Apple Messages for Business anders weiterleiten möchtest als andere Chat-Nachrichten, kannst du die Verzweigung auf der Grundlage von vornehmen MessagingPlatform. 

Weitere Informationen zu Kontaktattributen finden Sie unter [Amazon-Connect-Kontaktattribute verwenden](connect-contact-attributes.md). 

Verwenden Sie die folgenden Kontaktattribute für das Routing von Kunden in Apple Messages for Business. 


| Attribut | Description | Typ | JSON | 
| --- | --- | --- | --- | 
|  MessagingPlatform  |  Die Messaging-Plattform, von der die Kundenanfrage stammt.  Exakter Wert: **AppleBusinessChat**  | Benutzerdefiniert | \$1.Attribute. MessagingPlatform | 
|  AppleBusinessChatCustomerId  |  Die opake ID des Kunden, die von Apple bereitgestellt wird. Diese wird für die AppleID und ein Unternehmen beibehalten. Sie können diese verwenden, um festzustellen, ob die Nachricht von einem neuen Kunden oder einem wiederkehrenden Kunden stammt.  | Benutzerdefiniert | \$1.Attribute. AppleBusinessChatCustomerId | 
|  AppleBusinessChatIntent  |  Sie können die Absicht oder den Zweck des Chats definieren. Dieser Parameter ist in einer URL enthalten, die eine Chat-Sitzung in Messages initiiert, wenn Kunden die Schaltfläche **Business Chat** auswählen.  | Benutzerdefiniert | \$1.Attribute. AppleBusinessChatIntent | 
|  AppleBusinessChatGroup  |  Sie definieren die Gruppe, die die am besten für die Bearbeitung der speziellen Frage oder des Problems des Kunden qualifizierte Abteilung oder Personen festlegt. Dieser Parameter ist in einer URL enthalten, die eine Chat-Sitzung in Messages initiiert, wenn Kunden die Schaltfläche **Business Chat** auswählen.   | Benutzerdefiniert | \$1.Attribute. AppleBusinessChatGroup | 
|  AppleBusinessChatLocale  |  Definiert die Sprach- und AWS Regionseinstellungen, die der Benutzer auf seiner Benutzeroberfläche sehen möchte. Diese bestehen aus einer Sprachkennung (ISO 639-1) und einer Regionskennung (ISO 3166). Beispiel: **en\$1US**.   | Benutzerdefiniert | \$1.Attribute. AppleBusinessChatLocale | 
|  AppleFormCapability  |  Gibt an, ob das Kundengerät Formulare unterstützt. Falls „true“, wird das Kundengerät unterstützt. Falls „false“, wird das Gerät nicht unterstützt.  | Benutzerdefiniert | \$1.Attribute. AppleFormCapability | 
|  AppleAuthenticationCapability  |  Ob das Kundengerät Authentifizierung unterstützt (OAuth2). Falls „true“, wird das Kundengerät unterstützt. Falls „false“, wird ihr Gerät nicht unterstützt.  | Benutzerdefiniert | \$1.Attribute. AppleAuthenticationCapability | 
|  AppleTimePickerCapability  |  Gibt an, ob das Kundengerät Zeitauswahl unterstützt. Falls „true“, wird das Kundengerät unterstützt. Falls „false“, wird das Gerät nicht unterstützt.  | Benutzerdefiniert | \$1.Attribute. AppleTimePickerCapability | 
|  AppleListPickerCapability  |  Gibt an, ob das Kundengerät Listenauswahl unterstützt. Falls „true“, wird das Kundengerät unterstützt. Falls „false“, wird das Gerät nicht unterstützt.  | Benutzerdefiniert | \$1.Attribute. AppleListPickerCapability | 
|  AppleQuickReplyCapability  |  Gibt an, ob das Kundengerät Schnellantworten unterstützt. Falls „true“, wird das Kundengerät unterstützt. Falls „false“, wird das Gerät nicht unterstützt.  | Benutzerdefiniert | \$1.Attribute. AppleQuickReplyCapability | 

# Aktualisieren der Integration von Apple Messages for Business in Amazon Connect
<a name="update-apple-messages-for-business"></a>

Sie müssen Ihre Integration von Apple Messages for Business aktualisieren, wenn Sie die Flow-ID oder andere Informationen ändern möchten. 

1. Öffnen Sie ein [Ticket beim Support](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=customer-account&categoryCode=activation).

   Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem AWS Konto an.

1. Kopieren Sie die folgende Vorlage in das Feld **Beschreibung des Anwendungsfalls**, um anzugeben, dass es sich um eine **Aktualisierungsanfrage** handelt: 

   ```
   Subject: Update Apple Messages for Business Integration request
   Body:
      Apple Messages for Business Account ID (required): enter your current account ID change to new account ID
      Apple Token (required): enter your token
      Amazon Connect Instance ARN (required): enter your current instance ARN change to new instance ARN
      Amazon Connect Flow ID (required): enter your current flow ID change to new flow ID
   ```
**Anmerkung**  
Wenn Sie den ARN Ihrer Amazon-Connect-Instance aktualisieren, müssen Sie auch Ihre KontaktFlow-ID aktualisieren.

1. Maximieren Sie die **Kontaktoptionen**, geben Sie Ihre **Bevorzugte Kontaktsprache** an und wählen Sie **Web** als Kontaktmethode aus, falls die Option nicht standardmäßig ausgewählt ist.  
![\[Die Seite mit den Kontaktoptionen\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-contact-support-options.png)

1. Wählen Sie **Absenden** aus.

1. Support wird bei Ihrer Anfrage direkt mit dem Amazon Connect Connect-Team zusammenarbeiten und sich bei weiteren Fragen melden.

# Löschen der Integration von Apple Messages for Business in Amazon Connect
<a name="delete-apple-messages-for-business"></a>

1. Öffnen Sie ein [Ticket beim Support](https://console.aws.amazon.com/support/home#/case/create?issueType=customer-service&serviceCode=customer-account&categoryCode=activation). 

   Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem AWS Konto an.

1. Kopieren Sie die folgende Vorlage in das Feld **Beschreibung des Anwendungsfalls**, um anzugeben, dass es sich um eine **Löschanfrage** handelt: 

   ```
   Subject: Delete Apple Messages for Business Integration
   Body:
     Apple Messages for Business Account ID (required): enter your account ID   
      Amazon Connect Instance ARN (required): enter your instance ARN
      Amazon Connect Flow ID (required): enter your flow ID
   ```

   Die folgende Abbildung zeigt ein Beispiel für ein abgeschlossenes Ticket:

1. Maximieren Sie die **Kontaktoptionen**, geben Sie Ihre **Bevorzugte Kontaktsprache** an und wählen Sie **Web** als Kontaktmethode aus, falls die Option nicht standardmäßig ausgewählt ist.  
![\[Die Seite mit den Kontaktoptionen\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-contact-support-options.png)

1. Wählen Sie **Absenden** aus.

1. Support wird bei Ihrer Anfrage direkt mit dem Amazon Connect Connect-Team zusammenarbeiten und sich bei weiteren Fragen melden.

# Suchen der ID Ihres Kontos bei Apple Messages for Business für Ihre Integration in Amazon Connect
<a name="find-apple-messages-for-business-account-id"></a>

1. Navigieren Sie in [Apple Business Register](https://register.apple.com/) zu **Message Service Provider** und klicken oder tippen Sie auf **Test your Messaging Service Provider connection**.  
![\[Die Seite mit dem Messaging-Serviceanbieter\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-messaging-service-provider.png)

1. Klicken oder tippen Sie auf **Copy ID**.  
![\[Die Seite mit der Verbindung zum Messaging-Serviceanbieter, der Link „Copy ID“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-account-id.png)

# Suchen Ihres Apple-Tokens bei der Integration von Apple Messages for Business in Amazon Connect
<a name="find-apple-token-id"></a>
+ Navigieren Sie in [Apple Business Register](https://register.apple.com/) zu **Messaging Service Provider** und wählen Sie **Copy Token** aus.  
![\[Die Seite mit dem Messaging-Serviceanbieter, der Link „Copy Token“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-msp-copytoken.png)

# Suchen der Ablauf-ID bei der Integration von Apple Messages for Business in Amazon Connect
<a name="find-contact-flow-id"></a>

Die Flow-ID entspricht dem Flow, den Sie für eingehende Nachrichten von Apple Messages for Business verwenden möchten. Flows definieren den Betreuungsweg Ihrer Kunden, wenn sie einen neuen Chat beginnen.

Sie können entweder einen vorhandenen Flow verwenden, den Sie bereits für Sprach- oder Chat-Kontakte nutzen, oder einen neuen Flow speziell für Kontakte von Apple Messages for Business erstellen. Eine Anleitung zum Erstellen eines neuen Flows für eingehende Kontakte finden Sie unter [Erstellen eines Inbound-Flows](create-contact-flow.md#create-inbound-contact-flow). 

Weitere Informationen zu Flows finden Sie unter [Flows in Amazon Connect](connect-contact-flows.md).

**Suchen Sie Ihre Flow-ID für Apple Messages for Business wie folgt**

1. Melden Sie sich bei der Amazon-Connect-Konsole mit einem **Administratorkonto** oder einem Konto an, das einem Sicherheitsprofil zugewiesen ist und über Berechtigungen zum Aufrufen von Kontakt-Flows verfügt.

1. Wählen Sie im Navigationsmenü **Weiterleitung**, **GesprächsFlows** aus.

1. Wählen Sie den gewünschten Flow aus.
**Anmerkung**  
Wählen Sie nur Flows vom Typ **GesprächsFlow (eingehend)** aus. Apple Messages for Business funktioniert nicht mit anderen Flowtypen wie **Kundenwarteschlange**, **Kunde in Warteschleife**, **Kunden-Whisper** usw.

1. Maximieren Sie im GesprächsFlow-Editor die Option **Weitere Flowinformationen anzeigen**.  
![\[Ein Beispiel für einen Flow, der Abschnitt „Weitere Flowinformationen anzeigen“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-find-contactflow-id.png)

1. Kopieren Sie unter „ARN“ (Amazon-Ressourcenname) alles nach „contact-flow/“. Auf der folgenden Abbildung würden Sie beispielsweise den unterstrichenen Teil kopieren.   
![\[Ein Diagramm, das zeigt, wie der Schlüsselteil der Amazon-Ressourcennummer kopiert wird\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/abc-find-contactflow-id-copy.png)

   1. Beachten Sie: **Typ** = **GesprächsFlow (eingehend)** 

   1. Die Flow-ID befindet sich am Ende des ARN. Kopieren Sie nur diesen Teil am Ende.

# Verwalten der Chats von Apple Messages for Business in Ihrer Amazon-Connect-Instance
<a name="manage-customer-chats"></a>

Wenn Sie Apple Messages for Business in Ihre Amazon-Connect-Instance integrieren, verhalten sich Nachrichten von Apple Messages for Business genauso wie alle anderen Chat-Nachrichten, die in Ihrem Contact Center eingehen.

**Anmerkung**  
Die Service-Quota-Limits für den Amazon-Connect-Chat-Service gelten für Apple Messages for Business. Weitere Informationen hierzu finden Sie unter [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md). 

## Einrichten automatisierter Antworten
<a name="auto-respond-chats"></a>

Sie können mit Amazon Lex automatisierte Chat-Antworten einrichten. Ein Anleitung für die ersten Schritte bei der Einrichtung von Amazon Lex und Amazon Connect finden Sie unter [Einen Amazon-Lex-Bot zu Amazon Connect hinzufügen](amazon-lex.md).

# 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. 

# Einrichten von In-App-, Web-, Videoanruf- und Bildschirmfreigabe-Funktionen
<a name="inapp-calling"></a>

Die Funktionen für Amazon Connect In-App-, Web- und Videoanrufe ermöglichen es Ihren Kunden, Sie zu kontaktieren, ohne Ihre Web- oder Mobilanwendung verlassen zu müssen. Sie können diese Funktionen verwenden, um Kontextinformationen an Amazon Connect zu übergeben. Auf diese Weise können Sie den Kundenkomfort auf der Grundlage von Attributen wie dem Kundenprofil oder anderen Informationen, wie z. B. Aktionen, die zuvor in der App ausgeführt wurden, personalisieren.

## Wissenswertes
<a name="inapp-calling-important"></a>
+ Bei einem Videoanruf oder einer Bildschirmfreigabe sehen Kundendienstmitarbeiter das Video oder den geteilten Bildschirm des Kunden, auch wenn der Kunde in der Warteschlange ist. Es liegt in der Verantwortung des Kunden, die persönlich identifizierbaren Informationen entsprechend zu behandeln. Wenn Sie dieses Verhalten ändern möchten, können Sie ein benutzerdefiniertes CCP und ein Kommunikations-Widget erstellen. Weitere Informationen finden Sie unter [Native Integration von In-App-, Web- und Videoanrufen sowie Bildschirmfreigabe-Funktionen in Ihre mobile Anwendung](config-com-widget2.md).

## Kommunikations-Widget: Zentrale Konfiguration von Chat, Sprache und Video
<a name="one-page"></a>

Um In-App-, Web- und Videoanrufe einzurichten, verwenden Sie die Seite **Kommunikations-Widgets**. Diese unterstützt Chat-, Sprach-, Video- und Bildschirmfreigabe-Funktionen. Die folgende Abbildung zeigt den Bereich **Kommunikationsmöglichkeiten** der Seite, wenn dieser für all diese Optionen konfiguriert ist. 

![\[Bereich „Kommunikationsmöglichkeiten“ der Seite zum Erstellen eines Kommunikations-Widgets.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/comm-widget-all.png)


## Web-, In-App- und Videoanrufe für mehrere Benutzer
<a name="multi-user"></a>

Sie können bis zu vier weitere Benutzer zu einem laufenden oder geplanten Web-, In-App- oder Videoanruf hinzufügen, und zwar für insgesamt sechs Teilnehmer: den Kundendienstmitarbeiter, den ersten Benutzer und vier weitere Teilnehmer (Benutzer oder Kundendienstmitarbeiter).

Um beispielsweise den Abschluss einer Hypothekentransaktion zu erleichtern, können der Kundendienstmitarbeiter und der Kunde, der Ehepartner des Kunden, ein Übersetzer und sogar ein Supervisor (d. h. ein anderer Kundendienstmitarbeiter) gleichzeitig am Anruf teilnehmen, um jegliche Probleme schnell zu lösen.

Informationen zur Aktivierung von Web-, In-App- und Videoanrufen für mehrere Benutzer finden Sie unter [Aktivieren von In-App-, Web- und Videoanrufen für mehrere Benutzer](enable-multiuser-inapp.md).

## So richten Sie In-App-, Web- und Videoanrufe sowie die Bildschirmfreigabe ein
<a name="inapp-options"></a>

Es gibt zwei Möglichkeiten, Amazon Connect In-App-, Web- und Videoanrufe sowie Screensharing in Ihre Website oder mobile Anwendung einzubetten: 
+ Option 1: [Konfigurieren Sie ein out-of-the-box Kommunikations-Widget](config-com-widget1.md). Sie können den UI Builder verwenden, um die Schriftart und die Farben anzupassen und das Widget so zu sichern, dass es nur von Ihrer Website aus gestartet werden kann. 
+ Option 2: [Native Integration von In-App-, Web- und Videoanrufen in Ihre mobile Anwendung](config-com-widget2.md). Wählen Sie diese Option, um ein von Grund auf neues Kommunikations-Widget zu erstellen und in Ihre mobile Anwendung oder Website zu integrieren. Verwenden Sie den Amazon Connect APIs und Amazon Chime SDK-Client APIs , um ihn nativ in Ihre mobile Anwendung oder Website zu integrieren.

**Anmerkung**  
Wenn Sie über benutzerdefinierte Desktops für Kundendienstmitarbeiter verfügen, müssen Sie keine Änderungen für Amazon-Connect-In-App- und -Webanrufe vornehmen. Sie müssen jedoch [Videoanrufe und Bildschirmfreigabe-Funktionen integrieren](integrate-video-calling-for-agents.md).

# Konfigurieren Sie ein out-of-the-box Kommunikations-Widget in Amazon Connect
<a name="config-com-widget1"></a>

Verwenden Sie diese Option, um Kommunikations-Widgets für Desktop- und mobile [Browser](connect-supported-browsers.md#browsers-inapp) zu erstellen. Am Ende dieses Verfahrens generiert Amazon Connect einen benutzerdefinierten HTML-Codeausschnitt, den Sie in den Quellcode Ihrer Website kopieren.

1. Melden Sie sich auf der Amazon Connect Admin-Website mit einem Administratorkonto oder einem Benutzerkonto mit **Kanälen und Flows** an. Das **Widget „Kommunikation“ — Berechtigung erstellen** ist im Sicherheitsprofil enthalten.

1. Wählen Sie im Amazon Connect linken Navigationsmenü **Kanäle**, **Kommunikations-Widgets** aus. 

1. Der Assistent führt Sie durch die nächsten drei Schritte. 

## Schritt 1: Auswahl der Kommunikationskanäle
<a name="widgetdetails"></a>

1. Geben Sie auf der Seite **Kommunikations-Widgets** einen **Namen** und eine **Beschreibung** für das Kommunikations-Widget ein. 
**Anmerkung**  
Der Name muss für jedes Kommunikations-Widget, das in einer Amazon-Connect-Instance erstellt wurde, eindeutig sein.

1. Legen Sie im Abschnitt **Kommunikationsmöglichkeiten** fest, wie Ihre Kunden mit Ihrem Widget interagieren können. In der folgenden Abbildung sind die Optionen angegeben, mit denen Web- und Videoanrufe sowie die Bildschirmfreigabe für Kunden ermöglicht werden.   
![\[Die Seite „Kommunikations-Widget“, die für Web- und Videoanrufe sowie die Bildschirmfreigabe konfiguriert ist.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/comm-widget-page-call.png)

1. Wählen Sie im Bereich **Webanrufe** aus, ob Sie Videoanrufe und Bildschirmfreigabe-Funktionen für Ihre Kunden aktivieren möchten. Das vorherige Bild zeigt Optionen, mit denen Kunden die Videos der Kundendienstmitarbeiter ansehen und ihre Videos einschalten sowie Kundendienstmitarbeiter und Kunden ihre Bildschirme freigeben können. Informationen zum Festlegen von Einschränkungen bei der Bildschirmfreigabe finden Sie unter [Aktivieren der URL-Beschränkung für die Bildschirmfreigabe](screen-sharing-url-restriction.md).

1. Wählen Sie **Save and continue** aus.

## Schritt 2: Anpassen des Widgets
<a name="customizewidget"></a>

Bei der Auswahl dieser Optionen wird die Widget-Vorschau automatisch aktualisiert. Sie können also sehen, wie die Oberfläche für die Kunden aussehen wird.

![\[Die Vorschau des Kommunikations-Widgets.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/netra-call-preview.png)


**Definieren des Stils der Widget-Zugriffschaltflächen**

1. Wählen Sie die Farben für den Schaltflächenhintergrund aus. Geben Sie dazu Hexadezimalwerte ([HTML-Farbcodes](https://htmlcolorcodes.com/)) ein.

1. Wählen Sie **Weiß** oder **Schwarz** als Symbolfarbe aus. Die Farbe des Symbols kann nicht angepasst werden.

**Anpassen von Anzeigenamen und -stilen**

1. Geben Sie Werte für die Header-Nachricht und Farbe sowie für die Hintergrundfarbe des Widgets an. 

1. **Logo-URL**: Fügen Sie eine URL zu Ihrem Logo-Banner aus einem Amazon-S3-Bucket oder einer anderen Online-Quelle ein.
**Anmerkung**  
In der Vorschau des Kommunikations-Widgets auf der Anpassungsseite wird das Logo nicht angezeigt, wenn es aus einer anderen Online-Quelle als einem Amazon-S3-Bucket stammt. Das Logo wird jedoch angezeigt, wenn das benutzerdefinierte Kommunikations-Widget auf Ihrer Seite implementiert wird.

   Das Banner muss im .svg-, .jpg- oder .png-Format vorliegen. Das Bild kann 280 Pixel (Breite) mal 60 Pixel (Höhe) groß sein. Jedes Bild, das größer als diese Abmessungen ist, wird so skaliert, dass es in den Komponentenbereich des Logos von 280×60 passt.

   1. Anweisungen zum Hochladen einer Datei wie eines Logobanners auf S3 finden Sie unter [Hochladen von Objekten](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) im *Benutzerhandbuch zu Amazon Simple Storage Service*.

   1. Vergewissern Sie sich, dass die Bildberechtigungen richtig eingestellt sind, sodass das Kommunikations-Widget über Berechtigungen für den Zugriff auf das Bild verfügt. Informationen dazu, wie Sie ein S3-Objekt öffentlich zugänglich machen, finden Sie unter [Schritt 2: Hinzufügen einer Bucket-Richtlinie](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteAccessPermissionsReqd.html#bucket-policy-static-site) im Thema *Berechtigungen für den Zugriff auf Websites einrichten*.

## Schritt 3: Hinzufügen Ihrer Domain für das Widget
<a name="widgetdomain"></a>

In diesem Schritt können Sie das Kommunikations-Widget so sichern, dass es nur von Ihrer Website aus gestartet werden kann.

1. Geben Sie die Website-Domains ein, in denen Sie das Kommunikations-Widget platzieren möchten. Das Kommunikations-Widget wird nur in Websites geladen, die Sie in diesem Schritt auswählen. 

   Wählen Sie **Domain hinzufügen** aus, um bis zu 50 Domains hinzuzufügen.  
![\[Die Option „Domain hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-add-domain.png)
**Wichtig**  
Vergewissern Sie sich, dass Ihre Website URLs gültig ist und keine Fehler enthält. Geben Sie die vollständige URL beginnend mit https:// an.
Wir empfehlen die Verwendung von https:// für Ihre Produktionswebsites und -anwendungen.

1. Wählen Sie unter **Mehr Sicherheit für Ihre Kommunikations-Widget-Anfragen** die Option **Nein – Ich möchte diesen Schritt überspringen** aus, um die Einrichtung möglichst schnell durchzuführen.

   Wir empfehlen, **Ja** auszuwählen, um überprüfen zu können, ob der Benutzer authentifiziert ist. Weitere Informationen finden Sie unter [Personalisieren des Kundenerlebnisses für In-App-, Web- und Videoanrufe in Amazon Connect](optional-widget-steps.md). 

1. Wählen Sie **Save and continue** aus.

   Herzlichen Glückwunsch\$1 Ihr Widget wurde erstellt. Kopieren Sie den generierten Code und fügen Sie ihn auf jeder Seite Ihrer Website ein, auf der das Kommunikations-Widget erscheinen soll.

## Aktivieren von In-App-, Web- und Videoanrufen sowie der Bildschirmfreigabe für Kundendienstmitarbeiter
<a name="agent-cx-cw"></a>

Um Kundendienstmitarbeitern die Möglichkeit zur Nutzung von Videoanrufen und der Bildschirmfreigabe zu bieten, weisen Sie ihrem Sicherheitsprofil die Berechtigungen **Contact Control Panel (CCP)**, **Videoanrufe – Zugriff** zu.

Der Arbeitsbereich für Amazon Connect Agenten unterstützt Amazon Connect In-App-, Web- und Videoanrufe sowie Screensharing. Sie können dieselbe Konfiguration, Weiterleitung, Analyse und Kundendienstmitarbeiteranwendung wie bei Telefonanrufen und Chats verwenden. Für den Einstieg müssen Sie lediglich den Sicherheitsprofilen Ihres Kundendienstmitarbeiters die Berechtigungen für Videoanrufe und für die Bildschirmfreigabe zuweisen.

Für benutzerdefinierte Agenten-Desktops sind keine Änderungen für Amazon Connect In-App- und Webanrufe erforderlich. Weisen Sie den Sicherheitsprofilen Ihres Kundendienstmitarbeiters die Berechtigungen für Videoanrufe und für die Bildschirmfreigabe zu und folgen Sie der nachstehenden Anleitung zur Integration von Videoanrufen in den Desktop Ihres Kundendienstmitarbeiters.

## So leitet ein Client-Gerät einen In-App- oder Webanruf ein
<a name="diagram-option1"></a>

Das folgende Diagramm zeigt die Reihenfolge der Ereignisse, wenn ein Client-Gerät (mobile Anwendung oder Browser) einen In-App- oder Webanruf einleitet.

![\[Konzeptionelles Diagramm, das zeigt, wie ein Client-Gerät einen Anruf einleitet.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/netra-gs-diagram-option1.png)


1. (Optional) Sie können auf der Website erfasste Attribute übergeben und mit dem JSON-Web-Token (JWT) validieren. 

1. Der Kunde klickt auf das Kommunikations-Widget auf Ihrer Website oder mobilen App. 

1. Das Kommunikations-Widget startet den Webaufruf an, Amazon Connect indem es die im JWT enthaltenen Attribute weitergibt. 

1. Der Kontakt erreicht den Flow, wird weitergeleitet und in die Warteschlange gestellt. 

1. Der Kundendienstmitarbeiter akzeptiert den Kontakt.

1. (Optional) Wenn Video für den Kunden und den Kundendienstmitarbeiter aktiviert ist, können sie ihr Video starten.

## Weitere Informationen
<a name="cw-more-resources"></a>

Weitere Informationen zu den Anforderungen für In-App-, Web- und Videoanruffunktionen finden Sie in den folgenden Themen:
+ [Anforderungen an die Workstation des Kundendienstmitarbeiters für App-, Web- und Videoanrufe in Amazon Connect](videocalling-networking-requirements.md)
+ [Unterstützte Browser und mobile Betriebssysteme für In-App-, Web- und Videoanruffunktionen](connect-supported-browsers.md#browsers-inapp) 

# Native Integration von In-App-, Web- und Videoanrufen sowie Bildschirmfreigabe-Funktionen in Ihre mobile Anwendung
<a name="config-com-widget2"></a>

So integrieren Sie In-App-, Web- und Videoanrufe sowie Bildschirmfreigabe-Funktionen von Amazon Connect in Ihre Anwendung:

1. Verwenden Sie die Amazon Connect [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)Connect-API, um den Kontakt zu erstellen.

1. Verwenden Sie dann die vom API-Aufruf zurückgegebenen Details, um dem Anruf mithilfe der Amazon Chime Clientbibliothek für [iOS](https://github.com/aws/amazon-chime-sdk-ios), [Android](https://github.com/aws/amazon-chime-sdk-android) oder beizutreten [JavaScript](https://github.com/aws/amazon-chime-sdk-js). 

Informationen zum Erstellen von weiteren Teilnehmern finden Sie unter [Aktivieren von In-App-, Web- und Videoanrufen für mehrere Benutzer](enable-multiuser-inapp.md). 

Beispielanwendungen finden Sie im folgenden Github-Repository: [amazon-connect-in-app-calling-examples](https://github.com/amazon-connect/amazon-connect-in-app-calling-examples). 

**Topics**
+ [So leitet ein Client-Gerät einen In-App- oder Webanruf ein](#diagram-option2)
+ [Erste Schritte](#diagram-option2-gs)
+ [Optionale Schritte:](#optional-steps)

## So leitet ein Client-Gerät einen In-App- oder Webanruf ein
<a name="diagram-option2"></a>

Das folgende Diagramm zeigt die Reihenfolge der Ereignisse, wenn ein Client-Gerät (mobile Anwendung oder Browser) einen In-App- oder Webanruf einleitet.

![\[Konzeptionelles Diagramm, das zeigt, wie ein Client-Gerät einen Anruf einleitet.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/netra-gs-diagram.png)


1. Ihr Kunde verwendet die Client-Anwendung (Website oder Anwendung), um einen In-App- oder Webanruf zu starten.

1. Die Client-Anwendung (Website oder mobile Anwendung) oder der Webserver verwendet die Amazon Connect [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API, um den Kontakt zu starten und übergibt Attribute oder Kontext an. Amazon Connect

1. Die Client-Anwendung nimmt mithilfe der [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)in Schritt 2 zurückgegebenen Details am Anruf teil.

1. (Optional) Der Client verwendet die [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)API, um eine zu empfangen`ConnectionToken`, die zum Senden von DTMF über die [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)API verwendet wird.

1. Der Kontakt erreicht den Flow und wird basierend auf dem Flow weitergeleitet und in die Warteschlange gestellt.

1. Der Kundendienstmitarbeiter akzeptiert den Kontakt.

1. (Optional) Wenn Video für den Kunden und den Kundendienstmitarbeiter aktiviert ist, können sie ihr Video starten.

1. (Optional — nicht im Diagramm dargestellt) Zusätzliche Teilnehmer können mit dem [CreateParticipant](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipant.html)und [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html) APIshinzugefügt werden. 

## Erste Schritte
<a name="diagram-option2-gs"></a>

Im Folgenden sind die allgemeinen Schritte für den Einstieg aufgeführt:

1. Verwenden Sie die [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API, um den Kontakt zu erstellen. Die API gibt die erforderlichen Details zurück, damit der Amazon Chime SDK Client am Anruf teilnehmen kann.

1. Instanziieren Sie das Amazon Chime `MeetingSessionConfiguration` SDK-Client-Objekt mithilfe der von zurückgegebenen Konfigurationen. [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)

1. Instanziieren Sie den Amazon-Chime-SDK-Client `DefaultMeetingSession` mit dem Parameter `MeetingSessionConfiguration`, der in Schritt 2 erstellt wurde, um eine Client-Besprechungssitzung zu erstellen. 
   + iOS

     ```
     let logger = ConsoleLogger(name: "logger") 
     let meetingSession = DefaultMeetingSession(
         configuration: meetingSessionConfig, 
         logger: logger
     )
     ```
   + Android

     ```
     val logger = ConsoleLogger()
     val meetingSession = DefaultMeetingSession(
         configuration = meetingSessionConfig,
         logger = logger,
         context = applicationContext
     )
     ```
   + JavaScript

     ```
     const logger = new ConsoleLogger('MeetingLogs', LogLevel.INFO);
     const deviceController = new DefaultDeviceController(logger);
     const configuration = new MeetingSessionConfiguration(
         meetingResponse, 
         attendeeResponse
     );
     const meetingSession = new DefaultMeetingSession(
         configuration, 
         logger, 
         deviceController
     );
     ```

1. Verwenden Sie die Methode `meetingSession.audioVideo.start()`, um den WebRTC-Kontakt mit Audio zu verbinden.
   + iOS/Android

     ```
     meetingSession.audioVideo.start()
     ```
   + JavaScript

     ```
     await meetingSession.audioVideo.start();
     ```

1. Verwenden Sie die Methode `meetingSession.audioVideo.stop()`, um aufzulegen und den WebRTC-Kontakt zu beenden.
   + iOS/Android

     ```
     meetingSession.audioVideo.stop()
     ```
   + JavaScript

     ```
     meetingSession.audioVideo.stop();
     ```

## Optionale Schritte:
<a name="optional-steps"></a>

Weitere Vorgänge und eine umfassende API-Dokumentation finden Sie in den plattformspezifischen API-Übersichtsleitfäden:
+ **iOS**: [API-Übersicht](https://aws.github.io/amazon-chime-sdk-ios/guides/api_overview.html)
+ **Android**: [API-Übersicht](https://aws.github.io/amazon-chime-sdk-android/guides/api_overview.html)
+ **JavaScript**[: API-Übersicht](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/03_API_Overview.md)

### Senden von DTMF-Tönen
<a name="send-dtmf-tones"></a>

Um DTMF an den Anruf zu senden, APIs sind zwei Amazon Connect Participant Service erforderlich: [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)und [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)jeweils.

**Anmerkung**  
`contentType`für die SendMessage API muss es sein. `audio/dtmf`

1. Zum Abrufen [CreateParticipantConnection](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html)aufrufen`ConnectionToken`. (`ParticipantToken`wird für den Aufruf dieser API benötigt. Sie finden es in der [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)Antwort.)

1. Rufen Sie mit dem `ConnectionToken` [SendMessage](https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_SendMessage.html)zum Senden von DTMF-Ziffern auf.

### Auswählen von Audiogeräten
<a name="select-audio-devices"></a>

Um das input/output Audiogerät auszuwählen, können Sie die Methoden des Amazon Chime SDK-Clients für Android und iOS oder die [nativen iOS-Funktionen für iOS](https://developer.apple.com/documentation/avkit/avroutepickerview) verwenden.

**iOS/Android**

```
meetingSession.audioVideo.listAudioDevices()
meetingSession.audioVideo.chooseAudioDevice(mediaDevice)
```

**JavaScript**

```
await meetingSession.audioVideo.listAudioInputDevices();
await meetingSession.audioVideo.listAudioOutputDevices();
await meetingSession.audioVideo.startAudioInput(device);
await meetingSession.audioVideo.chooseAudioOutput(deviceId);
```

### Stummschalten von Audio und Aufheben der Audiostummschaltung
<a name="mute-unmute-audio"></a>

Verwenden Sie zum Stummschalten und Aufheben der Stummschaltung `meetingSession.audioVideo.realtimeLocalMute()` und `meetingSession.audioVideo.realtimeLocalUnmute()`.

**iOS/Android**

```
meetingSession.audioVideo.realtimeLocalMute()
meetingSession.audioVideo.realtimeLocalUnmute()
```

**JavaScript**

```
meetingSession.audioVideo.realtimeMuteLocalAudio();
meetingSession.audioVideo.realtimeUnmuteLocalAudio();
```

### Starten des eigenen Videos
<a name="start-self-video"></a>

Um das eigene Video zu starten, verwenden Sie den Parameter `meetingSession.audioVideo.startLocalVideo()`. Weitere Informationen zum Auflisten und Auswählen bestimmter Geräte finden Sie in den API-Anleitungen zur Clientbibliothek.

**iOS/Android**

```
meetingSession.audioVideo.startLocalVideo()
```

**JavaScript**

```
meetingSession.audioVideo.startLocalVideoTile();
```

### Stoppen des eigenen Videos
<a name="stop-self-video"></a>

Um das eigene Video zu stoppen, verwenden Sie den Parameter `meetingSession.audioVideo.stopLocalVideo()`.

**iOS/Android**

```
meetingSession.audioVideo.stopLocalVideo()
```

**JavaScript**

```
meetingSession.audioVideo.stopLocalVideoTile();
```

### Aktivieren des Kundendienstmitarbeiter-Videos
<a name="enable-agent-video"></a>

Verwenden Sie den Parameter `meetingSession.audioVideo.startRemoteVideo()`, um das Empfangen und Laden von Videos des Kundendienstmitarbeiters in der Anwendung zuzulassen. Sie müssen außerdem den Parameter „VideoTileObserver“ implementieren und Videokacheln an Anzeigeansichten binden.

**iOS/Android**

```
meetingSession.audioVideo.startRemoteVideo()
// Implement VideoTileObserver to handle video tiles
meetingSession.audioVideo.addVideoTileObserver(observer)
// In videoTileDidAdd callback:
meetingSession.audioVideo.bindVideoView(videoView, tileId: tileState.tileId)
```

**JavaScript**

```
// Remote video is received automatically when available
// Implement AudioVideoObserver to handle video tiles
meetingSession.audioVideo.addObserver(observer);
// In videoTileDidUpdate callback:
meetingSession.audioVideo.bindVideoElement(tileId, videoElement);
```

Umfassende Informationen zur Implementierung von Videokacheln finden Sie in den plattformspezifischen SDK-Anleitungen.

### Deaktivieren des Kundendienstmitarbeiter-Videos
<a name="disable-agent-video"></a>

Verwenden Sie den Parameter `meetingSession.audioVideo.stopRemoteVideo()`, um das Empfangen und Laden von Videos des Kundendienstmitarbeiters in der Anwendung nicht zuzulassen.

**iOS/Android**

```
meetingSession.audioVideo.stopRemoteVideo()
meetingSession.audioVideo.unbindVideoView(tileId)
```

**JavaScript**

```
meetingSession.audioVideo.unbindVideoElement(tileId);
```

### Verwenden von Datennachrichten
<a name="use-data-messages"></a>

Sie können [Datennachrichten](https://github.com/aws/amazon-chime-sdk-js/blob/main/guides/03_API_Overview.md#9-send-and-receive-data-messages-optional) verwenden, wenn Sie einen beliebigen Status des Kundendienstmitarbeiters an den Endbenutzer senden müssen. Wenn sich Kunden beispielsweise in der Warteschleife befinden, können Sie eine Datennachricht an die Anwendung des Kunden senden, um ihn darüber zu informieren, dass er sich in der Warteschleife befindet und das video/screen Teilen weiterhin gesendet wird, oder Sie können das video/screen Teilen deaktivieren.

**iOS/Android**

```
meetingSession.audioVideo.realtimeSendDataMessage(topic, data, lifetimeMs)
meetingSession.audioVideo.addRealtimeDataMessageObserver(topic, observer)
```

**JavaScript**

```
meetingSession.audioVideo.realtimeSendDataMessage(topic, data, lifetimeMs);
meetingSession.audioVideo.realtimeSubscribeToReceiveDataMessage(topic, callback);
```

### Hören von Stoppereignissen
<a name="listen-for-stop-events"></a>

Sie können über den Beobachter `audioVideoDidStop` nach Ereignissen hören, wenn die Teilnahme eines Kontakts endet. Spezifische Statuscodes können je nach Plattform variieren.

#### Anruf erreicht Kapazität
<a name="call-reaches-capacity"></a>

Wenn mehr als 6 Personen versuchen, am Anruf teilzunehmen, wird weiteren Teilnehmer die folgende Fehlermeldung angezeigt. Sie können erst teilnehmen, wenn andere Teilnehmer den Anruf beenden.
+ **iOS:** `MeetingSessionStatusCode.audioCallAtCapacity` oder `MeetingSessionStatusCode.audioAuthenticationRejected`
+ **Android:** `MeetingSessionStatusCode.AudioCallAtCapacity` oder `MeetingSessionStatusCode.AudioAuthenticationRejected`
+ **JavaScript:** `MeetingSessionStatusCode.AudioCallAtCapacity` oder `MeetingSessionStatusCode.AudioAuthenticationRejected`

#### Teilnehmer wurde aus Anruf entfernt
<a name="participant-removed-from-call"></a>

Wenn ein Teilnehmer vom Kundendienstmitarbeiter aus dem Anruf entfernt wird, der Kontakt jedoch für andere Teilnehmer weitergeführt wird, wird ihnen der folgende Statuscode angezeigt. Beachten Sie, wenn die Entfernung des Teilnehmers zum Beenden des Kontakts führt, wird ihm entweder dieser Status oder der Status „Kontakt beendet“ angezeigt.
+ **iOS:** `MeetingSessionStatusCode.audioServerHungup` oder `MeetingSessionStatusCode.audioAuthenticationRejected`
+ **Android:** `MeetingSessionStatusCode.AudioServerHungup` oder `MeetingSessionStatusCode.AudioAuthenticationRejected`
+ **JavaScript:** `MeetingSessionStatusCode.AudioAttendeeRemoved` oder `MeetingSessionStatusCode.AudioAuthenticationRejected`

#### Kontakt beendet
<a name="contact-ends"></a>

Wenn der tatsächliche Kontakt für alle Teilnehmer vollständig beendet wird, wird ihnen der folgende Statuscode angezeigt.
+ **iOS:** `MeetingSessionStatusCode.audioCallEnded`
+ **Android:** `MeetingSessionStatusCode.AudioCallEnded`
+ **JavaScript:** `MeetingSessionStatusCode.AudioCallEnded`

# Aktivieren von In-App-, Web- und Videoanrufen für mehrere Benutzer
<a name="enable-multiuser-inapp"></a>

Amazon Connect unterstützt das Hinzufügen zusätzlicher Benutzer zur Teilnahme am In-App-, Web- und Videoanruf in einem bestehenden Anruf. Sie können bis zu vier weitere Benutzer zu einem laufenden oder geplanten In-App-, Web- oder Videoanruf hinzufügen, und zwar für insgesamt sechs Teilnehmer: den Kundendienstmitarbeiter, den ersten Benutzer und vier weitere Teilnehmer (Benutzer oder Kundendienstmitarbeiter).

## So fügen Sie Teilnehmer zu einem Anruf für mehrere Benutzer hinzu
<a name="how-to-add-participants"></a>

1. Um Anrufe mit mehreren Benutzern zu aktivieren, müssen Sie die [erweiterte Kontaktüberwachung für mehrere Teilnehmer von der Amazon Connect Konsole](monitor-conversations.md) aus aktivieren.

1. Sobald dieser Vorgang abgeschlossen ist, können Sie mithilfe der vorhandenen Amazon Connect [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API einen Kontakt erstellen und diesen Kontakt an einen Agenten weiterleiten.

1. Um einen weiteren Teilnehmer hinzuzufügen, erstellen Sie zunächst einen Teilnehmer, `ContactId` der die [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API-Antwort an die [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)API weiterleitet. [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)wird erst erfolgreich sein, wenn der ursprüngliche Anrufer eine Verbindung zum Agenten hergestellt hat. Die Video- und Bildschirmfreigabe-Funktionen für den Teilnehmer können im Feld `ParticipantDetails.ParticipantCapabilities` festgelegt werden.

1. Nach erfolgreichem [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)Abschluss wird ein [Teilnehmer-Token](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html#connect-CreateParticipant-response-ParticipantCredentials) zurückgegeben. Dieses Token kann in einer Anfrage [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html)mit der `Type` Einstellung auf verwendet werden`WEBRTC_CONNECTION`. Die Antwort beinhaltet [ConnectionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_ConnectionData.html#connect-Type-ConnectionData-Meeting), welche für die Teilnahme an der Besprechung mithilfe der [Amazon Chime SDK-Clientbibliotheken](https://docs.aws.amazon.com/chime-sdk/latest/dg/mtgs-sdk-client-lib.html) für den zusätzlichen Teilnehmer verwendet werden können, die erstellt wurden. Folgen Sie den [Integrationsanleitungen](config-com-widget2.md), um dem Endbenutzer Ihrer Anwendung zu ermöglichen, am Meeting teilzunehmen.
**Anmerkung**  
[CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)gibt den Fehler Bad Request zurück, wenn der Agent noch nicht mit dem Kontakt verbunden ist. Informationen zu Geschäftsanwendungen, bei denen Benutzer versuchen können, am Meeting teilzunehmen, bevor der Kundendienstmitarbeiter verbunden wurde, finden Sie unter [Umgang mit der Teilnahme gleichzeitiger Benutzer](#handling-concurrent-joins).

1. Die zusätzlichen Kunden können nach der [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html)Rücksendung jederzeit eine Verbindung herstellen. Nachdem die Teilnehmer verbunden wurden, [ähnelt sämtliches zusätzliches Sprach- und Aufzeichnungsverhalten dem der Mehrparteienfunktion](multi-party-calls.md). Die neuen Teilnehmer können ihr Video und ihre Bildschirmübertragung aktivieren, sofern ihre Funktionen in der [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)Anfrage aktiviert wurden.
**Anmerkung**  
Insgesamt können nur 6 Teilnehmer (Kunden und Kundendienstmitarbeiter) jederzeit an einem aktiven Anruf teilnehmen. Die Amazon-Chime-SDK-Clientbibliotheken geben einen Statuscode mit der Angabe zurück, dass die Kapazität des Anrufs ausgelastet ist, wenn während der Teilnahme am Meeting eine Aktion ausgeführt wird, um zusätzliche Teilnehmer über die maximale Anzahl hinaus hinzuzufügen.

1. Nachdem die Teilnehmer mit dem Anruf verbunden und dann für einen vorkonfigurierten Zeitraum ordnungsgemäß oder nicht ordnungsgemäß getrennt wurden, sind ihre Teilnehmeranmeldeinformationen nicht mehr gültig. Wenn der `onAudioVideoDidStop` Beobachter der Kundenbibliothek einen Statuscode erhält, der besagt, dass der Teilnehmer nicht mehr gültig ist, können Anwendungen einen neuen Anruf an [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)und [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html)von Ihrem Geschäfts-Backend auslösen, um wieder an dem Anruf teilzunehmen.

1.  Amazon Connect [Erstellt für jede weitere Benutzerverbindung einen neuen Kontakt und einen neuen Kontaktdatensatz.](ctr-data-model.md) Alle zusätzlichen Kontakte haben den InitialContactId (d. h. den, der von der [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API erstellt wurde) PreviousContactId eingestellt, um ihn auf den ursprünglichen Kontakt zurückzuverfolgen. Jeder Kontaktdatensatz:
   + Hat ein **"InitiationMethod„: „WEBRTC\$1API**“
   + Hat die folgenden Segmentattribute:

     ```
        "SegmentAttributes": {
           "connect:Subtype": {
             "ValueString": "connect:WebRTC"
           }
         },
     ```

   Darüber hinaus hat jeder Kontaktdatensatz den Anzeigenamen, der in `CreateParticipant` angegeben ist. Die Informationen des Kundendienstmitarbeiters werden nicht für zusätzliche Benutzerkontakte ausgefüllt. Dies dient dazu, um die Duplizierung dieser Informationen zu vermeiden.

   Das folgende Diagramm zeigt, wie der vorherige und der nächste Kontakt in einem Szenario zugeordnet IDs werden, in dem mehrere Teilnehmer und Agenten zu einem Web-, In-App- oder Videoanruf hinzugefügt werden.  
![\[Diagramm, das zeigt, wie Kontakte für WebRTC-Anrufe mit mehreren Teilnehmern zugeordnet IDs werden\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/multiparty-webrtc-contact-mapping.png)

## Umgang mit der Teilnahme gleichzeitiger Benutzer
<a name="handling-concurrent-joins"></a>

Unternehmen möchten möglicherweise Anwendungen erstellen, an denen Benutzer in einer beliebigen Reihenfolge und zu jeder Zeit teilnehmen können. Beispielsweise kann Ihre Anwendung einen Link mit einer externen Termin-ID per E-Mail an mehrere Benutzer senden, über den sie zu einem festgelegten Zeitpunkt an einem Anruf teilnehmen können. Um dieses Verhalten zu erzielen, müssen Unternehmens-Backends Folgendes sicherstellen:
+ Der erste Benutzer, der beitritt, löst eine Anfrage aus. StartWeb RTCContact 
+ Alle weiteren Benutzer verwenden CreateParticipant und, CreateParticipantConnection aber **erst, nachdem der erste Benutzer eine Verbindung zu einem Agenten hergestellt hat**.

In diesem Abschnitt wird eine mögliche Implementierung beschrieben, vorausgesetzt, Ihr Unternehmens-Backend enthält einen Speicher (wie DynamoDB), in dem Metadaten zu geplanten Terminen gespeichert werden können. Beachten Sie, dass geplante Termine kein Feature von Amazon Connect, sondern ein Teil der Beispielimplementierung sind.

Wenn der Benutzer zu der Seite navigiert, sollte er eine Anforderung an das Backend senden. Das Backend prüft:
+ Gibt an, ob der Benutzer den Termin beginnen kann und ob es der richtige Zeitpunkt ist.
+ Ob der Amazon Connect Kontakt bereits durch einen Anruf erstellt wurde [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html).

**Wenn der Kontakt noch nicht erstellt wurde**, sollte der Kunde die [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)API mit einem benutzerdefinierten [Ablauf](connect-contact-flows.md) und einem [Attribut](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html#connect-StartWebRTCContact-request-Attributes) aufrufen, das die Agentenwarteschleife des entsprechenden Agenten angibt, von dem erwartet wurde, dass er dem Anruf beitreten würde. Der Ablauf sollte den Block [Arbeitswarteschlange festlegen](set-working-queue.md) beinhalten, der so konfiguriert ist, dass die in den Attributen angegebene Kundendienstmitarbeiter-Warteschlange verwendet wird. Der Ablauf sollte dann mit dem Block [An Warteschlange weiterleiten](transfer-to-queue.md) enden. Bevor die API aufgerufen wird, sollte das Backend den Speicher atomar aktualisieren, um den Aufruf vom Status „Keine“ in den Status „Wird erstellt“ zu versetzen und alle Ausnahmen gleichzeitiger Änderungen zu verarbeiten.

Die Anmeldeinformationen von [StartWebRTCContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartWebRTCContact.html)sollten an den Kunden zurückgeschickt werden und er sollte sofort am Anruf teilnehmen. Der Kontakt sollte zusammen mit der Kontakt-ID im Unternehmensspeicher als „Erstellt“ gekennzeichnet werden. **Diese Unternehmens-API muss zwischen allen möglichen dazukommenden Teilnehmern synchronisiert werden**. Dies kann mithilfe den von einer Datenbank bereitgestellten atomaren Vorgängen erfolgen.

**Wenn sich der Kontakt im Status „Wird erstellt“ befindet**, sollte für den zusätzlichen Benutzer dieser Status zurückgegeben, die entsprechenden Informationen angezeigt und dieser Vorgang nach einer kurzen Wartezeit erneut versucht werden.

**Wenn der Kontakt erstellt wurde**: Der Kunde sollte die Kontakt-ID abrufen und die [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)API aufrufen. Das Unternehmens-Backend sollte nach dem Feld **`Contact.AgentInfo.ConnectedToAgentTimestamp`** suchen. Wenn es nicht vorhanden ist, wurde der erste Benutzer nicht mit dem Kundendienstmitarbeiter verbunden. Der zusätzliche Benutzer sollte die entsprechenden Informationen anzeigen und es nach einer kurzen Wartezeit erneut versuchen.

Wenn das Feld existiert, sollte das Backend aufrufen [CreateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateParticipant.html)und dann [CreateParticipantConnection](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-participant_CreateParticipantConnection.html), wie in den vorherigen Abschnitten beschrieben [ConnectionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_ConnectionData.html#connect-Type-ConnectionData-Meeting), abrufen.

Der Backend-Ablauf sollte wie folgt aussehen.

![\[Backend-Flussdiagramm für die Verarbeitung gleichzeitiger Benutzerteilnahmen\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/multiparty-backend-flow.png)


Informationen zur Implementierung finden Sie in den [In-App-Anrufbeispielen von Amazon Connect](https://github.com/amazon-connect/amazon-connect-in-app-calling-examples/tree/main/Web). GitHub 

**Der Kundendienstmitarbeiter nimmt nicht über dieselbe Website teil**. Der Kundendienstmitarbeiter sollte seinen Status im [Contact Control Panel](launch-ccp.md) auf **Verfügbar** festlegen. Wenn der erste Kunde teilnimmt, wird der Kundendienstmitarbeiter automatisch angerufen.

## Fakturierung
<a name="multiuser-billing"></a>

Die Abrechnung für zusätzliche Teilnehmer entspricht der bestehenden Abrechnung für den ersten Kunden und alle am Anruf teilnehmenden Kundendienstmitarbeiter. Für die Audio-, Video- und Bildschirmfreigabe fallen jeweils eigene, teilnehmerspezifische Gebühren an.

## Verhalten während Wartezeit
<a name="multiuser-hold-behavior"></a>

Während eines Videoanrufs oder einer Bildschirmfreigabe-Sitzung können Kundendienstmitarbeiter das Video oder den freigegebenen Bildschirm des Teilnehmers sehen, auch wenn der Teilnehmer in die Warteschleife gestellt wurde. Es liegt in der Verantwortung des Teilnehmers, die persönlich identifizierbaren Informationen entsprechend zu behandeln. Bei Verwendung der nativen CCP-Anwendung ist das Video des Kundendienstmitarbeiters deaktiviert, wenn ein Teilnehmer, der kein Kundendienstmitarbeiter ist, in die Warteschleife gestellt wurde. Wenn Sie dieses Verhalten ändern möchten, können Sie ein benutzerdefiniertes CCP und ein Kommunikations-Widget erstellen. 

Weitere Informationen finden Sie unter [Native Integration von In-App-, Web- und Videoanrufen sowie Bildschirmfreigabe-Funktionen in Ihre mobile Anwendung](config-com-widget2.md). 

## Einschränkung
<a name="multiuser-limitations"></a>

Bei der Erstellung zusätzlicher Teilnehmer für In-App-, Web- und Videoanrufe sowie für die Bildschirmfreigabe gilt die folgende Einschränkung:
+ Für die zusätzlichen Teilnehmer dürfen die Videofunktionen nicht auf **Senden** festgelegt sein, wenn der ursprüngliche Kontakt erstellt wurde und dabei die Videofunktionen des Kunden auf **Keine** festgelegt waren.

# Personalisieren des Kundenerlebnisses für In-App-, Web- und Videoanrufe in Amazon Connect
<a name="optional-widget-steps"></a>

Die Schritte in diesem Thema sind optional, werden aber empfohlen. Sie können damit das Kundenerlebnis auf der Grundlage der zuvor in Ihrer App durchgeführten Aktionen personalisieren. Diese Option bietet Ihnen mehr Kontrolle beim Einleiten neuer Anrufe, einschließlich der Möglichkeit, Kontextinformationen als Attribute zu übergeben.

 Nachdem Sie diese Schritte ausgeführt haben, müssen Sie mit Ihrem Website-Administrator zusammenarbeiten, um Ihre Webserver so einzurichten, dass sie JSON-Web-Tokens (JWTs) für neue Aufrufe ausgeben

1. Wenn Sie Ihr Kommunikations-Widget bereits erstellt haben, wählen Sie das Widget auf der Seite **Kommunikations-Widgets** aus, um es zu bearbeiten. 

1. Wählen Sie im Abschnitt **Domain und Sicherheit** die Option **Bearbeiten** aus. 

1. Wählen Sie unter **Mehr Sicherheit für Ihre Kommunikations-Widget-Anfragen** die Option **Ja** aus.  
![\[Die Option „Ja“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-choose-security.png)

1. Wählen Sie **Save and continue** aus. Amazon Connect erstellt das Widget zusammen mit Folgendem:
   + Amazon Connect stellt auf der nächsten Seite einen 44-stelligen Sicherheitsschlüssel bereit, den Sie zum Erstellen JWTs verwenden können.
   + Amazon Connect fügt dem Einbettungsskript für das Kommunikations-Widget eine Callback-Funktion hinzu, die nach einem JWT sucht, wenn ein Anruf initiiert wird.

     Sie müssen die Callback-Funktion im Einbettungscode implementieren, wie im folgenden Beispiel gezeigt.

     ```
     amazon_connect('authenticate', function(callback) {
       window.fetch('/token').then(res => {
         res.json().then(data => {
           callback(data.data);
         });
       });
     });
     ```

   Im nächsten Schritt erhalten Sie einen Sicherheitsschlüssel für alle Anrufe, die auf Ihren Websites initiiert wurden. Bitten Sie Ihren Website-Administrator, Ihre Webserver so einzurichten, dass sie JWTs mit diesem Sicherheitsschlüssel ausgeben. 

1. Wählen Sie **Save and continue** aus.

1. Kopieren Sie den benutzerdefinierten HTML-Codeausschnitt und fügen Sie ihn in den Quellcode Ihrer Website ein.

## Alternative Methode: Weitergeben von Kontaktattributen direkt aus dem Codeausschnitt
<a name="pass-attrib-from-code"></a>

**Anmerkung**  
Diese Attribute haben zwar den Gültigkeitsbereich des Präfixes `HostedWidget-`, sind aber dennoch clientseitig veränderbar. Verwenden Sie das JWT-Setup, wenn Sie persönlich identifizierbare Informationen oder unveränderliche Daten in Ihrem Kontaktablauf benötigen. 

Das folgende Beispiel zeigt, wie Kontaktattribute direkt aus dem Codeausschnitt weitergegeben werden, ohne die Widget-Sicherheit zu aktivieren. 

```
<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...
  
  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>
```

### Verwenden der Attribute in Kontaktabläufen
<a name="contact-flow-usage-voice"></a>

Der Ablaufblock [Kontaktattribute prüfen](check-contact-attributes.md) ermöglicht den Zugriff auf diese Attribute mithilfe des Namespace **Benutzerdefiniert**, wie in der folgenden Abbildung dargestellt. Sie können den Ablaufblock verwenden, um Verzweigungslogik hinzuzufügen. Der vollständige Pfad lautet `$Attribute.HostedWidget-attributeName`. 

![\[Die Abbildung zeigt einen Ablaufblock, der zu den Prompts „Gültig“ und „Ungültig“ verzweigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/flow-check-contact-attrib.png)


## Kopieren des Codes und der Sicherheitsschlüssel für das Kommunikations-Widget
<a name="copy-widget-script4"></a>

In diesem Schritt bestätigen Sie Ihre Auswahl, kopieren den Code für das Kommunikations-Widget und betten ihn in Ihre Website ein. Sie können auch die geheimen Schlüssel für die Erstellung des kopieren JWTs. 

### Sicherheitsschlüssel
<a name="widget-security-key4"></a>

Verwenden Sie diesen 44-stelligen Sicherheitsschlüssel, um JSON-Webtoken von Ihrem Webserver aus zu generieren. Sie können Schlüssel auch aktualisieren oder rotieren, wenn Sie sie ändern müssen. Wenn Sie dies tun, stellt Ihnen Amazon Connect einen neuen Schlüssel zur Verfügung und behält den vorherigen Schlüssel bei, bis Sie ihn ersetzen können. Nachdem Sie den neuen Schlüssel bereitgestellt haben, können Sie zu Amazon Connect zurückkehren und den vorherigen Schlüssel löschen.

![\[Der Sicherheitsschlüssel.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-security-key.png)


Wenn Kunden mit dem Anrufstartsymbol auf Ihrer Website interagieren, fordert das Kommunikations-Widget vom Webserver ein JWT an. Wenn dieses JWT bereitgestellt wird, nimmt das Widget es als Teil des Anrufs des Endkunden an Amazon Connect auf. Amazon Connect verwendet dann den geheimen Schlüssel, um das Token zu entschlüsseln. Wenn dies erfolgreich möglich ist, bestätigt es, dass das JWT von Ihrem Webserver ausgestellt wurde, und Amazon Connect leitet den Anruf an Ihre Kundendienstmitarbeiter im Contact Center weiter.

#### Einzelheiten zum JSON-Web-Token
<a name="jwts4"></a>
+ Algorithmus: **HS256**
+ Claims: 
  + **Sub**: *widgetId*

    Ersetzen Sie `widgetId` durch Ihre eigene WidgetID. Um Ihre WidgetID zu finden, sehen Sie sich das Beispiel-[Skript für das Kommunikations-Widget](add-chat-to-website.md#chat-widget-script) an.
  + **iat**: \$1Ausgabezeitpunkt.
  + **exp**: \$1Flow (maximal 10 Minuten).

  \$1Informationen zum Datumsformat finden Sie im folgenden Dokument der Internet Engineering Task Force (IETF): [JSON Web Token (JWT)](https://tools.ietf.org/html/rfc7519), Seite 5. 

Der folgende Codeblock zeigt ein Beispiel für die Generierung eines JWT in Python:

```
payload = {
'sub': widgetId, // don't add single quotes, such as 'widgetId'
'iat': datetime.utcnow(),
'exp': datetime.utcnow() + timedelta(seconds=JWT_EXP_DELTA_SECONDS)
}

header = {
'typ': "JWT",
'alg': 'HS256'
}

encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm=JWT_ALGORITHM, headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect
```

#### Skript für das Kommunikations-Widget
<a name="chat-widget-script4"></a>

Die folgende Abbildung zeigt ein Beispiel dafür JavaScript , wie Sie es auf Websites einbetten, auf denen Kunden Ihr Kontaktzentrum anrufen können sollen. Dieses Skript zeigt das Widget in der unteren rechten Ecke Ihrer Website an. 

Die folgende Abbildung zeigt, wo Sie Ihre WidgetID finden.

![\[Skript für das Kommunikations-Widget\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-code.png)


Wenn Ihre Website geladen wird, sehen Kunden zuerst das Symbol **Starten**. Wenn sie dieses Symbol auswählen, wird das Kommunikations-Widget geöffnet und die Kunden können Ihre Kundendienstmitarbeiter anrufen.

Sie können jederzeit Änderungen am Kommunikations-Widget über **Bearbeiten** vornehmen.

**Anmerkung**  
Gespeicherte Änderungen aktualisieren die Kundenumgebung in wenigen Minuten. Überprüfen Sie Ihre Widget-Konfiguration, bevor Sie sie speichern. 

![\[Der Link zum Bearbeiten in der Widget-Vorschau.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/chatwidget-call-edit.png)


Damit Änderungen an Widget-Symbolen auf der Website wirksam werden, müssen Sie Ihre Website direkt mit einem neuen Codeblock aktualisieren.

# Zusätzliche Anpassungen für das Webanruf-Widget in Amazon Connect
<a name="more-customizations-web-calling-widget"></a>

Sie können Ihrem Webanruf-Widget die folgenden zusätzlichen Anpassungen hinzufügen:
+ Wenden Sie die Option [Unschärfe im Hintergrund](#background-blur) auf die Videokachel Ihres Kunden an.
+ Stellen Sie das Widget auf [Vollbild](#fullscreen-mode) ein.
+ Wählen Sie die [Standardkamera](#choose-default-camera) aus.
+ [Passen Sie die Größe des Videos so an](#resize-video), dass es in seinen Container passt.

In den folgenden Abschnitten werden die detaillierten Anpassungen sowie ihre Anwendungsfälle und ihre Konfiguration erläutert. Sie verwalten diese Anpassungen durch Konfigurieren von `WebCallingCustomizationObject`.

**Topics**
+ [Unschärfe im Hintergrund](#background-blur)
+ [Vollbildmodus](#fullscreen-mode)
+ [Auswählen der Standardkamera](#choose-default-camera)
+ [Anpassen der Videobildgröße](#resize-video)
+ [Konfigurieren des Anpassungsobjekts](#configure-customization-object-web)
+ [Unterstützte Optionen und Beschränkungen](#supported-options-web-calling)

## Unschärfe im Hintergrund
<a name="background-blur"></a>

Diese Anpassung steuert das Verhalten der Unschärfe im Hintergrund des Kundenvideos. Wenn diese Option aktiviert ist, ist der Hintergrund des Kunden bei aktivem Videoanruf unscharf. Dies trägt zum Schutz seiner persönlichen Daten oder privaten Bereiche bei, die während des Videoanrufs möglicherweise im Hintergrund sichtbar sind.

Um die Hintergrundunschärfe zu aktivieren, legen Sie `videoFilter.backgroundBlur.option` in `WebCallingCustomizationObject` auf `ENABLED_ON_BY_DEFAULT` fest.

## Vollbildmodus
<a name="fullscreen-mode"></a>

Verwenden Sie diese Anpassung, um das Verhalten des Widgets im Vollbildmodus zu steuern. Es gibt zwei Methoden zum Aktivieren des Vollbildmodus: 
+ Fügen Sie dem Widget die Schaltfläche „Vollbild“ hinzu. Der Kunde kann die Schaltfläche verwenden, um den Vollbildmodus zu aktivieren und zu deaktivieren.

  Um die Schaltfläche „Vollbild“ hinzuzufügen, legen Sie `fullscreen.displayButton` auf `ENABLED` fest. 

ODER
+ Stellen Sie das Widget beim Laden auf den Vollbildmodus ein.

  Um den Vollbildmodus beim Laden zu aktivieren, legen Sie `fullscreen.fullscreenOnLoad` auf `ENABLED` fest.

Die Verwendung des Vollbildmodus ist besonders hilfreich, wenn sich der Kunde auf das Widget konzentrieren muss, z. B. bei der Bildschirmfreigabe.

Sie können diese beiden Optionen einzeln oder in Kombination verwenden.

## Auswählen der Standardkamera
<a name="choose-default-camera"></a>

Diese Anpassung ermöglicht es dem Widget, die Standardkamera auszuwählen, wenn Ihr Kunde das Video aktiviert, und bietet Optionen für die front- oder rückseitige Kamera. Diese Funktion ist beispielsweise für die Ferndiagnose von Geräten nützlich. Der Kunde kann die rückseitige Kamera verwenden, um dem Kundendienstmitarbeiter das Gerät zu zeigen.

Um die rückseitige Kamera als Standard auszuwählen, legen Sie `devices.defaultCamera` auf `Back` fest.

## Anpassen der Videobildgröße
<a name="resize-video"></a>

Diese Anpassung steuert, wie die Größe der Videokacheln für den Kunden und den Kundendienstmitarbeiter im Widget geändert werden. Beispielsweise kann die Größe des Video-Frames so geändert werden, dass die gesamte Videokachel ausgefüllt wird. Die Größe kann auch entsprechend der Größe der Videokachel skaliert werden, sodass Leerräume übrig bleiben, wenn das Seitenverhältnis des Video-Frames nicht mit der Videokachel übereinstimmt.
+ Um die Größe des Videos für den Kunden zu ändern, legen Sie `videoTile.localVideoObjectFit` auf den Zielwert fest.
+ Um die Größe des Videos für den Kundendienstmitarbeiter zu ändern, legen Sie `videoTile.remoteVideoObjectFit` auf den Zielwert fest.

Weitere Informationen finden Sie unter [Unterstützte Optionen und Beschränkungen](#supported-options-web-calling).

## Konfigurieren des Anpassungsobjekts
<a name="configure-customization-object-web"></a>

Das folgende Beispiel veranschaulicht, wie Sie alle optionalen Anpassungen für Webanrufe implementieren. Eine detaillierte Beschreibung dieser Optionen finden Sie unter [Unterstützte Optionen und Beschränkungen](#supported-options-web-calling). 

Sie können einige oder alle der im folgenden Beispiel angegebenen Felder implementieren. Wenn Sie keine Anpassungen implementieren, wird das Standardverhalten für die fehlenden Felder angewendet.

```
amazon_connect('webCallingCustomizationObject', { 
        videoFilter: { 
            backgroundBlur: { 
                option: "ENABLED_OFF_BY_DEFAULT" 
            }
        },
        fullscreen: {
            displayButton: "ENABLED",
            fullscreenOnLoad: "DISABLED"
        },
        devices: { 
            defaultCamera: "Front" 
        },
        videoTile: {
            localVideoObjectFit: "cover",
            remoteVideoObjectFit: "cover"
        },
        copyDisplayNameFromAuthenticatedChat: true
});
```

In der folgenden Abbildung sind die Anpassungen dargestellt, wenn sie sich nicht im Vollbildmodus befinden. 

![\[Anpassungen, wenn sie sich nicht im Vollbildmodus befinden.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/fullscreenmode.png)


In der folgenden Abbildung sind die Anpassungen im Vollbildmodus dargestellt.

![\[Anpassungen im Vollbildmodus.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/nonfullscreenmode.png)


## Unterstützte Optionen und Beschränkungen
<a name="supported-options-web-calling"></a>

In der folgenden Tabelle sind die Namen von unterstützten Anpassungsfeldern und die empfohlenen Beschränkungen der Werte aufgeführt.


| Benutzerdefinierte Layoutoption | Typ | Werte | Description | 
| --- | --- | --- | --- | 
|  `videoFilter.backgroundBlur.option`  |  Zeichenfolge  |  `ENABLED_ON_BY_DEFAULT` \$1 `ENABLED_OFF_BY_DEFAULT`  |  Stellt die Unschärfe im Hintergrund der Kunden-Videokachel ein. Wenn Ihr Kunde Video aktiviert, wird der Filter für Hintergrundunschärfe standardmäßig auf die Videokachel angewendet. Wenn Sie den Filter nicht standardmäßig aktivieren möchten, können Sie ihn auf `ENABLED_OFF_BY_DEFAULT` festlegen. Ihr Kunde kann den Filter auf der Einstellungsseite des Widgets trotzdem manuell aktivieren. | 
|  `fullscreen.displayButton`  |  Zeichenfolge  |  `ENABLED`  |  Fügt eine Schaltfläche in der oberen rechten Ecke des Widgets hinzu, um es im Browser im Vollbildmodus anzuzeigen. Standardmäßig wird diese Schaltfläche nicht zum Widget hinzugefügt. Wenn Sie diese Schaltfläche hinzufügen möchten, können Sie sie auf `ENABLED` festlegen. | 
|  `fullscreen.fullscreenOnLoad`  |  Zeichenfolge  |  `ENABLED`  |  Zeigt das Widget im Browser im Vollbildmodus an. Standardmäßig wird das Widget in der unteren rechten Ecke der Webseite verankert. Wenn Sie das Widget auf `ENABLED` festlegen, wird es im Browser im Vollbildmodus angezeigt. | 
|  `devices.defaultCamera`  |  Zeichenfolge  |  `Front` \$1 `Back`  | Legt die Standardkamera fest, wenn Ihr Kunde Video aktiviert. Diese Option ist für Anwendungsfälle auf Mobilgeräten oder Tablets vorgesehen. Standardmäßig wird die Standardkamera ausgewählt ([detail](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices)). (Weitere Informationen finden Sie in der Mozilla-Entwicklerdokumentation [zur MethodeMediaDevices: enumerateDevices ()](https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices).) Wenn Sie den Wert auf `Front\|Back` einstellen, wird die entsprechende Kamera ausgewählt, sofern verfügbar. | 
|  `copyDisplayNameFromAuthenticatedChat`  |  boolesch  |  `true` \$1 `false`  | Wenn der Endkunde mithilfe des Ablaufblocks [Kunden authentifizieren](authenticate-customer.md) authentifiziert wird, wird der Anzeigename bei Festlegen des Werts auf `true` in den Sprachkontakt kopiert. Der Standardwert ist `false`. | 
|  `videoTile.localVideoObjectFit`  |  Zeichenfolge  |  `fill` \$1 `contain` \$1 `cover` \$1 `none` \$1 `scale-down`  |  Legt die Eigenschaft [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) der Kunden-Videokachel im Widget fest. Standardmäßig wird der Wert durch die Breite und Höhe der Videoauflösung bestimmt: Wenn die Höhe größer als die Breite ist, lautet der Wert `contain`, andernfalls `cover`. Eine ausführliche Beschreibung der einzelnen Werte finden Sie unter [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) in der Mozilla-Entwicklerdokumentation.  Dieses Attribut wird nur auf die Anzeigehöhe und -breite des Kundenvideos im Widget angewendet. Die Höhe und Breite des Kundenvideos, das an den Kundendienstmitarbeiter gesendet wird, bleiben unverändert.  | 
|  `videoTile.remoteVideoObjectFit`  |  Zeichenfolge  |  `fill` \$1 `contain` \$1 `cover` \$1 `none` \$1 `scale-down`  | Legt die Eigenschaft [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) der Kunden-Videokachel im Widget fest. Standardmäßig wird der Wert durch die Breite und Höhe der Videoauflösung bestimmt: Wenn die Höhe größer als die Breite ist, lautet der Wert `contain`, andernfalls `cover`. Eine ausführliche Beschreibung der einzelnen Werte finden Sie unter [object-fit](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) in der Mozilla-Entwicklerdokumentation.  Dieses Attribut wird nur auf die Anzeigehöhe und -breite des Kundendienstmitarbeiter-Videos im Widget angewendet.   | 

# Integrieren von Videoanrufen und Bildschirmfreigabe-Funktionen mithilfe von Amazon Connect Streams JS in Ihren benutzerdefinierten Desktop für Kundendienstmitarbeiter
<a name="integrate-video-calling-for-agents"></a>

Dieses Thema richtet sich an Entwickler. Bei benutzerdefinierten Desktops für Kundendienstmitarbeiter müssen Sie Änderungen vornehmen, um Videoanrufe und die Bildschirmfreigabe zu unterstützen. Im Folgenden sind allgemeine Schritte hierfür aufgeführt.

**Anmerkung**  
Wenn Sie das CCP direkt in Ihre benutzerdefinierte Kundendienstmitarbeiteranwendung einbetten, stellen Sie sicher, dass `allowFramedVideoCall` auf „true“ gesetzt ist, wenn Sie das CCP mit [Amazon Connect Streams JS](https://github.com/aws/amazon-connect-streams) initiieren.

1. Verwenden Sie [Amazon Connect Streams JS](https://github.com/aws/amazon-connect-streams), um zu überprüfen, ob es sich bei dem eingehenden Kontakt um einen WebRTC-Kontakt handelt. Verwenden Sie den Kontaktuntertyp `"connect:WebRTC"`, wie im folgenden Codebeispiel zu sehen:

   `contact.getContactSubtype() === "connect:WebRTC"`

1. Sie können den Anzeigenamen des Kunden über das Namensfeld in ` contact contact.getName()` abrufen.

## Hinzufügen der Unterstützung für Videos
<a name="support-video"></a>

Führen Sie die folgenden Schritte aus, um Unterstützung für die Videoverarbeitung hinzuzufügen, sofern Ihre Kunden diese Option aktiviert haben.

1. So überprüfen Sie, ob ein Kontakt über Videofunktionen verfügt:

   ```
   // Return true if any connection has video send capability
   contact.hasVideoRTCCapabilities()
   
   // Return true if the agent connection has video send capability
   contact.canAgentSendVideo()
   
   // Return true if other non-agent connection has video send capability
   contact.canAgentReceiveVideo()
   ```

1. So überprüfen Sie, ob der Kundendienstmitarbeiter über Videoberechtigung zur Bearbeitung von Videoanrufen verfügt:

   `agent.getPermissions().includes('videoContact');`

1. Um einen Videoanruf anzunehmen, muss der Kontakt über Videofunktionen und der Kundendienstmitarbeiter über eine Videoberechtigung verfügen.

   ```
   function shouldRenderVideoUI() {
       return contact.getContactSubtype() === "connect:WebRTC" &&
       contact.hasVideoRTCCapabilities() &&
       agent.getPermissions().includes('videoContact');
   }
   ```

1. Um an einer Videositzung teilzunehmen, rufen Sie `getVideoConnectionInfo` auf.

   ```
   if (shouldRenderVideoUI()) {
      const response = await
      contact.getAgentConnection().getVideoConnectionInfo();
   }
   ```

1. Informationen zum Erstellen einer Video-Benutzeroberfläche und zur Teilnahme an einer Videokonferenz finden Sie unter:
   + [Amazon Chime SDK für JavaScript](https://github.com/aws/amazon-chime-sdk-js) GitHub 
   + [Amazon Chime SDK React Components Library](https://github.com/aws/amazon-chime-sdk-component-library-react) aktiviert GitHub

1. Der Einfachheit halber verwenden die folgenden Codefragmente Beispiele aus der Amazon Chime SDK React Components Library.

   ```
   import { MeetingSessionConfiguration } from "amazon-chime-sdk-js";
   import {
     useMeetingStatus,
     useMeetingManager,
     MeetingStatus,
     DeviceLabels,
     useLocalAudioOutput
   } from 'amazon-chime-sdk-component-library-react';
   
   const App = () => (
     <MeetingProvider>
       <MyVideoManager />
     </MeetingProvider>
   );
   
   const MyVideoManager = () => {
       const meetingManager = useMeetingManager();
       if (shouldRenderVideoUI()) {
           const response = await contact.getAgentConnection().getVideoConnectionInfo();
           const configuration = new MeetingSessionConfiguration(
               response.meeting, response.attendee);
           await meetingManager.join(configuration, { deviceLabels: DeviceLabels.Video });
           await meetingManager.start();
       }
       
       function endContact() {
           meetingManager.leave();
       }
   }
   ```

1. Verwenden Sie zum Rendern des Videorasters die React Components Library [VideoTileGrid](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-components-videotilegrid--page)aus der Amazon Chime SDK oder passen Sie das Verhalten der Benutzeroberfläche mithilfe von an. [RemoteVideoTileProvider](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-providers-remotevideotileprovider--page) 

1. Um eine Videovorschau zu rendern, können Sie die [CameraSelection](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-components-deviceselection-camera-cameraselection--page)Komponenten [VideoPreview](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-components-previewvideo--page)und verwenden. Um ein Kameravideo auszuwählen oder zu ändern, können Sie `meetingManager.selectVideoInputDevice` oder `meetingManager.startVideoInput ` verwenden, wenn die Konferenz gerade läuft.

   ```
   const meetingManager = useMeetingManager();
   const { isVideoEnabled } = useLocalVideo();
   if (isVideoEnabled) {
       await meetingManager.startVideoInputDevice(current);
    } else {
       meetingManager.selectVideoInputDevice(current);
   }
   ```

1. Informationen zur Implementierung von Hintergrundunschärfe finden Sie unter [useBackgroundBlur](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-hooks-usebackgroundblur--page). 

1. Einen Beispielcode zum Erstellen eines benutzerdefinierten Videoerlebnisses finden Sie in diesem Amazon Chime -SDK-Beispiel: [Amazon Chime React Meeting – Demo](https://github.com/aws-samples/amazon-chime-sdk/tree/main/apps/meeting). 

## Hinzufügen der Unterstützung für die Bildschirmfreigabe
<a name="support-screen-sharing"></a>

**Anmerkung**  
Wenn Sie das out-of-box CCP direkt in Ihrer benutzerdefinierten Agentenanwendung verwenden, stellen Sie sicher`allowFramedScreenSharing`, dass `allowFramedScreenSharingPopUp` es auf true gesetzt ist, wenn Sie das CCP mit [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) JS initiieren.   
Durch Festlegen des Werts `allowFramedScreenSharing` auf „true“ wird die Schaltfläche für die Bildschirmfreigabe nur auf einem CCP in einem Fenster oder einer Registerkarte aktiviert. Wenn der Wert `allowFramedScreenSharingPopUp` auf „true“ festgelegt ist, wird die Bildschirmfreigabe-App in einem separaten Fenster gestartet, wenn der Kundendienstmitarbeiter die Bildschirmfreigabe-Schaltfläche auswählt. Weitere Informationen finden Sie in der Dokumentation zu [Amazon Connect Streams JS](https://github.com/aws/amazon-connect-streams).

Führen Sie die folgenden Schritte aus, um die Bildschirmfreigabe auf Ihren benutzerdefinierten Kundendienstmitarbeiter-Desktops zu aktivieren. 

1. Überprüfen Sie, ob ein Kontakt über die Bildschirmfreigabe-Funktionen verfügt. 

   ```
   // Return true if any connection has screen sharing send capability
   contact.hasScreenShareCapability()
   
   // Return true if the agent connection has screen sharing send capability
   contact.canAgentSendScreenShare()
   
   // Return true if customer connection has screen sharing send capability
   contact.canCustomerSendScreenShare()
   ```

1. Überprüfen Sie, ob der Kundendienstmitarbeiter über die Videoberechtigung verfügt.

   ```
   agent.getPermissions().includes('videoContact');
   ```

1. Überprüfen Sie, ob der Kundendienstmitarbeiter eine Bildschirmfreigabe-Sitzung für den berechtigten Kontakt einleiten kann.

   ```
   fun canStartScreenSharingSession() {
       return contactgetContactSubtype() === "connect:WebRTC" &&
       contact.hasScreenShareCapability() &&
       agent.getPermissions().includes('videoContact');
   }
   ```

1. Rufen Sie `startScreenSharing` auf, um die Bildschirmfreigabe-Sitzung zu initiieren. Dadurch wird `ScreenSharingActivated` zum Kontakt hinzugefügt, sodass Sie im [Kontaktdatensatz](ctr-data-model.md) danach suchen können. 

   ```
   contact.startScreenSharing();
   ```

1. Rufen Sie `getVideoConnectionInfo` auf, um an der Sitzung teilzunehmen. Sie können diesen Schritt überspringen, wenn der Kundendienstmitarbeiter an der Videositzung zum Verarbeiten des Videos teilgenommen hat.

   ```
   if (canStartScreenSharingSession) {
       contact.startScreenSharing();
       const response = await
       contact.getAgentConnection().getVideoConnectionInfo();
   }
   ```

1. Nehmen Sie an der Sitzung teil, indem Sie die Komponentenbibliothek von Amazon Chime SDK React verwenden. Einen Codeausschnitt finden Sie in Schritt 6 unter [Hinzufügen der Unterstützung für Videos](#support-video).

1. Verwenden Sie dasselbe [VideoTileGrid](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-components-videotilegrid--page)aus dem Amazon Chime SDK React Components, um eine Video-Kachel zur Bildschirmübertragung zu rendern. [Weitere Informationen finden Sie unter [useContentShareStatus](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-hooks-usecontentsharestate--page) und Steuerung useContentShare](https://aws.github.io/amazon-chime-sdk-component-library-react/?path=/docs/sdk-hooks-usecontentsharecontrols--page) 

1. Rufen Sie `stopScreenSharing` auf, wenn die Sitzung beendet ist.

   ```
   contact.stopScreenSharing();
   ```

1. Sie können Ereignisse für Bildschirmfreigabe-Aktivitäten erhalten, indem Sie die folgenden Rückrufe abonnieren:

   ```
   initScreenSharingListeners() {
       this.contact.onScreenSharingStarted(() => {
           // Screen sharing session started
       });
   
       this.contact.onScreenSharingStopped(() => {
           // Screen sharing session ended
       });
   
       this.contact.onScreenSharingError((error) => {
           // Screen sharing session error occurred
       });
     }
   }
   ```

# Aktivieren der URL-Beschränkung für die Bildschirmfreigabe
<a name="screen-sharing-url-restriction"></a>

Sie können festlegen URLs , welche Informationen Ihre Kunden und Agenten während des Kontakts teilen dürfen. Auf diese Weise können Sie eine bessere Sicherheit und einen besseren Datenschutz erzielen. Wenn ein Kunde oder ein Kundendienstmitarbeiter eine nicht zugelassene URL freigibt, erhält er eine Fehlermeldung und das Bildschirmfreigabe-Video wird automatisch angehalten und ausgeblendet. 

**Wichtig**  
Folgende Browser werden unterstützt:   
Chrome Version 109 und höher
Edge Version 109 und höher
Kundendienstmitarbeiter und Kunden können nur die Browser-Registerkarte freigeben. Sie können nicht das Fenster oder den gesamten Bildschirm freigeben. Wenn Sie dieses Feature aktivieren und Ihre Kunden oder Kundendienstmitarbeiter einen nicht unterstützten Browser bzw. ein nicht unterstütztes Fenster oder den gesamten Bildschirm verwenden, erhalten sie eine Fehlermeldung.

Führen Sie die folgenden Schritte aus, um die URL-Einschränkung für die Bildschirmfreigabe zu aktivieren.

## Schritt 1: Erstellen Sie eine URLs Liste der erlaubten Personen
<a name="step1-url-restriction"></a>

Sie konfigurieren die Listen der zulässigen Dateien URLs mithilfe vordefinierter Attribute. Führen Sie folgende Schritte aus:

1. Wählen Sie auf der Amazon Connect Admin-Website **** Routing****, **Vordefinierte Attribute**, **Vordefiniertes Attribut hinzufügen** aus.

1. Fügen Sie im Abschnitt **Vordefiniertes Attribut hinzufügen** im Feld **Vordefiniertes Attribut** eine der folgenden Optionen hinzu.
   + Geben Sie `screensharing:customer-allowed-urls` ein, um eine Zulassungsliste für die Bildschirmfreigabe durch den Kunden zu erstellen.
   + Geben Sie `screensharing:agent-allowed-urls` ein, um eine Zulassungsliste für die Bildschirmfreigabe durch den Kundendienstmitarbeiter zu erstellen.

1. Geben Sie im Feld **Wert** die zulässige URL ein. Dabei kann es sich um eine vollständig formatierte URL oder um ein Zeichenfolgemuster für den Abgleich von Teilzeichenfolgen handeln, z. B. ` https://mycompany` oder ` /mytransactions`. In der folgenden Tabelle sind Beispiele für gültige Formate angegeben.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/screen-sharing-url-restriction.html)

1. Speichern Sie die Liste. Sie URLs werden auf der Seite **Vordefinierte Attribute** angezeigt, wie im folgenden Beispiel gezeigt.   
![\[Die Seite „Vordefinierte Attribute“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/screen-sharing-restricted-urls.png)

## Schritt 2: Hinzufügen eines Skripts zur Website-Liste
<a name="step2-url-restriction"></a>

Sie müssen ein Skript in Ihre Website integrieren, damit die URL der Seite für die zu erfassende Anwendung angezeigt werden kann. Sie erhalten den Capture-Handler aus einer Datei auf dem CloudFront Amazon-Endpunkt, den Amazon Connect hostet. Führen Sie anschließend die folgenden Anleitungen aus.

1. Wählen Sie auf der Amazon Connect Admin-Website **Kanäle**, **Widgets kommunizieren** aus. Suchen Sie auf der Übersichtsseite des Kommunikations-Widgets nach dem Widget-Skript. Rufen Sie den Endpunkt aus dem Attribut `s.src` ab, wie im folgenden Beispiel dargestellt.   
![\[Das Widget-Skript.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/screen-sharing-restricted-urls-step2.png)

   Der Endpunkt kann sich in einer anderen AWS Region als Ihre Amazon Connect Connect-Instance befinden. Für optimale Performance empfehlen wir, die gleiche Region wie Ihre Amazon-Connect-Instance zu verwenden. 

1. Ersetzen Sie den folgenden Platzhalter `${endpoint}` durch den Wert aus dem vorherigen Schritt. Kopieren Sie den gesamten Codeausschnitt und fügen Sie ihn auf der obersten Ebene Ihrer Website ein.

   ```
   <script type="text/javascript" src='${endpoint}/amazon-connect-url-restriction.js'></script>
   ```

# Einrichten von Aufgaben in Amazon Connect
<a name="concepts-getting-started-tasks"></a>

1. [Aktualisieren Sie die Weiterleitungsprofile Ihrer Kundendienstmitarbeiter](routing-profiles.md), damit diese Aufgaben verwalten und erstellen können.

   Wenn Sie Aufgaben zu den Weiterleitungsprofilen hinzufügen, können Sie vorgeben, dass einzelnen Mitarbeitern maximal 10 Aufgaben gleichzeitig zugewiesen werden können. 

   Ein Kundendienstmitarbeiter kann die gleiche Anzahl von Aufgaben unterbrechen wie in der Einstellung **Maximale Anzahl an Aufgaben pro Kundendienstmitarbeiter** in seinem [Routing-Profil](routing-profiles.md) angegeben. 

   Ein Kundendienstmitarbeiter verfügt beispielsweise über die Einstellung **Maximale Anzahl an Aufgaben pro Kundendienstmitarbeiter**, um 5 aktive Aufgaben gleichzeitig zu bearbeiten. Das bedeutet, dass er bis zu 5 Aufgaben unterbrechen kann, wodurch er seine aktiven Slots für neue, kritischere Aufgaben freigeben kann. Das bedeutet aber auch, dass Kundendienstmitarbeiter zu jedem Zeitpunkt die doppelte Anzahl an Aufgaben in ihrem Workspace haben können. In unserem Beispiel kann dieser Kundendienstmitarbeiter 10 Aufgaben in seinem Workspace haben: 5 unterbrochen und 5 aktiv. 

   In der folgenden Abbildung sehen Sie die Option **Aufgaben** auf der **Weiterleitungsprofil**-Seite.  
![\[In der Option „Aufgaben“ ist die maximale Anzahl an Aufgaben pro Kundendienstmitarbeiter auf 5 festgelegt, die Warteschlange ist auf „Sprache“, „Chat“ und „Aufgabe“ gesetzt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-routing-profile-2.png)

1. [Erstellen Sie Schnellverbindungen](quick-connects.md), damit Agenten create/assign Aufgaben an sich selbst oder an andere Agenten oder gemeinsam genutzte Warteschlangen richten können.

1. Aktualisieren Sie Ihre Flows, damit sie Aufgaben weiterleiten können.

1. Sie können optional [Aufgabenvorlagen erstellen](task-templates.md), um Kundendienstmitarbeitern die Aufgabenerstellung zu erleichtern. Alle Felder, die für die Erstellung einer Aufgabe benötigt werden, sind vordefiniert.

1. Optional können Sie außerdem [externe Anwendungen integrieren](integrate-external-apps-tasks.md) und auf Basis vordefinierter Bedingungen [Regeln für die automatische Aufgabenerstellung einrichten](add-rules-task-creation.md).

1. Standardmäßig können alle Kundendienstmitarbeiter Aufgaben erstellen. Wenn Sie die [Berechtigungen](task-template-permissions.md) einiger Kundendienstmitarbeiter blockieren möchten, weisen Sie dem **Contact Control Panel** in deren Sicherheitsprofil die Option **Aufgabenerstellungsberechtigung einschränken** zu.

# Der Aufgabenkanal in Amazon Connect
<a name="tasks"></a>

Mit Amazon Connect Aufgaben können Sie Aufgaben priorisieren, zuweisen, nachverfolgen und sogar automatisieren, und zwar über die verschiedenen Tools hinweg, mit denen Kundendienstmitarbeiter Kunden unterstützen. Mit Aufgaben können Sie beispielsweise:
+ Kundenproblemen nachverfolgen, die in einer CRM-Lösung (Customer Relationship Management) wie Salesforce aufgezeichnet wurden.
+ Bei Kunden im Rahmen eines Telefonats nachfassen.
+ Aktionen in einem unternehmensspezifischen System durchführen, z. B. die Bearbeitung eines Kundenanspruchs in einem Versicherungsantrag.

Derzeit kann Amazon Connect Tasks in Übereinstimmung mit der [DSGVO](https://aws.amazon.com/compliance/gdpr-center) verwendet werden und erfüllt die Vorgaben von SOC, PIC, HITRUST, ISO und HIPAA.

## Was ist eine Aufgabe?
<a name="what-is-a-task"></a>

In einem Unternehmen ist eine *Aufgabe* eine Arbeitseinheit, die ein Kundendienstmitarbeiter erledigen muss. Dazu gehören Arbeiten, die möglicherweise ihren Ursprung in externen Anwendungen haben. In Amazon Connect ist diese Arbeitseinheit ein Kontakt. Er wird weitergeleitet, priorisiert, zugewiesen und nachverfolgt, genau wie ein Sprach- oder Chat-Kontakt. Alles, was für einen Sprach- oder Chat-Kontakt gilt, ist auch auf einen Aufgabenkontakt anwendbar.

Kundendienstmitarbeiter erledigen Aufgaben in ihrem Contact Control Panel (CCP), genau wie für jeden anderen Kontakt. Wenn Kundendienstmitarbeiter eine Aufgabe zugewiesen wird, erhalten sie eine Benachrichtigung mit einer Beschreibung der Aufgabe, Informationen zu den Aufgaben und Links zu allen Anwendungen, die sie möglicherweise für die Ausführung der Aufgabe benötigen. Die folgende Abbildung zeigt, wie das CCP eines Kundendienstmitarbeiters aussehen kann, wenn er Aufgaben verwaltet.

![\[Eine Aufgabe im Contact Control Panel.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-introduction.png)


## So erstellen Sie eine Aufgabe
<a name="concepts-set-up-tasks"></a>

Amazon Connect bietet Ihnen verschiedene Möglichkeiten, Aufgaben zu erstellen: 

1. Sie können vorgefertigte Schnittstellen zu CRM-Anwendungen (z. B. Salesforce und Zendesk) verwenden, um Aufgaben automatisch auf der Grundlage einer Reihe von vordefinierten Bedingungen zu erstellen, ohne dass eine benutzerdefinierte Entwicklung erforderlich ist. 

   Sie können beispielsweise eine Regel in Amazon Connect so konfigurieren, dass automatisch eine Aufgabe erstellt wird, wenn ein neuer Fall in Salesforce erstellt wird. 

   Weitere Informationen erhalten Sie unter [Einrichten der Integration von Anwendungen, um Aufgaben in Amazon Connect zu erstellen](integrate-external-apps-tasks.md) und [Erstellen von Regeln zur Aufgabengenerierung für Drittanbieterintegrationen in Amazon Connect](add-rules-task-creation.md).

1. Sie können Ihre eigenen oder unternehmensspezifischen Anwendungen integrieren, um Aufgaben mit Amazon Connect zu erstellen. APIs

   Weitere Informationen finden Sie in der [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html)-API.

1. Sie können Ihren Flows den Block [Aufgabe erstellen](create-task-block.md) hinzufügen. Mit diesem Block können Sie Aufgaben direkt aus Flows erstellen und orchestrieren, die auf Kundeneingaben (DTMF-Eingaben) sowie Kontakt- und Aufgabeninformationen basieren.

1. Sie können es Ihren Kundendienstmitarbeitern ermöglichen, Aufgaben über das Contact Control Panel (CCP) zu erstellen, ohne dass Sie Entwicklungsarbeit leisten müssen.

   Kundendienstmitarbeiter können beispielsweise Aufgaben erstellen, um sicherzustellen, dass Folgearbeiten nicht vergessen werden, z. B. einen Kunden zurückrufen, um ihn über den Status seines Problems zu informieren. 

   Weitere Informationen finden Sie unter [Testen von Sprach-, Chat- und Aufgabenerlebnissen in Amazon Connect](chat-testing.md).

Weitere Informationen zu den ersten Schritten mit Aufgaben finden Sie unter [Einrichten von Aufgaben in Amazon Connect](concepts-getting-started-tasks.md).

**Wichtig**  
Der Ablauf [Standard-Warteschlange für den Kunden](default-customer-queue.md) unterstützt keine Aufgaben. Es schlägt fehl, wenn Sie es out-of-the-box ohne Änderungen verwenden. Der **standardmäßige Kunden-Warteschlangenablauf** enthält einen Block [Loop prompts (Telefonansagen in Schleife schalten)](loop-prompts.md). Dieser Block unterstützt keine Aufgaben.   
Wir empfehlen Ihnen, einen neuen Ablauf zu erstellen, mit dem Sie den Kanal überprüfen und Aufgaben an die gewünschte Warteschlange weiterleiten können. Detaillierte Anweisungen finden Sie unter [So senden Sie Aufgaben an eine Warteschlange](#example-enqueue-task). Sie können auch den Block **Telefonansagen in Schleife schalten** im Standardablauf aktualisieren, sodass die Verzweigung **Fehler** nicht beendet wird, sondern stattdessen eine andere Aktion für den Kontakt ausgeführt werden kann. 

## Unterstützte Flowtypen
<a name="concepts-tasks-supported-contact-flow-types"></a>

Sie können Aufgaben in den folgenden Flowtypen verwenden:
+ Inbound-Flow
+ Customer queue flow (Kunden-WarteschlangenFlow)
+ Agent whisper flow (Whisper-Flow für Kundendienstmitarbeiter)
+ Der Flow „An Warteschlange weiterleiten“
+ Transfer to agent flow (Flow für Weiterleitung an Kundendienstmitarbeiter)

## Unterstützte Kontaktblöcke
<a name="concepts-tasks-supported-contact-blocks"></a>

Sie können Aufgaben in den folgenden Flowblocks verwenden:
+ Priorität/Alter der Weiterleitung ändern
+ Check contact attributes (Kontaktattribute prüfen)
+ Check hours of operation (Betriebsstunden prüfen)
+ Check queue status (​Warteschlangenstatus prüfen)
+ Check staffing (Personalbesetzung prüfen)
+ Aufgabe erstellen
+ Disconnect / hang up (Trennen/auflegen)
+ Distribute by percentage (Nach Prozentsatz verteilen)
+ EndFlow/Fortsetzen
+ Get queue metrics (Warteschlangen-Metriken abrufen)
+  AWS Lambda-Funktion aufrufen
+ Loop
+ Set contact attributes (Kontaktattribute festlegen)
+ Set customer queue flow (Kunden-WarteschlangenFlow festlegen)
+ Set disconnect flow (TrennungsFlow festlegen)
+ Set working queue (Arbeitswarteschlange festlegen)
+ Transfer to flow (Weiterleitung an Flow)
+ Transfer to queue (An Warteschlange weiterleiten)
+ Wait

## Verknüpfte Aufgaben
<a name="linked-tasks"></a>

Wenn Sie Aufgaben mit der [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html)API verwenden, kann ein neuer Kontakt über `PreviousContactID` oder einem vorhandenen Kontakt zugeordnet werden. `RelatedContactId` Dieser neue Kontakt enthält eine Kopie der [Kontaktattribute](connect-attrib-list.md) des verknüpften Kontakts.

Der folgende Code zeigt die Anforderungssyntax, die `PreviousContactID` und `RelatedContactId` enthält.

```
PUT /contact/task HTTP/1.1
Content-type: application/json

{
   "Attributes": { 
      "string" : "string" 
   },
   "ClientToken": "string",
   "ContactFlowId": "string",
   "Description": "string",
   "InstanceId": "string",
   "Name": "string",
   "PreviousContactId": "string",
   "QuickConnectId": "string",
   "References": { 
      "string" : { 
         "Type": "string",
         "Value": "string"
      }
   },
   "RelatedContactId": "string",
   "ScheduledTime": number,
   "TaskTemplateId": "string"
}
```

Beachten Sie Folgendes, wenn Sie `PreviousContactID` oder `RelatedContactID` zum Erstellen von Aufgaben verwenden:
+ `PreviousContactID`: Wenn Kontakte mithilfe von `PreviousContactID` verknüpft werden, wirken sich Aktualisierungen, die zu einem beliebigen Zeitpunkt in der Kette an den Kontaktattributen vorgenommen werden, auf die gesamte Kette aus.
+ `RelatedContactID`- Wenn Kontakte über die verknüpft werden, werden Aktualisierungen`RelatedContactID`, die an den Kontaktattributen vorgenommen werden, nur für die ContactID übernommen, auf die in der API verwiesen wird. [UpdateContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactAttributes.html) 

**Anmerkung**  
Sie können nur `PreviousContactID` oder `RelatedContactID` in einem Anforderungstext angeben, aber nicht beide. Wenn Sie beide angeben, gibt Amazon Connect den Fehler `InvalidRequestException` mit dem Statuscode 400 zurück.

Informationen darüber, wie `PreviousContactID` und `RelatedContactId` in Kontaktdatensätzen modelliert werden, finden Sie unter [ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord) im Datenmodell für Kontaktdatensätze.

## Kundendienstmitarbeiter können Aufgaben mit ausgehenden Kontakten verknüpfen
<a name="agents-can-link-tasks"></a>

Während Kundendienstmitarbeiter **aktiv an einer Aufgabe arbeiten**, erscheint im Contact Control Panel (CCP) der **Ziffernblock**. Wenn sie über den Ziffernblock einen ausgehenden Anruf tätigen, wird der Anruf automatisch mit der Aufgabe verknüpft. Amazon Connect verknüpft die Aufgabe und den ausgehenden Anruf mithilfe des `relatedContactID`-Parameters. 

Die folgende Abbildung des CCP zeigt, dass der **Ziffernblock** verfügbar ist, während der Kundendienstmitarbeiter an einer Aufgabe arbeitet.

![\[Der Ziffernblock auf dem CCP.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-linked-outboundcall.png)


## Verknüpfen von Aufgabe und Kontakt mithilfe des Blocks „Aufgabe erstellen“
<a name="link-contacts-using-create-task-block"></a>

Mit dem Block „Aufgabe erstellen“ können Sie die Aufgabe automatisch mit dem aktuellen Kontakt verknüpfen. 

Die folgende Abbildung der Eigenschaftenseite des Blocks **Aufgabe erstellen** zeigt die Option **Link zum Kontakt**.

![\[Die Option „Verknüpfung zum Kontakt“ auf der Eigenschaftsseite des Blocks „Aufgabe erstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/create-task-properties-manually.png)


## Verfolgen, wer eine Aufgabe erstellt hat
<a name="createdby-tasks"></a>

Für Kundendienstmitarbeiter, die Aufgaben über das CCP erstellen, wird automatisch ihr Ressourcen-ARN für Kundendienstmitarbeiter als [Segmentattribut](connect-attrib-list.md#attribs-segment-attributes) namens `CreatedByUser` zum Kontaktdatensatz hinzugefügt. Dieses Attribut ermöglicht es Ihnen, den ursprünglichen Kundendienstmitarbeiter für eine Aufgabe zu verfolgen. Sie können jedoch nicht über die Amazon Connect Admin-Website darauf zugreifen`CreatedByUser`, sondern verwenden Sie stattdessen die API. [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html) 

Das Segmentattribut `CreatedByUser` steht Ihnen im Block [Aufgabe erstellen](create-task-block.md) zur Verfügung. Sie können das Segmentattribut **Erstellt vom Benutzer** festlegen, das den ARN des Benutzers darstellt, der die Aufgabe erstellt hat. Die folgende Abbildung zeigt einen Abschnitt der Eigenschaftenseite **Aufgabe erstellen**, in dem dieses Attribut verfügbar ist.

![\[Die Eigenschaftenseite „Aufgabe erstellen“ und das Attribut „Erstellt vom Benutzer“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/contact-expiry.png)


 Sie können diesen Wert auch manuell für Aufgaben festlegen, die über die [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html)API erstellt werden.

## Kundendienstmitarbeiter können Aufgaben sich selbst zuweisen.
<a name="agents-self-assign-tasks"></a>

Wenn Contact-Center-Supervisoren Aufgabenvorlagen erstellen, können sie diese so konfigurieren, dass Kundendienstmitarbeiter sich Aufgaben selbst zuweisen können. Kundendienstmitarbeiter weisen sich mithilfe des CCP Aufgaben selbst zu. 

Entwickler können den in der [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html)API mit `assignmentType` dem Wert angeben `SELF` und einen gültigen Wert `CreatedByUser` und einen gültigen Wert angeben`TaskTemplateID`.

## Verwenden von IAM Hinzufügen von Aufgabenberechtigungen
<a name="iam-tasks"></a>

Wenn Ihre Organisation benutzerdefinierte [IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) verwendet, um den Zugriff auf die Amazon-Connect-Konsole zu verwalten, stellen Sie sicher, dass Benutzer über die entsprechenden Berechtigungen verfügen, um Anwendungen für die Aufgabenerstellung einzurichten. Eine Liste der erforderlichen Berechtigungen finden Sie unter [Seite "Tasks" (Aufgaben)](security-iam-amazon-connect-permissions.md#tasks-page).

**Anmerkung**  
Wenn Ihre Instance vor Oktober 2018 erstellt wurde, finden Sie Informationen zur Konfiguration Ihrer serviceverknüpften Rollen (SLR) unter [Für Instances, die vor Oktober 2018 erstellt wurden](connect-slr.md#migrate-slr).

## Nachverfolgen von Echtzeit- und Verlaufsmetriken in Berichten
<a name="tracking-tasks"></a>

Sie können den Status aller Aufgaben in Echtzeit- und Verlaufsmetrikberichten verfolgen, genau wie Sie Kontakte in anderen Kanälen verfolgen. Sie können beispielsweise verfolgen:
+ Wie lange Kundendienstmitarbeiter an jeder Aufgabe gearbeitet haben ([Gesprächszeit des Kundendienstmitarbeiters](metrics-definitions.md#agent-contact-time)).
+ Die Gesamtzeit von der Erstellung einer Aufgabe bis zu ihrer Fertigstellung. ([Contact handle time (Kontaktbearbeitungszeit)](metrics-definitions.md#contact-handle-time)).

### Kennzahlen
<a name="tracking-only-tasks"></a>
+ [Durchschnittliche aktive Zeit](metrics-definitions.md#average-active-time)
+ [Durchschnittliche Pausenzeit der Kundendienstmitarbeiter](metrics-definitions.md#average-agent-pause-time) 

### Contact metrics (Kontaktmetriken)
<a name="contact-data-tasks"></a>

Die folgenden Daten werden im Kontaktdatenmodell erfasst. 

### Metriken, die nicht für Aufgaben gelten und im Bericht den Wert 0 haben
<a name="tracking-null-tasks"></a>
+ [Average agent interaction time (Durchschnittliche Interaktionszeit des Kundendienstmitarbeiters)](metrics-definitions.md#average-agent-interaction-time)
+ [Average customer hold time (Durchschnittliche Haltezeit von Kunden)](metrics-definitions.md#average-customer-hold-time)
+ [Agent interaction and hold time (Interaktions- und Wartezeit des Kundendienstmitarbeiters)](metrics-definitions.md#agent-interaction-and-hold-time) – Verlauf
+ [Agent interaction time (Interaktionszeit des Kundendienstmitarbeiters)](metrics-definitions.md#agent-interaction-time) – Verlauf
+ [Average agent interaction time (Durchschnittliche Interaktionszeit des Kundendienstmitarbeiters)](metrics-definitions.md#average-agent-interaction-time)
+ [Average customer hold time (Durchschnittliche Haltezeit von Kunden)](metrics-definitions.md#average-customer-hold-time)

### Verwalten von Aufgaben mit benutzerdefinierten Serviceleveln (SL)
<a name="tasks-custom-sl"></a>

Während Sprach- und Chatdienste kurze, auf Sekunden oder Minuten basierende Service-Level-Zeiten haben können, betragen für einige Aufgaben die Servicelevel unter Umständen Stunden oder Tage. Sie können für jeden Ihrer Kanäle eine geeignete benutzerdefinierte Servicelevel-Dauer erstellen. Weitere Informationen finden Sie unter [Benutzerdefinierte Service-Levels](metrics-definitions.md#custom-service-levels). 

## Wann enden Aufgaben?
<a name="when-do-tasks-end"></a>

Die Gesamtdauer einer Aufgabe kann standardmäßig bis zu 7 Tage betragen. Wenn Sie [eine Aufgabenvorlage erstellen](task-templates.md), können Sie die Dauer der Aufgabe auf bis zu 90 Tage verlängern. 

Eine Aufgabe endet, wenn eines der folgenden Ereignisse eintritt:
+ Ein Kundendienstmitarbeiter erledigt die Aufgabe.
+ Ein Flow führt den Block [Disconnect / hang up (Trennen/auflegen)](disconnect-hang-up.md) aus, wodurch die Aufgabe beendet wird.
+ Eine Aufgabe erreicht das Standardlimit von 7 Tagen.
+ Die **Ablaufdauer in Minuten** wird erreicht, wenn diese Option in der Aufgabenvorlage konfiguriert ist.
+ Sie beenden die Aufgabe mithilfe der [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html)API.

Sie können auch die Einstellung **Ablauf des Kontakts** im Block [Aufgabe erstellen](create-task-block.md) verwenden. 

## So senden Sie Aufgaben an eine Warteschlange
<a name="example-enqueue-task"></a>

Da der Ablauf [Standard-Warteschlange für den Kunden](default-customer-queue.md) nur für Sprachkontakte vorgesehen ist, empfehlen wir Ihnen, einen neuen Ablauf zu erstellen, um Aufgaben (und andere Kanäle als Sprachkanäle) an eine Warteschlange zu senden.

Angenommen, Sie möchten eine Wartezeit von insgesamt 10 Minuten für eine Aufgabe haben, möchten aber jede Minute überprüfen, ob es noch Kundendienstmitarbeiter gibt, die an der Warteschlange arbeiten und die Aufgabe irgendwann übernehmen könnten. Für diesen Anwendungsfall gehen Sie wie folgt vor:

1. Fügen Sie Ihrem Flow einen [Loop](loop.md)-Block hinzu. Stellen Sie die **Schleifenanzahl** auf 10 ein.

1. Verwenden Sie für die Verzweigung **In Schleife** einen Block [Check staffing (Personalbesetzung prüfen)](check-staffing.md), um die Verfügbarkeit von Kundendienstmitarbeitern für die Warteschlange zu überprüfen. 

1. Wenn Kundendienstmitarbeiter verfügbar sind, leiten Sie den Kontakt mithilfe eines Blocks [Transfer to queue (An Warteschlange weiterleiten)](transfer-to-queue.md) an die Warteschlange weiter.

1. Stellen Sie die Verzweigung **Abgeschlossen** so ein, dass der Kontakt an einen Block [Disconnect / hang up (Trennen/auflegen)](disconnect-hang-up.md) weitergeleitet wird. Dieser Vorgang wird ausgelöst, wenn während der 10-Minuten-Schleife keine Kundendienstmitarbeiter verfügbar sind.

## Suchen und Überprüfen abgeschlossener Aufgaben
<a name="task-ctr-fields"></a>

Verwenden Sie die Seite [Kontaktsuche](contact-search.md), um nach abgeschlossenen Aufgaben zu suchen und diese zu überprüfen. 

Die folgende Abbildung zeigt ein Beispiel dafür, wie die **Kontaktzusammenfassung** und die **Referenzen** in einem Kontaktdatensatz für eine Aufgabe aussehen.

![\[Eine Kontaktdatensatzseite für eine Aufgabe.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-sample-ctr.png)


Die folgenden Daten werden an den Kontaktdatensatz angehängt, aber nicht zusammen gespeichert. Die Daten sind in einem Export enthalten. 
+ Flow-ID
+ Mögliche Attribute:
  + [ContactDetails](ctr-data-model.md#ctr-contact-details)
    + Name: Der Name der Aufgabe
    + Beschreibung: Eine Beschreibung der Aufgabe
  + [References](ctr-data-model.md#ctr-contact-references): Alle Links zu Formularen oder anderen Websites

Wenn die Aufgabe für ein zukünftiges Datum und eine zukünftige Uhrzeit geplant ist, wird in der **Kontaktzusammenfassung** auch die **geplante Uhrzeit** angezeigt.

## Weitere Informationen
<a name="tasks-more-information"></a>
+ [Amazon Connect Spezifikationen der Funktionen](feature-limits.md)
+ [Annehmen einer im Contact Control Panel (CCP) zugewiesenen Aufgabe](accept-task.md)
+ [Erstellen einer neuen Aufgabe im Contact Control Panel (CCP)](create-task.md)
+ [Übertragen einer Aufgabe an einen anderen Kundendienstmitarbeiter oder eine Warteschlange im Amazon Connect Contact Control Panel (CCP)](transfer-task.md)

# Unterbrechen und Fortsetzen von Aufgaben in Amazon Connect Tasks
<a name="concepts-pause-and-resume-tasks"></a>

Sie können alle Aufgaben, die nicht abgelaufen, getrennt oder für einen späteren Zeitpunkt geplant sind, unterbrechen und fortsetzen. Auf diese Weise können Kundendienstmitarbeiter einen aktiven Slot freigeben, sodass sie wichtigere Aufgaben annehmen können, wenn ihre aktuelle Aufgabe ins Stocken gerät, z. B. weil eine Genehmigung fehlt oder auf eine externe Eingabe gewartet wird. 

Sie können auch vollautomatische Aufgaben unterbrechen, um Ereignissen höherer Gewalt (Naturkatastrophen, Infrastrukturausfälle, Invasionen) zu begegnen, bei denen Sie möglicherweise alle Geschäftsprozesse vorübergehend unterbrechen und dann fortsetzen müssen, wenn der Notfall vorüber ist.

**Topics**
+ [So setzen Sie unterbrochene und wieder aufgenommene Aufgaben in die Warteschlange](#pause-tasks-queue)
+ [So unterbrechen Agenten Aufgaben und setzen sie fort](#pause-tasks-agent-experience)
+ [Wie viele Aufgaben ein Agent unterbrechen kann](#pause-tasks-number)
+ [Wann kann eine unterbrochene Aufgabe wieder fortgesetzt werden?](#when-resume-tasks)
+ [Programmgesteuert Abbrechen und Fortsetzen von Aufgaben](#programmatically-pause-and-resume-tasks)
+ [Konfigurieren eines Datenflusses, um Aufgaben zu unterbrechen und fortzusetzen](#pause-and-resume-flow)
+ [Kontaktereignis-Stream](#ces-pause-and-resume-tasks)
+ [Unterbrechen und Fortsetzen von Aufgabenereignissen in Kontaktdatensätzen](#ctr-pause-and-resume-tasks)
+ [Kennzahlen](#metrics-pause-and-resume-tasks)

## So setzen Sie unterbrochene und wieder aufgenommene Aufgaben in die Warteschlange
<a name="pause-tasks-queue"></a>
+ Alle unterbrochenen Aufgaben, die sich in der Warteschlange befinden und noch keinem Kundendienstmitarbeiter zugewiesen sind, werden aus der Warteschlange entfernt. Auf diese Weise verbrauchen sie nicht die Warteschlangenlimits für Ihre Instance und ermöglichen stattdessen die Zuweisung anderer wichtigerer Kontakte zu Kundendienstmitarbeitern. 
+ Nachdem die Aufgabe fortgesetzt, wird sie erneut in die Warteschlange gestellt und der Datenstrom wird gemäß Ihrer Konfiguration weiter ausgeführt.
+ Wenn Sie einen Datenstrom so entwerfen, dass nicht zugewiesene, unterbrochene Aufgaben, die aus der Warteschlange genommen wurden, fortgesetzt werden, müssen Sie dem Datenstrom unbedingt einen [Transfer to queue (An Warteschlange weiterleiten)](transfer-to-queue.md)-Block hinzufügen, um die Aufgabe nach der Fortsetzung wieder in die Warteschlange zu stellen. Andernfalls verbleibt die Aufgabe im Status außerhalb der Warteschlange. 

## So unterbrechen Agenten Aufgaben und setzen sie fort
<a name="pause-tasks-agent-experience"></a>

Kundendienstmitarbeiter können eine Aufgabe von ihrem Contact Control Panel (CCP) oder ihrem Workspace aus unterbrechen, indem sie die Schaltfläche **Unterbrechen** verwenden. Um die Aufgabe zu aktualisieren, muss der Kundendienstmitarbeiter **Fortfahren** wählen. Die einzigen Aktionen, die der Kundendienstmitarbeiter für eine Aufgabe ausführen kann, die sich im Status „Unterbrochen“ befindet, sind das Beenden oder Übertragen der Aufgabe.

Die folgende Abbildung zeigt die Schaltfläche **Unterbrechen** auf dem CCP. 

![\[Die Schaltfläche „Unterbrechen“ auf dem CCP.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-pause-button-ccp.png)


Die folgende Abbildung zeigt die Schaltfläche **Unterbrechen** im Arbeitsbereich für Kundendienstmitarbeiter. 

![\[Die Schaltfläche „Unterbrechen“ im Arbeitsbereich für Kundendienstmitarbeiter.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-pause-button-agentworkspace.png)


Nachdem ein Kundendienstmitarbeiter eine Aufgabe unterbrochen oder fortgesetzt hat, wird ein Banner angezeigt, das ihn über den aktuellen Status der Aufgabe informiert. Das folgende Bild des CCP zeigt das „Unterbrechung“-Banner.

![\[Die Banner „Unterbrechen“ und „Fortfahren“ auf dem CCP.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-paused-ccp.png)


Die folgende Abbildung des Arbeitsbereichs für Kundendienstmitarbeiter zeigt das Banner „Fortsetzen“ an.

![\[Banner „Unterbrechen“ und „Fortsetzen“ im Arbeitsbereich für Kundendienstmitarbeiter\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-resumed.png)


Wenn ein Kundendienstmitarbeiter mehrere Aufgaben geöffnet hat und er eine davon unterbricht, wird das Symbol in der Aufgabenliste aktualisiert und er über den Status der Aufgabe informiert. Die folgende Abbildung zeigt ein Beispiel eines „Unterbrochen“-Symbols.

![\[Ein Statussymbol für eine Aufgabe.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-pause-agentworkspace.png)


## Wie viele Aufgaben ein Agent unterbrechen kann
<a name="pause-tasks-number"></a>

Ein Kundendienstmitarbeiter kann etwa die doppelte Anzahl von Aufgaben unterbrechen wie in der Einstellung **Maximale Anzahl an Aufgaben pro Kundendienstmitarbeiter** in seinem [Weiterleitungsprofil](routing-profiles.md) angegeben. 

Ein Kundendienstmitarbeiter verfügt beispielsweise über die Einstellung **Maximale Anzahl an Aufgaben pro Kundendienstmitarbeiter**, um 5 aktive Aufgaben gleichzeitig zu bearbeiten. Das bedeutet, dass er bis zu 5 Aufgaben unterbrechen kann, wodurch er seine aktiven Slots für neue, kritischere Aufgaben freigeben kann. Das bedeutet aber auch, dass Kundendienstmitarbeiter zu jedem Zeitpunkt die doppelte Anzahl an Aufgaben in ihrem Workspace haben können. In unserem Beispiel kann dieser Kundendienstmitarbeiter 10 Aufgaben in seinem Workspace haben: 5 unterbrochen und 5 aktiv. 

## Wann kann eine unterbrochene Aufgabe wieder fortgesetzt werden?
<a name="when-resume-tasks"></a>

Eine unterbrochene Aufgabe kann jederzeit wieder fortgesetzt werden. Dadurch ist es für einen Kundendienstmitarbeiter möglich, vorübergehend das Doppelte seiner Anzahl an Aufgaben gleichzeitig zu bearbeiten. 

Beispielsweise kann ein Kundendienstmitarbeiter 10 Aufgaben in seinem Workspace haben: 5 unterbrochen und 5 aktiv. Er setzt alle seine unterbrochenen Aufgaben gleichzeitig fort. Jetzt hat er 10 aktive Aufgaben. Es werden keine neuen Aufgaben an ihn weitergeleitet, bis die Anzahl der aktiven Aufgaben unter dem in seinem Weiterleitungsprofil angegebenen Grenzwert für **maximale Aufgaben pro Kundendienstmitarbeiter** liegt.

## Programmgesteuert Abbrechen und Fortsetzen von Aufgaben
<a name="programmatically-pause-and-resume-tasks"></a>

Sie können Aufgaben programmgesteuert anhalten und fortsetzen, indem Sie den [PauseContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_PauseContact.html)Befehl und verwenden. [ResumeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContact.html) APIs

Beim Unterbrechen und Fortsetzen einer Aufgabe kann ein entsprechender Datenstrom so konfiguriert werden, dass er bei den Ereignissen „Unterbrechen“ und „Fortsetzen“ ausgeführt wird. Beispiel: 
+ Möglicherweise möchten Sie einen Datenstrom so entwerfen, dass unterbrochene Aufgaben nach einem bestimmten Zeitraum für die Mittagspausen der Kundendienstmitarbeiter automatisch fortgesetzt werden. 
+ Möglicherweise möchten Sie einen Datenstrom für die Fortsetzung erstellen, um Attribute der Aufgabe zu aktualisieren, die sich möglicherweise geändert haben, während die Aufgabe unterbrochen war.

## Konfigurieren eines Datenflusses, um Aufgaben zu unterbrechen und fortzusetzen
<a name="pause-and-resume-flow"></a>

Konfigurieren Sie einen [„EreignisFlow festlegen“](set-event-flow.md)-Block, um Aufgaben zu unterbrechen und fortzusetzen In der folgenden Abbildung sehen Sie die Seite **Eigenschaften** des Blocks **Ereignisdatenstrom einrichten** mit Konfiguration zum Unterbrechen eines Datenstroms. 

![\[Die Seite „Eigenschaften“ des Blocks „EreignisFlow festlegen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-set-event-flow.png)


Im Folgenden finden Sie einige Szenarien, die Sie möglicherweise in Ihren Datenströmen konfigurieren möchten:
+ Konfigurieren Sie Datenströme, die während der Kontaktunterbrechung ausgeführt werden, so, dass Supervisoren benachrichtigt werden, wenn eine Aufgabe unterbrochen wurde. 
+ Wenn Sie einen unterbrochenen Kontakt fortsetzen, konfigurieren Sie den Datenstrom so, dass die Kontaktattribute aktualisiert werden, um sicherzustellen, dass die Kundendienstmitarbeiter immer mit der neuesten Version der Attribute arbeiten.

## Neue Ereignisse im Kontaktereignis-Stream und im Ereignisstream für Kundendienstmitarbeiter
<a name="ces-pause-and-resume-tasks"></a>

Wenn Aufgaben unterbrochen und fortgesetzt werden, werden neue Ereignisse für PAUSED und RESUMED im Kontaktereignisstream und im Ereignisstream für Kundendienstmitarbeiter generiert. 

Die folgende Abbildung zeigt ein Beispiel für ein Ereignis mit dem Status PAUSED im Kontaktereignisstream. 

![\[Ein Ereignis mit dem Status PAUSED im Kontaktereignisstream.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-pause-ces.png)


Die folgende Abbildung zeigt ein Beispiel für ein Ereignis mit dem Status RESUMED im Kontaktereignisstream. 

![\[Ein Ereignis mit dem Status RESUMED im Kontaktereignisstream.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-resumed-ces.png)


Die folgende Abbildung zeigt ein Beispiel für Aufgabens mit dem Status PAUSEDim Kundendienstmitarbeiter-Ereignisstream. 

![\[Ereignisse mit dem Status PAUSED im Kundendienstmitarbeiter-Ereignisstream.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-aes.png)


## Unterbrechen und Fortsetzen von Aufgabenereignissen in Kontaktdatensätzen
<a name="ctr-pause-and-resume-tasks"></a>

Die folgenden Ereignisse werden im [ContactTraceRecord](ctr-data-model.md#ctr-ContactTraceRecord)Abschnitt des Datenmodells für Kontaktdatensätze erfasst. Sie können die [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)API verwenden, um Aufgabenereignisse zurückzugeben. 


| Name im Kontaktdatensatz | Von der DescribeContact API zurückgegebener Name | 
| --- | --- | 
| TotalPauseDurationInSeconds |  TOTAL\$1PAUSED\$1TIME  | 
| TotalPauseCount |  TOTAL\$1NUMBER\$1OF\$1PAUSES  | 
| LastPausedTimestamp |  LAST\$1PAUSED\$1TIMESTAMP  | 
| LastResumedTimestamp |  LAST\$1RESUMED\$1TIMESTAMP  | 

Die folgenden Werte sind nahezu in Echtzeit verfügbar, wenn Sie die [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)API verwenden oder die Seite **mit den Kontaktdaten** eines laufenden Kontakts aufrufen. 
+ TotalPauseCount
+ LastPausedTimestamp
+ LastResumedTimestamp

Ein abgeschlossener Kontakt hat TotalPauseDurationInSeconds. 

## Kennzahlen
<a name="metrics-pause-and-resume-tasks"></a>

Die folgenden Metriken zeigen die Zeit für „aktiv“, „unterbrochen“ und „fortgesetzt“ an. 


| Echtzeitmetriken | Description | 
| --- | --- | 
|  **[UI]** Agent/Routing Profiles/Queue → Leistung → **Durchschnittliche aktive Zeit**  |  SUM(active\$1time)/Anzahl der Kontakte  | 
|  **[UI]** Agent/Routing Profiles/Queue → Leistung → **Durchschnittliche Pausenzeit des Agenten**  |  SUM(agent\$1pause\$1time)/Anzahl der Kontakte, die unterbrochen wurden  | 
|  **[UI]** Kundendienstmitarbeiter → Kontakte → **Kontaktstatus**  |  Status „Unterbrochen“ eines Aufgabenkontakts  | 


| Historische Metriken | Description | 
| --- | --- | 
|  **[UI]** Kundendienstmitarbeiter → Prüfung der Kundendienstmitarbeiteraktivitäten → Unterstützung des Status „PAUSED“  |  Zeigt den Status „Unterbrochen“ an, wenn sich der Kontakt für einen Kundendienstmitarbeiter im Status „Unterbrochen“ befindet  | 
|  **[[GetMetricDataV2] Den](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html)** Durchschnitt von AGENT\$1PAUSE\$1TIME für ein Profil/eine Aufgabe abfragen queue/routing   |  SUM (total\$1agent\$1pause\$1time) für alle Kontakte, die unterbrochen wurden von queue/routing profile/TaskAVG = SUM(total\$1agent\$1pause\$1time)/number of paused contacts for queue/RP/Tasks  | 
|  **[V2] Den Durchschnitt GetMetricData** [von ACTIVE\$1TIME für ein Profil abfragen](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) queue/routing   |  SUM (total\$1handle\$1time - total\$1agent\$1pause\$1time) für alle Kontakte des Profils/der Aufgaben queue/routing  AVG = SUM (total\$1handle\$1time - total\$1agent\$1pause\$1time)/Gesamtzahl der Kontakte für Profile/Aufgaben queue/routing   | 


| Seite „Kontaktdetails“ | Description | 
| --- | --- | 
|  **[UI]** Kontaktsuche → Kontaktdetails → Kontaktzusammenfassung → Uhrzeit der letzten Unterbrechung  |  Zeitpunkt der letzten Unterbrechung  | 
|  **[UI]** Kontaktsuche → Kontaktdetails → Kontaktzusammenfassung → Uhrzeit der letzten Fortsetzung  |  Zeitpunkt der letzten Fortsetzung  | 
|  **[UI]** Kontaktsuche → Kontaktdetails → Kontaktzusammenfassung → Anzahl der Unterbrechungen  |  Gesamtzahl der Pausen, einschließlich der Zeiten, in denen der Kontakt nicht verbunden war.  | 
|  **[UI]** Kontaktsuche → Kontaktdetails → Kontaktzusammenfassung → Gesamtdauer der Unterbrechungen  |  Gesamtdauer der Unterbrechungen, einschließlich vor und nach der Verbindung des Kundendienstmitarbeiters.  | 

### Seite „Echtzeit-Metriken“
<a name="rtm-tasks-ui"></a>

In der folgenden Abbildung der Seite **Echtzeit-Metriken** wird der Kontaktstatus der Aufgabe als **Unterbrochen** angezeigt.

![\[Die Seite mit Echtzeit-Metriken, Aufgabe im Status „Kontakt unterbrochen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-paused-rtm.png)


Die folgende Abbildung der Seite **Echtzeit-Metriken** zeigt die **Durchschnittliche aktive Zeit**, die **AHT** und die **Durchschnittliche Unterbrechungszeit des Kundendienstmitarbeiters**.

![\[Die Seite mit Echtzeit-Metriken, Aufgabe im Status „Kontakt unterbrochen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-rtm-2.png)


### Bericht zur Prüfung der Kundendienstmitarbeiteraktivität
<a name="agent-audit-tasks-ui"></a>

Die folgende Abbildung des **Berichts zur Überprüfung der Kundendienstmitarbeiteraktivität** zeigt den Status „Unterbrochen“, wenn ein Kontakt von dem Kundendienstmitarbeiter unterbrochen wird.

![\[Der Bericht zur Prüfung der Kundendienstmitarbeiteraktivität, , Status „Unterbrochen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-agent-activity-report.png)


# Erstellen von Aufgabenvorlagen in Amazon Connect
<a name="task-templates"></a>

Aufgabenvorlagen machen es Ihren Kundendienstmitarbeitern leicht, die richtigen Informationen für die Erstellung und Abwicklung einer [Aufgabe](tasks.md) zu erfassen. Alle für die Erstellung einer Aufgabe benötigten Felder werden ihnen bereitgestellt.

## Was Sie wissen sollten, bevor Sie Ihre erste Vorlage erstellen
<a name="important-info-task-templates"></a>
+ Wenn Sie Ihre erste Vorlage veröffentlichen, werden Ihre Kundendienstmitarbeiter bei der Erstellung einer neuen Aufgabe aufgefordert, eine Vorlage auszuwählen. Die Kundendienstmitarbeiter müssen eine der Vorlagen auswählen, die Sie veröffentlicht haben.
+ Wenn Sie die Standarderfahrung für Aufgaben beibehalten und nicht verlangen möchten, dass Kundendienstmitarbeiter eine Vorlage auswählen, können Sie auf der Seite mit den **Aufgabenvorlagen** den Schalter **Deaktivieren/Aktivieren** umlegen, um alle von Ihnen veröffentlichten Vorlagen zu deaktivieren.
+ Stellen Sie sicher, dass Ihr Amazon-Connect-Konto [ Berechtigungen besitzt, Aufgabenvorlagen zu erstellen](task-template-permissions.md).
+ Sehen Sie sich die Liste der Kontingente für Aufgabenvorlagen an, z. B. die Felder **Aufgabenvorlagen pro Instance** und **benutzerdefinierte Felder der Aufgabenvorlagen pro Instance**. Siehe [Amazon Connect Servicekontingenten](amazon-connect-service-limits.md). 
+ Sie können eine Aufgabenvorlage so konfigurieren, dass sich ein Kundendienstmitarbeiter die Aufgaben selbst zuweisen kann. Der Kundendienstmitarbeiter benötigt die Sicherheitsprofilberechtigung **Contact Control Panel – Selbstzuweisung von Kontakten zulassen**. Die Berechtigung **Aufgabenerstellung einschränken** muss dabei deaktiviert sein. Der Kundendienstmitarbeiter kann dann ein Kontrollkästchen aktivieren, wenn er eine Aufgabe über das CCP erstellt und sie sich selbst zuweist. 

## So erstellen Sie eine Aufgabenvorlage
<a name="build-task-templates"></a>

### Schritt 1: Benennen der Vorlage
<a name="name-template"></a>

1. Melden Sie sich bei der Amazon-Connect-Konsole mit einem **Administrator**-Konto oder mit einem anderen Konto an, dessen Sicherheitsprofil über [Berechtigungen zum Erstellen von Aufgabenvorlagen](task-template-permissions.md) verfügt. 

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

1. Wählen Sie auf der **Aufgabenvorlagenseite** die Option **\$1 Neue Vorlage** aus. 

1. Geben Sie auf der Seite **Neue Vorlage erstellen** im Feld **Vorlagenname** den Namen ein, der Ihren Kundendienstmitarbeitern angezeigt werden soll.

1. Geben Sie im Feld **Beschreibung** den Zweck der Vorlage ein. Diese Informationen werden den Kundendienstmitarbeitern nicht angezeigt, sondern sind für Ihren eigenen Gebrauch bestimmt.

### Schritt 2: Hinzufügen von Feldern, Aufgabenzuweisungen, Zeitplanung und Ablauf
<a name="add-template-fields"></a>

1. Wählen Sie im Abschnitt **Felder** die Dropdownliste **Feld hinzufügen** aus, und anschließend den Feldtyp, den Sie Ihrer Vorlage hinzufügen möchten.  
![\[Die Seite „Neue Vorlage erstellen“, der Abschnitt „Felder“, die Dropdownliste „Feld hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-field-type.png)

1. Mithilfe der Aufwärts- und Abwärtspfeile können Sie die Reihenfolge ändern, in der die Felder in der Vorlage erscheinen.

1. Legen Sie im Abschnitt **Validierung und Berechtigungen** fest, ob das Feld von Kundendienstmitarbeitern ausgefüllt werden muss, wenn diese eine Aufgabe erstellen. Andernfalls können Sie einen Standardwert hinzufügen, mit dem das Feld vorab ausgefüllt wird, wenn ein Kundendienstmitarbeiter die Vorlage öffnet. 

   In der folgenden Abbildung sehen Sie ein Beispiel für diesen Abschnitt mit dem Feld vom Typ **E-Mail**.  
![\[Der Abschnitt „Validierung und Berechtigungen“ für ein „E-Mail“-Feld.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-field-permissions.png)
**Anmerkung**  
Auf der Seite „Aufgabenvorlagen“ können keine Attribute verwendet werden.

1. Im Abschnitt **Aufgabenzuweisung**: 

   1. **Zuweisen zu**: Wählen Sie die Option **Ja** aus, damit Kundendienstmitarbeiter eine Aufgabenzuweisung während der Aufgabenerstellung anzeigen und bearbeiten können. Andernfalls können Sie wie in der folgenden Abbildung gezeigt einen Standardwert zuweisen. Wählen Sie einen veröffentlichten Flow aus, der ausgeführt wird, nachdem der Kundendienstmitarbeiter mithilfe der Option **Erstellen** eine Aufgabe erstellt. Kundendienstmitarbeiter können den Namen des Flows nicht im CCP sehen.
**Anmerkung**  
In der Dropdownliste „**Standardwert**“ werden ausschließlich veröffentlichte Flows aufgeführt.  
![\[Der Abschnitt „Aufgabenzuweisung“, die Dropdownliste mit Standardwerten.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-task-assigment.png)

   1. **Selbstzuweisung**: Wählen Sie **Ja** aus, Kundendienstmitarbeiter sich selbst Aufgaben im CCP zuweisen können. Wählen Sie für **Standardstatus** die Option **Wahr** aus, wenn das Kontrollkästchen „Selbstzuweisung“ im CCP standardmäßig aktiviert sein soll.  
![\[Im Abschnitt mit dem Kontrollkästchen „Selbstzuweisung“ ist die Option „Standardstatus“ auf „Wahr“ eingestellt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-task-selfassigment.png)

1. Wählen Sie im Abschnitt **Zeitplan** aus, ob Kundendienstmitarbeiter in der Lage sein sollen, ein zukünftiges Startdatum und eine Uhrzeit für Aufgaben festzulegen.

1. Geben Sie im Abschnitt **Ablauf** an, wie lange die Aufgabe bestehen soll, bevor sie abläuft. Die Standardeinstellung ist 7 Tage. Sie können sie für bis zu 90 Tage (129 600 Minuten) konfigurieren  
![\[Der Abschnitt „Dauer der Aufgaben“ der Vorlagenliste.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-expiry-duration.png)

### Schritt 3: Veröffentlichen
<a name="task-template-publish"></a>

Nachdem Sie Ihre Vorlage konfiguriert haben, wählen Sie **Veröffentlichen** aus, um sie zu erstellen und für Ihre Kundendienstmitarbeiter sichtbar zu machen.

**Wichtig**  
Wenn dies Ihre erste Vorlage ist, müssen Kundendienstmitarbeiter bei der Erstellung einer Aufgabe automatisch eine Aufgabenvorlage auswählen, wenn Sie **Veröffentlichen** wählen.   
Wenn Sie die standardmäßige Aufgabenerfahrung ohne auswählbare Vorlagen beibehalten möchten, deaktivieren Sie alle Vorlagen. 

## Die Benutzererfahrung Ihrer Kundendienstmitarbeiter
<a name="agent-experience-task-template"></a>

Nachdem Sie eine Vorlage veröffentlicht haben, müssen Kundendienstmitarbeiter eine Vorlage auswählen, um eine Aufgabe zu erstellen. 

In der folgenden Beispielabbildung sehen Sie zwei veröffentlichte Vorlagen: **Vorlage für Kunden-E-Mails** und **Fakturierungsdisput**.

![\[Die „Aufgabenvorlage“-Seite, der Schalter „Deaktivieren/Aktivieren“ für einzelne Vorlagen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-published.png)


Wenn Kundendienstmitarbeiter im Contact Control Panel **Aufgabe erstellen** anklicken, müssen sie eine der folgenden Vorlagen auswählen: **Fakturierungsdisput** oder **Vorlage für Kunden-E-Mail**.

![\[Die Schaltfläche „Aufgabe erstellen“ im CCP, die beiden Vorlagen, die die Kundendienstmitarbeiter auswählen können.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-agent-experience.png)


Nehmen wir an, der Kundendienstmitarbeiter wählt die **Vorlage für Kunden-E-Mail** aus. In der folgenden Abbildung sehen Sie die Felder, die der Kundendienstmitarbeiter ausfüllen muss, um eine Aufgabe zu erstellen. Bemerkenswert hier ist, dass der Kundendienstmitarbeiter keine Option für die Zuweisung der Aufgabe an andere hat. In dieser Vorlage ist ein Standardwert für **Aufgabenzuweisung** festgelegt. Der Kundendienstmitarbeiter kann sich jedoch dafür entscheiden, die Aufgabe sich selbst zuzuweisen. 

![\[Das CCP bietet keine Möglichkeit, anderen eine Aufgabe zuzuweisen, aber der Kundendienstmitarbeiter kann sich die Aufgabe selbst zuweisen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-create-task-ccp.png)


## Die Meldung „Keine Daten“ in der Dropdownliste „Zuweisen an“
<a name="no-data-message-task-template"></a>

Nehmen wir an, dass Sie im Abschnitt **Aufgabenzuweisung** festlegen, dass Kundendienstmitarbeiter die Aufgabe einem anderen Mitarbeiter zuweisen können. Für dieses Szenario müssen Sie eine Schnellverbindung für den Zielagenten einrichten, die dann wie in der folgenden Abbildung gezeigt in der Dropdownliste erscheint. Anweisungen zum Erstellen einer Schnellverbindung für einen Kundendienstmitarbeiter finden Sie unter [Testen von Aufgaben](chat-testing.md#test-tasks).

![\[Das CCP, die Seite „Aufgabe erstellen“, das Feld „Zuweisen an“ mit der Schnellverbindung für John Doe.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-choose-agent-quick-connect.png)


Wenn keine Schnellverbindungen vorhanden sind, erscheint die Meldung **Keine Daten**, wenn Sie wie in der folgenden Abbildung gezeigt das Dropdownmenü **Zuweisen zu** auswählen.

![\[Das CCP, die Seite „Aufgabe erstellen“, „Leer zuweisen“, die Meldung „Keine Daten“ unten auf der Seite.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-templates-no-data.png)


# Erteilen von Berechtigungen zum Erstellen einer Aufgabenvorlage für Benutzer in Amazon Connect
<a name="task-template-permissions"></a>

Weisen Sie die Berechtigungen **Weiterleitung** und **Aufgabenvorlagen** zu, damit ein Benutzer Aufgabenvorlagen erstellen kann.

Informationen zum Hinzufügen weiterer Berechtigungen zu einem vorhandenen Sicherheitsprofil finden Sie unter [Aktualisieren von Sicherheitsprofilen in Amazon Connect](update-security-profiles.md).

Das **Admin**-Sicherheitsprofil verfügt standardmäßig über Berechtigungen zur Durchführung aller Aufgabenaktivitäten.

# Sperren von Kundendienstmitarbeitern für das Erstellen von Aufgaben im Amazon Connect Contact Control Panel (CCP)
<a name="task-permissions"></a>

Wenn ein Kundendienstmitarbeiter keine Aufgaben erstellen sollen, weisen Sie ihm im **Contact Control Panel (CCP)** die Berechtigung **Aufgabenerstellung einschränken** zu. Diese Berechtigung ist standardmäßig deaktiviert, sodass alle Kundendienstmitarbeiter Aufgaben erstellen können.

Informationen zum Hinzufügen weiterer Berechtigungen zu einem vorhandenen Sicherheitsprofil finden Sie unter [Aktualisieren von Sicherheitsprofilen in Amazon Connect](update-security-profiles.md).

Das **Admin**-Sicherheitsprofil verfügt standardmäßig über Berechtigungen zur Durchführung aller Aufgabenaktivitäten.

# Einrichten der Integration von Anwendungen, um Aufgaben in Amazon Connect zu erstellen
<a name="integrate-external-apps-tasks"></a>

Richten Sie die Integration von Anwendungen ein, um Aufgaben ohne Programmieren in Amazon Connect zu erstellen.

**Tipp**  
Wenn Ihre Organisation benutzerdefinierte [IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) verwendet, um den Zugriff auf die Amazon-Connect-Konsole zu verwalten, stellen Sie sicher, dass Benutzer über die entsprechenden Berechtigungen verfügen, um Anwendungen für die Aufgabenerstellung einzurichten. Eine Liste der erforderlichen Berechtigungen finden Sie unter [Seite "Tasks" (Aufgaben)](security-iam-amazon-connect-permissions.md#tasks-page).   
Wenn Ihre Instance vor Oktober 2018 erstellt wurde, finden Sie Informationen zur Konfiguration Ihrer serviceverknüpften Rollen (SLR) unter [Für Instances, die vor Oktober 2018 erstellt wurden](connect-slr.md#migrate-slr).

**Topics**
+ [Richten Sie die Anwendungsintegration für Salesforce mithilfe von Amazon ein AppFlow](integrate-salesforce-tasks.md)
+ [Richten Sie die Anwendungsintegration für Zendesk mithilfe von Amazon ein EventBridge](integrate-zendesk-tasks.md)
+ [Überwachen der Aufgabenerstellung in Amazon Connect](monitor-task-creation.md)
+ [Trennen von Amazon Connect von einer Verbindung eines Drittanbieters](disassociate-connection.md)

# Richten Sie die Anwendungsintegration für Salesforce mithilfe von Amazon ein AppFlow
<a name="integrate-salesforce-tasks"></a>

Wenn Sie Salesforce für die Erstellung von Ereignissen integrieren, verwendet Amazon Connect auch Amazon AppFlow , um die Daten in EventBridge Dies liegt daran, wie Salesforce Ereignisse über Amazon sendet AppFlow APIs. Weitere Informationen darüber, wie Amazon Connect Salesforce-Integrationen nutzt EventBridge und AppFlow Amazon-Ressourcen zur Unterstützung von Salesforce-Integrationen nutzt, finden Sie in diesem Blogbeitrag: [Aufbau von Salesforce-Integrationen mit Amazon EventBridge und Amazon](https://aws.amazon.com/blogs/compute/building-salesforce-integrations-with-amazon-eventbridge/). AppFlow 

**Anmerkung**  
Wenn Sie benutzerdefinierte Richtlinien AWS Identity and Access Management (IAM) verwenden, finden Sie eine Liste der erforderlichen IAM-Berechtigungen für die Einrichtung von Amazon Connect Connect-Aufgaben unter. [Seite "Tasks" (Aufgaben)](security-iam-amazon-connect-permissions.md#tasks-page)

**So integrieren Sie Salesforce für die Aufgabenerstellung**

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

1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias.  
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)

1. Wählen Sie **Aufgaben** und anschließend **Anwendung hinzufügen** aus.  
![\[Die Seite „Aufgaben“, die Schaltfläche „Anwendung hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-add-an-application-button.png)

1. Wählen Sie auf der Seite **Anwendung auswählen** die Option **Salesforce** aus. 

1. Überprüfen Sie die Anwendungsanforderungen, die auf der Seite **Anwendung auswählen** aufgeführt sind. 

   In der folgenden Abbildung sehen Sie die Anforderungen für Salesforce.  
![\[Die Seite „Anwendung auswählen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-choose-an-app-salesforce.png)

   1. Um zu überprüfen, ob Salesforce mit Amazon kompatibel ist AppFlow, melden Sie sich beispielsweise bei Salesforce an https://[instance\$1name].my.salesforce.com.
**Wichtig**  
Stellen Sie sicher, dass Sie in Salesforce die Option **Erfassung von Datenänderungen** aktiviert haben. In der folgenden Abbildung sehen Sie ein Beispiel für die Salesforce-Seite **Erfassung von Datenänderungen**, auf der Sie die Entitäten „Support-Fall“ auswählen:  

![\[Die Seite „Erfassung von Datenänderungen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-verify-app-salesforce.png)


1. Nachdem Sie die Salesforce-Anforderungen überprüft haben, klicken Sie auf der Seite **Anwendung auswählen** auf **Weiter**.

1. Wählen Sie auf der Seite **Verbindung herstellen** eine der folgenden Optionen aus: 
   + **Vorhandene Verbindung verwenden**. Auf diese Weise können Sie vorhandene EventBridge Ressourcen wiederverwenden, die mit AppFlow Amazon-Flows verknüpft sind, die Sie möglicherweise in Ihrem AWS Konto erstellt haben.
   + **Neue Verbindung erstellen**: Geben Sie die von der externen Anwendung geforderten Informationen ein.

     1. Geben Sie die URL Ihrer Anwendungs-Instance ein. Diese URL wird für Deep-Links zu den Aufgaben verwendet, die in Ihrer externen Anwendung erstellt wurden.

     1. Geben Sie einen benutzerfreundlichen Namen für Ihre Verbindung ein, z. B. **Salesforce – Test-Instance**. Wenn Sie später [Regeln hinzufügen](add-rules-task-creation.md), verweisen Sie auf diesen benutzerfreundlichen Namen.

     1. Geben Sie an, ob es sich um eine Produktions- oder eine Sandbox-Umgebung handelt.  
![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection.png)

1. Klicken Sie auf **Bei Salesforce anmelden**. 

1. Wählen Sie in Salesforce die Option, den „Zugriff auf die Amazon Connect Embedded Login App [Region] zulassen“ aus.   
![\[Die Salesforce-Anmeldeseite, der Prompt „Zugriff zulassen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-allow-access-salesforce.png)

1. Nachdem Amazon Connect eine Verbindung mit Salesforce hergestellt hat, vergewissern Sie sich in Salesforce, dass die Aktualisierungstoken-Richtlinie für die Amazon-Connect-Embedded-Login-App auf **Aktualisierungstoken bis zum Widerruf gültig** gesetzt ist. Dadurch erhält Amazon AppFlow Zugriff, um Daten von Ihrem Salesforce-Konto abzurufen, ohne sich erneut authentifizieren zu müssen.

1. Wählen Sie auf der Seite **Verbindung herstellen** das in der folgenden Abbildung gezeigte Feld aus und klicken Sie dann auf **Weiter**.   
![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-successful.png)

1. Vergewissern Sie sich auf der Seite **Überprüfen und Integrieren**, dass der **Verbindungsstatus** **Verbunden** lautet, und klicken Sie dann auf **Vollständige Integration**.   
![\[Die Seite „Überprüfen und integrieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-review-and-integrate.png)

1. Die neue Verbindung wird auf der Seite **Aufgaben** aufgeführt.  
![\[Die Seite „Aufgaben“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-final.png)

Fertig\$1 Als Nächstes fügen Sie Regeln hinzu, die Amazon Connect vorgeben, wann eine Aufgabe erstellt und wie sie weitergeleitet werden soll. Detaillierte Anweisungen finden Sie unter [Erstellen von Regeln zur Aufgabengenerierung für Drittanbieterintegrationen in Amazon Connect](add-rules-task-creation.md).

## Vorgehensweise, wenn keine Verbindung hergestellt wurde
<a name="fix-connection-not-established-salesforce"></a>

Eine Verbindung für Salesforce kann möglicherweise nicht hergestellt werden, wenn Sie die Anweisungen neben den Kontrollkästchen zur Überprüfung der Kompatibilität mit Amazon nicht befolgt haben AppFlow.

Ein häufiger Fehler: Die Entität **Support-Fall** in den Einstellungen für **Erfassung von Datenänderungen** zur Erfassung dieser Ereignisse wurde nicht festgelegt. So beheben Sie den Fehler:

1. Melden Sie sich bei Salesforce an, navigieren Sie zu **Erfassung von Datenänderungen** und wählen Sie die Entität „Support-Fall“ aus.  
![\[Die Seite „Erfassung von Datenänderungen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-verify-app-salesforce.png)

1. Öffnen Sie die AppFlow Amazon-Konsole unter [https://console.aws.amazon.com/appflow)](https://console.aws.amazon.com/appflow), um den gerade erstellten Flow auszuwählen, und wählen Sie dann Flow **aktivieren**.  
![\[Der Ablauf in der AppFlow Amazon-Konsole.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-integration-activate-flow.png)

Alternativ müssen Sie möglicherweise die Amazon AppFlow Salesforce-Verbindung und den Amazon Salesforce-Flow löschen und erneut beginnen. 

# Richten Sie die Anwendungsintegration für Zendesk mithilfe von Amazon ein EventBridge
<a name="integrate-zendesk-tasks"></a>

## Schritt 1: Aktivieren Sie den Events-Connector für Amazon EventBridge
<a name="enable-zendesk-in-eventbridge"></a>

Wenn Sie den EventBridge Connector für Zendesk noch nicht aktiviert haben, müssen Sie ihn zuerst einrichten. Andernfalls gehen Sie zum [Schritt 2: Zendesk zur Aufgabenerstellung in Amazon Connect integrieren](#steps-integrate-zendesk). 

1. Kopieren Sie Ihre AWS Kontonummer: 

   1. Gehen Sie in der EventBridge Amazon-Konsole zu **Partner-Eventquellen**.

   1. Suchen Sie „Zendesk“ oder scrollen Sie zu **Zendesk** und klicken Sie auf **Einrichten**.

   1. Wählen Sie **Kopieren**, um Ihre AWS Kontoinformationen zu kopieren.

1. Gehen Sie EventBridge in [der Zendesk-Hilfe zu Einrichtung des Events-Connectors für Amazon](https://support.zendesk.com/hc/en-us/articles/360043496933-Setting-up-the-events-connector-for-Amazon-EventBridge) und folgen Sie den Anweisungen.

## Schritt 2: Zendesk zur Aufgabenerstellung in Amazon Connect integrieren
<a name="steps-integrate-zendesk"></a>

**Anmerkung**  
Wenn Sie benutzerdefinierte Richtlinien AWS Identity and Access Management (IAM) verwenden, finden Sie eine Liste der erforderlichen IAM-Berechtigungen für die Einrichtung von Amazon Connect Connect-Aufgaben unter. [Seite "Tasks" (Aufgaben)](security-iam-amazon-connect-permissions.md#tasks-page)

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

1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias.  
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)

1. Wählen Sie **Aufgaben** und anschließend **Anwendung hinzufügen** aus.  
![\[Die Seite „Aufgaben“, die Schaltfläche „Anwendung hinzufügen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-add-an-application-button.png)

1. Wählen Sie auf der Seite **Anwendung auswählen** die Option **Zendesk** aus. 

1. Nachdem Sie sich für die Integration mit Zendesk entschieden haben, werden die Anwendungsanforderungen auf der Seite aufgeführt.

   In der folgenden Abbildung sehen Sie die Anforderungen für Zendesk. In diesem Vorgang führen wir Sie durch die Schritte zur Auswahl des Ereignistyps „Support-Ticket“ in Zendesk. Bestätigen Sie die Schritte und klicken Sie auf **Weiter**.  
![\[Die Seite „Anwendung auswählen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-choose-an-app-zendesk.png)

1. Wählen Sie auf der Seite **Verbindung herstellen** eine der folgenden Optionen aus: 
   + **Vorhandene Verbindung verwenden**. Auf diese Weise können Sie vorhandene EventBridge Ressourcen, die Sie möglicherweise in Ihrem AWS Konto erstellt haben, wiederverwenden.
   + **Neue Verbindung erstellen**: Geben Sie die von der externen Anwendung geforderten Informationen ein.

     1. Geben Sie die URL Ihrer Anwendungs-Instance ein. Diese URL wird für Deep-Links zu den Aufgaben verwendet, die in Ihrer externen Anwendung erstellt wurden.

     1. Geben Sie einen benutzerfreundlichen Namen für Ihre Verbindung ein, z. B. **Zendesk – Test-Instance**. Wenn Sie später [Regeln hinzufügen](add-rules-task-creation.md), verweisen Sie auf diesen benutzerfreundlichen Namen.  
![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-zendesk.png)

1. Wählen Sie **Kopieren**, um Ihre AWS Konto-ID zu kopieren, und wählen Sie dann Bei **Zendesk anmelden**. Damit verlassen Sie zunächst die Seite **Verbindung herstellen**, kehren aber in Kürze wieder zu ihr zurück.

1. Nachdem Sie sich bei Zendesk angemeldet haben, wählen Sie **Connect** aus, um den Events Connector für Amazon EventBridge zu verbinden.   
![\[Die Integrationsseite in Zendesk.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-connect-zendesk-eventbridge.png)

1. Fügen Sie auf der Seite **Amazon Web Services** in Zendesk Ihre Konto-ID für Amazon Web Service ein, wählen Sie Ihre Region aus, klicken Sie auf **Support-Ticket**, bestätigen Sie die Nutzungsbedingungen und klicken Sie dann auf **Verbinden**. Zendesk erstellt eine Ressource in Amazon EventBridge.  
![\[Die Seite „Amazon Web Services“ in Zendesk.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-connect-zendesk-support-ticket.png)

1. Kehren Sie jetzt zu der Seite **Verbindung herstellen** in Amazon Connect zurück, und klicken Sie auf **Weiter**.

1. Auf der Seite **Verbindung herstellen** sehen Sie eine Meldung, dass Amazon Connect eine Verbindung mit Zendesk hergestellt hat. Wählen Sie **Weiter** aus.   
![\[Die Seite „Verbindung herstellen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-final-zendesk.png)

1. Vergewissern Sie sich auf der Seite **Überprüfen und Integrieren**, dass der **Verbindungsstatus** **Verbunden** lautet, und klicken Sie dann auf **Vollständige Integration**. 

   Dadurch wird eine Verbindung hergestellt, die die EventBridge Ressource für Zendesk mit Amazon Connect verknüpft.  
![\[Die Seite „Überprüfen und integrieren“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-review-and-integrate-zendesk.png)

1. Auf der Seite **Aufgaben** wird die neue Zendesk-Verbindung wie in der folgenden Abbildung dargestellt aufgeführt.  
![\[Die Aufgabenseite mit der neuen Zendesk-Verbindung.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-establish-connection-final2-zendesk.png)

Fertig\$1 Als Nächstes fügen Sie Regeln hinzu, die Amazon Connect vorgeben, wann eine Aufgabe erstellt und wie sie weitergeleitet werden soll. Detaillierte Anweisungen finden Sie unter [Erstellen von Regeln zur Aufgabengenerierung für Drittanbieterintegrationen in Amazon Connect](add-rules-task-creation.md).

## Vorgehensweise, wenn keine Verbindung hergestellt wurde
<a name="fix-connection-not-established-zendesk"></a>

Eine Verbindung kann möglicherweise keine Aufgabe erstellen, wenn Sie beim Einrichten der Verbindung in Zendesk den Ereignistyp **Support-Ticket** nicht auswählen, nachdem Sie im Flow dazu aufgefordert wurden. Um dieses Problem zu beheben, melden Sie sich bei Zendesk an und aktualisieren Sie diese Einstellung wie in der folgenden Abbildung gezeigt. 

![\[Die Seite „Amazon Web Services“, die Option „Support-Ticket“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/zendesk-support-ticket.png)


Es gibt auch einen anderen Fall, in dem Sie bei der Einrichtung möglicherweise nicht die richtige AWS Region ausgewählt haben, in der sich die Amazon Connect Connect-Instance befindet EventBridge. So beheben Sie den Fehler:

1. Gehen Sie zur EventBridge Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Trennen Sie Ihre EventBridge Verbindung.

1. Starten Sie den Flow in der Amazon-Connect-Konsole neu.

# Überwachen der Aufgabenerstellung in Amazon Connect
<a name="monitor-task-creation"></a>

Wenn Ihre Verbindung hergestellt wurde und dann nicht mehr funktioniert, trennen Sie die Verbindung in Amazon Connect und stellen Sie sie dann erneut her. Wenn das nicht hilft, gehen Sie wie folgt vor:

**Zendesk**

1. Gehe zur EventBridge Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Prüfen Sie den Status der Verbindung zur Ereignisquelle, um festzustellen, ob sie aktiv ist.

**Salesforce**

1. Gehen Sie zur AppFlow Amazon-Konsole unter [https://console.aws.amazon.com/appflow](https://console.aws.amazon.com/appflow)). 

1. Überwachen Sie den Flow, der für das eingerichtete Konto erstellt wurde.

Die folgende Abbildung zeigt, wie ein Flow in der AppFlow Amazon-Konsole für Salesforce aussieht. Darin sehen Sie Informationen über den Status der Verbindung und wann sie zuletzt ausgeführt wurde.

![\[Die AppFlow Amazon-Konsole für Salesforce.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/salesforce-appflow-flow.png)


Sowohl für Zendesk als auch für Salesforce können Sie die EventBridge Konsole unter aufrufen, [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)um Ihren Verbindungsstatus zu überprüfen und zu überprüfen, ob er aktiv, ausstehend oder gelöscht ist. 

Die folgende Abbildung zeigt eine EventBridge Beispielkonsole.

![\[Eine EventBridge Beispielkonsole.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/eventbridge-zendesk-salesforce-connection-health.png)


# Trennen von Amazon Connect von einer Verbindung eines Drittanbieters
<a name="disassociate-connection"></a>

Sie können die Verbindung jederzeit trennen und die automatische Generierung von Aufgaben auf der Grundlage von Ereignissen aus der externen Anwendung beenden. 

**So beenden Sie die automatische Generierung von Aufgaben**

1. Wählen Sie die Anwendung aus und klicken Sie dann auf **Verbindung entfernen**.   
![\[Die Seite „Verbindung zu Salesforce trennen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-disconnect-connection.png)

1. Geben Sie **Entfernen** ein, und klicken Sie dann auf **Entfernen**. 

   Wenn Sie debuggen müssen, können Sie immer noch zu Amazon AppFlow (Salesforce) oder EventBridge wechseln.  
![\[Die Option „Verbindung zu Salesforce trennen“ in Amazon AppFlow.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-disconnect-2.png)

**So entfernen Sie die Verbindung vollständig aus Zendesk**

1. Melden Sie sich bei Zendesk an und navigieren Sie zu **https://[subdomain].zendesk.com/admin/Plattformen/Integrationen**. 

1. Trennen Sie die Verbindung. EventBridge 

**So entfernen Sie die Verbindung vollständig aus Salesforce**
+ Öffnen Sie die AppFlow Amazon-Konsole unter [https://console.aws.amazon.com/appflow](https://console.aws.amazon.com/appflow) und löschen Sie die Salesforce-Verbindung und den Salesforce-Flow, die in Amazon Connect erstellt wurden. 

  Flows werden mit dem Namensmuster amazon-connect-salesforce-to -eventbridge- [subdomain] erstellt.

  Verbindungen werden mit dem Namensmuster amazon-connect-salesforce - [Subdomain] erstellt

Wiederholen Sie die Einrichtungsschritte, wenn Sie die automatische Generierung von Aufgaben wieder aktivieren möchten. 

# Erstellen von Regeln zur Automatisierung von Aufgaben in Amazon Connect
<a name="connect-rules"></a>

Eine Regel ist eine Aktion, die Amazon Connect automatisch auf der Grundlage der von Ihnen angegebenen Bedingungen ausführt. Contact Center Manager, Supervisoren und QA-Analysten können mithilfe der Amazon-Connect-Konsole im Handumdrehen Regeln erstellen. Programmierkenntnisse sind nicht erforderlich.

## Weitere Informationen
<a name="rules-more-information"></a>
+ Informationen zum programmgesteuerten Erstellen und Verwalten von Regeln finden Sie unter [Regelaktionen](https://docs.aws.amazon.com/connect/latest/APIReference/rules-api.html), und die [Sprache der Amazon-Connect-Regelfunktion](https://docs.aws.amazon.com/connect/latest/APIReference/connect-rules-language.html) finden Sie im *Amazon-Connect-API-Referenzhandbuch*. 
+ [Hinzufügen von Benachrichtigungen in Echtzeit in Contact Lens für Supervisoren auf Grundlage von Schlüsselwörtern und Wortgruppen in einem Anruf](add-rules-for-alerts.md)
+ [Automatisches Kategorisieren von Kontakten durch das Abgleichen von Konversationen mit Aussagen in natürlicher Sprache oder bestimmten Wörtern und Wortgruppen](rules.md)
+ [Erstellen Sie eine Regel, die eine Aufgabe generiert](contact-lens-rules-create-task.md)
+ [Erstellen Sie eine Regel, die ein EventBridge Ereignis generiert](contact-lens-rules-eventbridge-event.md)
+ [Erstellen von Regeln für , die E-Mail-Benachrichtigungen versenden](contact-lens-rules-email.md)
+ [Benachrichtigen von Supervisoren und Kundendienstmitarbeitern über Leistungsbewertungen](create-evaluation-rules.md)
+ [Erstellen von Benachrichtigungen zu Echtzeitmetriken in Amazon Connect](rule-real-time-metrics.md)
+ [Erstellen von Regeln zur Aufgabengenerierung für Drittanbieterintegrationen in Amazon Connect](add-rules-task-creation.md)

# Erstellen von Regeln zur Aufgabengenerierung für Drittanbieterintegrationen in Amazon Connect
<a name="add-rules-task-creation"></a>

Nachdem Sie eine externe Anwendung für die automatische Generierung von Aufgaben eingerichtet haben, müssen Sie Regeln erstellen, die Amazon Connect mitteilen, wann Aufgaben erstellt und wie sie weitergeleitet werden sollen.

1. Melden Sie sich bei Amazon Connect mit einem Benutzerkonto an, dem das **CallCenterManager**Sicherheitsprofil zugewiesen wurde oder das für **Regelberechtigungen** aktiviert ist.

1. Wählen Sie im Navigationsmenü von Amazon Connect **Regeln** aus.

1. Wählen Sie auf der Seite **Regeln** in der Dropdownliste **Regel erstellen** die Option **Externe Anwendung** aus.

1. Weisen Sie der Regel auf der Seite **Auslöser und Bedingungen** einen Namen zu. Ein Regelname darf keine Leerzeichen enthalten.  
![\[Die Seite „Neue Regel“, ein Regelname darf keine Leerzeichen enthalten.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/contact-lens-add-category-rules.png)

1. Wählen Sie das Ereignis aus, das eine Aufgabe generieren soll, sowie die Instance der externen Anwendung, in der das Ereignis eintreten muss. In der folgenden Abbildung sehen Sie, dass die Erstellung eines neuen Tickets in Zendesk der Auslöser ist. Die zu erfüllende Bedingung ist, dass der Typ einer Frage entspricht. Dann wird eine Aufgabe generiert.  
![\[Die Dropdownmenüs „Wann“ und „Typ“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/tasks-add-rule-for-zendesk.png)

   1. Wählen Sie die Instance für die externe Anwendung aus.

   1. Wählen Sie die zu erfüllende Bedingungen aus, die die Aufgabe generiert.

1. Wählen Sie **Weiter** aus.

1. Geben Sie wie in der folgenden Abbildung gezeigt auf der Seite **Aktion** die bei Regelerfüllung zu generierende Aufgabe an.  
![\[Die Seite „Aktion“, die Aufgabe, die die bei Regelerfüllung zu generierende Aufgabe.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/task-rule-action-to-take.png)

   1. Die Beschreibung der Aufgabe wird dem Kundendienstmitarbeiter im Contact Control Panel (CCP) angezeigt.

   1. Der Referenzname der Aufgabe wird dem Kundendienstmitarbeiter als Link zur vorgegebenen URL angezeigt.

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

## Testen der -Regel
<a name="test-rules-task-creation"></a>

1. Navigieren Sie zur externe Anwendung und erstellen Sie das Ereignis, das die Aktion auslöst. Erstellen Sie in Zendesk beispielsweise ein Ticket vom Typ **Frage**. 

1. Navigieren Sie zu **Analytik und Optimierung**, **Kontaktsuche**. 

1. Wählen Sie unter **Kanal** die Option **Aufgabe** aus und klicken Sie dann auf **Suchen**.

1. Prüfen Sie, ob die Aufgabe erstellt wurde.

# Einrichten von E-Mail in Amazon Connect
<a name="setup-email-channel"></a>

Im Folgenden finden Sie eine Übersicht über die Schritte zur Einrichtung des E-Mail-Kanals für Ihr Contact Center. 
+ [Aktivieren von E-Mail für Ihre Amazon-Connect-Instance](enable-email1.md). Während dieses Vorgangs erhalten Sie eine automatisch generierte E-Mail-Adresse. Sie haben auch die Möglichkeit, 5 benutzerdefinierte Adressen hinzuzufügen.
+ [Erstellen von E-Mail-Adressen](create-email-address1.md).
+ [Warteschlangen für E-Mails erstellen oder aktualisieren](create-queue.md): Gehen Sie im Abschnitt **Konfiguration ausgehender E-Mails** wie folgt vor:
  + **Standard-E-Mail-Adresse**: Geben Sie die ausgehende E-Mail-Adresse an, die für Agenten vorausgewählt ist, wenn sie auf E-Mails antworten oder diese initiieren.
    + Dies muss eine verifizierte E-Mail-Adresse innerhalb von Amazon Connect sein (eine E-Mail-Adresse, die in Amazon Connect unter einer von Amazon SES verifizierten Domain erstellt wurde).
    + Dies sollte die am häufigsten verwendete E-Mail-Adresse für diese Warteschlange sein.
    + Für von Agenten initiierte ausgehende E-Mails können Agenten E-Mails mit der Standard-E-Mail-Adresse aus der in ihrem Routing-Profil konfigurierten Standard-Ausgangswarteschlange senden. Agenten können auch aus den in der Warteschlange konfigurierten **zusätzlichen E-Mail-Adressen** auswählen, sodass Sie je nach Rolle oder Team flexibel steuern können, welche E-Mail-Adressen Agenten verwenden können.
    + Dieses Modell ähnelt ausgehenden Sprachkontakten, bei denen Sie die ID und den Ablauf für ausgehende Anrufer pro Warteschleife angeben und die Agenten die standardmäßige Ausgangswarteschlange aus ihrem Routing-Profil verwenden.
  + **Ausgehender E-Mail-Fluss: Wählen Sie einen Flow** aus, der für ausgehende E-Mails ausgeführt werden soll, die aus dieser Warteschlange gesendet werden. Sie können den [Standard für ausgehende Abläufe in Amazon Connect: „Dieser Anruf wird nicht aufgezeichnet“](default-outbound.md) oder einen anderen Flow vom Typ Outbound auswählen.
    + Der ausgehende E-Mail-Fluss, den Sie hier konfigurieren, gilt für Agentenantworten auf eingehende E-Mail-Kontakte, die in dieser Warteschlange empfangen wurden, und für von Agenten initiierte ausgehende E-Mails, wenn diese Warteschlange im Routing-Profil des Agenten als Standard-Ausgangswarteschlange ausgewählt ist.
    + Wenn Sie keinen ausgehenden E-Mail-Fluss angeben, [Standard für ausgehende Abläufe in Amazon Connect: „Dieser Anruf wird nicht aufgezeichnet“](default-outbound.md) wird dieser automatisch für alle ausgehenden E-Mails aus dieser Warteschlange verwendet.
    + Ähnlich wie bei ausgehenden Sprachkontakten bietet Ihnen die Konfiguration verschiedener ausgehender E-Mail-Flüsse pro Warteschlange die Flexibilität, je nach Warteschlange unterschiedliche Kontaktflüsse auszuführen. Auf diese Weise können Sie das Erlebnis ausgehender E-Mails an verschiedene Teams, Marken oder Geschäftsbereiche anpassen.

  Im Abschnitt **Zusätzliche E-Mail-Adressen**:
  + Nach **E-Mail-Adressen suchen**: Wählen Sie bis zu 49 zusätzliche E-Mail-Adressen aus, die Agenten bei der Beantwortung oder Initiierung von E-Mails verwenden können. Agenten können mithilfe einer Dropdownliste in ihrem Workspace aus allen konfigurierten E-Mail-Adressen (Standard- und Zusatzadressen) auswählen (siehe[Wählen Sie eine Absender-E-Mail-Adresse aus](agent-select-from-email.md)). Sie können insgesamt bis zu 50 E-Mail-Adressen pro Warteschlange konfigurieren (1 Standard plus 49 zusätzliche).

  Die Liste der verfügbaren E-Mail-Adressen berücksichtigt die [tagbasierte Zugriffskontrolle (TBAC)](https://docs.aws.amazon.com/connect/latest/adminguide/tag-based-access-control.html). Agenten sehen nur E-Mail-Adressen, zu deren Verwendung sie aufgrund der ihnen zugewiesenen Tags berechtigt sind.
+  [Erstellen oder aktualisieren Sie Weiterleitungsprofile](routing-profiles.md), um festzulegen, dass Kundendienstmitarbeiter E-Mail-Kontakte bearbeiten können.
**Wichtig**  
Im Weiterleitungsprofil:  
Die **Standard-Ausgangswarteschlange** definiert die Liste der E-Mail-Adressen, die Agenten für alle von ihnen initiierten ausgehenden E-Mails zur Verfügung stehen. Agenten können aus den in dieser Warteschlange konfigurierten E-Mail-Adressen auswählen.
**Maximale Kontakte pro Kundendienstmitarbeiter** definiert, wie viele E-Mails Kundendienstmitarbeiter empfangen können. Die doppelte Anzahl davon gibt an, wie viele ausgehende E-Mails Kundendienstmitarbeiter initiieren können. Wenn Sie beispielsweise **Maximale Kontakte pro Kundendienstmitarbeiter** auf 5 setzen, können Kundendienstmitarbeiter bis zu 5 E-Mails empfangen und bis zu 10 Kundendienstmitarbeiter-initiierte ausgehende E-Mails erstellen.
+  [Erstellen Sie Nachrichtenvorlagen](create-message-templates1.md). E-Mail-Vorlagen definieren die Struktur der E-Mail für den Kundendienstmitarbeiter, z. B. für eine Signatur oder einen Haftungsausschluss, oder können als vollständige Antwort verwendet werden.
+ Konfigurieren Sie Flows mit dem [Nachricht senden](send-message.md)-Block. Verwenden Sie diesen Block, um Ihrem Kunden eine Nachricht zu senden, die auf einer Vorlage oder einer benutzerdefinierten Nachricht basiert. Darüber hinaus können Sie Folgendes angeben: 
  + Die „An“- und „Von“-E-Mail-Adressen sowie Anzeigenamen. Sie können sie manuell oder dynamisch angeben, indem Sie [Systemattribute](connect-attrib-list.md#attribs-system-table) wie die Folgenden verwenden: 
    + **Kunden-Endpunktadresse**: Dies ist die E-Mail-Adresse des Kunden, der den Kontakt initiiert hat.
    + **E-Mail-Adresse des Systems**: Dies ist die E-Mail-Adresse, an die der Kunde die E-Mail gesendet hat.
    + **Kundenanzeigename**: Dieser stammt aus der E-Mail, die der Kunde an Sie gesendet hat.
    + **Anzeigename des Systems**: Dies ist der Anzeigename der E-Mail-Adresse, an die der Kunde seine Nachricht gesendet hat.
    + **CC E-Mail-Adressliste**: Die vollständige Liste der in Kopie gesetzten E-Mail-Adressen im E-Mail-Konto des Kunden. 
    + **Zur E-Mail-Adressliste**: Die vollständige Liste der An-E-Mail-Adressen in der E-Mail des Kunden.

    Um beispielsweise eine automatische Antwort zu senden, wenn ein Kunde Ihnen eine E-Mail gesendet hat, legen Sie **E-Mail-Adresse** dynamisch auf **Kunden-Endpunktadresse** und **Anzeigename** auf **Kundenanzeigename** fest.
  + **Nachricht**: Geben Sie eine Vorlage oder reinen Text an.
    + Sie können den **Betreff** dynamisch festlegen, indem Sie **Segmentattribut** – **Betreff der E-Mail** verwenden.
    + Sie können die **Nachricht** dynamisch festlegen, indem Sie ein **benutzerdefiniertes** Attribut auswählen. 
  + **Link zum Kontakt**: Legen Sie fest, ob Sie die eingehende Kontakt-E-Mail mit der ausgehenden Kontakt-E-Mail verknüpfen möchten. Diese Option sollten Sie für automatische Antwort-E-Mails möglicherweise nicht auswählen.
+ Verwenden Sie die Attribute im [Check contact attributes (Kontaktattribute prüfen)](check-contact-attributes.md)-Block, um den Kanal des Kontakts zu überprüfen. Wenn es sich um eine E-Mail handelt, können Sie mit den [Segmentattribute](connect-attrib-list.md#attribs-segment-attributes) Folgendes überprüfen: 
  + **Betreff der E-Mail**: Sie können den Betreff beispielsweise auf bestimmte Schlüsselwörter überprüfen.
  + **Amazon SES-Spam-Urteil** und **Amazon SES-Virus-Urteil**: Wenn die E-Mail des Kunden eingeht, überprüft Amazon SES sie auf Spam und Viren. Wenn die Bedingung beispielsweise FEHLGESCHLAGEN lautet (die E-Mail die Prüfung also nicht bestanden hat), können Sie die Kontaktverbindung trennen oder die E-Mail an eine spezielle Warteschlange senden, damit sie von vorgesetzten Personen überprüft wird. 
+ Weisen Sie Kundendienstmitarbeitern, die ausgehende E-Mails initiieren müssen, die folgenden Sicherheitsprofilberechtigungen zu:
  + **Contact Control Panel (CCP)** – **E-Mail-Konversationen initiieren**

# So funktioniert E-Mail von Amazon Connect
<a name="email-capabilities"></a>

E-Mail von Amazon Connect bietet integrierte Funktionen, mit denen Sie die Bearbeitung von Kundenservice-E-Mails ganz einfach priorisieren, zuweisen und automatisieren können, wodurch die Kundenzufriedenheit und die Produktivität der Kundendienstmitarbeiter verbessert werden. Sie können E-Mails empfangen und beantworten, die von Kunden an Ihre [konfigurierten E-Mail-Adressen](create-email-address1.md) gesendet oder mithilfe von Webformularen auf Ihrer Website oder in Ihrer mobilen App mithilfe der [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API eingereicht wurden. 

E-Mail von Amazon Connect ist in [Amazon Simple Email Service (SES)](https://docs.aws.amazon.com/ses/latest/dg/Welcome.html) integriert, um E-Mails zu senden oder zu empfangen und sie auf [Inhalte, die als Spam markiert sind oder Viren enthalten](https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-auth-and-scan) sowie auf [Erfolgsquoten der Zustellung](https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) und [Ergebnisse zur Absenderzuverlässigkeit](https://docs.aws.amazon.com/ses/latest/dg/monitor-sender-reputation.html) hin zu überprüfen. 

 In diesem Thema wird erklärt, wie E-Mail von Amazon Connect zusammen mit Amazon SES für ein reibungsloses Kundenerlebnis sorgt.

**Topics**
+ [Empfangen von E-Mails](#email-capabilities-howreceived)
+ [E-Mail-Kontakte](#email-capabilities-howtranslated)
+ [Jede E-Mail-Nachricht ist ein eindeutiger E-Mail-Kontakt](#email-capabilities-howmanaged)
+ [E-Mail-Threads](#email-capabilities-howthreadsmanaged)
+ [E-Mail senden](#email-capabilities-howemailssent)

## Empfangen von E-Mails
<a name="email-capabilities-howreceived"></a>

Amazon Connect empfängt E-Mails hauptsächlich auf drei Arten: 
+ **Methode 1**: Durch eine in Amazon Connect definierte [E-Mail-Adresse](create-email-address1.md) (z. B. support@ *customer-domain* .com) unter Verwendung einer [verifizierten E-Mail-Domain von Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc), z. B. der mit Ihrer Amazon Connect Connect-Instance bereitgestellten E-Mail-Domain (z. B. @ *instance-alias* .email.connect.aws) oder einer benutzerdefinierten verifizierten Domain, die Ihnen gehört oder die von Ihrem Unternehmen bereitgestellt wird (z. B. @ .com). *customer-domain* Unter [Schritt 3: Verwenden eigener benutzerdefinierter E-Mail-Domains](enable-email1.md#use-custom-email) in [Aktivieren von E-Mail für Ihre Instance](enable-email1.md) finden Sie weitere Informationen zum Einbinden benutzerdefinierter E-Mail-Domains. 
+ **Methode 2**: Verwenden Sie eine Routing-Regel auf Ihrem E-Mail-Server (z. B. [Microsoft 365 Connectors](https://learn.microsoft.com/en-us/exchange/mail-flow-best-practices/use-connectors-to-configure-mail-flow/set-up-connectors-to-route-mail), [Google Workspace Mail Routes](https://support.google.com/a/answer/2614757?hl=en&ref_topic=2921034&sjid=9077065025577504786-NC)), um die eingehende E-Mail mithilfe einer verifizierten, in [Amazon SES integrierten E-Mail-Domain (z. B. @ .com) an einen der SMTP-Endpunkte](https://docs.aws.amazon.com/general/latest/gr/ses.html) von Amazon SES zu senden. *customer-domain* 
+ **Methode 3**: Mithilfe der [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API zum Starten eines E-Mail-Kontakts mithilfe eines Webformulars auf Ihrer Website oder in Ihrer mobilen App. Dadurch werden eingehende E-Mail-Kontakte initiiert, ähnlich wie bei Kunden, die E-Mails an Ihre E-Mail-Adressen senden. 

Das folgende Diagramm zeigt, wie von Ihren Kunden gesendete E-Mails von Amazon Connect über die [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API für jede der oben genannten Methoden empfangen werden.

![\[Ein Diagramm, das zeigt, wie eine Nachricht als Webformular oder E-Mail an die StartEmailContact API gesendet wird.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-ses-diagram.png)


Um die Methoden 1 oder 2 zu integrieren, müssen Sie eine E-Mail-Domain bei Amazon SES verifizieren, bevor Sie die E-Mail-Domain in Amazon Connect verwenden können. Anleitungen finden Sie unter [Verifizieren einer DKIM-Domainidentität bei Ihrem DNS-Anbieter](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc). 

Um Methode 3 zu integrieren, verwenden Sie die [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API. Dies ist die primäre API aller Integrationsmethoden für eingehende E-Mail-Kontakte. Sie funktioniert ähnlich wie [StartTaskContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartTaskContact.html). Sie müssen einen der folgenden Schritte ausführen:
+ Fügen Sie mindestens eine E-Mail-Adresse aus Ihrer Amazon-Connect-Instance entweder zum An- oder CC-Attribut des eingehenden E-Mail-Kontakts hinzu.

-ODER-
+ Definieren Sie einen eingehenden Flow Ihrer Amazon-Connect-Instance, um den erstellten eingehenden E-Mail-Kontakt weiterzuleiten.

Wenn beides definiert ist, priorisiert das Standardverhalten den eingehenden Flow von Ihrer Amazon-Connect-Instance, um den erstellten eingehenden E-Mail-Kontakt zu verarbeiten. Wenn mehrere E-Mail-Adressen von Ihrer Amazon-Connect-Instance in den E-Mail-Adressattributen „An“ oder „CC“ enthalten sind, werden mehrere eingehende E-Mail-Kontakte in Ihrer Amazon-Connect-Instance erstellt.

## Wie aus E-Mail-Nachrichten E-Mail-Kontakte werden
<a name="email-capabilities-howtranslated"></a>

Für den allgemeinen E-Mail-Empfang in Amazon Connect, einschließlich webformularbasierter E-Mails, macht die [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API grundlegende E-Mail-Felder im Anforderungsobjekt verfügbar. Dieses Objekt wird verwendet, um E-Mail-Informationen aufzufüllen und einen E-Mail-Kontakt in Amazon Connect zu starten. Folgende Felder sind enthalten:
+ Von-E-Mail-Adresse
+ An-E-Mail-Adresse(n)
+  CC-E-Mail-Adresse(n)
+ Betreff
+ Einfacher oder HTML-Nachrichtentext
+ Anlage(n)

Weitere Informationen darüber, wie die E-Mail-Kontaktinformationen in den E-Mail-Kontakt übernommen werden, finden Sie im E-Mail-Kontaktdatenmodell von Amazon Connect.

Nachdem die [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API die Überprüfung der Anforderungsparameter durchgeführt und sichergestellt hat, dass mindestens eine An- oder CC-E-Mail-Adresse gültig ist und in der Amazon Connect Connect-Instance vorhanden ist, passiert Folgendes: 

1. Es wird eine Kontakt-ID generiert und als Teil des API-Antworttextes zurückgegeben.

1. Es wird ein asynchroner Workflow ausgelöst, um eine zusätzliche Verarbeitung der E-Mail-Nachricht durchzuführen. 

1. Der Flow wird gestartet. Dies ist der Flow, der der E-Mail-Adresse zugeordnet ist, die in der Amazon-Connect-Instance gefunden wurde.

In diesem Zusammenhang müssen Sie Ihren E-Mail-Nachrichten- und Anlagenspeicher für Ihre Amazon-Connect-Instance einrichten. 
+ Sowohl E-Mail-Nachrichten als auch Anlagen werden in Ihrem eigenen S3-Bucket von Amazon SES gespeichert und von dort abgerufen. 
+ Die übrigen E-Mail-Kontaktattribute wie „An“, „CC“, „Betreff“ und andere Attribute werden im E-Mail-Kontakt gespeichert. Siehe [Datenmodell für Amazon-Connect-Kontaktdatensätze](ctr-data-model.md).

Das folgende Diagramm zeigt den Flow der E-Mail-Nachricht vom Kunden über Amazon SES bis hin zu Amazon Connect. Es zeigt den Inhalt der E-Mail-Nachricht, der in Ihrem S3-Bucket gespeichert ist, und das Abrufen von Daten aus diesem Bucket, um sie dem Kundendienstmitarbeiter anzuzeigen. 

![\[Diagramm, das den Inhalt einer E-Mail-Nachricht zeigt, der in Ihrem S3-Bucket gespeichert ist\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-concepts-translated.png)


## Jede E-Mail-Nachricht ist ein eindeutiger E-Mail-Kontakt
<a name="email-capabilities-howmanaged"></a>

E-Mail von Amazon Connect unterscheidet sich von Sprach-, Chat- und Aufgabenfunktionen. 
+ Jede E-Mail-Nachricht, die in Amazon Connect eingeht oder von dort gesendet wird, ist ein eigener eindeutiger E-Mail-Kontakt.
+ Jeder E-Mail-Kontakt enthält spezifische Informationen zu dieser E-Mail-Nachricht wie Absenderadresse, Empfängeradresse (n), CC-Adresse (n), Betreff relatedContactId, Links zum Speicherort des E-Mail-Textes und der Anlage (en) sowie weitere Informationen, die für den einzelnen E-Mail-Kontakt relevant sind.

 Genau wie andere Kanäle in Amazon Connect verfügt ein E-Mail-Kontakt über ähnliche Initiierungsmethoden wie `INBOUND`, `OUTBOUND`, `TRANSFER`, `API`, `QUEUE_TRANSFER` und `END/DISCONNECT`. Er verfügt auch über ähnliche Zustände wie `CREATED`, `QUEUED`, `CONNECTING`, `CONNECTED`, `MISSED`, `TRANSFERRED`, `ERROR`, `ENDED/DISCONNECTED` und `REJECTED`. 

Informationen darüber, wie die E-Mail-Kontaktinformationen in den E-Mail-Kontakt übernommen werden, finden Sie unter [Datenmodell für Amazon-Connect-Kontaktdatensätze](ctr-data-model.md).

## E-Mail-Threads
<a name="email-capabilities-howthreadsmanaged"></a>

Durch E-Mail-Threads wird sichergestellt, dass ausgehende E-Mails und eingehende Antworten im Zusammenhang mit einer Kundenanfrage chronologisch und organisiert miteinander verknüpft werden. 

Um die gesamte E-Mail-Konversation aufrechtzuerhalten, verknüpft Amazon Connect die E-Mail-Kontakte mithilfe einiger Felder im E-Mail-Kontakt, wie z. B. dem relatedContactId und einer Liste von E-Mail-Headern, die den herkömmlichen E-Mail-Client-Standards (RFC 5256) entsprechen. 

Die meisten E-Mail-Clients wie Gmail, Apple Mail und Outlook unterstützen E-Mail-Threads. Beachten Sie jedoch, dass es einige gibt, die dies nicht tun. 

Wenn Ihr Kunde auf die neueste E-Mail-Nachricht im Thread antwortet, folgt der Thread einem einfachen Muster, wie in der folgenden Abbildung dargestellt:

![\[E-Mail-Thread mit einfachem Muster\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-threading.png)


Wenn der Kunde auf eine ältere Nachricht im E-Mail-Thread antwortet, wird ein E-Mail-Thread-Baum gebildet, und das E-Mail-Thread-Muster sieht ungefähr so aus wie in der folgenden Abbildung gezeigt:

![\[E-Mail-Thread in Form eines Baummusters\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-threading-tree.png)


In beiden Szenarien speichert Amazon Connect einen Datensatz für jede E-Mail-Nachricht, die sich auf einen Thread bezieht. Jede E-Mail-Nachricht kann über die nachfolgende E-Mail aufgerufen werden. 

## E-Mail senden
<a name="email-capabilities-howemailssent"></a>

Alle E-Mail-Nachrichten von Amazon Connect werden von Amazon SES direkt an Ihren Kunden gesendet. Unabhängig davon, ob Sie die mit Ihrer Amazon Connect Connect-Instance bereitgestellte E-Mail-Domain (z. B. @ *instance-alias* .email.connect.aws) oder eine benutzerdefinierte verifizierte Domain (z. B. @ *customer* .com) verwenden, ist Amazon SES durch die Überprüfung einer Domain-Identität autorisiert, E-Mails direkt an Ihre Kunden zu senden.

Das folgende Diagramm zeigt, dass die [StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API E-Mails an Amazon SES sendet und Amazon SES sie an Ihren Kunden sendet.

![\[Diagramm, das den E-Mail-Fluss von der StartOutboundEmailContact API über SES zum Kunden zeigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-concepts-sent.png)


Die [StartOutboundEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartOutboundEmailContact.html)API ist die primäre API aller Integrationsmethoden für ausgehende E-Mail-Kontakte, einschließlich Antworten von Mitarbeitern auf eingehende Kontakte und von Agenten initiierte ausgehende E-Mail-Kontakte.
+ Sie funktioniert ähnlich wie die [StartEmailContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartEmailContact.html)API, ist jedoch umgekehrt, da sie ausgehend ist.
+  Sie erfordert mindestens eine E-Mail-Adresse in den E-Mail-Adressattributen „An“ oder „CC“ sowie einen ausgehenden Whisper-Flow für die Bearbeitung des ausgehenden Kontakts.

# Aktivieren von E-Mail für Ihre Amazon-Connect-Instance
<a name="enable-email1"></a>

Dieses Thema richtet sich an Administratoren, die Zugriff auf die Amazon-Connect-Konsole haben. Darin wird erklärt, wie Sie mithilfe der Amazon Connect Admin-Website E-Mail für Ihre Instanz aktivieren. Eine Liste der Optionen, mit denen APIs Sie E-Mail programmgesteuert aktivieren können, finden Sie unter. [APIs um E-Mail zu aktivieren](#apis-email-setup2) 

Wenn Sie E-Mail aktivieren, erhalten Sie eine automatisch generierte E-Mail-Domain. Optional können Sie auch benutzerdefinierte Domains verwenden.
+ **E-Mail-Domain von Amazon Connect** *Die E-Mail-Domain lautet .email.connect.aws*instance-alias*.*
  +  Sie können diese Domain zum Testen verwenden.
  + Sie können diese E-Mail-Domain auch für die Integration in Amazon Connect verwenden, um damit zu beginnen, E-Mails in Amazon Connect zu empfangen. Wenn Sie beispielsweise eine E-Mail-Adresse wie *support@example.com* haben, können Sie E-Mails mit *support@example.email.connect.aws* an Amazon Connect weiterleiten.
+ **Benutzerdefinierte Domains** Sie können bis zu 5 benutzerdefinierte Domains angeben, die in [Amazon SES eingegliedert](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc) wurden.

## Schritt 1: Versetzen von Amazon SES in den Produktionsmodus
<a name="move-ses-production"></a>

Amazon Connect verwendet Amazon SES für das Senden und Empfangen von E-Mails. Wenn Sie eine neue Amazon-SES-Instance haben, müssen Sie sie aus dem Sandbox-Modus nehmen. Anweisungen finden Sie unter [Beantragen des Produktionszugriffs (Verlassen der Amazon-SES-Sandbox)](https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html) im *Entwicklerhandbuch zu Amazon SES*. 

Nachdem Sie Amazon SES in den Produktionsmodus versetzt haben und E-Mail bereits bei der Erstellung Ihrer Amazon-Connect-Instance aktiviert haben, fahren Sie mit den folgenden Themen fort:
+ [(Optional) Schritt 3: Verwenden eigener benutzerdefinierter E-Mail-Domains](#use-custom-email)
+ [Schritt 5: Konfigurieren Sie eine CORS-Richtlinie für Ihren Anhangs-Bucket](#config-email-attachments-cors1)

## Schritt 2: Erhalten einer standardmäßigen E-Mail-Domain von Amazon Connect
<a name="get-email-domain"></a>

Diese Schritte gelten nur, wenn Sie bereits eine Amazon-Connect-Instance erstellt, aber E-Mail nicht aktiviert haben. Führen Sie diese Schritte aus, um eine standardmäßige E-Mail-Domain von Amazon Connect zu erhalten.

1. Wählen Sie in der Amazon-Connect-Konsole im linken Navigationsmenü **E-Mail** und dann **Servicerolle erstellen** aus. Diese Rolle muss nur einmal für Ihr Konto erstellt werden. Sie ermöglicht Amazon SES, E-Mails an Amazon Connect weiterzuleiten.

1.  Wählen Sie **Domain hinzufügen** aus, wie in der folgenden Abbildung gezeigt.  
![\[Die Seite „E-Mail verwalten“ und die Schaltfläche „Domain hinzufügen“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-aws-console1.png)

1. Wählen im Sie Feld **E-Mail-Domain hinzufügen** die Option **Amazon-Connect-E-Mail-Domain** aus, wie in der folgenden Abbildung gezeigt. Wenn Sie diese Option wählen, wird der Name der Domain automatisch generiert: **instance-alias*.email.connect.aws*. Diese E-Mail-Adresse kann nicht geändert werden.  
![\[Das Feld „E-Mail-Domain hinzufügen“ und die Option „Amazon-Connect-E-Mail-Domain“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-add-email-domain.png)

## (Optional) Schritt 3: Verwenden eigener benutzerdefinierter E-Mail-Domains
<a name="use-custom-email"></a>

Sie können bis zu 5 benutzerdefinierte Domains importieren, die in [Amazon SES integriert](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc) wurden.

1. Wählen Sie in der Amazon-Connect-Konsole im linken Navigationsmenü **E-Mail** und dann **Domain hinzufügen** aus, wie in der folgenden Abbildung gezeigt.  
![\[E-Mail-Kanal in der Amazon-Connect-Konsole\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-aws-console.png)

1. Wählen Sie **Verwenden Sie eine benutzerdefinierte E-Mail-Domain** aus. Verwenden Sie das Dropdown-Feld, um benutzerdefinierte Domains auszuwählen, die [von Amazon SES verifiziert](https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#just-verify-domain-proc) wurden.  
![\[Option „Verwenden Sie eine benutzerdefinierte E-Mail-Domain“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-add-custom-domain.png)

## Schritt 4: Aktivieren von E-Mail und Erstellen eines Amazon-S3-Buckets zum Speichern von E-Mails und Anlagen
<a name="enable-email-buckets"></a>

Diese Schritte gelten nur, wenn Sie bereits eine Amazon-Connect-Instance erstellt, aber E-Mail nicht aktiviert haben.

Sie müssen die Einstellungen Ihrer **Datenspeicherung** aktualisieren, um den E-Mail-Kanal zu aktivieren und den Amazon-S3-Bucket angeben, in dem E-Mail-Nachrichten und Anlagen gespeichert werden sollen. E-Mail erfordert zwei Amazon-S3-Bucket-Zeiger. Sie können zu demselben Amazon-S3-Bucket oder zu zwei verschiedenen Buckets gehören.

**Wichtig**  
Wenn Sie für Ihre Instance die Option **Freigabe von Anhängen aktivieren** auswählen, müssen Sie einen Amazon-S3-Bucket erstellen und [eine CORS-Richtlinie in Ihrem Anhangs-Bucket konfigurieren](#config-email-attachments-cors1), wie in diesem Thema beschrieben. Wenn Sie dies nicht tun, **funktioniert der E-Mail-Kanal für Ihre Instance nicht**.

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

1. Wählen Sie auf der Seite „Instances“ den Instance-Alias aus. Der Instance-Alias ist auch Ihr **Instance-Name**, der in Ihrer Amazon-Connect-URL erscheint. In der folgenden Abbildung sehen Sie die Seite **Instances des virtuellen Contact Centers für Amazon Connect** mit einem Rahmen um den Instance-Alias.  
![\[Die Seite „Instances des virtuellen Contact Centers für Amazon Connect“, „Instance Alias“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/instance.png)

1. Wählen Sie im linken Navigationsmenü **Datenspeicherung**, **E-Mail-Nachrichten**, **Bearbeiten**, **Exportieren von E-Mail-Nachrichten nach S3 aktivieren** und dann **Speichern** aus. 

1. Füllen Sie die Seite **E-Mail-Nachrichten** aus, um einen S3-Bucket zu erstellen oder auszuwählen, in dem E-Mail-Nachrichten gespeichert werden. Die folgende Abbildung zeigt ein Beispiel für eine ausgefüllte Seite.   
![\[Die Menüoption „Datenspeicherung“ und die Seite „E-Mail-Nachrichten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-messages-export-to-s3.png)

1.  Wenn Sie E-Mail-Anhänge zulassen möchten, wählen Sie ebenfalls **Anhänge** aus. Das folgende Abbild zeigt diese Optionen.

Die folgende Abbildung der Seite **Datenspeicherung** zeigt den Amazon-S3-Bucket für E-Mail-Nachrichten und Anhänge. 

![\[Amazon-S3-Bucket zum Speichern von E-Mails und Anhängen\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-s3-bucket.png)


## Schritt 5: Konfigurieren Sie eine CORS-Richtlinie für Ihren Anhangs-Bucket
<a name="config-email-attachments-cors1"></a>

Um Kunden und Kundendienstmitarbeiter das Hoch- und Herunterladen von Dateien zu ermöglichen, aktualisieren Sie Ihre CORS-Richtlinie (Cross-Origin Resource Sharing) so, dass `PUT`- und `GET`-Anfragen für diesen Amazon-S3-Bucket, den Sie für Anhänge verwenden, zugelassen werden. Dies ist sicherer als die Aktivierung von public in read/write Ihrem Amazon S3 S3-Bucket, was wir nicht empfehlen.

**Um CORS im Attachments Bucket zu konfigurieren**

1. Suchen Sie den Namen des Amazon-S3-Buckets zum Speichern von Anhängen: 

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

   1. Wählen Sie in der Amazon-Connect-Konsole **Datenspeicher** und suchen Sie den Namen des Amazon-S3-Buckets. 

1. Öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Wählen Sie in der Amazon S3-Konsole Ihren Amazon S3-Bucket aus. 

1. Wählen Sie den Tab **Berechtigungen** und scrollen Sie dann nach unten zum Abschnitt **Cross-Origin Resource Sharing (CORS)**.

1. Fügen Sie Ihrem Anhangs-Bucket eine CORS-Richtlinie hinzu, die eine der folgenden Regeln enthält. Beispiele für CORS-Richtlinien finden Sie unter [Cross-Origin-Resource-Sharing: Anwendungsfälle](https://docs.aws.amazon.com/AmazonS3/latest/userguide/cors.html#example-scenarios-cors) im *Amazon S3 Entwicklerhandbuch*.
   + Option 1: Führen Sie die Endpunkte auf, von denen aus Anlagen gesendet und empfangen werden, z. B. den Namen Ihrer Unternehmenswebsite. Diese Regel ermöglicht ursprungsübergreifende PUT- und GET-Anfragen von Ihrer Website (z. B. http://www.example1.com).

     Ihre CORS-Richtlinie könnte ähnlich wie das folgende Beispiel aussehen:

     ```
     [
         {
             "AllowedHeaders": [
                 "*"
             ],
             "AllowedMethods": [
                 "PUT",
                 "GET"
             ],
             "AllowedOrigins": [
                 "*.my.connect.aws",
                 "*.awsapps.com"
             ],
             "ExposeHeaders": []
         }
     ]
     ```
   + Option 2: Fügen Sie den `*`-Platzhalter zu `AllowedOrigin` hinzu. Diese Regel erlaubt ursprungsübergreifende PUT- und GET-Anfragen aller Herkunft, sodass Sie Ihre Endpunkte nicht auflisten müssen.

     Ihre CORS-Richtlinie könnte ähnlich wie das folgende Beispiel aussehen:

     ```
     [
         {                               
             "AllowedMethods": [
                 "PUT",
                 "GET"            
             ],
             "AllowedOrigins": [   
                 "*" 
                 ],
            "AllowedHeaders": [
                 "*"
                 ]
         }    
     ]
     ```

## Nächste Schritte
<a name="next-steps-email-setup3"></a>
+ [Einrichten des Scannens von Anhängen in Amazon Connect](setup-attachment-scanning.md): Dieses Thema richtet sich an Entwickler, die mit Lambda vertraut sind. Sie können Amazon Connect so konfigurieren, dass E-Mail-Anhänge mithilfe Ihrer bevorzugten Scan-Anwendung gescannt werden.

## APIs um E-Mail zu aktivieren
<a name="apis-email-setup2"></a>

Gehen Sie wie folgt vor APIs , um E-Mail programmgesteuert zu aktivieren:
+ [CreateIntegrationAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)
+ [AssociateInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociateInstanceStorageConfig.html)
+ [DescribeInstanceStorageConfig](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeInstanceStorageConfig.html)

# Erstellen von E-Mail-Adressen
<a name="create-email-address1"></a>

In diesem Thema wird erklärt, wie Sie mithilfe der Amazon Connect Admin-Website E-Mail-Adressen erstellen. Sie können E-Mail-Adressen erstellen, auf die Kunden antworten können, sowie solche, die nur ausgehende E-Mails unterstützen (no-reply).

Eine Liste der zum programmgesteuerten Erstellen und Verwalten von E-Mail-Adressen APIs verwendeten Adressen finden Sie unter. [APIs um E-Mail-Adressen zu erstellen und zu verwalten](#apis-manage-email-addresses1) 

Sie können bis zu 100 E-Mail-Adressen erstellen. 

**So erstellen Sie E-Mail-Adressen**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*instance name*.my.connect.aws/ an. Verwenden Sie ein Administratorkonto oder ein Konto mit der Berechtigung **Kanäle und Abläufe** – **E-Mail-Adressen** – **Erstellen** im Sicherheitsprofil.

1. Wählen Sie im Navigationsmenü **Kanäle**, **E-Mail-Adressen** aus.

1. Wählen Sie eine Domain aus der Dropdown-Liste aus. Die Liste enthält die automatisch generierte Domain, die erstellt wurde, als Sie den E-Mail-Kanal für Ihre Instance aktiviert haben. Es können auch bis zu 5 benutzerdefinierte Domains angezeigt werden, wenn Sie sie hinzugefügt haben. 

1. Unter **Weitere Informationen** können Sie optional Folgendes hinzufügen: 
   + **Benutzerfreundlicher Absendername**
   + **Beschreibung**: Dies ist für Ihren Gebrauch bestimmt und nicht für die Verwendung durch Kunden.
   + **Flow**: Wählen Sie einen veröffentlichten Flow für den Versand von E-Mails aus. Lassen Sie dieses Feld für die E-Mail-Adresse leer, die nur für die ausgehende Kommunikation verwendet werden soll. Kunden werden nicht in der Lage sein, an diese E-Mail-Adresse zu antworten.
**Tipp**  
Zum Erstellen von E-Mail-Adressen vom Typ **no-reply**, d. h. Adressen, die nur für ausgehende E-Mails verwendet werden und keine Antwort unterstützen, wählen Sie keinen Flow aus, der für die E-Mail-Adresse verwendet werden soll.

1. Fügen Sie unter **Tags** optional [Tags](tagging.md) hinzu, um festzulegen, wer E-Mail-Adressen in Amazon Connect und im Arbeitsbereich für Kundendienstmitarbeiter einsehen und darauf zugreifen kann.

1. Wählen Sie **Erstellen** aus.

## APIs um E-Mail-Adressen zu erstellen und zu verwalten
<a name="apis-manage-email-addresses1"></a>

Eine Liste aller E-Mail-Adressen APIs finden Sie unter [E-Mail-Aktionen](https://docs.aws.amazon.com/connect/latest/APIReference/email-api.html) im *Amazon Connect API-Referenzhandbuch*.

Gehen Sie wie folgt vor APIs , um Adressen programmgesteuert zu erstellen:
+ [CreateEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateEmailAddress.html)
+ [DescribeEmailAddress](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeEmailAddress.html)
+ [UpdateEmailAddressMetadata](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateEmailAddressMetadata.html)

# Erstellen von Nachrichtenvorlagen
<a name="create-message-templates1"></a>

Wenn Sie häufig eine bestimmte Art von Nachricht entwerfen und versenden, z. B. eine wöchentliche E-Mail- oder Terminerinnerung, können Sie diese als Nachrichtenvorlage erstellen und speichern. Sie können die Vorlage dann jedes Mal als Ausgangspunkt verwenden, wenn Sie diese Art von Nachricht erstellen müssen, anstatt die Nachricht erneut zu entwerfen und zu schreiben.

Dieses Thema richtet sich an Administratoren und Contact-Center-Manager, die Nachrichtenvorlagen über die Amazon Connect Admin-Website erstellen möchten. 

**Tipp**  
Obwohl Nachrichtenvorlagen die Connect AI-Agenten verwenden APIs, führen Nachrichtenvorlagen nicht zu einer zusätzlichen Abrechnung. Sie zahlen nur die Kosten für die Chat- oder E-Mail-Nachricht. Weitere Informationen finden Sie unter [Amazon Connect – Preise](https://aws.amazon.com/connect/pricing/).

## Was sind Nachrichtenvorlagen?
<a name="what-message-templates"></a>

Eine *Nachrichtenvorlage* ist eine Gruppe von Inhalten und Einstellungen, die Sie in von Ihnen gesendeten Nachrichten erstellen, speichern und dann wiederverwenden können. In einigen Unternehmen werden sie als *E-Mail-Vorlagen* und *SMS-Vorlagen* bezeichnet. Beim Erstellen einer Nachrichtenvorlage geben Sie den Inhalt an, den Sie in verschiedenen Komponenten von Nachrichten wiederverwenden möchten, die auf der Vorlage basieren.

Wenn Sie eine Nachricht erstellen, können Sie eine Vorlage für die Nachricht auswählen. Wenn Sie eine Vorlage auswählen, füllt Amazon Connect die Nachricht mit den Inhalten und Einstellungen in der Vorlage.

Sie können in Amazon Connect die folgenden Arten von Nachrichtenvorlagen erstellen:
+ **E-Mail-Vorlagen** für E-Mail-Nachrichten, die Sie als Antwort auf Kunden-E-Mails an Ihren gesendeten Kontakt senden oder die Kundendienstmitarbeiter für häufig gestellte Fragen verwenden können. E-Mail-Vorlagen können die Struktur der E-Mail für den Kundendienstmitarbeiter definieren, z. B. für eine Signatur, oder sie können als eine vollständige Antwort dienen.
+ **SMS-Vorlagen** für SMS-Textnachrichten, die Sie von Kampagnen oder an eine begrenzte Zielgruppe als Direkt- oder Testnachrichten senden.
+ **WhatsApp Vorlagen** für WhatsApp Nachrichten, die Sie im Rahmen von Kampagnen oder als Direkt- oder Testnachrichten an eine begrenzte Zielgruppe senden.

Sie können Vorlagen mit den folgenden Features erstellen: 
+ Rich-Text-Formatierung (fett, kursiv, unterstrichen, durchgestrichen, hochgestellt, tiefgestellt), Rich-Text-Schriftstil (Farbe, Markierung, Größe, Überschrift, Schriftartfamilie, Blockzitat, Codeblock), Sonderzeichen, Emojis, Listen (Aufzählung, nummerierte Liste), Ausrichtung und Einrückungen, Tabellen, Hyperlinks und eingebettete Bilder
+ Attribute in der E-Mail-Vorlage zur Definition personalisierter Details wie Kundenname, Kunden-E-Mail, Kundenkontonummer, Kundentelefonnummer, Kundenadresse und Name des Kundendienstmitarbeiters
+ Dateianlagen bis zu 1 MB. Eine Liste der unterstützten Anlagentypen finden Sie unter [Amazon Connect Spezifikationen der Funktionen](feature-limits.md).

Wenn Sie eine E-Mail-Nachricht erstellen, die auf einer Vorlage basiert, füllt Amazon Connect die Nachricht mit dem Inhalt und den Einstellungen auf, die Sie in der Vorlage definiert haben. 

## So erstellen Sie Nachrichtenvorlagen
<a name="howto-message-templates"></a>

1. Melden Sie sich auf der Amazon Connect Admin-Website mit einem Administratorkonto oder einem Benutzerkonto an, dessen Sicherheitsprofil **Content Management** — **Nachrichtenvorlagen** — **Erstellen** enthält. 

1. Wählen Sie im Navigationsbereich **Nachrichtenvorlagen** aus.

1. Wenn Sie zum ersten Mal Vorlagen erstellen, werden Sie aufgefordert, eine Wissensdatenbank anzulegen, in der die Vorlagen gespeichert werden.

   Ihr Unternehmen kann über mehrere Wissensdatenbanken verfügen, von denen jedoch nur eine mit Vorlagen verknüpft werden kann. 

1. Wählen Sie **Create template (Vorlage erstellen)** aus.

1. Wählen Sie unter **Kanal** einen Kanal aus.

1. Geben Sie unter **Name** einen Namen für die Vorlage ein. Der Name muss mit einem Buchstaben oder einer Zahl beginnen. Er darf bis zu 128 Zeichen lang sein. 

1. Geben Sie unter **Beschreibung – *optional*** eine kurze Beschreibung der Vorlage ein. Die Beschreibung kann bis zu 255 Zeichen enthalten.

1. Geben Sie unter **Weiterleitungsprofile – *optional*** die Weiterleitungsprofile für Kundendienstmitarbeiter ein, damit sie diese Vorlage im Kundendienstmitarbeiter-Workspace verwenden können.

1. Je nachdem, ob Sie eine **E-Mail**, eine **SMS** oder eine **WhatsApp**Vorlage erstellen, gehen Sie wie folgt vor:

   Für E-Mail-Vorlagen:

   1. Verwenden Sie unter **Email details (E-Mail-Details)** die folgenden Optionen, um den Inhalt für Nachrichten anzugeben, die die Vorlage verwenden:
      + Geben Sie **Subject (Betreff)** den Text ein, der in der Betreffzeile der Nachricht angezeigt werden soll.
      + Geben Sie unter **Text** den Inhalt ein, der im Textteil der Nachricht angezeigt werden soll.
        + **Editor**: Verwenden Sie den Rich-Text-Editor, um den Inhalt einzugeben. Verwenden Sie die Formatsymbolleiste, um Formatierungen anzuwenden und der Nachricht Links und andere Inhalte hinzuzufügen. Um Anlagen hinzuzufügen, muss Ihr IT-Administrator die Anlagenfunktion für diese Option aktivieren.
        + **Code**: Sie können HTML-Inhalte manuell eingeben, einschließlich Formatierungen, Links und anderen Features, die Sie in die Nachricht aufnehmen möchten.

        Sie können auch mithilfe von Attributen personalisierte Inhalte in den Betreff und den Textkörper der Vorlage einfügen. Fügen Sie hierzu Nachrichtenvariablen hinzu, die auf bestimmte Attribute verweisen, die von Ihnen oder Amazon Connect erstellt wurden, z. B. ein Attribut zum Speichern des Vornamens eines Benutzers. Mithilfe von Nachrichtenvariablen können Sie für die einzelnen Empfänger einer Nachricht, die die Vorlage verwendet, unterschiedliche Inhalte anzeigen. 

        Um eine Nachrichtenvariable zu verwenden, wählen Sie den Namen eines vorhandenen Attributs aus der **Attributsuche** aus. Amazon Connect fügt dieses in Ihre Nachricht ein. Sie können es kopieren und an der gewünschten Stelle einfügen. Weitere Informationen finden Sie unter [Hinzufügen von personalisierten Inhalten zu Nachrichtenvorlagen](personalize-templates.md).  
![\[Der Attributsucher auf der Seite „Nachrichtenvorlagen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-template-attribute-finder.png)

   1. Sie können unter **Header – *optional*** zwei statische Header zur E-Mail-Nachricht hinzufügen. Um beispielsweise einer Werbe-E-Mail einen Link hinzuzufügen, mit dem Sie das Abonnement mit nur einem Klick abbestellen können, geben Sie die folgenden zwei Header ein:
      + **List-Unsubscribe**: Dieser Header ist auf den Abbestelllink Ihres Unternehmens festgelegt. Der Link muss HTTP-POST-Anforderungen unterstützen, um die Abbestellanforderung des Empfängers verarbeiten zu können.
      + **List-Unsubscribe-Post**: Ist auf `List-Unsubscribe=One-Click` festgelegt.

      Es hat sich bewährt, einen Link zum Abbestellen in Ihre E-Mail aufzunehmen. In einigen Ländern ist dies sogar gesetzlich vorgeschrieben. Wenn Ihre Vorlage einen Link mit diesem Attribut enthält, muss Ihr System in der Lage sein, Abmeldeanforderungen zu verarbeiten.

   1. Wenn Sie die Eingabe von Inhalten und Einstellungen für die Vorlage abgeschlossen haben, wählen Sie **Speichern** aus.

   1. Bevor Sie die Vorlage Benutzern zur Verfügung stellen, empfehlen wir Ihnen, eine Test-E-Mail-Nachricht zu senden, um sich zu vergewissern, dass die Vorlage wie vorgesehen funktioniert.

   1. Wenn Sie bereit sind, die Vorlage in Abläufen und Kampagnen sowie für Kundendienstmitarbeiter, die den Kundendienstmitarbeiter-Workspace verwenden, zur Verfügung zu stellen, führen Sie die Schritte aus, um sie zu [aktivieren](#create-message-templates1). 

**Für SMS-Vorlagen:**

1. Geben Sie im **Text** unter **SMS-Details** die Nachricht ein. Verwenden Sie die obigen Anleitungen, um die Nachricht zu personalisieren, indem Sie nach Bedarf Attribute hinzufügen.

1. Wenn Sie mit der Eingabe von Inhalten und Einstellungen für die Vorlage fertig sind, wählen Sie **Erstellen** aus.

1. Bevor Sie die Vorlage Benutzern zur Verfügung stellen, empfehlen wir Ihnen, eine Test-Nachricht zu senden, um sich zu vergewissern, dass die Vorlage wie vorgesehen funktioniert.

1. Wenn Sie bereit sind, die SMS-Vorlage im Block **Nachricht senden** oder die E-Mail-Vorlage für E-Mail-Kampagnen zur Verfügung zu stellen, führen Sie die Schritte aus, um sie zu [aktivieren](#create-message-templates1). 

**Für WhatsApp Vorlagen:**

1. Wählen Sie unter **WhatsApp Details** die Vorlage aus der Dropdownliste aus. Bitte beachten Sie, dass nur von Meta zugelassene Vorlagen zum Erstellen von Nachrichtenvorlagen verwendet werden können. Stellen Sie sicher, dass Ihre importierten Vorlagen in Meta Business WhatsApp Manager genehmigt wurden, bevor Sie fortfahren.

1. Definieren Sie einen Namen für die Vorlage und fügen Sie bei Bedarf Beschreibungen hinzu.

1. Sobald Sie die von Meta Approved Template ausgewählt haben, werden die Details im Format **Body** und **Template Metadata (JSON)** angezeigt.

1. **Attributzuweisung:** Um die personalisierte Nachrichtenzustellung in Amazon Connect zu ermöglichen, müssen Sie Ihre importierten Metaattribute dem benutzerdefinierten Text zuordnen. Indem Sie Ihre vorhandenen Connect-Attribute mit Klartext kombinieren, können Sie maßgeschneiderte Nachrichten für Ihre Kunden erstellen. Beispielsweise könnten Sie Hello \$1\$11\$1\$1 im **Text** sehen, und Sie können `Attributes.Customer.FirstName` aus der Connect-Attributliste auswählen, ob ein Treffer gefunden werden soll.

1. Es gibt eine Vielzahl von Schaltflächentypen, die zu einer Inhaltsvorlage hinzugefügt werden können. Wenn Ihre gewählte Vorlage Schaltflächen enthält, z. B. eine Website-URL, die Attribute enthält, können Sie entweder Connect-Attribute für die Zuordnung auswählen oder statischen Text eingeben.

1. Wenn Sie die Zuordnung der Attribute abgeschlossen haben, wählen Sie **Speichern**.

1. Bevor Sie die Vorlage Benutzern zur Verfügung stellen, empfehlen wir Ihnen, eine Test-Nachricht zu senden, um sich zu vergewissern, dass die Vorlage wie vorgesehen funktioniert.

# Aktivieren einer Nachrichtenvorlage
<a name="activate-message-templates"></a>

Damit Sie die Entwicklung und Verwendung einzelner Nachrichtenvorlagen verwalten können, unterstützt Amazon Connect die Versionsverwaltung für alle Arten von Nachrichtenvorlagen. Die Versionsverwaltung bietet Ihnen die Möglichkeit, einen Verlauf der Änderungen an einer Vorlage zu erstellen. Jede Version ist ein Snapshot einer Vorlage zu einem bestimmten Zeitpunkt. Mit der Versionierung können Sie auch den Inhalt und die Einstellungen von Nachrichten steuern, die eine Vorlage verwenden.

Sie können nur Nachrichtenvorlagen aktivieren, die **als neue Version gespeichert** wurden. Dies soll verhindern, dass versehentlich Vorlagen aktiviert werden, bei denen es sich um Entwürfe handelt.

Wenn eine Vorlagenversion **aktiviert** wird, kann sie dem [Flow-Block in Amazon Connect: Nachricht senden](send-message.md) hinzugefügt und den Kundendienstmitarbeitern im Kundendienstmitarbeiter-Workspace zur Verfügung gestellt werden.

**So aktivieren Sie eine Messaging-Vorlage**

Melden Sie sich auf der Amazon Connect Admin-Website mit einem Administratorkonto oder einem Benutzerkonto an, dessen Sicherheitsprofil **Content Management** — **Nachrichtenvorlagen** — **Erstellen** enthält. 

1. Wählen Sie im linken Navigationsmenü die Option **Nachrichtenvorlagen** aus.

1. Speichern Sie die Vorlage auf der Seite **Nachrichtenvorlagen** mit der Option **Als neue Version speichern**.

1. Öffnen Sie auf der Seite **Nachrichtenvorlagen** erneut die Vorlage, die Sie soeben gespeichert haben.

1. Wählen Sie im Dropdown-Menü die Version der zu aktivierenden Vorlage aus.  
![\[Die Versionsnummer einer Vorlage.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-template-version.png)

1. Wählen Sie **Aktivieren**.  
![\[Die Schaltfläche „Aktivieren“ auf der Seite „Nachrichtenvorlage“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-template-version-activate.png)

# Informationen zur Versionsverwaltung von Nachrichtenvorlagen
<a name="about-version-message-templates"></a>

Jedes Mal, wenn Sie eine Vorlage ändern, können Sie angeben, ob Sie die Änderungen als neuen Entwurf der Vorlage oder als Aktualisierung des neuesten, vorhandenen Entwurfs der Vorlage speichern möchten. Während Sie eine Vorlage entwerfen, entwickeln und verfeinern, dient jede dieser Versionen als Snapshot, mit dem Sie den Fortschritt und den Status der Vorlage nachverfolgen können. Das heißt, Sie können die Versionierung verwenden, um eine Vorlage zu speichern, nachzuverfolgen und zu verwalten, wenn sie sich im Laufe der Zeit ändert. Sie können:
+ Verfolgen des Verlaufs einer Vorlage: Für jede Vorlage wird in Amazon Connect eine Liste mit den Versionen der Vorlage angezeigt. In dieser Liste werden die Namen der jeweiligen Versionen angezeigt. Die Liste wird in absteigender chronologischer Reihenfolge sortiert, wobei die neueste Version zuerst aufgeführt ist.
+ Anzeigen und Vergleichen von Versionen einer Vorlage: Mithilfe der Versionsliste können Sie frühere Versionen einer Vorlage durchsuchen. Wenn Sie eine Version aus der Liste auswählen, werden in Amazon Connect die Inhalte und Einstellungen angezeigt, die in dieser Version gespeichert sind.
+ Wiederherstellen einer früheren Version einer Vorlage: Wenn Probleme in der neuesten Version einer Vorlage auftreten, können Sie eine frühere Version wiederherstellen, die die Probleme nicht enthält. Anschließend können Sie diese vorherige Version als neue Version der Vorlage speichern. Die neue Version wird dann die neueste Version der Vorlage.

Sie können mit der Versionierung auch steuern, welche Version einer Vorlage in Nachrichten verwendet werden kann. Dazu legen Sie eine bestimmte Version als aktive Version einer Vorlage fest. Die aktive Version ist abhängig vom Workflow Ihrer Organisation zum Entwickeln und Verwalten von Vorlagen in der Regel die Version, die zuletzt überprüft und für die Verwendung in Nachrichten genehmigt wurde.

Wenn Sie eine Version als aktive Version festlegen, aktivieren Sie diese Version für die Verwendung in Nachrichten. Wenn sich eine Vorlage im Laufe der Zeit ändert, können Sie eine andere Version als aktive Version festlegen. Es ist möglich, diese Bezeichnung mehrmals zu ändern.

# Hinzufügen von personalisierten Inhalten zu Nachrichtenvorlagen
<a name="personalize-templates"></a>

Fügen Sie der Nachrichtenvorlage *Nachrichtenvariablen* hinzu, um dynamische, personalisierte Inhalte in Nachrichten bereitzustellen, die eine Vorlage verwenden. Eine *Nachrichtenvariable* ist ein Platzhalter, der sich auf ein bestimmtes Attribut bezieht, das Sie oder Amazon Connect zum Speichern von Informationen über Ihre Benutzer erstellt haben. Jedes Attribut entspricht typischerweise einem Merkmal eines Benutzers, z. B. dem Vornamen eines Benutzers oder dem Ort, in dem er wohnt. Durch Hinzufügen von Nachrichtenvariablen zu Vorlagen können Sie diese Attribute verwenden, um jedem Empfänger einer Nachricht, für die eine Vorlage verwendet wird, benutzerdefinierte Inhalte bereitzustellen.

Wenn eine Vorlage Nachrichtenvariablen enthält, wird in Amazon Connect die jeweilige Variable durch den aktuellen, entsprechenden Wert des Attributs für den jeweiligen Empfänger ersetzt. Dies geschieht jedes Mal, wenn es eine Nachricht sendet, die die Vorlage verwendet. Dies bedeutet, dass Sie personalisierte Inhalte an jeden Empfänger senden können, ohne mehrere benutzerdefinierte Versionen einer Nachrichten- oder Nachrichtenvorlage zu erstellen. Sie können auch sicher sein, dass die Nachricht die neuesten Informationen enthält, die Sie für einen Empfänger haben.

Wenn Ihr Projekt beispielsweise eine Fitnessanwendung für Läufer ist und Attribute für den Vornamen, die bevorzugte Aktivität und den persönlichen Rekord jedes Benutzers enthält, können Sie die folgenden Text- und Nachrichtenvariablen in einer Vorlage verwenden:

`Hi {{Attributes.Customer.FirstName}}, attached is information about the insurance plans we discussed.`

Wenn Sie eine Nachricht senden, die die Vorlage verwendet, werden in Amazon Connect die Variablen durch den aktuellen Wert jedes Attributs für den jeweiligen Empfänger ersetzt. In den nachstehenden Beispielen wird dies veranschaulicht.

**Beispiel 1**  
`Hi Sofia, attached is information about the insurance plans we discussed.`

**Beispiel 2**  
`Hi Alejandro, attached is information about the insurance plans we discussed.`

## Hinzufügen von Nachrichtenvariablen
<a name="message-templates-add-variables"></a>

Sie können Nachrichtenattribute zu einer neuen Vorlage, die Sie erstellen, oder zu einer vorhandenen Vorlage hinzufügen. Wenn Sie einer vorhandenen Vorlage Variablen hinzufügen, wendet Amazon Connect die Änderungen nicht unbedingt auf die Nachrichten an, die die Vorlage verwenden und noch nicht gesendet wurden. Dies hängt von der Version der Vorlage ab, der Sie Variablen hinzufügen, und von der Konfiguration der Nachrichten, die die Vorlage verwenden. 

**So fügen Sie einer Nachrichtenvorlage eine Nachrichtenvariable hinzu:**

1. Wählen Sie im Navigationsbereich **Nachrichtenvorlagen** aus.

1. Führen Sie auf der Seite **Message templates (Nachrichtenvorlagen)** eine der folgenden Aktionen aus: 
   + Um eine neue Vorlage zu erstellen und ihr eine Nachrichtenvariable hinzuzufügen, wählen Sie **Create template (Vorlage erstellen)** aus. Geben Sie dann auf der Vorlagenseite einen Namen für die Vorlage und optional eine Beschreibung der Vorlage ein.
   + Um einer vorhandenen Vorlage eine Nachrichtenvariable hinzuzufügen, wählen Sie die Vorlage aus, der Sie eine Variable hinzufügen möchten. Wählen Sie dann auf der Vorlagenseite **Edit (Bearbeiten)** aus. Wählen Sie unter **Template details (Vorlagendetails)** die Version der Vorlage aus, die Sie als Ausgangspunkt verwenden möchten. Wenn Sie die neueste Version auswählen, können Sie die Änderungen direkt in dieser Version der Vorlage speichern. Andernfalls können Sie Ihre Änderungen als neue Version der Vorlage speichern.

1. Legen Sie im Abschnitt „Message details (Nachrichtendetails)“ fest, wo Sie eine Nachrichtenvariable hinzufügen möchten. Bei E-Mail-Vorlagen können Sie dem Betreff oder dem Text der Nachricht Variablen hinzufügen. Bei SMS-Vorlagen können Sie dem Text Variablen hinzufügen. 

1. Platzieren Sie den Cursor an der Stelle, an der sich das Attribut in der Nachricht befinden soll. Klicken oder tippen Sie auf **Attributsucher** und scrollen Sie dann zum Attributtyp, für den Sie eine Nachrichtenvariable hinzufügen möchten.   
![\[Der Attributsucher auf der Seite „Nachrichtenvorlagen“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-template-attribute-finder.png)

   Sie können unter den folgenden Attributtypen auswählen:
   + **Systemattribute**:
     + **CustomerEndpointAddress**: Die E-Mail-Adresse des Kunden, der den Kontakt initiiert hat.
     + **SystemEmailAddress**: Die E-Mail-Adresse, an die der Kunde die E-Mail gesendet hat.
     + **Name**: Der Anzeigename in der E-Mail, die der Kunde an Ihren Contact Center gesendet hat. 
   + **Kundendienstmitarbeiter-Attribute**:
     + **FirstName**
     + **LastName**
   + **Kundenprofilattribute**. Eine vollständige Liste und Beschreibungen finden Sie unter [Customer-Profiles-Attribute](connect-attrib-list.md#customer-profiles-attributes).
     + **Empfehlungsattribute**: Wenn Sie Predictive Insights mit ausgehenden Kampagnen verwenden, können Sie personalisierte Produktempfehlungen in Ihre Nachrichtenvorlagen aufnehmen. Diese Attribute sind verfügbar, wenn Sie Empfehlungen in einer ereignisgesteuerten Kampagne konfigurieren.

       Auf jede Empfehlung wird über einen Index zugegriffen, z. B. `{{Attributes.Customer.Recommendations.[0].CatalogItem.Name}}` für die erste Empfehlung, `{{Attributes.Customer.Recommendations.[1].CatalogItem.Name}}` für die zweite usw.  
![\[E-Mail-Vorlageneditor, der Empfehlungsattribute im Attributfinder und personalisierte Produktempfehlungen im Nachrichtentext anzeigt.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/RecommendationAttributesInTemplate.png)

       Weitere Informationen zur Konfiguration von Empfehlungen in Kampagnen finden Sie unter[Erstellen einer ausgehenden Kampagne mit Ereignisauslösern](how-to-create-campaigns-using-event-triggers.md).

1. Wenn Sie im Attributsucher auf ein Attribut klicken, wird es automatisch in Ihrer Nachricht platziert. Sie können das Attribut kopieren und an einer anderen Stelle einfügen.

   Nachdem Sie das Attribut eingefügt haben, wird es in Amazon Connect in je zwei geschweiften Klammern eingeschlossen angezeigt, zum Beispiel `{{Attributes.Agent.FirstName}}`. In der folgenden Abbildung ist eine E-Mail-Nachricht mit drei Attributen dargestellt: dem Vor- und Nachnamen des Kunden und dem Vornamen des Kundendienstmitarbeiters.  
![\[Eine E-Mail-Nachricht mit Nachrichtenattributen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/message-template-email-attributes.png)

1. Führen Sie nach Abschluss einen der folgenden Schritte aus:
   + Wenn Sie einer neuen Vorlage Nachrichtenvariablen hinzugefügt haben, wählen Sie **Speichern** aus.
   + Wenn Sie einer vorhandenen Vorlage Nachrichtenvariablen hinzugefügt haben und Ihre Änderungen als neue Version der Vorlage speichern möchten, wählen Sie **Save as new version (Als neue Version speichern)** aus.
   + Wenn Sie einer vorhandenen Vorlage Nachrichtenvariablen hinzugefügt haben und Ihre Änderungen als Aktualisierung des neuesten Entwurfs der Vorlage speichern möchten, wählen Sie **Speichern** aus. Wenn Sie den Entwurf aktualisieren und anhand des Entwurfs eine neue Version erstellen möchten, wählen Sie **Als neue Version speichern** aus.

# Verwenden von Helferobjekten für Nachrichtenvorlagen
<a name="message-template-helpers"></a>

Mit Amazon-Connect-Nachrichtenvorlagen können Kunden wiederverwendbare Nachrichtenvorlagen erstellen, die auf der Sprache „Handlebars.js“ basieren. Helferobjekte bietet eine Vielzahl von Features, z. B. die Formatierung eines Preises in der Währung einer bestimmten Region oder das Hinzufügen eines Standorts, der auf einer Zeitzone basiert. Ein Helferobjekt kann eine bestimmte Zeichenfolge oder Ganzzahl für den Wert oder eine bestimmte Amazon-Connect-Nachrichtenvariable verwenden.

Dies sind die Kategorien von Helferobjekten, die in den folgenden Abschnitten beschrieben werden:

## Standard-Helferobjekte
<a name="defaulthelpers"></a>

In diesem Abschnitt werden die **integrierten** Helferobjekte beschrieben, die von Handlebars bereitgestellt werden. 

**Wichtig**  
Das von Handlebars bereitgestellte integrierte Helferobjekt `with` wird nicht unterstützt. Alle anderen Handlebars-Helferobjekte werden jedoch vollständig unterstützt. Eine vollständige Liste finden Sie unter [Built-in Helpers](https://handlebarsjs.com/guide/builtin-helpers.html) auf [handlebarsjs.com](https://handlebarsjs.com). 

 Dies sind die integrierten Helferobjekte:
+ `each`: Iteriert eine Liste.
**Anmerkung**  
Die maximale Listengröße beträgt 15 Elemente.
+ `if`: Wertet eine Aussage aus.

*each*  
Iteriert eine Liste. Dieses Helferobjekt verwendet nur eine Blockanweisung. Sie können optional:   
+ `@index` in die Anforderung übergeben, um auf den aktuellen Loop-Index zu verweisen.
+ Verwenden Sie das `this`-Helferobjekt, um auf das aktuelle Element zu verweisen, das gerade iteriert wird.
+ Gibt die Antwort des Helferobjekts mithilfe des `<li>`-Tags in einer Liste zurück.
**Usage**  
`{{#each value}}`  
Der Wert an der Position `{{@index}}` ist `{{this}}`.  
`{{else}}`  
Zustand ist „false“.  
`{{/each}}`  
`each` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/each}}` in der Blockanweisung enden.  
**Beispiel**  
In diesem Beispiel wird `each` verwendet, um eine Liste der Lieblingsfarben eines Benutzers zurückzugeben. Für ein `false` wird eine `else`-Anweisung zurückgegeben. Wenn die Anfrage wie folgt lautet:  
`{{#each User.UserAttributes.FavoriteColors}}`  
`<li>{{this}}</li>`  
`{{else}}`  
*You have no favorite colors.*  
Folgendes wird zurückgegeben: `{{/each}}`  
+ *red*
+ *blue*
+ *yellow*
für eine „true“-Aussage lautet.

*if*  
Prüft, ob etwas wahr ist, und gibt auf der Grundlage der Bewertung eine Antwort zurück.   
**Usage**  
`{{#if value}}`  
Der Wert ist nicht undefiniert  
`{{else}}`  
Der Wert ist undefiniert  
`{{/if}}`  
`if` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/if}}` in der Blockanweisung enden.  
**Beispiel**  
In diesem Beispiel wird das `if`-Helferobjekt verwendet, um auszuwerten, ob es der Vorname eines Benutzers ist. Wenn der Name gefunden wird, wird eine Begrüßung zurückgegeben, die den Vornamen des Benutzers in der Antwort enthält. Andernfalls gibt die `else`-Anweisung eine alternative Begrüßung zurück.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
`Hello {{User.UserAttributes.FirstName.[0]}},`  
`{{else}}`  
*Hello,*  
`{{/if}}`  
gibt zurück*Hello, Jane*, ob der `if` Helper wahr ist.

## Bedingte Helferobjekte
<a name="conditionhelpers"></a>

In diesem Abschnitt werden die **bedingten** Helferobjekte beschrieben. 

Bedingte Helferobjekte können entweder in einer einzelnen Zeile oder in einer Blockanweisung verwendet werden. Sie können die Antwort unabhängig davon anpassen, welche Hilfsmethode Sie verwenden. Sie können zusätzliche bedingte Helferobjekte sowohl in einzeiligen als auch in Blockanweisungen übergeben. Die folgenden bedingten Helferobjekte zeigen die Verwendung zuerst für eine einzelne Zeile und dann für eine Blockanweisung mit einer optionalen `else`-Klausel. Dies sind die bedingten Helferobjekte:
+ `and`: Vergleicht, ob alle übergebenen Elemente gleich sind.
+ `eq`: Prüft, ob zwei Elemente gleich sind.
+ `gt`: Prüft, ob ein Element größer als ein anderes ist.
+ `gte`: Prüft, ob ein Element größer als oder gleich ein anderes ist.
+ `if`: Prüft, ob etwas wahr ist.
+ `lt`: Prüft, ob ein Element kleiner als ein anderes ist.
+ `lte`: Prüft, ob ein Element kleiner als oder gleich ein anderes ist.
+ `neq`: Prüft, ob zwei Elemente nicht gleich sind.
+ `not`: Kehrt die Antwort einer booleschen Operation um.
+ `or`: Vergleicht, ob eines der Elemente im Argument gleich ist.

*und*  
Vergleicht, ob *alle* in einem Argument übergebenen Elemente gleich sind, und gibt dann die Antwort auf der Grundlage des Ergebnisses zurück. Dieses Helferobjekt kann für nichtboolesche Werte verwendet werden. Sie müssen mindestens zwei Elemente für die Bedingung übergeben.  
**Usage**  
+ `{{and valuea valueb valuec valued yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten.
+ `{{#and valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/and}}`

  `and` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/and}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel wird `eq` innerhalb der `and`-Block-Anweisung verwendet, um festzustellen, ob beide für die Attribute `Location.City ` und `Location.Country` übergebenen Zeichenfolgen wahr sind. Wenn beide Bedingungen gleich sind, wird eine „true“-Anweisung zurückgegeben. Wenn eines dieser Attribute falsch ist, wird eine `else`-Aussage zurückgegeben.  
`{{#and (eq Location.City "Los Angeles") (eq Location.Country "US")}}`  
*You live in Los Angeles and the US.*  
`{{else}}`  
*You don’t live in Los Angeles and the US.*  
`{{/and}}`

*eq*  
Testet, ob zwei Elemente gleich sind oder ob der Wert eines Elements einer übergebenen Zeichenfolge entspricht.  
**Usage**  
+ `{{eq valuea valueb yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten.
+ `{{#eq valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/eq}}`

  `eq` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/eq}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel `eq` wird verwendet, um zu bewerten, ob der Wert von `User.UserAttributes.FavoriteColors.[0]` ist*Red*. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#eq User.UserAttributes.FavoriteColors.[0] "red"}}`  
*Your favorite color is red.*  
`{{else}}`  
*You don't like red.*  
`{{/eq}}`

*gt*  
Prüft, ob der Wert eines Elements größer als ein anderer ist.   
**Usage**  
+ `{{gt valuea valueb yes='y' no='n'}}`

  Je nach Bedingung können Sie *y* und *n* durch andere Werte, z. B. *yes* und*no*, oder eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten, ersetzen.
+ `{{#gt valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/gt}}`

  `gt` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/gt}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel vergleicht der Helper den Wert eines `User.UserAttributes.UserAge.[0]` Attributs mit einer Zeichenfolge*17*, um zu überprüfen, ob das Alter des Benutzers älter als 17 ist. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#gt User.UserAttributes.UserAge.[0] "17"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gt}}`

*gte*  
Prüft, ob der Wert eines Elements größer als oder gleich ein anderer ist.  
`Usage`  
+ `{{gte valuea valueb yes='y' no='n'}}`

  Sie können *y* und je nach Bedingung *n* durch andere Werte wie *yes* und *no* oder eine beliebige andere Zeichenfolge ersetzen, die Sie zurückgeben möchten.
+ `{{#gte valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/gte}}`

  `get` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/gte}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel vergleicht der Helper das `User.UserAttributes.UserAge.[0]` Attribut mit einer Zeichenfolge*18*, um zu überprüfen, ob das Alter des Benutzers mindestens 18 Jahre beträgt. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#gte User.UserAttributes.UserAge.[0] "18"}}`  
*You are old enough to rent a car.*  
`{{else}}`  
*You are not old enough to rent a car.*  
`{{/gte}}`

*if*  
Prüft, ob etwas wahr ist, und gibt auf der Grundlage der Bewertung eine Antwort zurück.  
**Usage**  
+ `{{#if value}}`

  Sie können *y* und je nach Bedingung *n* durch andere Werte wie *yes* und *no* oder eine beliebige andere Zeichenfolge ersetzen, die Sie zurückgeben möchten.
+ `{{#if value}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/if}}`

  `if` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/if}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel wird das -Helferobjekt verwendet, um auszuwerten, ob es der Vorname eines Benutzers ist. Wenn der Name gefunden wird, wird eine Begrüßung zurückgegeben, die den Vornamen des Benutzers in der Antwort enthält. Andernfalls gibt die „else“-Anweisung eine alternative Begrüßung zurück.  
`{{#if User.UserAttributes.FirstName.[0]}}`  
*Hello* `{{User.UserAttributes.FirstName.[0]}}`*,*  
`{{else}}`  
*Hello,*  
`{{/if}}`  
gibt zurück*Hello Jane,*, ob der Helper wahr ist.

*lt*  
Prüft, ob der Wert eines Elements kleiner als der Wert eines anderen ist.  
**Usage**  
+ `{{lt valuea valueb yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten.
+ `{{#lt valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/lt}}`

  `lt` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/lt}}` in der Blockanweisung enden.
**Beispiel**  
In diesem Beispiel vergleicht der Helper das `User.UserAttributes.UserAge.[0]` Attribut mit einer Zeichenfolge*18*, um zu überprüfen, ob der Benutzer jünger als 18 Jahre ist. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#lt User.UserAttributes.UserAge.[0] "18"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lt}}`

*lte*  
Prüft, ob der Wert eines Elements kleiner als oder gleich ein anderer ist.  
**Usage**  
+ `{{lte valuea valueb yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten.
+ `{{#lte valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/lte}}`

  `lte` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/lte}}` in der Blockanweisung enden.
**Beispiel**  
In dieser Blockanweisung vergleicht der Helper das `User.UserAttributes.UserAge.[0]` Attribut mit einer Zeichenfolge*17*, um zu überprüfen, ob das Alter des Benutzers 17 Jahre oder jünger ist. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#lte User.UserAttributes.Age.[0] "17"}}`  
*You are not old enough to rent a car.*  
`{{else}}`  
*You are old enough to rent a car.*  
`{{/lte}}`

*neq*  
Prüft, ob zwei Elemente *nicht* gleich sind.  
**Usage**  
+ `{{neq valuea valueb yes='y' no='n'}}`

  Sie können *y* und je nach Bedingung *n* durch andere Werte wie *yes* und *no* oder eine beliebige andere Zeichenfolge ersetzen, die Sie zurückgeben möchten.
+ `{{#neq valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/neq}}`

  `neq` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/neq}}` in der Blockanweisung enden.
**Beispiel**  
In dieser Blockanweisung wird das Attribut `User.UserAttributes.FavoriteColors.[0]` anhand der Zeichenfolge `Red` geprüft. Wenn die Antwort `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn die Antwort `false` lautet, wird eine `else`-Aussage zurückgegeben.  
`{{#neq User.UserAttributes.Favorite.Colors.[0] "red"}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/neq}}`

*not*  
Kehrt die Antwort einer booleschen Operation um, sodass eine `true`-Aussage zurückgegeben wird, wenn `not` ein positiver Vergleich ist. Wenn die Antwort „false“ lautet, wird eine „else“-Aussage zurückgegeben.   
**Usage**  
+ `{{not value yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten.
+ `{{#not value}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/not}}`

  `not` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/not}}` in der Blockanweisung enden.
**Beispiel**  
In dieser Blockanweisung wird das `User.UerAttributes.FavoriteColors.[0]` Attribut mithilfe des `eq` Helpers mit einer Zeichenfolge *red* verglichen. Das `not`-Helferobjekt gibt dann das Gegenteil des `eq`-Helferobjekt zurück. Wenn die Antwort eine andere Farbe als zurückgibt*red*, wird `true` eine A-Anweisung zurückgegeben. Wenn die Antwort zurückkehrt*red*, wird eine `else` Aussage zurückgegeben, die auf eine falsche Aussage hinweist.  
`{{#not (eq User.UserAttributes.Favorite.Colors.[0] "red")}}`  
*You do not like red.*  
`{{else}}`  
*You like red.*  
`{{/not}}`  
**Beispiel**  
In diesem Beispiel:   
`{{not (eq User.UserAttributes.FavoriteColors.[0] "red")}}`  
gibt false zurück, wenn `User.UserAttributes.FavoriteColors.[0]` ja*red*.

*oder*  
Vergleicht, ob *beliebige* in einem Argument übergebenen Elemente gleich sind, und gibt dann eine Antwort auf der Grundlage des Ergebnisses zurück. Dieses Helferobjekt kann für nichtboolesche Werte verwendet werden.  
**Usage**  
+ `{{or valuea valueb valuec valued yes='y' no='n'}}`

  Sie können *y* und *n* je nach Bedingung durch andere Werte ersetzen*no*, z. B. *yes* und, oder durch eine beliebige andere Zeichenfolge, die Sie zurückgeben möchten. Sie müssen mindestens zwei Elemente für die Bedingung übergeben.
+ `{{#or valuea valueb}}`

  Die Bedingung ist „true“.

  `{{else}}`

  Die Bedingung ist „false“.

  `{{/or}}`

  `or` muss ein Pfundzeichen (`#`) vorangestellt werden und muss mit einem schließenden `{{/or}}` in der Blockanweisung enden.
**Beispiel**  
In dieser `or`-Blockanweisung werden zwei Zeichenketten für das `Location.City`-Attribut zusätzlich mithilfe des `eq`-Helferobjekts verglichen. Wenn eines dieser Attribute `true` lautet, wird eine „true“-Aussage zurückgegeben. Wenn eine oder mehrere Antworten `false` lauten, wird eine `else`-Aussage zurückgegeben.  
`{{#or (eq Location.City "Los Angeles") (eq Location.City "Seattle")}}`  
*You live on the West Coast of the United States.*  
`{{else}}`  
*You do not live on the West Coast of the United States.*  
`{{/or}}`

## Zeichenfolgen-Helferobjekte
<a name="stringhelpers"></a>

In diesem Abschnitt werden die folgenden **Zeichenfolgen-Helferobjekte** beschrieben:
+ `abbreviate`: Kürzt einen Wert.
+ `capitalize`: Schreibt jedes Wort zwischen Leerzeichen groß.
+ `capitalizeFirst`: Schreibt das erste Zeichen eines Werts groß.
+ `center`: Zentriert einen Wert.
+ `cut`: Schneidet einen Wert aus.
+ `dateFormat`: Legt den Datumsstil fest.
+ `inflect`: Gibt eine Zeichenfolge im Singular oder Plural zurück, die auf der Anzahl basiert.
+ `join`: Verbindet ein Array, einen Iterator oder ein iterierbares Objekt.
+ `ljust`: Richtet einen Wert am linken Rand aus.
+ `lower`: Konvertiert einen Wert in Kleinbuchstaben.
+ `now`: Druckt das aktuelle Datum.
+ `ordinalize`: Ordinalisiert einen numerischen Wert.
+ `replace`: Ersetzt eine Zeichenfolge durch eine andere.
+ `rjust`: Richtet einen Wert am rechten Rand aus.
+ `slugify`: Konvertiert einen Wert in Kleinbuchstaben und entfernt Zeichen, die kein Wort sind, wandelt Leerzeichen in Bindestriche um und entfernt nachfolgende Leerzeichen.
+ `stripTags`: Entfernt [X]HTML-Tags von einem Wert.
+ `substring`: Gibt eine neue Zeichenfolge als Teilzeichenfolge eines übergebenen Werts zurück.
+ `upper`: Konvertiert den übergebenen Wert in Großbuchstaben.
+ `yesno`: Ersetzt wahr, falsch und nein durch Ja, Nein und Vielleicht.

*abbreviate*  
Kürzt einen Wert, wenn dieser die angegebene Zahl überschreitet. Leerzeichen sind in der Längenzählung enthalten. In der Antwort wird eine Ellipse angezeigt, die auf einen gekürzten Wert hinweist. Die Ellipse wird auf den gekürzten Wert in der Antwort angerechnet. Diese Art von Helferobjekt ist nützlich, wenn Sie eine große Tabelle und wenig Platz haben. Durch das Kürzen von Werten in einer Zelle können Sie der Tabelle ein einheitlicheres Aussehen verleihen.  
**Usage**  
 `{{abbreviate value X}}`, *X* ersetzt durch einen numerischen Wert, der die Anzahl der beizubehaltenden Zeichen angibt. Negative Zahlen werden nicht unterstützt.  
**Beispiel**  
In diesem Beispiel wird `abbreviate` verwendet, um `User.UserAttributes.LastName.[0]` auf sechs (6) Zeichen zu kürzen. Die Antwort enthält eine Ellipse, deren Punkte auf die Summe von sechs Zeichen angerechnet werden.  
Folgendes wird zurückgegeben: `{{abbreviate User.UserAttributes.LastName.[0] 6}}`  
*Ale...*if *Alejandro* ist der Wert von`[0]`.

*capitalize*  
Schreibt jedes Wort zwischen Leerzeichen groß.  
**Usage**  
 `{{capitalize value}}`  
**Beispiel**  
In diesem Beispiel wird jedem Wort für den `Attributes.description.[0]`-Eintrag die Großschreibung am Anfang zugewiesen.  
`{{capitalize Attributes.description.[0]}}`  
Wenn `Attributes.description.[0]` zurückgegeben wird   
 *My First Post*, wenn der Wert von `Attributes.description.[0]` ist*my first post*.

*capitalizeFirst*  
Schreibt das erste Zeichen eines Werts groß.  
**Usage**  
`{{capitalizeFirst value}}`  
**Beispiel**  
In diesem Beispiel wird das erste Zeichen des ersten Wortes des `Attributes.description.[0]`-Eintrags groß geschrieben.  
Folgendes wird zurückgegeben: `{{capitalizeFirst Attributes.description.[0]}}`  
 *My first post*, wenn der Wert von `Attributes.description.[0]` ist*my first post*.  
**Beispiel**

*center*  
Zentriert den Wert in einem Feld mit einer bestimmten Breite um die angegebene Zahl. Sie können optional ein Zeichen für die Auffüllung angeben oder das Feld leer lassen. Wenn kein Zeichen angegeben wird, wird ein Leerzeichen verwendet.  
**Usage**  
 `{{center value size=X [pad=" "}}`, *X* ersetzt durch einen numerischen Wert.  
Wenn `pad` leer gelassen wird, werden Leerzeichen als Füllung in der Antwort verwendet. Wenn Sie ein Zeichen angeben, wird dieses Zeichen in jedem Leerzeichen des Auffüllens angezeigt. Negative Zahlen werden nicht unterstützt.  
**Beispiel**  
In diesem Beispiel `Location.City ` wird der Wert von mit einer Größe von zentriert*19*.  
Folgendes wird zurückgegeben: `{{center Location.City size=19}}`   
*"    Los Angeles    "*Wenn `Location.City` es ist*Los Angeles*. Beachten Sie, dass die Anführungszeichen in der Beispielausgabe nur zur Hervorhebung dienen.

*cut*  
Entfernt den angegebenen Wert aus einer Zeichenfolge.   
**Usage**  
 `{{cut value [" "]}}`, ersetzt das Leerzeichen in den Anführungszeichen durch den auszuschneidenden Wert. Wenn kein Parameterwert übergeben wird, wird ein Leerzeichen verwendet.   
**Beispiel**  
In diesem Beispiel wird der Buchstabe *e* aus dem `Location.City` Attribut entfernt.  
Folgendes wird zurückgegeben: `{{cut Location.City "e"}}`  
*Los Angls*wenn `[Location.City` es ist*Los Angeles*.

*dateFormat*  
Legt den Standard-Datumsstil für das Datum in jeder Antwort fest. Eine Liste der Zeitzone finden Sie IDs unter[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Usage**  
`{{dateFormat date [inputFormat="format1"] [outputFormat="format2"] [tz=timeZoneId] [locale=localeID]}}`  
Der Parameter `format` muss einer der folgenden sein:  
+ "`full`„: vollständiges Datumsformat. Beispiel: *Tuesday, September 19, 2020*
+ "`long`„: langes Datumsformat. Beispiel: *September 19, 2020*
+ "`medium`„: mittleres Datumsformat. Beispiel: *Sept 19, 2020*
+ "`short`„: kurzes Datumsformat. Beispiel: *9/19/20*
+ "`pattern`„: verwendet ein benutzerdefiniertes Datumsmusterformat. Weitere Informationen zu Datumsmustern finden Sie unter [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html).
"`locale`„: verwendet ein Datumsformat, das auf einem bestimmten Gebietsschema basiert. Weitere Informationen zu Gebietsschemata finden Sie unter [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Wenn ein Format nicht übergeben wird, wird `medium` standardmäßig verwendet.   
**Beispiel**  
In diesem Beispiel `[0]` lautet der Eintrag für **09/19/2020** und eine Nachricht `User.UserAttributes.StartDate.[0]` wird an einen Benutzer gesendet, wobei das auf der *America/Los\$1Angeles* Zeitzone basierende `full` Datumsformat verwendet wird.  
Folgendes wird zurückgegeben: `We can meet with you any time on ``{{dateFormat User.UserAttributes.StartDate.[0] inputFormat="MM/dd/yyyy" outputFormat="full" tz=America/Los_Angeles}}.`  
*We can meet with you any time on Tuesday, September 19, 2020.*

*inflect*  
Gibt eine Zeichenfolge im Singular oder Plural zurück, die auf dem Zählwert basiert.  
**Usage**  
 `{{inflect count singular plural [includeCount=false]}}`  
+ Geben Sie die Singular- und Pluralform der Zeichenfolge ein, die Sie im Argument übergeben möchten.
+ Wenn `includeCount` auf `false` gesetzt ist, wird in der Antwort keine Anzahl zurückgegeben. Wenn es auf `true` gesetzt, ist der `count` in der Antwort enthalten.
**Beispiel**  
Die folgenden Beispiele zeigen die Beugung beim Kauf von Äpfeln mit und ohne `includeCount`.  
`Thank you for your purchase of {{inflect 3 apple apples includeCount=false}}.` gibt Folgendes zurück:  
*Thank you for your purchase of apples.*  
Wenn `includeCount` auf `true` gesetzt ist, dann lautet die Antwort  
*Thank you for your purchase of 3 apples.*

*join*  
Verbindet ein Array, einen Iterator oder ein iterierbares Objekt. Die Antwort gibt eine Liste zurück, wobei jeder Wert in der Liste durch das Zeichen verkettet wird, das Sie im `join` übergeben Beispielsweise können Sie Werte mit einem Komma (`,`) trennen. Der Wert in diesem Helferobjekt muss eine Liste ohne Attributpositionsindex sein. Dabei könnte es sich zum Beispiel um `Attributes.custom_attribute` handeln.  
**Usage**  
`{{join value " // " [prefix=""] [suffix=""]}}`  
**Beispiel**  
In diesem Beispiel wird eine Liste von Farben zurückgegeben, wobei die Liste durch ein Komma und ein Leerzeichen (`", "`) getrennt ist:  
Folgendes wird zurückgegeben: `{{join Attributes.favorite_colors ", "}}`   
*blue, red, green*wenn `Attributes.favorite_colors` ist die Liste*blue,red,green*.

*ljust*  
Richtet den Wert am linken Rand aus und fügt nach rechts Leerzeichen hinzu, sodass die Länge des Werts der Zahl entspricht. Negative Zahlen werden nicht unterstützt.  
Sie können optional ein Zeichen für die `pad` angeben oder das Feld leer lassen. Wenn Sie den `pad`-Wert leer lassen, ist der Standardwert ein Leerzeichen.  
**Usage**  
`{{ljust value size=X [pad=" "]}}`, wobei *X* die Gesamtlänge des Werts einschließlich Leerraum ist.   
**Beispiel**  
In diesem Beispiel *15 * wird der Wert für die linke Ausrichtung auf Location.City angewendet.  
Folgendes wird zurückgegeben: `{{ljust Location.City size=15}}`  
*"Los Angeles    "*wenn der Wert von ist. `Location.City` *Los Angeles* Beachten Sie, dass die in der Beispielausgabe angezeigten Anführungszeichen nur zur Verdeutlichung dienen.

*lower*  
Konvertiert einen Wert in Kleinbuchstaben.  
**Usage**  
`{{lower value}}`  
**Beispiel**  
In diesem Beispiel wird der Eintrag `[0]` für `User.UserAttributes.LastName.[0]` in Kleinbuchstaben geändert.  
Folgendes wird zurückgegeben: `{{lower User.UserAttributes.LastName.[0]}}`  
*santos*wenn *Santos* ist der Wert von`[0]`.

*now*  
Druckt das aktuelle Datum basierend auf der übergebenen Zeitzonen-ID aus. Eine Liste der Zeitzone finden Sie IDs unter[https://en.wikipedia.org/wiki/List_of_tz_database_time_zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).  
**Usage**  
`{{now ["format"] [tz=timeZoneId] [locale=localeID]}}`  
Der Parameter `format` muss einer der folgenden sein:  
+ "`full`„: vollständiges Datumsformat. Beispiel: *Tuesday, September 19, 2020*
+ "`long`„: langes Datumsformat. Beispiel: *September 19, 2020*
+ "`medium`„: mittleres Datumsformat. Zum Beispiel: 19. Sept. 2020
+ "`short`„: kurzes Datumsformat. Zum Beispiel 19.09.20
+ "`pattern`„: ein Datumsmuster. Weitere Informationen zu Datumsmustern finden Sie unter [https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html](https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html). 
"`locale`„: verwendet ein Datumsformat, das auf einem bestimmten Gebietsschema basiert. Weitere Informationen zu Gebietsschemata finden Sie unter [https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-](https://commons.apache.org/proper/commons-lang/apidocs/org/apache/commons/lang3/LocaleUtils.html#toLocale-java.lang.String-).  
Wenn ein Format nicht übergeben wird, wird `medium` standardmäßig verwendet.  
**Beispiel**  
In diesem Beispiel wird das aktuelle Datum in Los Angeles mit einem `medium` -Format zurückgegeben.  
Folgendes wird zurückgegeben: `{{now "medium" tz=America/Los_Angeles}}`   
*Sept 19, 2020*.

*ordinalize*  
Ordinalisiert den im Argument übergebenen numerischen Wert. *1*Ist beispielsweise als *1st* und *2* als *2nd* ordinalisiert. Es werden nur numerische Werte unterstützt.  
**Usage**  
`{{ordinalize [number]}} `  
**Beispiel**  
In diesem Beispiel wird der `[0]`-Eintrag von `User.UserAttributes.UserAge` ordinalisiert und zusammen mit einer Meldung zurückgegeben.   
`Congratulations on your {{ordinalize User.UserAttributes.UserAge.[0]}} birthday!`gibt *22* ordinalisiert als zurück. *22nd*  
*Congratulations on your 22nd birthday\$1*

*replace*  
Ersetzt eine Zeichenfolge durch eine andere. Eine Zeichenfolge oder ein numerischer Wert muss ein Literalwert sein. Platzhalterzeichen werden nicht unterstützt.  
**Usage**  
`{{replace stringToReplace replacementValue}}`  
**Beispiel**  
In diesem Beispiel ersetzt ein Unterstrich (\$1) ein Leerzeichen.  
Folgendes wird zurückgegeben: `{{replace Location.City " " "_"}}`  
*Los\$1Angeles*wenn das `Location.City ` ist*Los Angeles*.

*rjust*  
Richtet den Wert am rechten Rand aus und fügt nach links Leerzeichen hinzu, sodass die Länge des Werts der Zahl entspricht. Negative Zahlen werden nicht unterstützt.  
Sie können optional ein Zeichen für die `pad` angeben oder das Feld leer lassen. Wenn Sie den `pad`-Wert leer lassen, ist der Standardwert ein Leerzeichen.  
**Usage**  
`{{rjust value size=X [pad=" "]}}`, wobei *X* die Gesamtlänge des Werts einschließlich Leerraum ist.   
**Beispiel**  
In diesem Beispiel *15* wird dem `Location.City` Attribut der Wert für die rechte Ausrichtung zugewiesen.  
Folgendes wird zurückgegeben: `{{rjust Location.City size=15}}`  
*"    Los Angeles" *. wenn das `Location.City` ist*Los Angeles*. Beachten Sie, dass die in der Ausgabe angezeigten Anführungszeichen nur zur Verdeutlichung dienen.

*slugify*  
Konvertiert den übergebenen Wert in Kleinbuchstaben, entfernt Zeichen, die kein Wort sind (alphanumerisch und Unterstrich), wandelt Leerzeichen in Bindestriche um und entfernt vorstehende oder nachfolgende Leerzeichen.  
**Usage**  
`{{slugify value}}`  
**Beispiel**  
In diesem Beispiel wird „slugify“ für das `Location.City`-Attribut ausgeführt.   
Folgendes wird zurückgegeben: `{{slugify Location.City}}`  
*los-angeles*wenn `Location.City` ist*Los Angeles*.

*stripTags*  
Entfernt [X]HTML-Tags von einem Wert.  
**Usage**  
 `{{stripTags value}}`  
**Beispiel**  
In diesem Beispiel die HTML-Tags für den Benutzer. UserAttributes.interest. [0] wurden entfernt.   
Folgendes wird zurückgegeben: `{{stripTags User.UserAttributes.interests.[0]}}`  
*Art*, wenn es so `User.UserAttributes.interests.[0]` ist`<h1>Art</h1>`.

*substring*  
Gibt eine neue Zeichenfolge als Teilzeichenfolge des übergebenen Werts zurück. Die Länge und Position werden durch die Parameter `startOffset` und `endOffset` bestimmt, bei denen es sich um ganze Zahlen handeln muss. Negative Zahlen werden nicht unterstützt. Wenn ein `endOffset` nicht übergeben wird, verwendet die Teilzeichenfolge den ursprünglichen Endwert der Zeichenfolge.  
**Usage**  
`{{substring value startOffset [endOffset]}}`  
**Beispiel**  
In diesem Beispiel werden ein Offset von 4 und ein endOffset von 9 auf das Location.City-Attribut angewendet.   
`{{substring Location.City 4 9}} `returns  
`Angel`wenn Los Angeles der Wert von `Location.City` ist*Los Angeles*.

*upper*  
Konvertiert den übergebenen Wert in Großbuchstaben.  
**Usage**  
`{{upper value}}`  
**Beispiel**  
In diesem Beispiel wird der `[0] `-Eintrag für das `User.UserAttributes.LastName`-Attribut ausschließlich in Großbuchstaben umgewandelt.  
`{{upper User.UserAttributes.LastName.[0]}}`returns  
*ROE*wenn der `User.UserAttributes.LastName.[0]` Wert ist*Roe*.

*yesno*  
Ersetzt `true`, `false` und `NULL` durch `Yes`, `No` und `Maybe`.  
**Usage**  
`{{yesno value [yes="yes"] [no="no"] maybe=["maybe"]}}`  
**Beispiel**  
In diesem Beispiel gibt das `IsUserSubscribed`-Attribut zurück, ob ein Benutzer eine bestimmte Liste abonniert hat.  
Folgendes wird zurückgegeben: `{{yesno Attributes.IsUserSubscribed}}`   
*yes*wenn `Attributes.IsUserSubscribed` ist*true*.

## Mathematische und Kodierungs-Hilfsobjekte
<a name="mathhelpers"></a>

In diesem Abschnitt werden die **Mathematischen und Kodierungs-Hilfsobjekte** beschrieben.
+ `add`: Gibt die Summe zweier Zahlen zurück.
+ `ceiling`: Rundet eine Ganzzahl auf ihre mathematische Obergrenze.
+ `decode64`: Dekodiert einen base64-kodierten Wert in eine Zeichenfolge.
+ `divide`: Gibt den Quotienten zweier Zahlen zurück.
+ `encode64`: Kodiert eine Zeichenfolge mithilfe von base64.
+ `floor`: Rundet eine Ganzzahl auf ihre mathematische Untergrenze.
+ `md5`— Hasht eine übergebene Zeichenfolge mithilfe des MD5 Algorithmus.
+ `modulo`: Gibt den Rest zweier Zahlen unter Verwendung von Fließkommazahlen zurück.
+ `multiply`: Gibt das Produkt zweier Zahlen zurück.
+ `round`: Rundet eine Dezimalzahl auf die nächste ganze Zahl.
+ `sha256`: Hasht eine übergebene Zeichenfolge mithilfe von SHA-256.
+ `sha512`: Hasht eine übergebene Zeichenfolge mithilfe von SHA-512.
+ `subtract`: Gibt die Differenz zweier Zahlen zurück.
+ `uuid`: Generiert nach dem Zufallsprinzip eine UUID in einem 128-Bit-Format.

*hinzufügen*  
Gibt die Summe zweier Zahlen zusammen mit Fließkommazahlen zurück.  
**Usage**  
`{{add arg1 arg2}}`  
**Beispiel**  
`{{add 5 2.3}} `returns  
*7.3*

*ceiling*  
Rundet eine Ganzzahl auf ihre mathematische Obergrenze. Dabei handelt es sich um die höchste ganze Zahl, die dem übergebenen Wert am nächsten kommt.  
**Usage**  
`{{ceiling value}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{ceiling 5.23}}`  
*6*

*decode64*  
Dekodiert einen base64-kodierten Wert in eine Zeichenfolge.  
**Usage**  
`{{decode64 "string"}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{decode64 "SGVsbG8gd29ybGQ="}}`  
*Hello World*

*divide*  
Gibt den Quotienten zweier Zahlen zurück, einschließlich Fließkommazahlen.  
**Usage**  
 `{{divide arg1 arg2}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{divide 5 2.3}}`  
*2.17391304*

*encode64*  
Kodiert die im Argument übergebene Zeichenfolge mit base64.  
**Usage**  
`{{encode64 "string"}}`  
**Beispiel**  
`{{encode64 "Hello World"}}`  
*SGVsbG8gd29ybGQ=*

*floor*  
Rundet eine Ganzzahl auf ihre mathematische Untergrenze. Dabei handelt es sich um die niedrigste ganze Zahl, die dem übergebenen Wert am nächsten kommt.  
**Usage**  
`{{floor value}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{floor 5.23}}`  
*5*

*md5*  
Hasht eine übergebene Zeichenfolge mithilfe des MD5 Algorithmus.  
**Usage**  
`{{md5 "string"}}`  
**Beispiel**  
`{{md5 "Hello World"}}`  
*3e25960a79dbc69b674cd4ec67a72c62*

*Modulo*  
Gibt den Rest zweier Zahlen unter Verwendung von Fließkommazahlen zurück.  
**Usage**  
`{{modulo arg1 arg2}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{modulo 7 2}}`  
*1*

*multiply*  
Gibt das Produkt zweier Zahlen zusammen mit Fließkommazahlen zurück.  
**Usage**  
`{{multiply arg1 arg2}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{multiply 5 2.3}}`  
*11.5*

*round*  
Rundet eine Dezimalzahl auf die nächste ganze Zahl.  
**Usage**  
`{{round value}}`  
**Beispiel**  
`You spent an average of {{round 19.21}} minutes on our website each day.` gibt Folgendes zurück:  
*You spent an average of 19 minutes on our website each day.*

*sha256*  
Hasht eine übergebene Zeichenfolge mit kryptografischer SHA-256-Sicherheit.  
**Usage**  
`{{sha256 "string"}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{sha256 "Hello World"}}`  
*a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e*

*sha512*  
Hasht eine übergebene Zeichenfolge mit kryptografischer SHA-512-Sicherheit.  
**Usage**  
`{{sha512 "string"}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{sha512 "Hello World"}}`  
*2c74fd17edafd80e8447b0d46741ee243b7eb74dd2149a0ab1b9246fb30382f27e853d8585719e0e67cbda0daa8f51671064615d645ae27acb15bfb1447f459b*

*subtract*  
Gibt die Differenz zweier Zahlen zusammen mit Fließkommazahlen zurück.  
**Usage**  
`{{subtract arg1 arg2}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{subtract 5 2.3}} `  
*2.7*

*uuid*  
Generiert nach dem Zufallsprinzip eine UUID in einem 128-Bit-Format. Im Argument muss kein Wert übergeben werden.  
**Usage**  
`{{uuid}}`  
**Beispiel**  
Folgendes wird zurückgegeben: `{{uuid}} `  
**95f36680-152c-4052-99ec-cc3cdf7ca594**

## Inline-Partials
<a name="inlinepartials"></a>

Inline-Partials (eingebettete Teile) sind zwar technisch gesehen keine Helferobjekte, aber sie sind eine Methode von Handlebars, um Vorlagen, die wiederholte Zeichenfolgen enthalten, zu optimieren und so eine einfachere Wiederverwendung zu ermöglichen. Weitere Informationen finden Sie unter [Inline partials](https://handlebarsjs.com/guide/partials.html#inline-partials) auf [handlebarsjs.com](https://handlebarsjs.com). 

**Usage**

`{{#* inline "inlineName"}}Content to reuse{{/inline}}`

Um den Inhalt des Inline-Partial an anderer Stelle zu referenzieren, verwenden Sie:

` {{> inlineName}}`

**Beispiel**

Im folgenden Beispiel wird ein Inline-Partial erstellt, der den Vornamen und, falls verfügbar, den Nachnamen des Empfängers enthält. Fügen Sie dazu am Anfang Ihrer Vorlage den folgenden Code hinzu:

`{{#* inline "fullName"}}`

`{{User.UserAttributes.FirstName.[0]}} {{#if User.UserAttributes.LastName.[0]}} {{User.UserAttributes.LastName.[0]}} {{/if}}`

`{{/inline}}`

Nachdem Sie den `fullName`-Partial erstellt haben, können Sie ihn an jeder Stelle in Ihrer Vorlage verwenden, indem Sie dem Namen des Partials ein Größerzeichen `>` gefolgt von einem Leerzeichen voranstellen, wie im folgenden Beispiel: `{{> fullName}}`.

*` Hello {{> fullName}}`*

gibt den Vor- und Nachnamen des Benutzers zurück, wenn der Wert wahr ist — zum Beispiel*Hello Jane Doe*. Andernfalls, wenn kein Nachname gefunden wurde, *Hello Jane* wird zurückgegeben.

Handlebars umfasst neben den hier vorgestellten Features noch weitere Features. Weitere Informationen finden Sie unter [handlebarsjs.com](https://handlebarsjs.com/).

## Verwenden von Variablen mit Helferobjekten für Nachrichtenvorlagen
<a name="template-helpers-variables"></a>

Namen von benutzerdefinierten Amazon-Connect-Attributen unterstützen Leerzeichen. Um das benutzerdefinierte Attribut `"Last Name"` zu verwenden, müssen Sie es als `Attributes.[Last Name]` formatieren. 

## Verwenden von verschachtelten Helferobjekten
<a name="template-helpers-nesting"></a>

 Sie können mehrere Helferobjekte für Nachrichtenvorlagen ineinander verschachteln. Im folgenden Beispiel wird gezeigt, wie zwei Helferobjekte formatiert werden: `{{ first helper (second helper)}}`. Das zweite Helferobjekt wird zuerst verarbeitet, gefolgt vom ersten Helferobjekt. Denken Sie daran, dass das erste Helferobjekt immer die Ausgabe bestimmt. Nachfolgende Helferobjekt müssen wie folgt innerhalb des vorherigen Helferobjekts verschachtelt sein: `{{ first helper (second helper (third helper) )}}`.

Das folgende Beispiel zeigt, wie zwei Helferobjekt verschachtelt werden, um **JANE** in **Jane** zu ändern: `{{capitalizeFirst (lower "JANE")}}`. `lower` konvertiert **JANE** zuerst in **jane**. Dann konvertiert `capitalizeFirst` **jane** in **Jane**.

# Sicherheitsprofile wirken sich nicht auf die Autorisierung von Kundendienstmitarbeitern zum Anzeigen eines E-Mail-Threads aus
<a name="email-security-profiles1"></a>

Jeder Benutzer mit der folgenden Berechtigung in seinem Sicherheitsprofil kann E-Mails lesen, die er bearbeitet, oder E-Mails lesen, die Teil eines Threads sind, an dem er beteiligt ist: **Contact Control Panel (CCP)** – **Auf Contact Control Panel zugreifen** – **Zugriff**.

![\[Option „Auf Contact Control Panel zugreifen“ auf der Seite „Sicherheitsprofile“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/access-ccp-perm.png)


Dieses Autorisierungsverhalten ist standardmäßig aktiviert. Es ist nicht erforderlich, zusätzliche Berechtigungen einzurichten oder Konfigurationen vorzunehmen.

Dieses Verhalten wird durch die folgenden Kontextschlüssel gesteuert:

1. `connect:UserArn`: Stellt den Benutzer dar, der Zugriff auf einen einzelnen Kontakt hat

1. `connect:ContactAssociationId`: Stellt die Kontaktzuordnung dar, auf die der Benutzer Zugriff hat. Bei einem E-Mail-Kanal stellt eine Kontaktzuordnung immer einen E-Mail-Thread dar.

1. `connect:Channel`: Stellt den Kontaktkanal dar, auf den der Benutzer Zugriff hat. Beim E-Mail-Kanal ist dieser contextKey immer `EMAIL`.

Sie sollten `connect:ContactAssociationId` nicht in derselben Richtlinie verwenden wie `connect:UserArn`, da dies zu einem Ausfall führen könnte. Da der `connect:UserArn`-Bedingungsschlüssel restriktiver ist, greift er für alle Kontakte auf `Deny` zu, die nicht vom entsprechenden Benutzer gehandhabt werden, unabhängig davon, welchen Zugriff sie auf E-Mail-Threads haben.

Sie können `connect:Channel` isoliert verwenden, um den Zugriff auf bestimmte Kanäle zu beschränken. Akzeptierte Werte sind: `VOICE`, `CHAT`, `TASK` oder `EMAIL`. Weitere Informationen finden unter [Kontakt-API](https://docs.aws.amazon.com/connect/latest/APIReference/API_Contact.html).

Im Folgenden sind die kontaktbezogenen Schlüssel aufgeführt APIs , die diese Kontextschlüssel unterstützen:

1. [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)

1. [UpdateContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContact.html)

1. [ListContactReferences](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactReferences.html)

1. [TagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagContact.html)

1. [UntagContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_UntagContact.html)

1. [UpdateContactRoutingData](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactRoutingData.html)

1. [GetContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetContactAttributes.html) 

1. [UpdateContactAttributes](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactAttributes.html) 

1.  [StopContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContact.html) 

1. [StartContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartContactRecording.html) 

1.  [StopContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_StopContactRecording.html) 

1. [ResumeContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_ResumeContactRecording.html) 

1. [SuspendContactRecording](https://docs.aws.amazon.com/connect/latest/APIReference/API_SuspendContactRecording.html) 

1. [UpdateContactSchedule](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateContactSchedule.html) 

1. [TransferContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_TransferContact.html) 

1. [StartScreenSharing](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartScreenSharing.html) 

# Erstellen von Schnellantworten zur Verwendung bei Chat- und E-Mail-Kontakten in Amazon Connect
<a name="create-quick-responses"></a>

Mithilfe von Schnellantworten erhalten Kundendienstmitarbeiter in Contact Centers vorgefertigte Antworten in Englisch, die sie bei Chat- und E-Mail-Kontakten verwenden können. Schnellantworten sind besonders nützlich, um häufig gestellte Kundenanfragen zu beantworten. Sie tragen dazu bei, die Produktivität der Kundendienstmitarbeiter zu verbessern, die Bearbeitungszeiten zu verkürzen und die Kundenzufriedenheit zu erhöhen. Schnellantworten sind nur auf Englisch verfügbar.

Sie können die Amazon Connect Admin-Website oder die [Aktionen der Connect AI-Agenten](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_Operations.html) verwenden, um schnelle Antworten zu erstellen. Sie können einzelne Schnellantworten hinzufügen oder viele davon gleichzeitig importieren. Sie können Antworten auch mit [benutzerdefinierten Attributen](add-attributes.md) personalisieren. Darüber hinaus können Sie Schnellantworten Tastenkombinationen zuweisen und sie mit [Weiterleitungsprofilen](https://docs.aws.amazon.com/connect/latest/adminguide/about-routing.html) verknüpfen, so dass Kundendienstmitarbeiter schnell auf relevante Inhalte zugreifen können.

Standardmäßig ermöglicht CCP Kundendienstmitarbeitern die Suche nach Schnellantworten. Custom Builder können [Amazon Connect Streams](https://github.com/aws/amazon-connect-streams) verwenden, um die Schnellantwortsuche programmgesteuert in ihren CCP-Implementierungen zu implementieren.

Informationen darüber, wie Kundendienstmitarbeiter nach Schnellantworten suchen können, finden Sie unter [Durchsuchen des Contact Control Panel (CCP) nach Schnellantworten an Kunden](search-qr-ccp.md).

**Tipp**  
Auch wenn für schnelle Antworten die Connect AI-Agenten verwendet werden APIs, führen schnelle Antworten nicht zu einer zusätzlichen Abrechnung. Sie zahlen nur die Kosten für die Chat- oder E-Mail-Nachricht. Weitere Informationen finden Sie unter [Amazon Connect – Preise](https://aws.amazon.com/connect/pricing/).

**Topics**
+ [Zuweisen von Sicherheitsprofilberechtigungen](quick-response-permissions.md)
+ [Richten Sie eine Amazon Connect Connect-Wissensdatenbank ein](setup-knowledgebase.md)
+ [Hinzufügen von Schnellantworten zur Verwendung bei Chat- und E-Mail-Kontakten](quick-responses.md)
+ [Fügen Sie Attribute hinzu, um Schnellantworten zu personalisieren](add-attributes.md)
+ [Bearbeiten von Schnellantworten](edit-quick-responses.md)
+ [Löschen von Schnellantworten in Amazon Connect](delete-qr.md)
+ [Importieren von Schnellantworten](add-data.md)
+ [Anzeigen des Importverlaufs für Ihre Schnellantworten](view-import-history.md)
+ [Aktivieren von Schnellantworten in einem benutzerdefinierten CCP](enable-qr-search.md)

# Zuweisen von Berechtigungen, um Schnellantworten in Amazon Connect zu verwalten
<a name="quick-response-permissions"></a>

Um Schnellantworten auf der Amazon Connect Admin-Website zu erstellen und zu verwalten, benötigen Benutzer die Berechtigungen für das Content Management-Sicherheitsprofil. Die folgende Abbildung zeigt diese Berechtigungen auf der Seite **Sicherheitsprofile**.

![\[Die verschiedenen Schnellantwort-Berechtigungen, alle mit grünen Häkchen versehen.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/content-mgmt-qr.png)


Im Folgenden finden Sie eine Beschreibung der Content-Management-Berechtigungen.
+ **Alle** – Aktiviert alle Berechtigungen, aber Sie benötigen eine benutzerdefinierte Ansicht, um **Zugriff** zu aktivieren.
+ **Zugriff** – Gewährt Benutzern Zugriff auf benutzerdefinierte Ansichten. Dieses Kontrollkästchen ist erst verfügbar, wenn Sie eine benutzerdefinierte Ansicht erstellen.
+ **Erstellen** — Ermöglicht es Benutzern, Wissensdatenbanken und schnelle Antworten für Connect AI-Agenten auf der Amazon Connect Admin-Website zu erstellen. Diese Einstellung ermöglicht Benutzern auch das Anzeigen und Bearbeiten. Gewährt nicht die Berechtigung zum Löschen von Schnellantworten
+ **Anzeigen** – Ermöglicht Benutzern, Schnellantworten auf der Amazon Connect -Admin-Website anzuzeigen.
+ **Bearbeiten** – Ermöglicht Benutzern, Schnellantworten auf der Amazon Connect -Admin-Website zu bearbeiten.
+ **Löschen** – Ermöglicht Benutzern, Schnellantworten auf der Amazon Connect -Admin-Website zu löschen.

Wenn Sie möchten, dass dieselben Benutzer Schnellantworten mit personalisierten Attributen versehen, benötigen sie auch die Berechtigung **Kanäle und Datenströme**, **Datenströme – Veröffentlichen**. 

Informationen zum Hinzufügen von Berechtigungen zu einem vorhandenen Sicherheitsprofil finden Sie unter [Aktualisieren von Sicherheitsprofilen in Amazon Connect](update-security-profiles.md).

# Richten Sie eine Amazon Connect Connect-Wissensdatenbank ein, um schnelle Antworten zu speichern
<a name="setup-knowledgebase"></a>

Sie müssen eine [Amazon Connect Connect-Wissensdatenbank](connect-ai-agent.md) erstellen, um schnelle Antworten zu speichern. Sie können die Amazon Connect Admin-Website verwenden, um die Wissensdatenbank mit einem einzigen Klick zu erstellen. Die Site verwendet AWS-eigene Schlüssel , um Daten zu verschlüsseln. 

**Anmerkung**  
Sie können Ihren eigenen Schlüssel erstellen, indem Sie [ ServerSideEncryptionConfiguration](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_ServerSideEncryptionConfiguration.html#wisdom-Type-ServerSideEncryptionConfiguration-kmsKeyId)in einem [CreateKnowledgeBase](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_CreateKnowledgeBase.html)API-Aufruf einen benutzerdefinierten Schlüssel angeben. Weitere Informationen finden Sie unter [Erste Einrichtung für KI-Agenten](ai-agent-initial-setup.md) in diesem Handbuch.

In den folgenden Schritten wird erklärt, wie Sie die Amazon Connect Admin-Website verwenden, um eine Amazon Connect Connect-Wissensdatenbank zu erstellen.

**So erstellen Sie eine Wissensdatenbank**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein Administrator-Konto oder ein Konto mit der Berechtigung **Content-Management – Schnellantworten – Erstellen** im Sicherheitsprofil.

1. Wählen Sie in der Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.

1. Wählen Sie auf der Seite **Schnellantworten die** Option **Erste Schritte** aus.
**Anmerkung**  
Wenn die Schaltfläche **Erste Schritte** nicht verfügbar ist, melden Sie sich mit einem Konto an, das über das Administrator-Sicherheitsprofil verfügt, oder bitten Sie einen anderen Administrator um Hilfe.

1. Bleiben Sie auf der Seite, bis der Vorgang abgeschlossen ist. Aktualisieren Sie die Seite erst, wenn der Vorgang abgeschlossen ist. Eine Anzeige zeigt den Status an.  
![\[Eine horizontale grüne Statusleiste.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-3.png)

Die fertige Wissensdatenbank enthält zwei Beispiele für Schnellantworten.
+ Wenn das [grundlegende Weiterleitungsprofil](https://docs.aws.amazon.com/connect/latest/adminguide/concepts-routing.html) in Ihrer Amazon-Connect-Instance vorhanden ist, werden die Beispiel-Antworten diesem zugeordnet.
+ Die Beispielantworten sind auf **Inaktiv** gesetzt, was bedeutet, dass Kundendienstmitarbeiter sie nicht sehen oder danach suchen können. Wenn Sie eine Beispiel-Schnellantwort aktivieren, wird sie für Kundendienstmitarbeiter, die dem grundlegenden Weiterleitungsprofil zugewiesen sind, sichtbar und durchsuchbar.
+  Wenn das grundlegende Weiterleitungsprofil in Ihrer Amazon-Connect-Instance nicht vorhanden ist, werden die Beispiel-Schnellantworten **allen** Weiterleitungsprofilen zugeordnet. Nachdem Sie eine Beispiel-Schnellantwort aktiviert haben, können alle Kundendienstmitarbeiter diese Antwort sehen und danach suchen, unabhängig von den ihnen zugewiesenen Weiterleitungsprofilen. 

**Anmerkung**  
Schnellantworten sind nur für die Kanäle **Chat** und **E-Mail** verfügbar. 

# Hinzufügen von Schnellantworten zur Verwendung bei Chat- und E-Mail-Kontakten in Amazon Connect
<a name="quick-responses"></a>

In diesem Thema wird erklärt, wie Sie mithilfe der Amazon Connect Admin-Website eine Schnellantwort hinzufügen. Informationen APIs zur programmgesteuerten Erstellung und Verwaltung von Schnellantworten finden Sie unter. [APIs um Schnellantworten zu erstellen und zu verwalten](#apis-quick-responses) 

**So fügen Sie Antworten hinzu**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Erstellen** verfügt.

1. Wählen Sie in der Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Wählen Sie auf der Seite **Schnellantworten** die Option **Antwort hinzufügen** aus.
**Anmerkung**  
Wenn die Schaltfläche **Antwort hinzufügen** nicht verfügbar ist, melden Sie sich mit einem Konto an, das über das Administrator-Sicherheitsprofil verfügt, oder bitten Sie einen anderen Administrator um Hilfe.

1. Wählen Sie auf der Seite **Antwort hinzufügen** aus, ob die Antwort für Chat, E-Mail oder beide Kanäle bestimmt ist.

1. Geben Sie auf der Seite **Antwort hinzufügen** einen Namen, eine Beschreibung und eine Tastenkombination für die Schnellantwort ein. Sie müssen einen eindeutigen Namen und eine Tastenkombination eingeben, da Kundendienstmitarbeiter nach diesen Werten suchen.

1. Öffnen Sie die Liste der **Weiterleitungsprofile** und wählen Sie ein oder mehrere Profile aus. **Sie können maximal 20 Profile oder Alle auswählen.** Nur die Kundendienstmitarbeiter, die einem bestimmten Profil zugewiesen sind, können die mit diesem Profil verknüpften Schnellantworten sehen.

1. (Optional) Wählen Sie **Aktivieren: Diese Antwort für Kundendienstmitarbeiter sichtbar machen**, wenn Sie möchten, dass Kundendienstmitarbeiter die Antwort sehen und nach ihr suchen können.

1. Geben Sie im Bereich **Inhalt** die Antwort ein und wählen Sie dann **Speichern** aus.

**Anmerkung**  
Wenn im Datenstrom-Block benutzerdefinierte Attribute konfiguriert sind, werden diese Attribute, wie etwa der Name des Kunden, angezeigt, wenn ein [Kundendienstmitarbeiter in CCP nach einer Antwort sucht](search-qr-ccp.md). Weitere Informationen finden Sie unter [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md).

## APIs um Schnellantworten zu erstellen und zu verwalten
<a name="apis-quick-responses"></a>

Verwenden Sie Folgendes APIs , um Schnellantworten programmgesteuert zu erstellen und zu verwalten:
+ [CreateQuickResponse](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_CreateQuickResponse.html)
+ [UpdateQuickResponse](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateQuickResponse.html)
+ [DeleteQuickResponse](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_DeleteQuickResponse.html)
+ [GetQuickResponse](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_GetQuickResponse.html)
+ [ListQuickResponses](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListQuickResponses.html)
+ [SearchQuickResponses](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_SearchQuickResponses.html)
+ [UpdateQuickResponse](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateQuickResponse.html)

# Hinzufügen von Attributen zur Personalisierung von Schnellantworten in Amazon Connect
<a name="add-attributes"></a>

Sie können Schnellantworten auch mit benutzerdefinierten Attributen personalisieren. Dazu verwenden Sie die Amazon Connect -Admin-Website, um Antworten zu erstellen, die [Amazon-Connect-Kontaktattribute](https://docs.aws.amazon.com/connect/latest/adminguide/connect-contact-attributes.html) enthalten. Sie können den [Set contact attributes (Kontaktattribute festlegen)](set-contact-attributes.md)-Block auch verwenden, um benutzerdefinierte Attribute in Datenströmen zu erstellen.

Wenn Schnellantworten benutzerdefinierte Attribute enthalten, wird der Wert dieser Attribute, wie z. B. der Kundenname, angezeigt, wenn ein [Kundendienstmitarbeiter in CCP nach einer Antwort sucht](search-qr-ccp.md).

In den folgenden Schritten wird erläutert, wie Sie Schnellantworten benutzerdefinierte Attribute hinzufügen. Sie erstellen zuerst ein Set-Contact-Attribut und fügen dann das Attribut zu einer Schnellantwort hinzu.

**So erstellen Sie ein Set-Contact-Attribut**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Datenströme – Bearbeiten oder Erstellen** verfügt.

1. Wählen Sie auf der Navigationsleiste **Weiterleitung** und dann **Datenströme** aus.  
![\[Menü mit „Weiterleitung“ und „Datenströme“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/routing-flows.png)

1. Auf der Seite **Datenströme** werden in der Spalte **Typ** die einzelnen Typen von Datenströmen aufgeführt. Wählen Sie den Datenstrom aus, dem Sie Attribute hinzufügen möchten.

1. Folgen Sie den Schritten unter [Erstellen eines festgelegten Kontaktattributs](set-contact-attributes.md).
**Anmerkung**  
Wählen Sie in der Konfiguration des Kontaktattributs den Namespace **Benutzerdefiniert** aus, speichern und veröffentlichen Sie dann den Datenstrom.

1. Wenn Sie fertig sind, führen Sie die nächsten Schritte aus.

Sie können diese Schritte befolgen, wenn Sie eine Schnellantwort erstellen oder aktualisieren.

**So fügen Sie einer Schnellantwort ein Attribut hinzu**

1. *Melden Sie sich auf der Amazon Connect Admin-Website unter https://Instanzname .my.connect.aws/ an.* Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Erstellen oder Bearbeiten** verfügt.

1. Wählen Sie in der linken Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Um eine Antwort zu erstellen, wählen Sie **Antwort hinzufügen** aus.

    –oder –

   Markieren Sie das Kontrollkästchen neben der Schnellantwort, die Sie personalisieren möchten und wählen Sie dann **Bearbeiten**.

1. Wählen Sie den Inhaltsabschnitt aus, geben Sie den Inhalt der Schnellantwort ein und verwenden Sie dann die Handlebar-Syntax, um ein benutzerdefiniertes Attribut einzugeben. Stellen Sie sicher, dass Sie das Namespace-Präfix `Attributes` angeben. Beispiel, **\$1\$1Attributes.Customer\$1\$1**.

   Das folgende Bild zeigt eine Schnellantwort auf eine E-Mail.   
![\[Schnellantwort mit einem Attribut für den Kundennamen\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/email-quick-response-attributes.png)

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

In den folgenden Schritten wird erläutert, wie Attribute in CCP getestet werden.

**So testen Sie Attribute**

1. *Melden Sie sich auf der Chat-Testseite der Amazon Connect Admin-Website unter https://Instanzname .my.connect.aws/test-chat an.*

1. Wählen Sie den Datenstrom mit dem benutzerdefinierten Attribut aus.

1. Starten Sie einen Chat und geben Sie **/\$1*searchText*** ein, wobei *searchText* die zugewiesene Tastenkombination ist.

**Anmerkung**  
Weitere Informationen finden Sie unter [Testen von Sprach-, Chat- und Aufgabenerlebnissen in Amazon Connect](chat-testing.md).

# Bearbeiten von Schnellantworten in Amazon Connect
<a name="edit-quick-responses"></a>

In diesem Thema wird erklärt, wie Sie die Admin-Website verwenden, um eine Schnellantwort zu bearbeiten. Amazon Connect Informationen zum programmgesteuerten Bearbeiten einer Schnellantwort finden Sie [UpdateQuickResponse](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_UpdateQuickResponse.html)in der *API-Referenz für Connect AI-Agenten*.

**So bearbeiten Sie eine Antwort**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Bearbeiten** verfügt.

1. Wählen Sie in der Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Wählen Sie auf der Seite **Schnellantworten** den Namen der Schnellantwort aus, die Sie bearbeiten möchten. Sie können auch das Kontrollkästchen neben der Antwort aktivieren und dann **Bearbeiten** auswählen.

1. Nehmen Sie nach Bedarf Änderungen in den folgenden Feldern vor: 
   + **Name**
   + **Beschreibung**
   + **Tastenkombination**
   + **Weiterleitungsprofile**
   + **Aktivieren/Deaktivieren der Schnellantwort**
   + **Inhalt**
   + **Channel**

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

# Löschen von Schnellantworten in Amazon Connect
<a name="delete-qr"></a>

In diesem Thema wird erklärt, wie Sie die Amazon Connect Admin-Website verwenden, um eine Schnellantwort zu löschen. Informationen zum programmgesteuerten Löschen einer Schnellantwort finden Sie [DeleteQuickResponse](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_DeleteQuickResponse.html)im *API-Referenzhandbuch für Connect AI-Agenten*.

**Wichtig**  
Sie können einen Löschvorgang nicht rückgängig machen.
Kundendienstmitarbeiter können gelöschte Schnellantworten nicht sehen oder verwenden.

**So löschen Sie eine Antwort**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Löschen** verfügt.

1. Wählen Sie in der Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Markieren Sie auf der Seite **Schnellantworten** das Kontrollkästchen neben der Antwort, die Sie löschen möchten. Sie können maximal 20 Antworten auswählen.

1. Wählen Sie **Löschen** aus.

   Eine Erfolgsmeldung wird angezeigt:  
![\[Ein grünes Häkchen und der Text „Ausgewählte Schnellantwort wurde erfolgreich gelöscht“.\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/deletion-success-message.png)

**Anmerkung**  
Wenn die Schaltfläche **Löschen** inaktiv ist, melden Sie sich bei einem Amazon-Connect-Konto an, das über das erforderliche Sicherheitsprofil verfügt, oder bitten Sie einen anderen Administrator um Hilfe.
Bleiben Sie auf der Seite, bis der Löschvorgang abgeschlossen ist. 

# Importieren von Schnellantworten in Amazon Connect
<a name="add-data"></a>

Sie können maximal 100 Schnellantworten gleichzeitig aus einer .csv-Datei importieren. In diesem Thema wird erklärt, wie Sie die Admin-Website verwenden, um Schnellantworten zu importieren Amazon Connect . Informationen zum programmgesteuerten Import von Schnellantworten finden Sie [StartImportJob](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_StartImportJob.html)in der *API-Referenz für Connect AI-Agenten*.

**So importieren Sie Antworten**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Erstellen** verfügt.

1. Wählen Sie in der Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Wählen Sie auf der Seite **Schnellantworten die** Option **Import** aus. 

1. Wählen Sie im Dialogfeld **Import** den Link **Responses Import Template.csv** und speichern Sie dann die resultierende Datei **Response Import Template.csv** auf Ihrem Desktop. Die Datei wird in Microsoft Excel oder einem ähnlichen Tabellenkalkulationsprogramm geöffnet.

1. Geben Sie in der .csv-Datei Werte in jede Spalte ein. Beachten Sie Folgendes:
   + Die Werte für **Name** und **Tastenkombination** müssen für alle Schnellantworten in Ihrer Amazon-Connect-Instance eindeutig sein.
   + Bei den Werten in der Spalte **Weiterleitungsprofil** wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen exakt mit dem Namen Ihres Weiterleitungsprofils übereinstimmen.
   + Benennen Sie die Werte in der ersten Zeile der .csv-Datei nicht um und ändern Sie sie nicht. Diese Header-Schlüssel sind reserviert und werden verwendet, um Payloads für die API zu generieren. [CreateQuickResponse](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_CreateQuickResponse.html)
   + Entfernen Sie alle Instances von **<\$1Required field>** aus der .csv-Datei. Diese dienen nur zu Informationszwecken.

1. Speichern Sie die CSV-Datei, kehren Sie zur Amazon Connect Admin-Website zurück und wählen Sie im Dialogfeld **Import** die Option Datei **hochladen** aus.

1. Suchen und öffnen Sie die .csv-Datei und wählen Sie dann **Import**.

   Erfolgs- oder Fehlschlagsmeldungen werden angezeigt, wenn der Importvorgang abgeschlossen ist. Wenn der Vorgang fehlschlägt, wählen Sie in der Meldung den **Link Fehlgeschlagene Importe herunterladen** aus. Überprüfen Sie die .csv-Datei auf vor- oder nachgestellte Leerzeichen und auf Meldungen zu dem Fehler.

Sie können die Seite **Schnellantwort** verlassen, bevor der Importauftrag abgeschlossen ist. Wählen Sie den Link **Importverlauf anzeigen**, der sich unter der Liste der Antworten befindet, um den Status Ihrer Importaufträge einzusehen.

# Anzeigen des Importverlaufs für Ihre Amazon-Connect-Schnellantworten
<a name="view-import-history"></a>

Amazon Connect speichert den Importverlauf für die gesamte Lebensdauer Ihrer Wissensdatenbank. Um diesen Verlauf zu löschen, müssen Sie die [DeleteKnowledgeBase](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_DeleteKnowledgeBase.html)Aktion zum Löschen der Wissensdatenbank verwenden.

In diesem Thema wird erklärt, wie Sie die Amazon Connect Admin-Website verwenden, um Importverläufe einzusehen. Informationen zum programmgesteuerten Anzeigen von Importverläufen finden Sie [ListImportJobs](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_ListImportJobs.html)in der API-Referenz für *Connect AI-Agenten*.

**So zeigen Sie den Importverlauf an**

1. Melden Sie sich auf der Amazon Connect Admin-Website unter https://*Instanzname* .my.connect.aws/ an. Verwenden Sie ein **Administrator**-Konto oder ein Konto, das einem Sicherheitsprofil zugewiesen ist und über die Berechtigung **Content Management – Schnellantworten – Anzeigen** verfügt.

1. Wählen Sie in der linken Navigationsleiste **Content-Management** und dann **Schnellantworten** aus.  
![\[Menü mit „Content-Management“ und „Schnellantworten“\]](http://docs.aws.amazon.com/de_de/connect/latest/adminguide/images/agent-application-1.png)

1. Wählen Sie auf der Seite **Schnellantworten** den Link **Importverlauf anzeigen** aus.

# Aktivieren Sie Amazon-Connect-Schnellantworten in einem benutzerdefinierten Connect Control Panel (CCP).
<a name="enable-qr-search"></a>

Damit Ihre Agenten Schnellantworten für ein eingebettetes oder benutzerdefiniertes CCP verwenden können, verwenden Sie die [Amazon Connect Streams-Bibliothek](https://github.com/amazon-connect/amazon-connect-streams), GitHub um die [SearchQuickResponse](https://docs.aws.amazon.com/amazon-q-connect/latest/APIReference/API_SearchQuickResponses.html)API aufzurufen und eine Liste mit Schnellantwort-Suchergebnissen an CCP zurückzugeben. Weitere Informationen finden Sie in der [Dokumentation zu Amazon Connect Streams](https://github.com/amazon-connect/amazon-connect-streams/blob/master/Documentation.md#quick-responses-apis) auf GitHub.

**Anmerkung**  
Um den Missbrauch der Such-API zu verhindern, haben wir Standardwerte für die folgenden Anforderungsparameter implementiert:  
`debounceTime` – 250 ms zwischen aufeinanderfolgenden `SearchQuickResponse`-API-Aufrufen
`maxSearchResults` – 25
Reihenfolge der Suchpriorität:  
`shortcut key`
`name`
`content`
`description`

Informationen zu den Erfahrungen des Kundendienstmitarbeiters mit Schnellantworten finden Sie unter [Suchen nach Schnellantworten an Kunden](search-qr-ccp.md).