Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazione con Zoom
Con il connettore d'azione Zoom, puoi accedere alla piattaforma Zoom direttamente in Amazon Quick tramite linguaggio naturale. Puoi creare e gestire riunioni, accedere alle registrazioni e ai riepiloghi delle riunioni, visualizzare i dettagli dei webinar e cercare contatti senza uscire da Amazon Quick.
Amazon Quick supporta diversi metodi di autenticazione per Zoom. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Gli utenti si autenticano direttamente con il proprio account Zoom.
+ **App OAuth personalizzata**: utilizza un'applicazione OAuth gestita dal cliente registrata nello Zoom App Marketplace. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth.
Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).
## Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account Zoom attivo con accesso alle riunioni, alle registrazioni e ai webinar che desideri utilizzare.
+ Per l'app **OAuth personalizzata: accedi allo Zoom App** [Marketplace](https://marketplace.zoom.us/) sul sito web di Zoom per creare un'app.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).
## Configurazione di Zoom
Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e procedi con. [Configurazione del connettore in Amazon Quick](#zoom-quicksuite-setup)
Per l'autenticazione personalizzata dell'app OAuth, completa i seguenti passaggi in Zoom App Marketplace prima di configurare Amazon Quick.
### Crea un'app Zoom (app OAuth personalizzata)
Crea un'app in Zoom App Marketplace per ottenere le credenziali client di cui hai bisogno per Amazon Quick. Per ulteriori informazioni, consulta [OAuth](https://developers.zoom.us/docs/integrations/oauth/) sul sito Web di Zoom Developer.
1. Accedi a [Zoom App Marketplace](https://marketplace.zoom.us/) sul sito web di Zoom e vai al portale per la creazione di app.
1. Crea una nuova applicazione . Scegli **Generale** per OAuth basato sull'utente o **Server-to-Server OAuth** per l'autenticazione da servizio a servizio.
1. **Nella scheda **Informazioni di base**, in Credenziali dell'app, registra i seguenti valori.** Ne hai bisogno quando configuri Amazon Quick.
+ **ID cliente**
+ **Client secret**
1. Nella sezione **Informazioni OAuth**, per l'**URI di reindirizzamento autorizzato**, aggiungi l'URL di callback di Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Scegli la scheda Ambiti e scegli **\+ Aggiungi **ambiti**** per selezionare le autorizzazioni richieste dalla tua integrazione. Per gli ambiti consigliati, consulta. [Ambiti consigliati](#zoom-oauth-scopes)
### Ambiti consigliati
I seguenti ambiti sono richiesti quando ti connetti a Zoom. Quando crei un'app Zoom personalizzata, aggiungi questi ambiti nella scheda **Ambiti**.
**Ambiti Zoom consigliati**
| Scope | Description |
| --- | --- |
| meeting:read:list\_meetings | Elenca le riunioni. |
| meeting:read:meeting | Legge i dettagli della riunione. |
| meeting:read:summary | Legge i riepiloghi delle riunioni. |
| meeting:read:list\_past\_participants | Elenca i partecipanti alle riunioni precedenti. |
| meeting:read:list\_past\_instances | Elenca le istanze delle riunioni passate. |
| meeting:write:meeting | Crea riunioni. |
| meeting:update:meeting | Aggiorna le riunioni. |
| meeting:delete:meeting | Elimina le riunioni. |
| meeting:write:registrant | Aggiunge i partecipanti alle riunioni. |
| cloud\_recording:read:list\_user\_recordings | Elenca le registrazioni degli utenti. |
| cloud\_recording:read:list\_recording\_files | Elenca i file di registrazione. |
| cloud\_recording:delete:meeting\_recording | Elimina le registrazioni delle riunioni. |
| webinar:read:webinar | Legge i dettagli del webinar. |
| webinar:read:list\_webinars | Elenca i webinar. |
| webinar:read:list\_past\_participants | Elenca i partecipanti ai webinar passati. |
| webinar:read:list\_registrants | Elenca gli iscritti al webinar. |
| webinar:write:registrant | Aggiunge gli iscritti al webinar. |
| user:read:user | Legge le informazioni dell'utente. |
| user:read:settings | Legge le impostazioni dell'utente. |
| user:read:list\_collaboration\_devices | Elenca i dispositivi di collaborazione. |
| contact:read:list\_contacts | Elenca i contatti. |
**Nota**
Sono inoltre richiesti ambiti aggiuntivi per le funzionalità di whiteboard e marketplace. Gli ambiti sopra elencati riguardano le azioni principali relative alla riunione, alla registrazione, al webinar, all'utente e ai contatti.
## Configurazione del connettore in Amazon Quick
### Connect dalla scheda Available
Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Nella scheda **Disponibile**, trova **Zoom** e scegli **Connect**.
1. Completa il flusso di accesso a Zoom e concedi le autorizzazioni richieste.
Per configurare invece un connettore con l'app OAuth personalizzata, usa la scheda **Crea per il tuo team** come descritto di seguito.
### Crea dalla scheda Crea per il tuo team
Dopo aver completato la configurazione Zoom richiesta, crea il connettore in Amazon Quick.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Scegli la scheda **Crea per il tuo team**.
1. Trova e scegli **Zoom**.
**Nota**
Se esiste già un connettore Zoom, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli **No, crea nuovo**.
1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.
1. Per **Tipo di connessione**, scegli **Rete pubblica**.
1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
1. Per l'app **OAuth predefinita:**
Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.
1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
+ **URL di base** (opzionale): l'URL di base dell'API Zoom. Ad esempio: `https://api.zoom.us`
+ **ID cliente**: l'ID cliente dell'app Zoom.
+ **Segreto** del cliente: il segreto del cliente dell'app Zoom.
+ **URL del token**: l'endpoint del token. Ad esempio: `https://zoom.us/oauth/token`
+ **URL di autorizzazione: l'**endpoint di autorizzazione. Ad esempio: `https://zoom.us/oauth/authorize`
+ URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.
1. Scegli **Next (Successivo)**.
1. Se scegli l'app **OAuth predefinita o l'app OAuth** **personalizzata, si apre una finestra di autorizzazione Zoom**. **Controlla le autorizzazioni richieste e scegli Consenti.**
1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.
1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.
1. Seleziona **Pubblica**.
## Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
**Azioni di zoom disponibili**
| Categoria | Azione | Description |
| --- | --- | --- |
| Riunioni | Elenca le riunioni | Elenca le riunioni per un utente. |
| Riunioni | Organizza una riunione | Recupera i dettagli di una riunione specifica. |
| Riunioni | Crea riunione | Crea una nuova riunione. |
| Riunioni | Aggiorna riunione | Aggiorna una riunione esistente. |
| Riunioni | Ottieni il riepilogo della riunione | Recupera il AI-generated riepilogo di una riunione. |
| Riunioni | Elenco dei modelli di riepilogo delle riunioni | Elenca i modelli di riepilogo delle riunioni disponibili. |
| Riunioni | Recupera i partecipanti alla riunione precedente | Recupera i partecipanti da una riunione precedente. |
| Riunioni | Elenca le istanze delle riunioni precedenti | Elenca le istanze di una riunione ricorrente. |
| Riunioni | Crea un registrante alla riunione | Aggiunge un registrante a una riunione. |
| Registrazioni | Elenca le registrazioni | Elenca tutte le registrazioni di un utente. |
| Registrazioni | Ottieni le registrazioni delle riunioni | Recupera le registrazioni di una riunione specifica. |
| Registrazioni | Elenca i file archiviati | Elenca i file di registrazione archiviati. |
| Webinar | Elenca i webinar | Elenca i webinar per un utente. |
| Webinar | Ottieni un webinar | Recupera i dettagli per un webinar specifico. |
| Webinar | Elenca i partecipanti al webinar | Elenca i partecipanti a un webinar. |
| Contatti | Cerca i contatti dell'azienda | Cerca i contatti nell'elenco dell'azienda. |
| dispositivi | Elenca dispositivi | Elenca i dispositivi Zoom. |
| Report | Ottieni un rapporto sull'utilizzo giornaliero | Recupera un rapporto sull'utilizzo giornaliero. |
| Utenti | Ottieni utente | Recupera informazioni sull'utente autenticato. |
**Nota**
Le azioni che puoi utilizzare dipendono dalle autorizzazioni configurate per il tuo account Zoom e dai dati accessibili all'utente autenticato.
## Gestione e risoluzione dei problemi
Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).
### Problemi di autenticazione
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo account Zoom sia attivo e che tu possa accedere a [zoom.us](https://zoom.us) direttamente dal sito web di Zoom. Per l'app OAuth personalizzata, verifica che l'URI di reindirizzamento nell'app Zoom corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID cliente e il segreto del cliente corrispondano ai valori dell'app Zoom. Puoi visualizzare le tue credenziali dalle impostazioni dell'app in Zoom App Marketplace.
+ **Autorizzazioni insufficienti**: verifica che gli ambiti configurati per la tua app Zoom includano le autorizzazioni necessarie per le azioni che desideri utilizzare. Per informazioni, consulta [Ambiti consigliati](#zoom-oauth-scopes).