

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.

# Zoom-Integration
<a name="zoom-integration"></a>

Mit dem Zoom Action Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf die Zoom-Plattform zugreifen. Sie können Besprechungen erstellen und verwalten, auf Aufzeichnungen und Besprechungszusammenfassungen zugreifen, Webinar-Details anzeigen und Kontakte suchen, ohne Amazon Quick zu verlassen.

Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Zoom. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.
+ **Standard-OAuth-Anwendung** — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Benutzer authentifizieren sich direkt mit ihrem Zoom-Konto.
+ **Benutzerdefinierte OAuth-App — Verwendet eine vom** Kunden verwaltete OAuth-Anwendung, die im Zoom App Marketplace registriert ist. Diese Option gibt Ihrem Unternehmen die volle Kontrolle über die OAuth-Konfiguration.

Weitere Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unter[Authentifizierungsmethoden](quick-action-auth.md).

## Bevor Sie beginnen
<a name="zoom-integration-prerequisites"></a>

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.
+ Ein aktives Zoom-Konto mit Zugriff auf die Besprechungen, Aufzeichnungen und Webinare, die Sie verwenden möchten.
+ Für **benutzerdefinierte OAuth-Apps: Zugriff auf den Zoom App** [Marketplace auf der Zoom-Website](https://marketplace.zoom.us/), um eine App zu erstellen.
+ Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unter[Integrationen in der Konsole einrichten](integration-console-setup-process.md).

## Zoom konfigurieren
<a name="zoom-source-setup"></a>

Wenn Sie die **standardmäßige OAuth-App-Authentifizierung** verwenden, überspringen Sie diesen Abschnitt und fahren Sie fort mit. [Den Connector in Amazon Quick einrichten](#zoom-quicksuite-setup)

Führen Sie für die benutzerdefinierte OAuth-App-Authentifizierung die folgenden Schritte im Zoom App Marketplace aus, bevor Sie Amazon Quick konfigurieren.

### Erstellen Sie eine Zoom-App (benutzerdefinierte OAuth-App)
<a name="zoom-register-oauth"></a>

Erstellen Sie eine App im Zoom App Marketplace, um die Kundenanmeldedaten zu erhalten, die Sie für Amazon Quick benötigen. Weitere Informationen finden Sie unter [OAuth auf der](https://developers.zoom.us/docs/integrations/oauth/) Zoom Developer-Website.

1. Melden Sie sich auf der [Zoom-Website im Zoom App Marketplace](https://marketplace.zoom.us/) an und rufen Sie das Portal zur App-Erstellung auf.

1. Erstellen Sie eine neue -Anwendung. Wählen Sie **Allgemein** für benutzerbasiertes OAuth oder **Server-to-Server OAuth für die Service-to-Service-Authentifizierung**.

1. Notieren Sie sich auf der Registerkarte **Grundinformationen** unter **App-Anmeldeinformationen** die folgenden Werte. Sie benötigen sie, wenn Sie Amazon Quick konfigurieren.
   + **Kunden-ID**
   + **Clientschlüssel**

1. Fügen Sie im Abschnitt **OAuth-Informationen** für **Authorized Redirect URI** die Amazon Quick Callback-URL hinzu: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

1. Wählen Sie die Registerkarte **Bereiche** und dann **\+ Bereiche hinzufügen**, um die Berechtigungen auszuwählen, die für Ihre Integration erforderlich sind. Die empfohlenen Bereiche finden Sie unter. [Empfohlene Bereiche](#zoom-oauth-scopes)

### Empfohlene Bereiche
<a name="zoom-oauth-scopes"></a>

Die folgenden Bereiche werden angefordert, wenn Sie eine Verbindung zu Zoom herstellen. **Wenn Sie eine benutzerdefinierte Zoom-App erstellen, fügen Sie diese Bereiche auf der Registerkarte Bereiche hinzu.**


**Von Zoom empfohlene Bereiche**  

| Scope | Description | 
| --- | --- | 
| meeting:read:list\_meetings | Listet Besprechungen auf. | 
| meeting:read:meeting | Liest Besprechungsdetails. | 
| meeting:read:summary | Liest Besprechungszusammenfassungen. | 
| meeting:read:list\_past\_participants | Listet frühere Besprechungsteilnehmer auf. | 
| meeting:read:list\_past\_instances | Listet vergangene Besprechungsinstanzen auf. | 
| meeting:write:meeting | Erstellt Besprechungen. | 
| meeting:update:meeting | Aktualisiert Besprechungen. | 
| meeting:delete:meeting | Löscht Besprechungen. | 
| meeting:write:registrant | Fügt registrierte Teilnehmer für Besprechungen hinzu. | 
| cloud\_recording:read:list\_user\_recordings | Listet Benutzeraufzeichnungen auf. | 
| cloud\_recording:read:list\_recording\_files | Listet die Aufnahmedateien auf. | 
| cloud\_recording:delete:meeting\_recording | Löscht Besprechungsaufzeichnungen. | 
| webinar:read:webinar | Liest Webinar-Details. | 
| webinar:read:list\_webinars | Listet Webinare auf. | 
| webinar:read:list\_past\_participants | Listet frühere Webinar-Teilnehmer auf. | 
| webinar:read:list\_registrants | Listet Webinar-Registranten auf. | 
| webinar:write:registrant | Fügt Webinar-Registranten hinzu. | 
| user:read:user | Liest Benutzerinformationen. | 
| user:read:settings | Liest Benutzereinstellungen. | 
| user:read:list\_collaboration\_devices | Listet Geräte für die Zusammenarbeit auf. | 
| contact:read:list\_contacts | Listet Kontakte auf. | 

**Anmerkung**  
Zusätzliche Bereiche für Whiteboard- und Marketplace-Funktionen werden ebenfalls angefordert. Die oben aufgeführten Bereiche decken die wichtigsten Besprechungs-, Aufzeichnungs-, Webinar-, Benutzer- und Kontaktaktionen ab.

## Den Connector in Amazon Quick einrichten
<a name="zoom-quicksuite-setup"></a>

### Über die Registerkarte „Verfügbar“ eine Connect
<a name="zoom-quick-connect"></a>

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte **Verfügbar** eine Verbindung herstellen.

1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus.

1. Suchen Sie auf der Registerkarte **Verfügbar** nach **Zoom** und wählen Sie **Connect** aus.

1. Schließen Sie den Zoom-Anmeldevorgang ab und erteilen Sie die angeforderten Berechtigungen.

Um stattdessen einen Connector mit der benutzerdefinierten OAuth-App zu konfigurieren, verwenden Sie den Tab „**Für Ihr Team erstellen**“ wie unten beschrieben.

### Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“
<a name="zoom-full-setup"></a>

Nachdem Sie alle erforderlichen Zoom-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.

1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus.

1. Wählen Sie den Tab „**Für Ihr Team erstellen**“.

1. Suchen Sie nach **Zoom** und wählen Sie es aus.
**Anmerkung**  
Wenn bereits ein Zoom-Konnektor vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Konnektoren angezeigt. Um einen vorhandenen Konnektor zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie **Nein, neu erstellen**.

1. Geben Sie einen **Namen** für Ihren Connector ein. Wählen Sie optional **\+ Beschreibung hinzufügen**, um eine Beschreibung hinzuzufügen.

1. Wählen Sie als **Verbindungstyp** die Option **Öffentliches Netzwerk** aus.

1. Wählen Sie für die **OAuth-Konfiguration** eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.

   1. Für die **Standard-OAuth-App**:

      Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie **Next** (Weiter), um fortzufahren.

   1. Konfigurieren **Sie für die benutzerdefinierte OAuth-App** die folgenden Felder:
      + **Basis-URL** (optional) — Die Zoom-API-Basis-URL. Beispiel: `https://api.zoom.us`
      + **Client-ID** — Die Client-ID aus Ihrer Zoom-App.
      + **Geheimer Client-Schlüssel** — Der geheime Client-Schlüssel aus Ihrer Zoom-App.
      + **Token-URL** — Der Token-Endpunkt. Beispiel: `https://zoom.us/oauth/token`
      + **Autorisierungs-URL** — Der Autorisierungsendpunkt. Beispiel: `https://zoom.us/oauth/authorize`
      + **Weiterleitungs-URL** — Pre-filled mit der Amazon Quick Callback-URL.

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

1. Wenn Sie die **Standard-OAuth-App oder die benutzerdefinierte OAuth-App** **ausgewählt haben, wird ein Zoom-Autorisierungsfenster** geöffnet. **Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Zulassen.**

1. **Überprüfen Sie** auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie **Weiter** aus.

1. Wählen Sie auf der Seite **Veröffentlichen** aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.

1. Wählen Sie **Publish**.

## Verfügbare Aktionen
<a name="zoom-integration-actions"></a>

Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.


**Verfügbare Aktionen zoomen**  

| Kategorie | Action | Description | 
| --- | --- | --- | 
| Meetings | Treffen auflisten | Listet Besprechungen für einen Benutzer auf. | 
| Meetings | Meeting abrufen | Ruft Details für ein bestimmtes Meeting ab. | 
| Meetings | Besprechung erstellen | Erstellt ein neues Meeting. | 
| Meetings | Besprechung aktualisieren | Aktualisiert ein vorhandenes Meeting. | 
| Meetings | Zusammenfassung der Besprechung abrufen | Ruft die AI-generated Zusammenfassung einer Besprechung ab. | 
| Meetings | Vorlagen für Besprechungszusammenfassungen auflisten | Listet die verfügbaren Vorlagen für Besprechungszusammenfassungen auf. | 
| Meetings | Frühere Besprechungsteilnehmer abrufen | Ruft Teilnehmer aus einer vergangenen Besprechung ab. | 
| Meetings | Listet vergangene Besprechungsinstanzen auf | Listet Instanzen einer wiederkehrenden Besprechung auf. | 
| Meetings | Registrant für ein Meeting erstellen | Fügt einem Meeting einen Registranten hinzu. | 
| Aufnahmen | Aufzeichnungen auflisten | Listet alle Aufzeichnungen für einen Benutzer auf. | 
| Aufnahmen | Holen Sie sich Besprechungsaufzeichnungen | Ruft Aufzeichnungen für ein bestimmtes Meeting ab. | 
| Aufnahmen | Archivierte Dateien auflisten | Listet archivierte Aufnahmedateien auf. | 
| Webinare | Webinare auflisten | Listet Webinare für einen Benutzer auf. | 
| Webinare | Holen Sie sich Webinar | Ruft Details für ein bestimmtes Webinar ab. | 
| Webinare | Webinar-Teilnehmer auflisten | Listet die Teilnehmer eines Webinars auf. | 
| Kontakte | Suchen Sie nach Unternehmenskontakten | Sucht nach Kontakten im Unternehmensverzeichnis. | 
| Geräte | Geräte auflisten | Listet Zoom-Geräte auf. | 
| Berichte | Holen Sie sich den täglichen Nutzungsbericht | Ruft einen täglichen Nutzungsbericht ab. | 
| Benutzer | Benutzer abrufen | Ruft Informationen über den authentifizierten Benutzer ab. | 

**Anmerkung**  
Die Aktionen, die Sie verwenden können, hängen von den für Ihr Zoom-Konto konfigurierten Berechtigungen und den Daten ab, auf die der authentifizierte Benutzer zugreifen kann.

## Verwaltung und Problembehebung
<a name="zoom-integration-troubleshooting"></a>

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations).

### Probleme bei der Authentifizierung
<a name="zoom-troubleshooting-auth"></a>
+ **Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App)** — Stellen Sie sicher, dass Ihr Zoom-Konto aktiv ist und dass Sie sich direkt auf der Zoom-Website bei [zoom.us](https://zoom.us) anmelden können. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Weiterleitungs-URI in Ihrer Zoom-App mit der Amazon Quick Callback-URL übereinstimmt.
+ **Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App)** — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten in Ihrer Zoom-App übereinstimmen. Sie können Ihre Anmeldedaten in den App-Einstellungen im Zoom App Marketplace einsehen.
+ **Unzureichende Berechtigungen** — Stellen Sie sicher, dass die für Ihre Zoom-App konfigurierten Bereiche die Berechtigungen enthalten, die für die Aktionen erforderlich sind, die Sie verwenden möchten. Siehe [Empfohlene Bereiche](#zoom-oauth-scopes).